Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update k3d cluster create example #1187

Closed
wants to merge 1 commit into from
Closed

Update k3d cluster create example #1187

wants to merge 1 commit into from

Conversation

brooke-hamilton
Copy link
Contributor

@brooke-hamilton brooke-hamilton commented Aug 10, 2024

Thank you for helping make the Radius documentation better!

Please follow this checklist before submitting:

  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within codetabs
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have codetabs

In addition, please fill out the following to help reviewers understand this pull request:

Description

This PR updates the recommended command to use when creating a k3d cluster by adding a parameter to the k3d cluster create command to disable the default load balancer. The default load balancer was conflicting with the load balancer deployed by Radius. See the issue reference linked below for details.

Note: traefik@server:0 was changed to traefik@server:* to indicate that all instances should be affected, not just the one at index zero.

Issue reference

Fixes: radius-project/radius#7637

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
@@ -86,7 +86,7 @@ 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:

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just so I know what's going on ... does this command actually disable the built-in ingress + load balancer?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rynowak K3d has an external load balancer that can be disabled, but the configuration in this PR does not do that. The external LB is an nginx instance that runs as a container and routes traffic from the host machine into the k3d cluster container. We could disable it by passing --no-lb to the k3d cluster create command, i.e. k3d cluster create --no-lib, however, we need the routing from the host machine into the cluster that is provided by the nginx container.

Inside the k3d cluster there is an internal load balancer called servicelb that distributes traffic. That is the one we are disabling with this configuration.

@brooke-hamilton brooke-hamilton closed this by deleting the head repository Aug 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Gateway broken on K3d
2 participants