Diese Anleitung installiert Argo CD in einem Cluster und meldet dich an der Web-Oberfläche an. Du brauchst kubectl, konfiguriert für einen Cluster, mit dem du frei experimentieren kannst. Ein lokaler kind- oder minikube-Cluster ist ideal.

Einen Namespace erstellen und das Install-Manifest anwenden

Argo CD läuft in einem eigenen Namespace. Erstelle ihn und wende dann das offizielle Install-Manifest an:

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts \
  -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

Neuere Argo-CD-Releases empfehlen Server-Side Apply, weil einige der mitgelieferten CRDs für das Annotationslimit von Client-Side Apply zu groß sind. Den genauen Befehl für die installierte Version findest du auf der Getting-Started-Seite. Wenn du vorher prüfen möchtest, was du ausführst, lade das Manifest zuerst herunter und lies es durch.

Warten, bis die Komponenten laufen

kubectl get pods -n argocd
kubectl wait --for=condition=Ready pods --all -n argocd --timeout=300s

Du solltest den Application Controller, den Repo-Server, den API-Server, Redis und einige unterstützende Controller sehen. Manche Pods brauchen eine Minute, bis sie bereit sind, daher ist ContainerCreating anfangs normal.

Die Web-Oberfläche erreichen

Der API-Server wird über einen ClusterIP-Service namens argocd-server bereitgestellt. Für einen lokalen Cluster richtest du ein Port-Forward ein:

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

Öffne https://localhost:8080. Dein Browser warnt vor dem Zertifikat, da Argo CD standardmäßig ein selbstsigniertes erzeugt. Akzeptiere die Warnung für dieses lokale Setup.

Das initiale Admin-Passwort holen und anmelden

Der Benutzername ist admin. Das initiale Passwort wird bei der Installation erzeugt und in einem Secret gespeichert:

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

Füge es in das Anmeldeformular ein. Die Oberfläche ist leer, weil noch keine Anwendungen registriert sind. Das ist die nächste Anleitung.

Zwei Dinge solltest du erledigen, bevor das Ganze über ein lokales Experiment hinausgeht: das Admin-Passwort ändern und das Secret mit dem initialen Passwort löschen, und Argo CD über einen Ingress oder LoadBalancer mit einem echten TLS-Zertifikat bereitstellen, statt sich auf Port-Forwarding zu verlassen.