Configuration d'Argo CD dans un cluster k3s

Cette traduction a été générée par une IA générative à l'aide de la traduction continue Action. →

A beautiful cover image with the text "Argo CD"

27 juil. 2024 • Dernière mise à jour : 28 juil. 2024 • 5 min de lecture • 800 mots

Après avoir lu l’article de Vegard S. Hagen “Argo CD Kustomize with Helm” et décidé que leur solution n’était pas adaptée à notre cluster, nous sommes directement passés au guide “Getting started” par défaut d’Argo CD. Et maintenant, nous allons vous faire traverser les étapes de configuration d’Argo CD sur k3s et Cilium, en poursuivant à partir du chapitre “Setup Certificate Manager with Cloudflare” de notre article précédent “Setting up Kubernetes with Cilium and Cloudflare”. Dans ce même article récent, nous avons également configuré Keel à la fin, mais cette étape sera désormais inutile car nous utiliserons Argo CD pour obtenir le code le plus récent et le plus avancé à partir de chaque dépôt GitHub. Bonne lecture !

Pré-requis

Avant de commencer, nous devons nous assurer que nous avons installé kubectl, un fichier kubeconfig (k3s enregistre ce fichier ici :

1
flannel-backend: "none"
2
disable-kube-proxy: true
3
disable-network-policy: true
4
cluster-init: true
5
disable:
6
    - servicelb
7
    - traefik

) et CoreDNS (vérifiez si vous avez CoreDNS en exécutant cette commande :

kubectl get pods -n kube-system -l k8s-app=kube-dns

commande).

Installation

Tout d’abord, appliquons tous les services nécessaires, les déploiements et de nombreuses autres ressources Kubernetes différentes en exécutant :

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

Certificat

De plus, nous aurons besoin d’un certificat :

1
apiVersion: cert-manager.io/v1
2
kind: Certificate
3
metadata:
4
    name: argocd
5
    namespace: argocd
6
spec:
7
    secretName: argocd
8
    issuerRef:
9
        name: acme-issuer
10
        kind: ClusterIssuer
11
    dnsNames:
12
        - "argo-cd.trueberryless.org"

Appliquez cette ressource en exécutant kubectl apply -f certificate.yaml.

Contrôleur d’Ingress

Nous aurons également besoin d’un contrôleur d’Ingress géré par Cilium :

1
apiVersion: networking.k8s.io/v1
2
kind: Ingress
3
metadata:
4
    name: argocd-ingress
5
    namespace: argocd
6
spec:
7
    rules:
8
        - host: argo-cd.trueberryless.org
9
          http:
10
              paths:
11
                  - path: /
12
                    pathType: Prefix
13
                    backend:
14
                        service:
15
                            name: argocd-server
16
                            port:
17
                                number: 80
18

19
    tls:
20
        - hosts:
21
              - argo-cd.trueberryless.org
22
          secretName: argocd

Appliquez cette ressource en exécutant kubectl apply -f argocd-ingress.yaml.

Désactiver TLS dans Argo CD

Avec le certificat, la connexion entre le client et le serveur est sécurisée. Cependant, il existe toujours un certificat auto-signé au sein des services Argo CD, dont nous n’avons pas strictement besoin. Nous pouvons donc désactiver la sécurité du serveur Argo CD en modifiant la propriété server.insecure.

Pour ce faire, exécutez d’abord cette commande :

kubectl edit cm argocd-cmd-params-cm -n argocd

ce qui ouvrira, espérons-le, un fichier dans vim ou neovim (sinon ce serait une honte si vous nous demandez, MDR). Le fichier devrait ressembler à ceci :

1
# Please edit the object below. Lines beginning with a '#' will be ignored,
2
# and an empty file will abort the edit. If an error occurs while saving this file will be
3
# reopened with the relevant failures.
4
#
5
apiVersion: v1
6
data:
7
    server.insecure: "true"
8
kind: ConfigMap
9
metadata:
10
    annotations:
11
        kubectl.kubernetes.io/last-applied-configuration: |
12
            {"apiVersion":"v1","kind":"ConfigMap","metadata":{"annotations":{},"labels":{"app.kubernetes.io/name":"argocd-cmd-params-cm","app.kubernetes.io/part-of":"argocd"},"name":"arg
13
    creationTimestamp: "2024-07-27T11:15:28Z"
14
    labels:
15
        app.kubernetes.io/name: argocd-cmd-params-cm
16
        app.kubernetes.io/part-of: argocd
17
    name: argocd-cmd-params-cm
18
    namespace: argocd
19
    resourceVersion: "239710156"
20
    uid: 5f53d26b-3adf-4ed9-9807-c3da847335a2
21
data:
22
    server.insecure: "true"

Les deux dernières lignes ne seront probablement pas là au départ, mais c’est exactement le paramètre que nous voulons atteindre. Allez-y et ajoutez ces deux lignes (marquées ci-dessus) et enregistrez le fichier (Esc → :wq si vous êtes cool).

Redémarrez le serveur Argo CD en exécutant cette commande et en attendant que le déploiement soit terminé :

kubectl rollout restart deploy argocd-server -n argocd
kubectl rollout status deploy argocd-server -n argocd

Après toutes ces étapes, nous devrions maintenant voir l’interface utilisateur sur https://argo-cd.trueberryless.org (protégé par mot de passe).

Tableau de bord de l'interface utilisateur d'Argo CD

Les identifiants de connexion à l’interface utilisateur d’Argo CD se composent d’un utilisateur et d’un mot de passe. L’utilisateur est toujours admin et vous pouvez obtenir votre mot de passe en exécutant :

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

Ajouter le manifest au dépôt

Pour créer une nouvelle application dans Argo CD (via l’interface utilisateur ou l’interface CLI — nous utilisons l’interface utilisateur car nous n’avons pas configuré l’interface CLI), nous devons préparer le dépôt Git. Comme le dépôt est la seule source de vérité, c’est aussi l’endroit où nous définissons toutes les ressources Kubernetes qui devraient être créées par Argo CD.

Nous recommandons de créer un nouveau dossier dans le dépôt Git appelé quelque chose comme manifest. Dans ce dossier, nous allons créer quelques fichiers :

certificate.yaml :

1
apiVersion: cert-manager.io/v1
2
kind: Certificate
3
metadata:
4
name: mutanuq
5
namespace: mutanuq
6
spec:
7
secretName: mutanuq
8
issuerRef:
9
    name: acme-issuer
10
    kind: ClusterIssuer
11
dnsNames:
12
    - "mutanuq.trueberryless.org"

deployment.yaml :

1
apiVersion: apps/v1
2
kind: Deployment
3
metadata:
4
    name: mutanuq
5
    namespace: mutanuq
6
    labels:
7
        app: mutanuq
8
spec:
9
    replicas: 3
10
    selector:
11
        matchLabels:
12
            app: mutanuq
13
    template:
14
        metadata:
15
            labels:
16
                app: mutanuq
17
        spec:
18
            containers:
19
                - name: mutanuq
20
                image: "trueberryless/mutanuq"
21
                imagePullPolicy: Always

service.yaml :

1
apiVersion: v1
2
kind: Service
3
metadata:
4
name: mutanuq
5
namespace: mutanuq
6
annotations:
7
    cert-manager.io/issuer: acme-issuer
8
spec:
9
selector:
10
    app: mutanuq
11
ports:
12
    - name: http
13
    port: 80

ingress.yaml :

1
apiVersion: networking.k8s.io/v1
2
kind: Ingress
3
metadata:
4
name: mutanuq
5
namespace: mutanuq
6
spec:
7
rules:
8
    - host: mutanuq.trueberryless.org
9
    http:
10
        paths:
11
        - path: /
12
            pathType: Prefix
13
            backend:
14
            service:
15
                name: mutanuq
16
                port:
17
                number: 80
18

19
tls:
20
- hosts:
21
    - mutanuq.trueberryless.org
22
    secretName: mutanuq

Ces fichiers sont essentiellement les mêmes que ceux mentionnés dans l’autre article mais séparés en quatre fichiers, car cela nous donne l’avantage de manipuler le manifest depuis GitHub Actions. Mais chaque chose en son temps, vous verrez comment configurer le manifest avec GitHub Actions dans le prochain article.

Créer une nouvelle application dans l’interface utilisateur d’Argo CD

Vous verrez probablement le grand bouton NEW APP dans l’interface utilisateur d’Argo CD. Cliquez dessus et créez une nouvelle application avec les propriétés adaptées ci-dessous :

Nom de l’application : mutanuq
Nom du projet : défaut
Politique de synchronisation : En savoir plus dans cet article / laissez Manuel pour l’instant
URL du dépôt : https://github.com/trueberryless-org/mutanuq
Révision : HEAD
Chemin : manifest
URL du cluster : https://kubernetes.default.svc
Namespace : mutanuq

Optionnellement — si vous avez le CLI installé — vous pouvez exécuter cette commande pour obtenir le même résultat :

argocd app create mutanuq \
  --project default \
  --repo https://github.com/trueberryless-org/mutanuq \
  --revision HEAD \
  --path manifest \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace mutanuq

Vous devriez maintenant voir votre site web en cours de déploiement dans l’interface utilisateur. Ce processus peut prendre un certain temps, car, par exemple, la demande de certificat doit être approuvée. Une application saine devrait ressembler à ceci :

Interface utilisateur d'exemple d'Argo CD

Célébrez avec un café !

Félicitations, vous avez configuré avec succès Argo CD sur un cluster k3s ! Vous méritez une pause café. Savourez une tasse bien méritée et, si vous souhaitez partager un café virtuel avec moi, n’hésitez pas à soutenir mon travail sur Ko-fi. Merci !

Continuation

La suite dans notre prochain article de blog, qui décrira comment configurer un dépôt GitHub pouvant ensuite être déployé via Argo CD.