Skip to content

ArgoCD

Version

Install

kubectl create namespace argocd
kubectl apply -k setup # v1.21 or later
# kubectl kustomize setup | kubectl apply -f - # before v1.21

Check all the pods are running

kubectl get pod -n argocd
NAME                                                READY   STATUS    RESTARTS   AGE
argocd-application-controller-0                     1/1     Running   0          90s
argocd-applicationset-controller-547665bdfd-rjgvm   1/1     Running   0          94s
argocd-dex-server-865966bc45-s6fgf                  1/1     Running   0          94s
argocd-notifications-controller-c47c9f869-2smdk     1/1     Running   0          93s
argocd-redis-896595fb7-h9pmr                        1/1     Running   0          93s
argocd-repo-server-678c6cc99c-kkzmd                 1/1     Running   0          93s
argocd-server-96cdb4df5-mxsq2                       1/1     Running   0          92s

Login

kubectl -n argocd port-forward service/argocd-server 8080:80
  • user: admin
  • password: kubectl get secret argocd-initial-admin-secret -n argocd -o jsonpath='{.data.password}' | base64 --decode (v1.9.0 or later, there's a secret for initial admin password.)

Add ArgoCD AppProject & Application

  • AppProject: dev

  • Application: guestbook-kustomize-dev.

  • Deploy application with ArgoCD

    kubectl apply -f project/dev

  • Check in console

    kubectl get pod -n dev
NAME                                          READY   STATUS    RESTARTS   AGE
dev-kustomize-guestbook-ui-7574c75879-6cfnq   1/1     Running   0          95s

  • Check on ArgoCD

Manage argocd by argocd

kubectl apply -f project/argocd/project.yaml,project/argocd/app-argocd.yaml

Clean up

kubectl delete -f project/dev
kubectl delete -k setup
kubectl delete ns argocd

ArgoCD Notifications

Github: https://github.com/argoproj-labs/argocd-notifications Docs: https://argocd-notifications.readthedocs.io/en/stable/

Prerequisite

ArgoCD is installed.

Version

Manage by kustomize

Basic

  1. Install

    kubectl apply -k setup-notifications/base

  2. Clean up

    kubectl delete -k setup-notifications/base

Manage by ArgoCD

kubectl apply -f project/argocd/project.yaml,project/argocd/app-argocd-notifications.yaml

Manage by Helm

  1. Install

    helm repo add argo https://argoproj.github.io/argo-helm
helm install argo/argocd-notifications --generate-name -n argocd -f argocd/setup-notification-with-helm/value.yaml

    failed:

    Error: YAML parse error on argocd-notifications/templates/configmap.yaml: error converting YAML to JSON: yaml: line 15: did not find expected key

    https://github.com/argoproj/argo-helm/issues/616 → fixed in https://github.com/argoproj-labs/argocd-notifications/pull/315

Configure Slack Notification

https://argocd-notifications.readthedocs.io/en/stable/services/slack/

  1. Prepare Slack bot and channel.
    1. Create Slack Application with chat:write:bot permission.
    2. Get OAuth token.
    3. Create Slack channel (e.g. #argocd-notifications).
    4. Add your bot to this channel. (/invite @<your-app-name>)
  2. Install either by Kustomize or Helm:

    • Kustomize:

      1. Prepare Secret argocd-notifications-secret (setup-notifications/overlays/slack/argocd-notification-secret.yaml) 

        cp setup-notifications/overlays/slack/argocd-notification-secret-sample.yaml setup-notifications/overlays/slack/argocd-notification-secret.yaml

        Fill your Slack token.

      2. Prepare argocd-notifications-cm (setup-notifications/overlays/slack/argocd-notification-cm.yaml)

        • context
        • subscriptions
        • service.slack
        • Just writing ConfigMap doesn't work -> Added annotation in Application or Project (Subscribe to notifications by adding the notifications.argoproj.io/subscribe.on-sync-succeeded.slack annotation to the Argo CD application or project) 
          kubectl patch app <my-app> -n argocd -p '{"metadata": {"annotations": {"notifications.argoproj.io/subscribe.on-sync-succeeded.slack":"<my-channel>"}}}' --type merge
      3. Apply 
        kubectl apply -k setup-notifications/overlays/slack
        • Helm:
      helm install argo/argocd-notifications --generate-name -n argocd -f setup-notification-with-helm/value.yaml --set secret.items.slack-token=<SLACK BOT TOKEN>