Install Weave Flux

This workshop has been deprecated and archived. The new Amazon EKS Workshop is now available at

Now we will use Helm to install Weave Flux into our cluster and enable it to interact with our Kubernetes configuration GitHub repo.

First, install the Flux Custom Resource Definition:

kubectl apply -f

Check that Helm is installed.

helm list

This command should either return a list of helm charts that have already been deployed or nothing.

If you get an error message, see installing helm for instructions.

In the following steps, your Git user name will be required. Without this information, the resulting pipeline will not function as expected. Set this as an environment variable to reuse in the next commands:


First, create the flux Kubernetes namespace

kubectl create namespace flux

Next, add the Flux chart repository to Helm and install Flux.

Update the Git URL below to match your user name and Kubernetes configuration manifest repository.

helm repo add fluxcd

helm upgrade -i flux fluxcd/flux \
--set${YOURUSER}/k8s-config \
--set git.branch=main \
--namespace flux

helm upgrade -i helm-operator fluxcd/helm-operator \
--set helm.versions=v3 \
--set git.ssh.secretName=flux-git-deploy \
--set git.branch=main \
--namespace flux

Watch the install and confirm everything starts. There should be 3 pods.

kubectl get pods -n flux

Install fluxctl in order to get the SSH key to allow GitHub write access. This allows Flux to keep the configuration in GitHub in sync with the configuration deployed in the cluster.

sudo wget -O /usr/local/bin/fluxctl $(curl | jq -r ".assets[] | select(.name | test(\"linux_amd64\")) | .browser_download_url")
sudo chmod 755 /usr/local/bin/fluxctl

fluxctl version
fluxctl identity --k8s-fwd-ns flux

Copy the provided key and add that as a deploy key in the GitHub repository.

  • In GitHub, select your k8s-config GitHub repo. Go to Settings and click Deploy Keys. Alternatively, you can go by direct URL by replacing your user name in this URL:
  • Click on Add Deploy Key
  • Name: Flux Deploy Key
  • Paste the key output from fluxctl
  • Click Allow Write Access. This allows Flux to keep the repo in sync with the real state of the cluster
  • Click Add Key

Now Flux is configured and should be ready to pull configuration.