argocd

argocd

Installation files are from https://github.com/argoproj/argo-cd/releases

Install

Install argocd with these lines:

# navigate to the argocd/overlays/localdev folder
cd argocd/overlays/localdev
kubectl create ns argocd
kubectl apply -k .

To get the initial admin password:

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

Setup

1. create access token in github (see https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
2. browse to https://argocd.localdev.me
3. click Advanced and the link Continue to argo.localdev.me
4. login with username admin and the initial admin password (see Install section)
5. go to settings > repositories > connect repo
   • use Default for the project
   • use https://github.com/<YOUR_NAME_HERE>/rancher-desktop-playground.git for repository url and replace <YOUR_NAME_HERE> with your github account
   • use git for the username
   • use the access token for the password
6. edit the environments/localdev/app-of-apps.yaml git urls - look for <YOUR_NAME_HERE>
7. edit the bootstrap/localdev/*.yaml git urls - look for <YOUR_NAME_HERE>
8. commit and push these changes
9. add localdev.yaml as app-of-apps to argocd
   • new app
   • application name: localdev
   • project name: default
   • repository url: the repository you connected before
   • revision: HEAD
   • path: environments/localdev
   • cluster url: https://kubernetes.default.svc
   • namespace: argocd
10. click sync on the app to initialize the sync - else the state remains Missing

You'll end up with this

Upgrade

After installation you can upgrade argocd with argocd. Just edit the overlays/localdev/kustomization.yaml to use the new argocd installation files. Here is an example how to upgrade from 2.9.3 to 2.9.6:

kustomization.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: argocd

resources:
- ../../2.9.6 # <- changed this to the new version
- ingress-http.yaml
- ingress-grpc.yaml

patches:
# ... more ...

back to index