Ce guide installe Argo CD dans un cluster et vous connecte à l’interface web. Il vous faut kubectl configuré pour un cluster sur lequel vous pouvez expérimenter librement. Un cluster local kind ou minikube est idéal.

Créer un namespace et appliquer le manifeste d’installation

Argo CD s’exécute dans son propre namespace. Créez-le, puis appliquez le manifeste d’installation officiel :

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

Les versions récentes d’Argo CD recommandent le server-side apply, car certaines CRD incluses sont trop volumineuses pour la limite d’annotation du client-side apply. Consultez la page Getting Started pour la commande exacte correspondant à la version que vous installez. Si vous préférez relire ce que vous allez exécuter, téléchargez d’abord le manifeste et lisez-le.

Attendre que les composants démarrent

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

Vous devriez voir l’application controller, le repo server, l’API server, Redis et quelques controllers de support. Certains pods mettent une minute à devenir prêts : il est donc normal de voir ContainerCreating au début.

Accéder à l’interface web

L’API server est exposé via un service ClusterIP nommé argocd-server. Pour un cluster local, faites un port-forward :

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

Ouvrez https://localhost:8080. Votre navigateur affichera un avertissement concernant le certificat, car Argo CD en génère un auto-signé par défaut. Acceptez l’avertissement pour cette configuration locale.

Récupérer le mot de passe admin initial et se connecter

Le nom d’utilisateur est admin. Le mot de passe initial est généré pendant l’installation et stocké dans un Secret :

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

Collez-le dans le formulaire de connexion. L’interface sera vide, car aucune application n’est encore enregistrée. C’est l’objet du guide suivant.

Deux choses à faire avant d’aller au-delà d’une expérience locale : changer le mot de passe admin et supprimer le Secret du mot de passe initial, et exposer Argo CD via un Ingress ou un LoadBalancer avec un vrai certificat TLS plutôt que de compter sur le port-forwarding.