Install Flux
See https://fluxcd.io/docs/installation/#install-the-flux-cli
Linux/Mac
$ curl -s https://fluxcd.io/install.sh | sudo bash |
Generate a User Token
https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
Export User Token as Environment Variables
$ export GITHUB_TOKEN=xxxx
$ export GITHUB_USER=johnmehan |
Bootstrap
Perform pre-check to make sure we are able to install flux.
$ flux check --pre
► checking prerequisites
✗ flux 0.19.1 <0.20.0 (new version is available, please upgrade)
✔ Kubernetes 1.21.2 >=1.19.0-0
✔ prerequisites checks passed |
With Github
$ flux bootstrap github --owner=$GITHUB_USER --repository=<REPO_NAME> --branch=main --path=<CLUSTER_NAME> --personal
# example
$ flux bootstrap github --owner=$GITHUB_USER --repository=ft --branch=main --path=local --personal |
Add Sources
Git Clone New Repo
$ git clone git@github.com:johnmehan/ft.git
$ cd ft
$ cd local |
Define Helm Repo
$ flux create source helm ncyd--url https://artifactory-fpark1.int.net.nokia.com/artifactory/ncyd-helm-virtual --interval 1m0s --export >helmrepo-ncyd.yaml |
---
apiVersion: source.toolkit.fluxcd.io/v1beta1
kind: HelmRepository
metadata:
name: ncyd
namespace: flux-system
spec:
interval: 1m0s
url: https://artifactory-fpark1.int.net.nokia.com/artifactory/ncyd-helm-virtual |
$ git add <file>
$ git commit
$ git push
|
Wait a bit and then try retrieving your list of helm sources:
$ flux get sources helm
NAME READY MESSAGE REVISION SUSPENDED
ncyd True Fetched revision: 732d32e292bd0def8d5782211f139523d23880a1 732d32e292bd0def8d5782211f139523d23880a1 False |
Create Helm Release
Create secret for flux to use to talk to the helm repository
$ kubectl create secret generic acr --from-literal username=mehan --from-literal "password=xxx" -n flux-system |
Create a helm repo
$ flux create source helm ncyd-helm-virtual --url https://artifactory-fpark1.int.net.nokia.com/artifactory/ncyd-helm-virtual --interval 1m0s --secret-ref=acr --export > helmrepo-ncyd-helm-virtual.yaml |
View Repo
---
apiVersion: source.toolkit.fluxcd.io/v1beta1
kind: HelmRepository
metadata:
name: ncyd-helm-virtual
namespace: flux-system
spec:
interval: 1m0s
secretRef:
name: acr
url: https://artifactory-fpark1.int.net.nokia.com/artifactory/ncyd-helm-virtual/ |
$ flux create helmrelease ssh-server --source=HelmRepository/ncyd-helm-virtual --chart ssh-server--release-name ssh-server --target-namespace default --interval 5m0s --export > helmrelease-ssh-server.yaml |
You may want to update this helmrelease to override certain values
$ vi helmrelease-ssh-server.yaml |
---
apiVersion: helm.toolkit.fluxcd.io/v2beta1
kind: HelmRelease
metadata:
name: ssh-server
namespace: flux-system
spec:
chart:
spec:
chart: ssh-server
version: '1.0.0-1362439'
sourceRef:
kind: HelmRepository
name: ncyd-helm-virtual
interval: 5m0s
releaseName: ssh-server
targetNamespace: default
values:
usePassword: false |
Now, commit this file to your git and wait a little bit before executing the following command:
Debug a Failed helmrelease
$ kubectl describe helmrelease ssh-server -n flux-system
$ flux get hr -A
$ kubectl logs -f -n flux-system deployment/source-controller
$ flux reconcile ks flux-system --with-source |
References