Installation des prérequis

Etant donné que les artefacts Kubernetes requis sont déployés en tant que graphiques Helm dans Kubernetes pour exécuter les piles, vous devez installer kubectl et Helm. En outre, vous aurez besoin de l'interface de ligne de commande Oracle Cloud Infrastructure, qui est requise pour kubectl et sera utile pour d'autres tâches.

Cette étape consiste à installer les composants suivants :

Interface de ligne de commande OCI.
S'il n'est pas déjà présent, kubectl version 1.18 ou supérieure.
Helm 3.x.

Installation de l'interface de ligne de commande Oracle Cloud Infrastructure

Vous devez d'abord installer l'interface de ligne de commande Oracle Cloud Infrastructure.

Pour installer l'interface de ligne de commande OCI sur Linux ou Mac OS X, exécutez la commande suivante :
```
bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
```
Appuyez sur Entrée pour accepter les valeurs par défaut de toutes les options.
Redémarrez votre shell.
```
exec -l $SHELL
```
Collectez les OCID de location et d'utilisateur :
1. Obtenez l'OCID de location à partir de la console Oracle Cloud en cliquant sur l'icône Utilisateur (en haut à droite), puis sur Location. Copiez l'OCID de la location (champ Location).
2. Pour obtenir l'OCID utilisateur à partir de la console, cliquez sur Utilisateur, puis sur Paramètres d'utilisateur. Copiez ensuite l'OCID de l'utilisateur.
Configuration de l'interface de ligne de commande OCI.
```
oci setup config
```
Vous serez invité à entrer les éléments suivants :
- Emplacement de la configuration : appuyez sur Entrée.
- user_ocid : entrez votre OCID utilisateur.
- tenancy_ocid : entrez l'OCID de votre location.
- region : entrez votre région dans la liste fournie.
- Générer une paire de clés RSA : appuyez sur Entrée pour Oui (valeur par défaut).
- Répertoire des touches : appuyez sur Entrée pour la valeur par défaut.
- Nom de la clé : appuyez sur Entrée pour la valeur par défaut.
- Phrase de passe : appuyez sur Entrée pour ne pas indiquer de phrase de passe.
La sortie doit se présenter comme suit :
```
Private key written to: /home/oracle/.oci/oci_api_key.pem
Fingerprint: 21:d4:f1:a0:55:a5:c2:ce:...
Config written to ~/.oci/config
```
Pour utiliser l'interface de ligne de commande, vous devez télécharger la clé publique générée vers votre compte utilisateur. Obtenez le contenu clé en saisissant la commande suivante :
```
cat ~/.oci/oci_api_key_public.pem 
```
Vous pouvez éventuellement ouvrir le fichier avec l'éditeur de votre choix et copier la sortie imprimée complète dans le presse-papiers.
Dans la console Web OCI, ajoutez la clé générée à l'étape précédente :
1. Sous Utilisateur, cliquez sur Paramètres d'utilisateur.
2. Cliquez sur Clés d'API.
3. Cliquez sur Ajouter une clé publique.
4. Cliquez sur Coller la clé publique.
5. Collez la clé copiée ci-dessus.
6. Cliquez sur Ajouter.
7. Vérifiez que l'empreinte générée correspond à la sortie d'empreinte de la configuration.
Testez votre CLI en saisissant la commande suivante :
```
oci os ns get
```
Cette commande doit afficher l'espace de noms de votre location (généralement le nom de la location ou une chaîne randomisée), par exemple :
```
{
    "data": "your-tenancy-namespace"
}
```

Installation de kubectl

Installez ensuite l'outil de ligne de commande Kubernetes, kubectl.

Remarques :

Si vous utilisez Docker Desktop sur Mac OS X ou Windows, kubectl doit déjà être installé et vous pouvez ignorer cette étape.

Vous trouverez ci-dessous une procédure générale d'installation de kubectl. Pour obtenir des instructions plus détaillées propres à votre système d'exploitation, reportez-vous à "Outils d'installation" dans la documentation en ligne de Kubernetes, répertoriée dans la rubrique "Avant de commencer".

Pour installer kubectl, exécutez la commande suivante :

PLATFORM=$(uname)
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/${PLATFORM,,}/amd64/kubectl"
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl

Sous Windows :

curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.0/bin/windows/amd64/kubectl.exe

Ajoutez le binaire à votre chemin.
Vérifiez que vous utilisez une version de kubectl 1.18 ou ultérieure en saisissant ce qui suit :
```
kubectl version --client
```

Installer Helm

Vous allez maintenant installer l'interface de ligne de commande Helm.

Vous trouverez ci-dessous une procédure générale d'installation de Helm. Pour obtenir des instructions plus détaillées spécifiques à votre système d'exploitation, reportez-vous à la section "Installation de Helm", répertoriée dans la rubrique "Avant de commencer".

Pour installer helm sur Mac OS X et Linux, saisissez :

curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

Installation de Terraform

Enfin, s'il n'est pas déjà installé, vous devez installer Terraform.

Remarques :

Vous trouverez des liens vers la documentation d'installation référencée dans cette rubrique dans la rubrique "Avant de commencer".

Si vous utilisez un ordinateur Linux ou Mac OS X, nous vous recommandons d'installer Terraform à l'aide de tfswitch, comme décrit dans Installation de la documentation tfswitch, car cela vous permet de basculer facilement d'une version de Terraform à une autre. Si vous avez installé tfswitch, sélectionnez une version avec :

tfswitch

Ce livre de jeux a été testé avec Terraform version 0.14.11

Sinon, si vous avez besoin de conseils pour configurer Terraform, consultez la documentation d'installation de Terraform et sélectionnez le chemin correspondant à votre environnement.