Gérer les grappes Oracle Cloud Infrastructure Kubernetes Engine dans ArgoCD à l'aide de l'identité de charge de travail

Présentation

ArgoCD est un outil de diffusion continue GitOps déclaratif pour Kubernetes. Au moment de l'écriture de ce tutoriel, ArgoCD ne dispose pas des capacités de l'interface de ligne de commande Oracle Cloud Infrastructure requises pour générer le jeton d'accès pour Oracle Cloud Infrastructure Kubernetes Engine (OKE). Par conséquent, une image ArgoCD personnalisée est requise.

Note : L'image ArgoCD de base utilisée pour l'image personnalisée est quay.io/argoproj/argocd:v3.1.1.

Objectifs

Créez une image ArgoCD personnalisée contenant l'interface de ligne de commande OCI.
Installez ArgoCD sur une grappe OKE améliorée à l'aide de l'image personnalisée.
Ajoutez une grappe OKE à la liste des grappes ArgoCD à l'aide de execProviderConfig.
Déployez une application sur la grappe OKE cible à partir de ArgoCD.

Conditions requises

Installez Podman ou Docker et l'interface de ligne de commande argocd.
Grappe améliorée OKE pour installer ArgoCD.

Note : Vous ne pouvez utiliser l'identité de charge de travail que pour les grappes améliorées.
Grappe OKE à gérer par ArgoCD.
Jeton d'authentification pour votre utilisateur OCI (à partir de la console OCI, allez à votre profil d'utilisateur et cliquez sur Jetons d'authentification), l'activation peut prendre jusqu'à 5 minutes.
Permission pour votre utilisateur OCI de créer des référentiels dans le registre de conteneurs OCI.
```
Allow group <your_group> to manage repos in tenancy
```
Autorisation pour ArgoCD de gérer les grappes OKE.
```
allow any-user to manage all-resources in compartment <compartment_ocid> where all { request.principal.type='workload', request.principal.cluster_id = '<cluster_ocid>', request.principal.namespace = 'argocd', request.principal.service_account = 'argocd-application-controller' }
```
Note : Cette politique est trop ouverte, mais vous pouvez la rendre aussi restrictive que vous le souhaitez.
- Remplacer dans la politique :
  - compartment_ocid : Il doit s'agir de l'OCID du compartiment qui contient les grappes que vous voulez gérer avec ArgoCD.
  - cluster_ocid : Il doit s'agir de l'OCID de la grappe à partir duquel vous voulez gérer d'autres grappes. Celui qui a ArgoCD.

Tâche 1 : Pousser l'image personnalisée ArgoCD vers le registre de conteneurs OCI

Note : Vous pouvez utiliser Podman ou docker.

Créez un fichier Dockerfile contenant :

FROM quay.io/argoproj/argocd:v3.1.1

USER root


RUN apt-get update; \
    apt-get install -y --no-install-recommends python3-venv; \
    python3 -m venv /opt/oci; \
    /opt/oci/bin/pip install --no-cache-dir --upgrade pip; \
    /opt/oci/bin/pip install --no-cache-dir "oci-cli==3.65.0"; \
    ln -s /opt/oci/bin/oci /usr/local/bin/oci; \
    apt-get clean; \
    rm -rf /var/lib/apt/lists/*

USER 999

Exécutez la commande suivante dans le dossier contenant le 'Dockerfile'.
```
podman build --platform linux/amd64 -t argocd-oci:01 .
```
Note : Le point (.) à la fin de la commande sert au répertoire courant, où se trouve le fichier Dockerfile.

Exécutez la commande suivante .

podman tag argocd-oci:01 ocir.**your_region**.oci.oraclecloud.com/**your_tenancy_namespace**/**your_repository_name**/argocd-oci:01

Exécutez la commande suivante .
```
podman login ocir.**your_region**.oci.oraclecloud.com
```
- L'utilisateur est :
  - Si le domaine d'identité est utilisé : your_tenancy_namespace/OracleIdentityCloudService/your_email.
  - Si le domaine par défaut est utilisé : your_tenancy_namespace/your_email.
- Le mot de passe est votre jeton d'authentification OCI.

Exécutez la commande suivante .

podman push ocir.**your_region**.oci.oraclecloud.com/**your_tenancy_namespace**/**your_repository_name**/argocd-oci:01

Tâche 2 : Installer ArgoCD à l'aide de l'image personnalisée

Téléchargez et installez le manifeste ArgoCD à partir d'ici : argo-cd/manifests/install.yaml.
Modifiez le fichier pour remplacer l'image ArgoCD par notre image personnalisée.
- Modifier à partir de l'image : quay.io/argoproj/argocd
- À l'image : ocir.**your_region**.oci.oraclecloud.com/**your_tenancy_namespace**/**your_repository_name**/argocd-oci:01
Exécutez la commande suivante pour créer un espace de noms argocd.
```
kubectl create namespace argocd
```
Exécutez la commande suivante pour déployer argocd.
```
kubectl apply -f install.yaml -n argocd
```

Tâche 3 : Ajouter une grappe à la liste des grappes ArgoCD

Démarrez ArgoCD.

Note : Vous pouvez utiliser un équilibreur de charge OCI pour exposer ArgoCD. Pour cet exemple, port-forward sera utilisé à la place. Utilisez un terminal supplémentaire uniquement pour le transfert de port.
1. Dans votre deuxième terminal, exécutez la commande suivante.
```
kubectl port-forward service/argocd-server -n argocd 63265:80
```
  Note : Ne fermez pas ce terminal, passez à votre terminal précédent car il est utilisé pour maintenir ArgoCD actif.
2. Obtenez le mot de passe de l'administrateur ArgoCD à l'aide de la commande suivante.
```
kubectl get secret -n argocd argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
```
3. Connectez-vous (l'utilisateur est administrateur, le mot de passe est celui de la commande précédente) à l'aide de la commande suivante.
```
argocd login 127.0.0.1:63265
```
Téléchargez et modifiez le fichier nommé add_cluster.yaml à partir d'ici : add_cluster.yaml :

Note : Cet exemple utilise TLS non sécurisé, il peut être modifié.
- cluster_name : Nom de la grappe qui apparaîtra dans la liste des grappes ArgoCD.
- cluster_api_endpoint : Point d'extrémité de la grappe à ajouter à la liste des grappes ArgoCD.
- cluster_ocid : OCID de la grappe à ajouter à la liste des grappes ArgoCD.
- region : Région où réside la grappe.
Appliquez le fichier pour ajouter la grappe dans la liste des grappes ArgoCD à l'aide de la commande suivante.
```
kubectl apply -f add_cluster.yaml
```
Vérifiez si la grappe a été ajoutée à la liste des grappes ArgoCD à l'aide de la commande suivante.
```
argocd cluster list
```

Tâche 4 : Tester en déployant une application depuis ArgoCD vers la grappe

Téléchargez et modifiez le fichier nommé deploy_example.yaml à partir d'ici : deploy_example.yaml.
- cluster_name : Nom de la grappe à déployer l'application.
Appliquez le fichier pour déployer une application simple vers la grappe cible à l'aide de la commande suivante.
```
kubectl apply -f deploy-example.yaml
```
Vérifiez si l'application a été déployée avec succès à l'aide des commandes suivantes.
```
argocd app list
argocd app sync guestbook
```

Remerciements

Auteur - Gabriel Feodorov (ingénieur en nuage principal)

Ressources d'apprentissage supplémentaires

Explorez d'autres laboratoires sur le site docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation sur le produit, visitez Oracle Help Center.

Informations sur le titre et les droits d'auteur

Manage Oracle Cloud Infrastructure Kubernetes Engine Clusters in Argo CD using Workload Identity

G36150-02

Oracle et/ou ses sociétés affiliées.