Installer les préalables

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

Dans cette étape, vous allez installer les composants suivants :

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

Installer l'interface de ligne de commande d'Oracle Cloud Infrastructure

Tout d'abord, vous allez installer l'interface de ligne de commande d'Oracle Cloud Infrastructure.

Pour installer l'interface de ligne de commande OCI sous 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
```
Collecter les OCID de la location et de l'utilisateur :
1. Obtenez l'OCID de la location à partir de la console Oracle Cloud en cliquant sur l'icône Utilisateur (coin supérieur droit), puis sur Location. Copiez l'OCID de la location (champ Location).
2. Obtenez l'OCID d'utilisateur à partir de la console en cliquant sur Utilisateur, puis sur Paramètres de l'utilisateur. Copiez ensuite l'OCID de l'utilisateur.
Configurer l'interface CLI OCI.
```
oci setup config
```
Vous serez invité à indiquer :
- Emplacement de la configuration : appuyez sur Entrée.
- user_ocid : Entrez l'OCID de votre 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 (par défaut).
- Répertoire pour les clés : 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 secrète : appuyez sur Entrée pour ne pas en entrer une.
Une sortie de type :
```
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 charger la clé publique générée dans votre compte d'utilisateur. Obtenez le contenu clé en entrant :
```
cat ~/.oci/oci_api_key_public.pem 
```
Facultativement, vous pouvez ouvrir le fichier avec votre éditeur préféré 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 de l'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 de l'empreinte numérique de la configuration.
Testez votre interface de ligne de commande en entrant :
```
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 aléatoire); par exemple :
```
{
    "data": "your-tenancy-namespace"
}
```

Installer kubectl

Ensuite, installez l'outil de ligne de commande Kubernetes, kubectl.

Note :

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

Voici une procédure de haut niveau pour installer kubectl. Pour des instructions plus détaillées propres à votre système d'exploitation, voir "Installer des outils" dans la documentation en ligne de Kubernetes, répertoriée dans la rubrique "Avant de commencer".

Pour installer kubectl, exécutez cette commande :

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 PATH.
Vérifiez que vous utilisez une version kubectl 1.18 ou ultérieure en entrant :
```
kubectl version --client
```

Installer Helm

Maintenant, vous allez installer l'interface de ligne de commande Helm.

Voici une procédure de haut niveau pour l'installation de Helm. Pour des instructions plus détaillées spécifiques à votre système d'exploitation, voir "Installation de Helm", répertoriées dans la rubrique "Avant de commencer".

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

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

Installer Terraform

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

Note :

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 la documentation d'installation de tfswitch, car il permet de basculer facilement entre les versions de Terraform. Si vous avez installé tfswitch, sélectionnez une version avec :

tfswitch

Ce livre de jeu a été testé avec la version Terraform 0.14.11

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