Installing and Configuring Flux with GitHub

45 minutes
  • 5 Learning Objectives

About this Hands-on Lab

This lab introduces the steps necessary steps for installing Flux and configuring it to work with a student repository in GitHub. The student will need their own GitHub account to fork a sample repository, and this lab will spin up a Kubernetes cluster to enable the student to install and configure Flux.

Learning Objectives

Successfully complete this lab by achieving the following learning objectives:

Create a GitHub Repository Under Your Own Account

To create a repository on GitHub you must log in to your own account, and then you can create a repository with the YAML files you require. Or you can find the linuxacademy/content-gitops repository and fork it. Once you create your own version of that repository, examine the YAML files in the namespaces and workloads folders.

Deploy Flux Into Your Cluster

To check whether fluxctl is installed, enter:

$ fluxctl version

If fluxctl did not install automatically, you may enter the following command to install it:

$ sudo wget -O /usr/bin/fluxctl && sudo chmod +x /usr/bin/fluxctl

Create a namespace for Flux:

$ kubectl create ns flux

Set the GHUSER environment variable:

$ export GHUSER=[Your GitHub Handle]

Deploy Flux using the fluxctl command:

$ fluxctl install 
--namespace=flux | kubectl apply -f -
Verify The Deployment and Obtain the RSA Key

Verify the Flux deployment:

$ kubectl -n flux rollout status deployment/flux

Obtain the Flux RSA key created by fluxctl:

$ fluxctl identity --k8s-fwd-ns flux

Copy off the RSA key to implement in GitHub.

Implement the RSA Key in GitHub

Use the GitHub User Interface to Add the RSA Key obtained as a Deploy Key in GitHub.

Use the fluxctl sync Command to Synchronize the Cluster with the Repository

Use fluxctl to sync the cluster with the repository:

$ fluxctl sync --k8s-fwd-ns flux

Then check the existence of the lasample namespace:

$ kubectl get namespaces

Finally check that the Nginx deployment is running:

$ kubectl get pods --all-namespaces

Additional Resources

You will need your own GitHub Account to complete this lab.

What are Hands-on Labs

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Sign In
Welcome Back!

Psst…this one if you’ve been moved to ACG!

Get Started
Who’s going to be learning?