ArgoCD

https://argo-cd.readthedocs.io/en/stable/getting_started/

1. Install Argo CD

• kubectl create namespace argocd
• kubectl apply -n argocd -f argocd-install.yaml

2. Download Argo CD CLI

• Download the latest Argo CD version from https://github.com/argoproj/argo-cd/releases/latest. More detailed installation instructions can be found via the CLI installation documentation.
• Also available in Mac, Linux and WSL Homebrew:

brew install argocd

3. Access The Argo CD API Server

• Port Forwarding:

kubectl port-forward svc/argocd-server -n argocd 8080:443

• Service Type Load Balancer
• Change the argocd-server service type to LoadBalancer:

kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "LoadBalancer"}}'

• Ingress
• Follow the ingress documentation on how to configure Argo CD with ingress.

4. Login Using The CLI

• The initial username is 'admin'.
• The initial password for the admin account is auto-generated and stored as clear text in the field password in a secret named argocd-initial-admin-secret in your Argo CD installation namespace. You can simply retrieve this password using kubectl:

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

• WARNING: You should delete the argocd-initial-admin-secret from the Argo CD namespace once you changed the password. The secret serves no other purpose than to store the initially generated password in clear and can safely be deleted at any time. It will be re-created on demand by Argo CD if a new admin password must be re-generated.

• You can change the password via user settings on Argo UI. Otherwise you can change the password using the command below via CLI:

argocd account update-password

5. Register A Cluster To Deploy Apps To (Optional)

• This step registers a cluster's credentials to Argo CD, and is only necessary when deploying to an external cluster. When deploying internally (to the same cluster that Argo CD is running in), https://kubernetes.default.svc should be used as the application's K8s API server address.

• First list all clusters contexts in your current kubeconfig:

kubectl config get-contexts -o name

• Choose a context name from the list and supply it to argocd cluster add CONTEXTNAME. For example, for docker-desktop context, run:

argocd cluster add docker-desktop

• Create the 'Application project' process step here or copy the below (amend where applicable): https://argo-cd.readthedocs.io/en/stable/operator-manual/declarative-setup/#applications

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: myapp-argo-application #amend
  namespace: argocd 
spec:
  project: default #amend

  source:
    repoURL: https://github.com/Louispettitt/ArgoCD.git #amend
    targetRevision: HEAD
    path: dev #amend
  destination: 
    server: https://kubernetes.default.svc
    namespace: myapp #amend

  syncPolicy: #amend
    syncOptions:
    - CreateNamespace=true

    automated: #amend
      selfHeal: true
      prune: true

• See operator manual for more configuration options: https://argo-cd.readthedocs.io/en/stable/operator-manual/

HELP:

• If you get the following FATA[0000] Argo CD server address unspecified then make sure you are logged in from the CLI:

• Are you running argocd server locally, as a process? In this case you can use argocd login localhost:8080.

• Encode argocd token by using the following syntax:

• echo -n 'super-secret-password' | base64