Skip to main content

Connecting to Headlamp and controlling FluxCD resources

This tutorial describes how to connect to Headlamp with a temporary token and control FluxCD through Headlamp.

1. Get the token​

In the root of the gitops-flux repository, run:

task get-headlamp-token

2. Set-up port-forward​

In the root of the gitops-flux repository, run:

task port-forward-headlamp

3. Open Headlamp webUI and enter token​

  • Navigate to http://localhost:4466/
  • Click on the Use a token button
  • Enter the ID token which you've generated in step 1

4. Check the Flux overview​

In the menu on the left, click on Flux. This will show you an overview of all Flux resources and their state. For example, you can instantly see the amount of failed Kustomizations or HelmReleases.

5. Example: sync a HelmRelease​

  • In the menu on the left, click on Flux followed by HelmReleases.
  • In the presented list of HelmReleases, click on cloudnative-pg, the following screen shows details about this HelmRelease.
  • Click on the sync with source button. Flux will now pull the latest Git commits and sync the HelmRelease based on these commits. This way you can enforce reconciliation without waiting for the next run. The commandline equivalent would be flux -n cnpg-system reconcile helmrelease cloudnative-pg --with-source.

The same sync process can be triggered for Kustomizations.