Introduzione alle esercitazioni della soluzione

Le esercitazioni della soluzione forniscono istruzioni dettagliate su come utilizzare IBM Cloud per implementare modelli comuni basati su best practice e tecnologie comprovate.

Prima di passare attraverso la raccolta di esercitazioni, questa guida ti aiuterà a impostare il tuo ambiente di sviluppo per seguire correttamente le istruzioni delle guide trovate in questa raccolta.

Obiettivi

Installa gli strumenti indispensabili per essere produttivo con IBM Cloud:

  • CLI IBM Cloud: l'interfaccia della riga di comando per interagire con l'API IBM Cloud.
  • Docker: consente di distribuire ed eseguire il software in pacchetti chiamati contenitori.
  • kubectl: un'interfaccia della riga di comando per eseguire i comandi sui cluster Kubernetes.
  • oc: gestisce le applicazioni OpenShift e fornisce gli strumenti per interagire con ogni componente del tuo sistema.
  • Helm 3: ti consente di gestire le applicazioni Kubernetes — i grafici Helm ti aiutano a definire, installare ed eseguire l'upgrade anche dell'applicazione Kubernetes più complessa.
  • Terraform: automatizza il provisioning delle tue risorse.
  • jq: un processore JSON da riga di comando leggero e flessibile.
  • Git: un sistema di controllo delle versioni distribuito gratuito e open source.

Per evitare l'installazione di questi strumenti, puoi anche utilizzare Cloud Shell dalla console IBM Cloud.

Microsoft Windows

Le seguenti sezioni presuppongono che tu stia eseguendo Microsoft Windows 10 a 64 bit con un utente con privilegi di amministratore. Una volta terminate le sezioni specifiche, procedi alla configurazione comune a tutti i sistemi operativi.

CLI IBM Cloud

  1. Scarica e installa la CLI IBM Cloud da https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.

  2. Verifica l'installazione con:

    ibmcloud version

    È possibile che tu debba riavviare la tua macchina dopo l'installazione.

Docker

  1. Docker Desktop su Windows è un'opzione per eseguire le immagini contenitore su Windows. Assicurarsi di rivedere le condizioni dell'accordo di licenza prima di procedere con l'installazione.

  2. Se non ne hai uno, registrati per un account gratuito su https://hub.docker.com/signup.

  3. Scarica e installa Docker Desktop su Windows da https://docs.docker.com/docker-for-windows/install/.

  4. Verifica l'installazione con:

    docker --version
docker run hello-world

    È possibile che tu debba disconnetterti e attendere l'avvio del daemon Docker.

kubectl

  1. Scarica kubectl da https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows.
  2. Sposta il file binario kubectl.exe nel tuo PATH.
  3. Verifica l'installazione con:
    kubectl version --client=true

oc

  1. Scarica la CLI 4.x OpenShift più recente (oc) da https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Sposta il file binario oc.exe nel tuo PATH.
  3. Verifica l'installazione con:
    oc version

Helm 3

  1. Scarica helm da https://github.com/helm/helm/releases/latest.
  2. Decomprimi l'archivio scaricato.
  3. Sposta il file binario helm.exe nel tuo PATH.
  4. Verifica l'installazione con:
    helm version

Terraform

  1. Scarica terraform da https://developer.hashicorp.com/terraform/downloads.
  2. Decomprimi l'archivio scaricato.
  3. Sposta il file binario terraform.exe nel tuo PATH.
  4. Verifica l'installazione con:
    terraform version

Per gestire le risorse di IBM Cloud con Terraform, devi installare anche IBM Cloud Provider. A partire da Terraform 0.13, il fornitore può essere scaricato automaticamente dal registro del plugin Terraform. Segui le istruzioni nella documentazione del provider per configurare la proprietà required_providers nei template Terraform.

jq

  1. Scaricare jq da https://jqlang.github.io/jq/.
  2. Rinomina jq-win64.exe in jq.exe.
  3. Sposta il file binario jq.exe nel tuo PATH.
  4. Verifica l'installazione con:
    jq --version

Git

  1. Scarica e installa git da https://github.com/git-for-windows/git/releases/latest.
  2. Verifica l'installazione con:
    git --version

Procedi alla configurazione comune a tutti i sistemi operativi.

Apple macOS

Le seguenti sezioni presuppongono che tu stia eseguendo macOS High Sierra o versioni successive con un utente con privilegi di amministratore. Una volta terminate le sezioni specifiche, procedi alla configurazione comune a tutti i sistemi operativi.

CLI IBM Cloud

  1. Scarica e installa la CLI IBM Cloud da https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Verifica l'installazione con:
    ibmcloud version

Docker

  1. Docker Desktop su Mac è un'opzione per eseguire le immagini del contenitore su macOS. Assicurarsi di rivedere le condizioni dell'accordo di licenza prima di procedere con l'installazione. Altre opzioni includono Podman.
  2. Se non ne hai uno, registrati per un account gratuito su https://hub.docker.com/signup.
  3. Scarica e installa Docker Desktop su Mac da https://docs.docker.com/docker-for-mac/install/.
  4. Verifica l'installazione con:
    docker --version
docker run hello-world

kubectl

  1. Scarica kubectl da https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos.
  2. Rendere l'eseguibile binario kubectl.
    chmod +x ./kubectl
  3. Sposta il file binario nel tuo PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Verifica l'installazione con:
    kubectl version --client=true

oc

  1. Scarica la CLI 4.x OpenShift più recente (oc) da https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Estrarre openshift-client-mac.tar.gz (Intel) o openshift-install-mac-arm64.tar.gz (Apple Silicon):
    tar zxvf openshift-client-mac*.tar.gz oc
  3. Sposta il file binario oc nel tuo PATH.
    sudo mv ./oc /usr/local/bin/oc
  4. Verifica l'installazione con:
    oc version
    macOS Catalina e versioni successive potrebbero richiedere un messaggio che indica che lo sviluppatore non può essere verificato. Per consentire comunque l'esecuzione di oc, esegui sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc.

Helm 3

  1. Scarica helm da https://github.com/helm/helm/releases/latest.
  2. Decomprimi l'archivio scaricato.
  3. Sposta il file binario helm nel tuo PATH.
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. Verifica l'installazione con:
    helm version
    macOS Catalina e versioni successive potrebbero richiedere un messaggio che indica che lo sviluppatore non può essere verificato. Per consentire comunque l'esecuzione di helm, esegui sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm.

Terraform

  1. Scarica terraform da https://developer.hashicorp.com/terraform/downloads.
  2. Decomprimi l'archivio scaricato.
  3. Sposta il file binario terraform nel tuo PATH.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Verifica l'installazione con:
    terraform version

Per gestire le risorse di IBM Cloud con Terraform, devi installare anche IBM Cloud Provider. A partire da Terraform 0.13, il fornitore può essere scaricato automaticamente dal registro del plugin Terraform. Segui le istruzioni nella documentazione del provider per configurare la proprietà required_providers nei template Terraform.

jq

  1. Scarica jq da https://jqlang.github.io/jq/.
  2. Rinomina il file scaricato in jq.
  3. Rendere l'eseguibile binario jq.
    chmod +x ./jq
  4. Sposta il file binario jq nel tuo PATH.
    sudo mv ./jq /usr/local/bin/jq
  5. Verifica l'installazione con:
    jq --version
    macOS Catalina e versioni successive potrebbero richiedere un messaggio che indica che lo sviluppatore non può essere verificato. Per consentire comunque l'esecuzione di jq, esegui sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq.

Git

  1. Verifica che git sia installato:
    git --version
    macOS potrebbe richiederti di installare gli strumenti per gli sviluppatori. Questi strumenti includono la riga di comando git.

Procedi alla configurazione comune a tutti i sistemi operativi.

Ubuntu Linux

Le seguenti sezioni presuppongono che tu stia eseguendo Ubuntu Linux come utente non root con accesso ai privilegi root. Una volta terminate le sezioni specifiche, procedi alla configurazione comune a tutti i sistemi operativi. Se stai utilizzando la Cloud Shellbasata su Linux, procedi alla sezione su Cloud Shell.

CLI IBM Cloud

  1. Scarica e installa la CLI IBM Cloud da https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Verifica l'installazione con:
    ibmcloud version

Docker

  1. Se non ne hai uno, registrati per un account gratuito su https://hub.docker.com/signup.
  2. Installa Docker Engine su Ubuntu seguendo le istruzioni da https://docs.docker.com/engine/install/ubuntu/.
  3. Verifica l'installazione con:
    docker --version
sudo docker run hello-world
    Per eseguire Docker con il proprio utente invece che con root, eseguire la procedura post - installazione.

kubectl

  1. Scarica kubectl da https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux.
  2. Rendere l'eseguibile binario kubectl.
    chmod +x ./kubectl
  3. Sposta il file binario nel tuo PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Verifica l'installazione con:
    kubectl version --client=true

oc

  1. Scarica la CLI 4.x OpenShift più recente (oc) da https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Estrai openshift-client-linux.tar.gz:
    tar zxvf openshift-client-linux.tar.gz oc
  3. Sposta il file binario oc nel tuo PATH.
    sudo mv ./oc /usr/local/bin/oc
  4. Verifica l'installazione con:
    oc version

Helm 3

  1. Scarica helm da https://github.com/helm/helm/releases/latest.
  2. Decomprimi l'archivio scaricato.
  3. Sposta il file binario helm nel tuo PATH.
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. Verifica l'installazione con:
    helm version

Terraform

  1. Scarica terraform da https://developer.hashicorp.com/terraform/downloads.
  2. Decomprimi l'archivio scaricato.
  3. Sposta il file binario terraform nel tuo PATH.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Verifica l'installazione con:
    terraform version

Per gestire le risorse di IBM Cloud con Terraform, devi installare anche IBM Cloud Provider. A partire da Terraform 0.13, il fornitore può essere scaricato automaticamente dal registro del plugin Terraform. Segui le istruzioni nella documentazione del provider per configurare la proprietà required_providers nei template Terraform.

jq

  1. Installa jq con:
    sudo apt install jq
  2. Verifica l'installazione con:
    jq --version

Git

  1. Installa git con:
    sudo apt install git
  2. Verifica l'installazione con:
    git --version

Procedi alla configurazione comune a tutti i sistemi operativi.

Comune a tutti i sistemi operativi

Le sezioni successive sono comuni a tutti i sistemi operativi.

Plugin della CLI IBM Cloud

I plugin estendono le funzionalità della CLI IBM Cloud con comandi specifici per un servizio.

  1. Installa i seguenti plugin:
    ibmcloud plugin install container-registry
ibmcloud plugin install cloud-object-storage
ibmcloud plugin install kubernetes-service
ibmcloud plugin install vpc-infrastructure
ibmcloud plugin install code-engine
    Per visualizzare tutti i plugin disponibili, eseguire ibmcloud plugin repo-plugins e installare un plugin ibmcloud plugin install <PLUGIN_NAME>

Account GitHub

  1. Registrati per un account gratuito su https://github.com/.
  2. Crea un nuovo repository pubblico su https://github.com/new per acquisire familiarità con GitHub.

IBM Cloud GitLab

IBM Cloud ti fornisce repository Git ospitati basati su GitLab Community Edition e accessibili tramite le stesse credenziali utilizzate per accedere a IBM Cloud. Ti consigliamo di configurare la tua chiave pubblica SSH per semplificare le interazioni della riga di comando con i repository Git.

  1. Utilizza queste istruzioni per generare una nuova coppia di chiavi SSH, se non ne hai una.
  2. Aggiungi la tua chiave pubblica SSH alle tue impostazioni Git nella regione in cui intendi ospitare i tuoi repository Git, come Dallas(us-south.git.cloud.ibm.com), London(eu-gb.git.cloud.ibm.com) o Frankfurt(eu-de.git.cloud.ibm.com).

Per verificare la configurazione:

  1. Crea un nuovo progetto privato in GitLab, seleziona l'opzione per inizializzare il repository con un README.
  2. Estrai il progetto dalla riga di comando clonandolo con il link SSH.
  3. Aggiorna il file README.
  4. Esegui il commit e il push delle modifiche.

Cloud Shell

oc

Segui questa procedura se hai bisogno di utilizzare un'altra versione della CLI OpenShift rispetto a quella preinstallata:

  1. Scarica la versione più recente della CLI 4.x OpenShift (oc)
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. Estrai oc.tar.gz:
    tar zxvf oc.tar.gz oc
  3. Aggiungere la propria directory corrente a PATH
    export PATH=$PWD:$PATH
  4. Verifica l'installazione con:
    oc version