Installare i prerequisiti

Poiché gli artifact Kubernetes necessari vengono distribuiti come grafici Helm in Kubernetes per eseguire gli stack, è necessario che sia installato kubectl che Helm. Inoltre, avrai bisogno dell'interfaccia della riga di comando (CLI, Command-Line Interface) di Oracle Cloud Infrastructure, richiesta per kubectl e utile per altre attività.

Questa operazione consente di installare i seguenti componenti:

Interfaccia della riga di comando OCI.
Se non è già presente, kubectl versione 1.18 o successiva.
Helm 3.x.

Installare l'interfaccia dalla riga di comando di Oracle Cloud Infrastructure

Innanzitutto, installerai l'interfaccia della riga di comando (CLI, Command-Line Interface) di Oracle Cloud Infrastructure.

Per installare l'interfaccia CLI OCI su Linux o Mac OS X, eseguire il comando:
```
bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
```
Premere Invio per accettare le impostazioni predefinite per tutte le opzioni.
Riavviare la shell.
```
exec -l $SHELL
```
Raccogliere gli OCID tenancy e utente:
1. Ottenere l'OCID della tenancy dalla console di Oracle Cloud facendo clic sull'icona Utente (nell'angolo superiore destro) e quindi sulla tenancy. Copiare l'OCID della tenancy (campo Tenancy).
2. Ottenere l'OCID utente dalla console facendo clic su Utente, quindi su Impostazioni utente. Quindi copiare l'OCID dell'utente.
Configurare l'interfaccia CLI OCI.
```
oci setup config
```
Verrà richiesto di fornire quanto riportato di seguito.
- Posizione della configurazione: premere Invio.
- user_ocid: immettere l'OCID utente.
- tenancy_ocid: immettere l'OCID della tenancy.
- region: immettere la propria area dall'elenco fornito.
- Genera una coppia di chiavi RSA: premere Invio per Sì (impostazione predefinita).
- Directory per i tasti: premere Invio per l'impostazione predefinita.
- Nome del tasto: premere Invio per l'impostazione predefinita.
- Passphrase: premere Invio per non indicare alcuna passphrase.
Dovresti vedere un output come:
```
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
```
Per utilizzare l'interfaccia CLI, è necessario caricare la chiave pubblica generata nel proprio account utente. Per ottenere i contenuti della chiave, immettere:
```
cat ~/.oci/oci_api_key_public.pem 
```
Facoltativamente, è possibile aprire il file con l'editor preferito e copiare l'output completo stampato negli Appunti.
Nella console Web OCI aggiungere la chiave generata nel passo precedente:
1. In Utente fare clic su Impostazioni utente.
2. Fare clic su Chiavi API.
3. Fare clic su Aggiungi chiave pubblica.
4. Fare clic su Incolla chiave pubblica.
5. Incollare la chiave copiata sopra.
6. Fare clic su Aggiungi.
7. Verificare che l'impronta digitale generata corrisponda all'output dell'impronta digitale della configurazione.
Eseguire il test dell'interfaccia CLI immettendo:
```
oci os ns get
```
Questo comando deve restituire lo spazio di nomi della tenancy (di solito il nome della tenancy o una stringa randomizzata). Ad esempio:
```
{
    "data": "your-tenancy-namespace"
}
```

Installa kubectl

Installare quindi lo strumento della riga di comando Kubernetes, kubectl.

Nota

Se si utilizza Docker Desktop su Mac OS X o Windows, è necessario che kubectl sia già installato ed è possibile saltare questo passaggio.

Di seguito è riportata una procedura di alto livello per l'installazione di kubectl. Per istruzioni più dettagliate specifiche per il tuo sistema operativo, consulta "Strumenti di installazione" nella documentazione online di Kubernetes, elencata nell'argomento "Prima di iniziare".

Per installare kubectl, eseguire il comando seguente:

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

In Windows utilizzare:

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

Aggiungi il file binario al tuo PATH.
Verificare che si stia utilizzando una versione kubectl della versione 1.18 o successiva immettendo:
```
kubectl version --client
```

Installa Helm

A questo punto, sarà possibile installare l'interfaccia CLI Helm.

Di seguito è riportata una procedura di alto livello per l'installazione di Helm. Per istruzioni più dettagliate specifiche per il tuo sistema operativo, consulta "Installazione di Helm", elencato nell'argomento "Prima di iniziare".

Per installare helm su Mac OS X e Linux, immettere:

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

Installa Terraform

Infine, se non è già installato, è necessario installare Terraform.

Nota

I collegamenti alla documentazione di installazione a cui si fa riferimento in questo argomento sono disponibili nell'argomento "Prima di iniziare".

Se si utilizza un computer basato su Linux o un Mac OS X, si consiglia di installare Terraform utilizzando tfswitch, come descritto nella documentazione di installazione in tfswitch, in quanto consente di passare facilmente da una versione a un'altra di Terraform. Se è stato installato tfswitch, selezionare una versione con:

tfswitch

Questo playbook è stato testato con Terraform versione 0.14.11

In caso contrario, se hai bisogno di indicazioni per impostare Terraform, visita la documentazione di installazione di Terraform e seleziona il percorso corrispondente al tuo ambiente.