Skip to content

Commit

Permalink
Update k3d cluster create example (#1193)
Browse files Browse the repository at this point in the history
* Update k3d cluster create command to disable servicelb

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>

* Improve explanation of k3d cluster configuration

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>

* Add balancer to custom spell list

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>

---------

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
  • Loading branch information
brooke-hamilton authored Aug 14, 2024
1 parent 2053366 commit 52f9cfc
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 2 deletions.
1 change: 1 addition & 0 deletions .github/config/en-custom.txt
Original file line number Diff line number Diff line change
Expand Up @@ -439,6 +439,7 @@ tcp
BucketName
roadmap
Balancer
balancer
vHost
URI
uri
Expand Down
15 changes: 13 additions & 2 deletions docs/content/guides/operations/kubernetes/overview/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,10 +83,21 @@ First, ensure that memory resource is 8GB or more in `Resource` setting of `Pref
softwareupdate --install-rosetta --agree-to-license
```

Next, use the following commands to create a new cluster and install the Radius control plane, along with a new environment:
Use the following command to create a new cluster. and install the Radius control plane, along with a new environment:

- The first parameter adds a port mapping which routes traffic from the local machine into the cluster.
- The second parameter disables [`traefik`](https://k3d.io/v5.1.0/usage/k3s/#traefik) pods because Radius provides an ingress controller.
- The third parameter disables the [k3d internal load balancer](https://k3d.io/v5.1.0/usage/k3s/#servicelb-klipper-lb).

The `rad install` command is configured to route localhost traffic on port 8081 into the cluster.

```bash
k3d cluster create -p "8081:80@loadbalancer" --k3s-arg "--disable=traefik@server:*" --k3s-arg "--disable=servicelb@server:*"
```

Next, install the Radius control plane, along with a new environment. The `rad install` command below adds a parameter to override the default public endpoint so that Radius knows that traffic from the local machine will enter the pod on port 8081:

```bash
k3d cluster create -p "8081:80@loadbalancer" --k3s-arg "--disable=traefik@server:0"
rad install kubernetes --set rp.publicEndpointOverride=localhost:8081
rad init
```
Expand Down

0 comments on commit 52f9cfc

Please sign in to comment.