Skip to content

Latest commit

 

History

History

bin

README.md

Multi-cluster GitOps Scripts

Note: these scripts operate on local repos and do not commit changes or push to remotes. Commits and pushes must be done separately.

Workload cluster management

add-cluster.sh

Usage:

add-cluster.sh <gitops_system_path> <cluster_name>

Updates the local repo for gitops-system to add a new workload cluster.

This is achieved by copying the required template folders into new folders for the cluster to be added, and updating the cluster name. The kustomization.yaml file in clusters-config is also updated to add the new cluster.

remove-cluster.sh

Usage:

remove-cluster.sh <gitops_system_path> <gitops_workloads_path> <cluster_name>

This removes the specified cluster from cluster-configs/kustomization.yaml, which triggers crossplane to remove the cluster.

It also removes all cluster configuration files from the local repos for gitops-system and gitops-workloads.

Application management

add-cluster-app.sh

Usage:

add-cluster-app.sh
  <gitops_workloads_path>
  <cluster_name> <app-name>
  <public_key_pem>
  <git_creds_template_path>
  <git_private_key_file> <git_public_key_file> <git_known_hosts>
  <sealed_secrets_public_pem_file>

Adds the application app-name to the cluster cluster-name, using the following steps:

  • creates a new folder for the app under the correct workloads cluster folder and copies the app template
  • updates the folder content with the correct cluster name and app name
  • creates a sealed secret gitops-secret.yaml using the supplied template, keys, and known_hosts string
  • updates kustomization.yaml in the workloads cluster folder.

It is assumed that a repo called app-name-manifests exists.

remove-cluster-app.sh

remove-cluster-app.sh <gitops_workloads_path> <cluster_name> <app-name>

Removes the application from kustomization.yaml and deletes the application folder from the workloads cluster folder.

add-app-cluster-overlay

Usage:

add-app-cluster-overlay <app_manifests_path> cluster_name

Example sequence

Create a commercial-staging cluster:

add-cluster.sh ./gitops-system commercial-staging

Commit and push:

cd gitops-system
git add .
git commit -m "Added cluster"
git push

Create an application manifests repo:

cd ~/environment
gh repo create --private --clone product-catalog-fe-manifests
cp -r multi-cluster-gitops/repos/apps-manifests/product-catalog-fe-manifests/* product-catalog-fe-manifests/
cd product-catalog-fe-manifests
git add .
git commit -m "baseline version"
git branch -M main
git push --set-upstream origin main

Add the app product-catalog-fe to the commercial-staging cluster:

add-cluster-app.sh \
  ./gitops-workloads \
  commercial-staging product-catalog-fe \
  multi-cluster-gitops/initial-setup/secrets-template/git-credentials.yaml \
  ~/.ssh/gitops ~/.ssh/gitops.pub \
  "github.com ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBEmKSENjQEezOmxkZMy7opKgwFB9nkt5YRrYMjNuG5N87uRgg6CLrbo5wAdT/y6v0mKV0U2w0WZ2YB/++Tpockg=" \
  ./sealed-secrets-keypair-public.pem

Commit and push:

cd gitops-workloads
git add .
git commit -m "Added pc-fe to staging"
git push