Remarque :

Ce tutoriel nécessite un accès à Oracle Cloud. Pour vous inscrire à un compte gratuit, reportez-vous à Introduction à Oracle Cloud Infrastructure Free Tier.
Il utilise des exemples de valeur pour les informations d'identification Oracle Cloud Infrastructure, la location et les compartiments. A la fin de votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

Utilisez les microservices Golang avec OCI Resource Manager pour déployer Airflow sur OKE

Introduction

Cela fait partie d'une série de tutoriels en six parties qui vous montre comment déployer un ensemble temporaire de ressources sur un cluster OKE à l'aide de microservices Golang représentant l'utilisation du kit SDK OCI, OCI-CLI, Resource Manager, OCI Devops et Helm pour déployer et détruire Apache Airflow.

Objectif

Cette série de tutoriels explique comment implémenter le flux de processus suivant à l'aide d'un microservice Golang pour créer et détruire des ressources sur un cluster OKE. Ce tutoriel explique comment installer et configurer un cluster OKE.

Flux de traitement

Architecture

Prérequis

Connaissance des éléments suivants :
- Git (extraction, ajout, validation, propagation)
- Linux
- Concepts de base de ssh-key
- Concepts de base de Kubernetes

Tâche 1 : installation et configuration d'un cluster OKE à l'aide de l'assistant

Créez un compartiment pour cet atelier : connectez-vous à votre compte Oracle Cloud. Cliquez sur le menu de navigation en haut à gauche, sélectionnez Identité et sécurité, puis cliquez sur Compartiments.
Créez un cluster OKE dans le compartiment dans lequel nous venons de créer oci-resource-manager-lab.

Remarque : dans cette section, nous allons utiliser la forme "Ampere", qui est l'architecture ARM64. Il s'agit d'une note importante car les microservices que nous allons déployer doivent se trouver dans la même architecture, sinon cela ne fonctionnera pas.
Créez une instance de machine virtuelle en tant que boîte de saut pour votre bastion : pour accéder à l'adresse OKE, nous devons configurer une session de bastion. Pour cela, vous devez d'abord fournir une instance de machine virtuelle de boîte de saut. Vous pouvez suivre la documentation standard pour créer des instances : Lancer des instances sur OCI.

Remarque : vous pouvez également utiliser le shell cloud de la console qui vous permet d'accéder à l'adresse OKE. Dans le but de ce tutoriel, nous irons avec Bastion sur une boîte à saut. Pour plus d'informations, reportez-vous à CloudShell
1. Accédez à Compute et cliquez sur cette option pour créer une instance de calcul sur le niveau gratuit.
2. Sélectionnez la forme de machine virtuelle Ampere (VM.Standard.A1.Flex) située sur le niveau libre et placez-la sur le même sous-réseau que les noeuds OKE ("oke-nodesubnet-quick-....").
3. Collez les clés publiques de votre ordinateur portable pour accéder à la machine virtuelle à partir de votre ordinateur. Si vous ne disposez pas d'une paire de clés SSH, suivez les instructions suivantes : Generate ssh-key-pair.
4. Cliquez sur Afficher les options avancées, accédez à l'onglet Agent Oracle Cloud et cochez la case Bastion.
Créez votre bastion et pointez-le vers la machine virtuelle jump-box. Veillez à sélectionner le même sous-réseau que la machine virtuelle Jumpbox.
1. Maintenant, vous devez créer un bastion SESSION qui dure un certain temps, donc après son expiration, vous devrez créer une nouvelle session. Assurez-vous de coller votre clé publique SSH.
  
  Remarque : pour l'image Oracle Linux, le nom utilisateur par défaut est "opc".
2. Obtenez la commande SSH instantanée, puis configurez simplement l'emplacement de la clé SSH.
```
ssh -i <privateKey> -o ProxyCommand="ssh -i <privateKey> -W %h:%p -p 22 ocid1.bastionsession.oc1.sa-saopaulo-1.amaaaaaa3jinyjqa4kfosxytglr6q27365j67yjdh5hxrfpqn4y72nq2p6ma@host.bastion.sa-saopaulo-1.oci.oraclecloud.com" -p 22 opc@10.0.10.127
```
3. Remplacez "privateKey" par l'emplacement de votre clé SSH locale, généralement ~/.ssh/id_rsa.
```
ssh -i ~/.ssh/id_rsa -o ProxyCommand="ssh -i ~/.ssh/id_rsa -W %h:%p -p 22 ocid1.bastionsession.oc1.sa-saopaulo-1.amaaaaaa3jinyjqa4kfosxytglr6q27365j67yjdh5hxrfpqn4y72nq2p6ma@host.bastion.sa-saopaulo-1.oci.oraclecloud.com" -p 22 opc@10.0.10.127
```
Installez et configurez l'interface de ligne de commande OCI dans votre boîte de dialogue. Vous devez configurer l'interface de ligne de commande OCI dans votre boîte de dialogue afin d'utiliser les ressources OCI. Pour obtenir des instructions et des détails complets, reportez-vous à Installation et configuration de l'interface de ligne de commande OCI (CLI).
1. Accédez à la console jump-box et exécutez les commandes suivantes.
```
 sudo dnf -y install oraclelinux-developer-release-el8 -y
 sudo dnf install python36-oci-cli -y
```
  Remarque : notez les détails suivants car vous en aurez besoin pour les étapes suivantes :
  - OCID utilisateur : OCID de l'utilisateur auquel vous voulez accéder aux ressources OCI
  - OCID de location : OCID de votre location
  - Votre région : par exemple, sa-saopaulo-1
2. Exécutez la commande config OCIsetup.
```
oci setup config
```
3. Renseignez les notes sur les valeurs requises à l'étape ci-dessus et cliquez sur Y pour créer une paire de clés RSA et sélectionnez enter par défaut pour les autres champs.
  - Les fichiers ssh-key ont été créés, oci_api_key_public.pem et oci_api_key.pem.
  - Vous devez maintenant télécharger la clé SSH générée dans votre API utilisateur dans Oracle Cloud. Pour plus d'informations, reportez-vous à Téléchargement de la clé. Cette opération est nécessaire pour pouvoir utiliser OCI-CLI et communiquer avec votre locataire Oracle Cloud. Pour ce tutoriel, nous avons créé un utilisateur spécifique appelé devmaster, mais vous pouvez choisir l'un des vôtres.
  - Obtenez le contenu de votre fichier oci_api_key_public.pem.
  - Cliquez sur Ajouter une clé d'API et collez le contenu du fichier oci_api_key_public.pem.
  - Le fichier de configuration OCI doit déjà être créé dans votre boîte de saut à l'étape 2. Vérifiez le fichier ~/.oci/config et assurez-vous que le chemin key_file est correct, puis testez votre connexion.
  - Dans la console jump-box, exécutez la commande suivante.
    oci iam compartment list
  - Vous devez obtenir la liste des compartiments en cours dans votre location, ce qui signifie que vous avez accès à votre tente OCI.
Configurez votre boîte à saut pour accéder à votre cluster OKE à l'aide de la ligne de commande.
1. Installez la commande kubectl sur votre instance Jump-box.
  
  Remarque : nous utilisons "arm64" en tant qu'architecture, ce qui est nécessaire car nous utilisons la forme Ampere dans notre modèle de saut.
2. Dans la console jump-box, exécutez la commande suivante.
```
 cd /home/opc   
 curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/arm64/kubectl
 chmod +x ./kubectl
 sudo mv ./kubectl /usr/local/bin
```
Accédez à votre cluster OKE sur la page de la console et cliquez sur Accéder au cluster pour obtenir les commandes que vous devez exécuter dans votre boîte de dialogue.
Exécutez les droits de correction et testez la connexion.
```
chmod 600 /home/opc/.kube/config
kubectl get nodes
```

Maintenant, vous êtes connecté à votre cluster Kubernetes à partir de la boîte aux lettres !

Etape suivante

Pour passer au tutoriel suivant de ce parcours de formation, cliquez ici.

Remerciements

Auteur - Joao Tarla (ingénieur solutions Oracle LAD A-Team)

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à davantage de contenu de formation gratuit sur le canal Oracle Learning YouTube. En outre, accédez à education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour consulter la documentation produit, consultez Oracle Help Center.

Informations relatives au titre et au copyright

Use Golang microservices with OCI Resource Manager to deploy Airflow on OKE

F79687-01

April 2023