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 allemargocd-cm,argocd-rbac-cmundargocd-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.yamlErwartet:
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.yamlErwartet:
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.yamlErwartet (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-sidescheitert ein einziges Objekt:The CustomResourceDefinition "applicationsets.argoproj.io" is invalid: metadata.annotations: Too long: may not be more than 262144 bytes. Ein normaleskubectl applylegt 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 podsErwartet (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.yamlErwartet:
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 argocdErwartet (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 --insecureErwartet:
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-passwordErwartet (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-secretErwartet:
secret "argocd-initial-admin-secret" deleted from argocd namespace
Fortschritt speichern? Kostenlos registrieren
Drill 5: Was die CLI weiß
argocd versionErwartet (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 listErwartet:
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 contextErwartet:
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 configmapsErwartet (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,statefulsetErwartet: sechs Deployments und ein StatefulSet, alle mit
1/1 bei READY.
argocd account get-user-infoErwartet:
Logged In: true
Username: admin
Issuer: argocd
Groups:
kubectl -n argocd get svc argocd-server-nodeportErwartet: 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 listErwartet (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
--insecurefragtlogoutnachProceed insecurely (y/n)?.logoutmeldet 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"inargocd-cm). - Viele Teams installieren Argo CD mit dem Helm-Chart und verwalten es danach mit sich selbst. Das Prinzip zeigt Tag 7.