Gestion des clusters Oracle Cloud Infrastructure Kubernetes Engine dans ArgoCD à l'aide de l'identité de charge globale

Introduction

ArgoCD est un outil déclaratif de distribution continue GitOps pour Kubernetes. Au moment de la rédaction de ce tutoriel, ArgoCD ne dispose pas des fonctionnalités de l'interface de ligne de commande OCI (Oracle Cloud Infrastructure Command Line Interface) 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.

Remarque : 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 le cluster OKE amélioré à l'aide de l'image personnalisée.
Ajoutez un cluster OKE à la liste de clusters ArgoCD à l'aide de execProviderConfig.
Déployez une application sur le cluster OKE cible à partir de ArgoCD.

Prérequis

Installez Podman ou Docker et la CLI argocd.
Cluster amélioré OKE pour installer ArgoCD.

Remarque : vous ne pouvez utiliser l'identité de charge globale que pour les clusters améliorés.
Cluster OKE à gérer par ArgoCD.
Jeton d'authentification pour votre utilisateur OCI (à partir de la console OCI, accédez à votre profil utilisateur et cliquez sur Jetons d'authentification), l'activation peut prendre jusqu'à 5 minutes.
Droit d'accès permettant à l'utilisateur OCI de créer des référentiels dans OCI Container Registry.
```
Allow group <your_group> to manage repos in tenancy
```
Droit d'accès permettant à ArgoCD de gérer des clusters 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' }
```
Remarque : cette stratégie est trop ouverte, mais vous pouvez la rendre aussi restrictive que vous le souhaitez.
- Remplacer dans la stratégie :
  - compartment_ocid : il doit s'agir de l'OCID de compartiment contenant les clusters à gérer avec ArgoCD.
  - cluster_ocid : il doit s'agir de l'OCID de cluster à partir duquel gérer les autres clusters. Celui qui contient ArgoCD.

Tâche 1 : propagation de l'image personnalisée ArgoCD vers OCI Container Registry

Remarque : vous pouvez utiliser Podman ou docker.

Créez un élément 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 fichier Dockerfile.
```
podman build --platform linux/amd64 -t argocd-oci:01 .
```
Remarque : le point (.) à la fin de la commande concerne le répertoire en cours, 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
- A 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 un cluster à la liste des clusters ArgoCD

Démarrez ArgoCD.

Remarque : vous pouvez utiliser un équilibreur de charge OCI pour exposer ArgoCD. Dans cet exemple, port-forward sera utilisé à la place. Utilisez un terminal supplémentaire uniquement pour le transfert de port.
1. Dans le second terminal, exécutez la commande suivante.
```
kubectl port-forward service/argocd-server -n argocd 63265:80
```
  Remarque : ne fermez pas ce terminal, passez au terminal précédent car il est utilisé pour maintenir le fonctionnement de ArgoCD.
2. Obtenez le mot de passe d'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 admin, 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 de l'adresse suivante : add_cluster.yaml :

Remarque : cet exemple utilise le protocole TLS non sécurisé, il peut être modifié.
- cluster_name : nom du cluster qui apparaîtra dans la liste des clusters ArgoCD.
- cluster_api_endpoint : adresse du cluster à ajouter à la liste de clusters ArgoCD.
- cluster_ocid : OCID du cluster à ajouter à la liste de clusters ArgoCD.
- region : région dans laquelle réside le cluster.
Appliquez le fichier pour ajouter le cluster dans la liste de clusters ArgoCD à l'aide de la commande suivante.
```
kubectl apply -f add_cluster.yaml
```
Vérifiez si le cluster a été ajouté à la liste de clusters ArgoCD à l'aide de la commande suivante.
```
argocd cluster list
```

Tâche 4 : effectuer un test en déployant une application depuis ArgoCD vers le cluster

Téléchargez et modifiez le fichier nommé deploy_example.yaml à partir d'ici : deploy_example.yaml.
- cluster_name : nom du cluster dans lequel déployer l'application.
Appliquez le fichier pour déployer une application simple vers le cluster 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
```

Accusés de réception

Auteur - Gabriel Feodorov (ingénieur cloud senior)

Ressources de formation supplémentaires

Explorez d'autres ateliers sur le site docs.oracle.com/learn ou accédez à d'autres contenus d'apprentissage gratuits sur le canal Oracle Learning YouTube. En outre, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

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

Informations relatives au titre et au copyright

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

G36151-02

Oracle et/ou ses affiliés.