Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 1: Argo CD installieren

Ziel: Argo CD läuft im Namespace argocd, ist über einen NodePort erreichbar, und du bist per CLI und Browser angemeldet. · Dauer: ca. 40 min · Voraussetzung: Tag 0

Briefing

  • Argo CD besteht aus mehreren Diensten. Die wichtigsten: der repo-server holt Git und rendert die Manifeste, der application-controller vergleicht sie mit dem Cluster und gleicht ab, der server liefert API und Weboberfläche.
  • Installiert wird mit einer einzigen Manifest-Datei oder dem Helm-Chart argo/argo-cd. Dieses Buch nimmt die Manifest-Datei, weil du damit genau siehst, was im Cluster landet. An Tag 14 hebst du Argo CD damit auf eine neue Version.
  • Die Konfiguration steckt in ConfigMaps und Secrets im Namespace argocd, vor allem argocd-cm, argocd-rbac-cm und argocd-secret.
 argocd-CLI / Browser ──► argocd-server (API, UI) ──► Redis (Cache)
                              │
            ┌─────────────────┴──────────────────┐
            ▼                                    ▼
 argocd-repo-server ◄── Git      argocd-application-controller ──► Kubernetes-API
 (holt, rendert)                 (vergleicht, gleicht ab)

Drill 1: Die Manifest-Datei

mkdir -p ~/argo-lab/tag01
cd ~/argo-lab/tag01
curl -fsSLO \
  https://raw.githubusercontent.com/argoproj/argo-cd/v3.5.7/manifests/install.yaml
wc -l install.yaml

Erwartet:

34050 install.yaml

Über 34.000 Zeilen, das meiste davon sind die drei CRDs. Welche Arten von Objekten drinstecken, zeigt grep:

grep -c "^kind: CustomResourceDefinition" install.yaml
grep -c "^kind: Deployment" install.yaml
grep -c "^kind: StatefulSet" install.yaml

Erwartet:

3
6
1

Sechs Deployments und ein StatefulSet, das ist der application-controller. Er hält den Zustand aller Anwendungen und läuft deshalb mit stabilem Namen.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Installieren

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f install.yaml

Erwartet (gekürzt):

namespace/argocd created
customresourcedefinition.apiextensions.k8s.io/applications.argoproj.io serverside-applied
customresourcedefinition.apiextensions.k8s.io/applicationsets.argoproj.io serverside-applied
customresourcedefinition.apiextensions.k8s.io/appprojects.argoproj.io serverside-applied
…
networkpolicy.networking.k8s.io/argocd-server-network-policy serverside-applied

Ausprobiert: Ohne --server-side scheitert ein einziges Objekt: The CustomResourceDefinition "applicationsets.argoproj.io" is invalid: metadata.annotations: Too long: may not be more than 262144 bytes. Ein normales kubectl apply legt eine Kopie des ganzen Objekts als Annotation ab, und die CRD ist dafür zu groß. Server-Side Apply braucht diese Annotation nicht. --force-conflicts übernimmt Felder, die ein anderer Manager gesetzt hat, etwa beim zweiten Lauf.

kubectl -n argocd rollout status deploy/argocd-server
kubectl -n argocd get pods

Erwartet (gekürzt, Namen weichen bei dir ab):

deployment "argocd-server" successfully rolled out
NAME                                               READY   STATUS    RESTARTS   AGE
argocd-application-controller-0                    1/1     Running   0          85s
argocd-applicationset-controller-78d8f6b76-t5r9q   1/1     Running   0          86s
argocd-dex-server-569657dd78-xsfxj                 1/1     Running   0          86s
argocd-notifications-controller-7cc66698b7-5nbc6   1/1     Running   0          86s
argocd-redis-66578bc5bc-94rs9                      1/1     Running   0          86s
argocd-repo-server-5b5df66788-n6gcs                1/1     Running   0          85s
argocd-server-7d8744db95-snzpd                     1/1     Running   0          85s
  • applicationset-controller erzeugt Anwendungen aus Vorlagen (Tag 8).
  • dex-server bindet fremde Logins an, etwa GitHub. Das Buch nutzt ihn nicht.
  • notifications-controller verschickt Nachrichten (Tag 12).

Zusammen brauchen die sieben Pods im Leerlauf rund 150 MiB RAM (kubectl top pods -n argocd).

Fortschritt speichern? Kostenlos registrieren

Drill 3: Von außen erreichbar

Der Service argocd-server ist nur im Cluster erreichbar. Statt ihn zu ändern, legst du einen eigenen NodePort-Service daneben. So bleibt install.yaml unverändert, und ein Upgrade überschreibt nichts von dir:

cat > argocd-nodeport.yaml <<'EOF'
apiVersion: v1
kind: Service
metadata:
  name: argocd-server-nodeport
  namespace: argocd
spec:
  type: NodePort
  selector:
    app.kubernetes.io/name: argocd-server
  ports:
    - name: https
      port: 443
      targetPort: 8080
      nodePort: 30443
EOF
kubectl apply -f argocd-nodeport.yaml

Erwartet:

service/argocd-server-nodeport created

argocd-server lauscht auf Port 8080 und spricht dort selbst TLS, mit einem selbst signierten Zertifikat. Ein Test:

curl -sk https://localhost:30443/ | grep -o "<title>.*</title>"

Erwartet:

<title>Argo CD</title>

-k nimmt das selbst signierte Zertifikat hin. Die CLI braucht dafür --insecure.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Anmelden

Bei der Installation erzeugt Argo CD ein zufälliges Passwort für den Benutzer admin und legt es im Secret argocd-initial-admin-secret ab. Die CLI liest es aus:

argocd admin initial-password -n argocd

Erwartet (dein Passwort weicht ab):

<16 Zeichen>

 This password must be only used for first time login. We strongly recommend you update the password using `argocd account update-password`.

argocd admin spricht direkt mit Kubernetes, nicht mit Argo CD. Deshalb klappt es schon vor dem ersten Login. Jetzt meldest du dich an und gibst das Passwort ein:

argocd login 172.16.0.182:30443 --username admin --insecure

Erwartet:

Password:
'admin:login' logged in successfully
Context '172.16.0.182:30443' updated

Das Startpasswort ersetzt du durch den Lab-Wert lab-argo-pw-123. Die CLI fragt nach dem alten und zweimal nach dem neuen:

argocd account update-password

Erwartet (gekürzt):

*** Enter password of currently logged in user (admin):
*** Enter new password for user admin:
*** Confirm new password for user admin:
Password updated
Context '172.16.0.182:30443' updated

Das alte Secret braucht niemand mehr:

kubectl -n argocd delete secret argocd-initial-admin-secret

Erwartet:

secret "argocd-initial-admin-secret" deleted from argocd namespace

Fortschritt speichern? Kostenlos registrieren

Drill 5: Was die CLI weiß

argocd version

Erwartet (gekürzt):

argocd: v3.5.7+6d73296
…
argocd-server: v3.5.7
…
  Kustomize Version: v5.8.1 2026-02-09T16:15:27Z
  Helm Version: v4.2.1+gd591a19

Der Server bringt eigene Versionen von Kustomize und Helm mit. Damit rendert der repo-server die Manifeste. Dein lokales Helm spielt für Argo CD keine Rolle.

argocd cluster list

Erwartet:

SERVER                          NAME        VERSION  STATUS   MESSAGE                                                  PROJECT
https://kubernetes.default.svc  in-cluster  1.37.2   Unknown  Cluster has no applications and is not being monitored.  

in-cluster ist der Cluster, in dem Argo CD selbst läuft. Ein zweiter kommt an Tag 11 dazu. Die Anmeldung merkt sich die CLI in ~/.config/argocd/config:

argocd context

Erwartet:

CURRENT  NAME                SERVER
*        172.16.0.182:30443  172.16.0.182:30443

Fortschritt speichern? Kostenlos registrieren

Drill 6: Die Weboberfläche

Öffne im Browser auf dem Laptop https://172.16.0.182:30443. Der Browser warnt vor dem selbst signierten Zertifikat. Nimm es für dieses Lab hin und melde dich mit admin und lab-argo-pw-123 an. Die Liste der Anwendungen ist noch leer.

Die Oberfläche spricht dieselbe API wie die CLI. Alles, was du in diesem Buch per CLI machst, findest du dort wieder, und umgekehrt.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Wo die Konfiguration liegt

kubectl -n argocd get configmaps

Erwartet (gekürzt):

NAME                        DATA   AGE
argocd-cm                   9      117s
argocd-cmd-params-cm        0      117s
argocd-gpg-keys-cm          0      117s
argocd-notifications-cm     0      117s
argocd-rbac-cm              0      117s
argocd-ssh-known-hosts-cm   1      117s
argocd-tls-certs-cm         0      117s
ConfigMap Inhalt Tag
argocd-cm Hauptkonfiguration: Benutzer, SSO, Ressourcen-Regeln 6, 9, 10
argocd-rbac-cm Rechte 9
argocd-ssh-known-hosts-cm Host-Keys von Git-Servern, GitHub ist schon drin 2
argocd-notifications-cm Vorlagen und Auslöser für Nachrichten 12

Passwörter und Schlüssel liegen in argocd-secret, nie in einer ConfigMap.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

kubectl -n argocd get deploy,statefulset

Erwartet: sechs Deployments und ein StatefulSet, alle mit 1/1 bei READY.

argocd account get-user-info

Erwartet:

Logged In: true
Username: admin
Issuer: argocd
Groups: 
kubectl -n argocd get svc argocd-server-nodeport

Erwartet: Typ NodePort mit 443:30443/TCP.

Challenge

Melde dich per CLI ab und wieder an, diesmal ohne Rückfrage, mit Benutzer und Passwort auf der Befehlszeile. Prüfe danach, dass argocd cluster list wieder antwortet.

Hinweis: argocd logout <server> und argocd login --help.

Lösung

argocd logout 172.16.0.182:30443 --insecure
argocd login 172.16.0.182:30443 --username admin --password lab-argo-pw-123 --insecure
argocd cluster list

Erwartet (gekürzt):

Logged out from '172.16.0.182:30443'
{"level":"info","msg":"token successfully invalidated on server",…}
'admin:login' logged in successfully
Context '172.16.0.182:30443' updated
SERVER                          NAME        VERSION  STATUS   …
https://kubernetes.default.svc  in-cluster  1.37.2   Unknown  …

Ausprobiert: Ohne --insecure fragt logout nach Proceed insecurely (y/n)?. logout meldet den Token beim Server ab und prüft dabei das Zertifikat erneut. Die Einstellung aus dem Login gilt dafür nicht.

Ein Passwort auf der Befehlszeile landet in der Shell-Historie. Im Lab ist das egal, im Betrieb nimmst du SSO oder Tokens für Maschinen (Tag 9).

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Für Hochverfügbarkeit gibt es ha/install.yaml: mehrere Replikate, Redis mit Sentinel. Ein Node allein bringt davon nichts.
  • Vor die Weboberfläche gehört ein Ingress oder Gateway mit echtem Zertifikat statt eines NodePorts mit selbst signiertem.
  • Das admin-Konto schaltet man nach der Einrichtung von SSO ab (admin.enabled: "false" in argocd-cm).
  • Viele Teams installieren Argo CD mit dem Helm-Chart und verwalten es danach mit sich selbst. Das Prinzip zeigt Tag 7.