Technical Tutorials

Dans le paysage en évolution rapide de l'infrastructure cloud-native, le passage d'une gestion impérative à une gestion déclarative n'est pas seulement une tendance, c'est une nécessité. À mesure que la complexité des clusters augmente et que la fréquence des déploiements s'intensifie, les interventions manuelles deviennent un goulot d'étranglement significatif et une source de « dérive de configuration ». C'est ici que le GitOps émerge comme la référence absolue. En combinant la résilience de l'infrastructure déclarative avec les avantages collaboratifs de Git, les organisations peuvent parvenir à une livraison d'applications robuste, auditable et automatisée. Parmi les nombreux outils disponibles, Argo CD s'est imposé comme la norme de facto pour la livraison continue vers Kubernetes.

Cet article explore l'implémentation pratique d'Argo CD, guidant les développeurs intermédiaires à avancés tout au long du processus d'établissement d'un flux de travail GitOps qui garantit que l'état de votre cluster en production correspond toujours à l'état désiré défini dans Git.

Comprendre le paradigme GitOps avec Argo CD

Le GitOps est un cadre opérationnel qui reprend les meilleures pratiques DevOps utilisées pour le développement d'applications, telles que le contrôle de version, la collaboration, la conformité et l'intégration/déploiement continus (CI/CD), et les applique à l'automatisation de l'infrastructure. Argo CD sert d'outil de livraison continue qui surveille le cluster et réconcilie tous les changements qui surviennent. Contrairement aux pipelines CI/CD traditionnels qui poussent les changements vers le cluster, Argo CD fonctionne selon un modèle « pull » (tirage). Il surveille en continu le dépôt Git pour détecter les changements et synchronise automatiquement le cluster afin qu'il corresponde aux fichiers de manifeste stockés dans ce dépôt.

Cette approche basée sur le « pull » offre plusieurs avantages :

Sécurité : Les nœuds du cluster n'ont pas besoin d'un accès en écriture externe vers les systèmes de contrôle de source.
Traçabilité (Auditabilité) : Chaque changement est suivi via les commits Git, fournissant un historique clair de qui a changé quoi et quand.
Récupération : En cas de catastrophe, revenir à un commit Git précédent est souvent plus simple que de revenir en arrière à travers un historique CI/CD complexe.

Étape 1 : Installer Argo CD sur votre cluster

La première étape de votre voyage GitOps est l'installation d'Argo CD. La méthode la plus efficace consiste à utiliser Helm, le gestionnaire de paquets pour Kubernetes. Assurez-vous que Helm est installé et configuré pour interagir avec votre cluster cible. Nous créerons un espace de noms dédié pour Argo CD afin de maintenir les ressources isolées et gérables.

D'abord, créez l'espace de noms :

kubectl create namespace argocd

Ensuite, appliquez les manifestes d'Argo CD. Dans un environnement de production, vous utiliseriez généralement Helm pour gérer les mises à jour plus efficacement, mais pour la configuration initiale, le manifeste YAML est simple :

kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

Une fois l'installation terminée, vérifiez que les pods du serveur Argo CD sont en cours d'exécution :

kubectl get pods -n argocd

Étape 2 : Exposer le serveur Argo CD

Pour interagir avec Argo CD, vous avez besoin d'accéder à son interface web et à son API. Par défaut, le service n'est accessible que depuis l'intérieur du cluster. Pour le développement local ou les tests, le port-forwarding est la méthode la plus rapide :

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

Vous pouvez ensuite naviguer vers https://localhost:8080. Le mot de passe administrateur initial peut être récupéré à partir du secret du cluster :

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

Étape 3 : Connecter votre dépôt Git

Avec Argo CD en cours d'exécution, l'étape critique suivante consiste à le connecter à votre source de vérité : votre dépôt Git. Ce dépôt doit contenir les manifestes Kubernetes (fichiers YAML) ou les chartes Helm qui définissent l'état désiré de votre application.

Dans l'interface utilisateur d'Argo CD, accédez à Paramètres > Dépôts. Cliquez sur Connecter le dépôt via HTTPS (ou SSH, selon vos exigences de sécurité). Vous devrez fournir l'URL HTTPS de votre dépôt. Si le dépôt nécessite une authentification, vous devrez créer un Secret contenant les identifiants et le lier lors du processus de connexion. Pour les dépôts publics, cette étape est immédiate.

Étape 4 : Créer une ressource Application

Connecter le dépôt ne suffit pas ; vous devez indiquer à Argo CD quelles parties du dépôt surveiller et synchroniser. Cela se fait via une définition de ressource personnalisée (CRD) Application. Bien que vous puissiez créer cela via l'interface utilisateur, il est recommandé de le définir comme du code.

Voici un exemple de Application.yaml qui pointe vers un répertoire contenant des manifestes Kubernetes standard :

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: guestbook
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/your-org/your-repo.git
    targetRevision: main
    path: k8s/overlays/production
  destination:
    server: https://kubernetes.default.svc
    namespace: default
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

Les composants clés de cette configuration incluent :

source : Définit où se trouvent les manifestes dans Git.
destination : Spécifie quel cluster et quel espace de noms utiliser pour le déploiement.
syncPolicy : C'est le moteur d'automatisation. Définir automated.prune sur true garantit que les ressources supprimées de Git sont retirées du cluster. selfHeal assure que tout changement manuel effectué directement sur le cluster est écrasé pour correspondre à Git.

Appliquez ce manifeste à votre cluster :

kubectl apply -f application.yaml

Conclusion : La puissance de l'infrastructure déclarative

Implémenter le GitOps avec Argo CD transforme la manière dont les équipes gèrent les clusters Kubernetes. En ancrant l'infrastructure dans Git et en automatisant la synchronisation, vous réduisez les erreurs humaines, améliorez la sécurité et accélérez les cycles de déploiement. Bien que la configuration initiale nécessite une réflexion attentive sur les contextes de sécurité et le réseau, les avantages à long terme d'une infrastructure stable, auditable et auto-réparatrice sont indéniables. À mesure que vous évoluez, envisagez d'intégrer Argo CD avec des pipelines CI/CD pour mettre à jour automatiquement les balises ou les branches de votre dépôt lors d'une construction réussie, complétant ainsi la boucle d'une livraison logicielle entièrement automatisée et pilotée par Git.