Creazione di immagini container con multi-architettura per i dispositivi IoT

Creazione della pipeline di build

Il file del modello Terraform terraform/main.tf definisce le risorse create per questo tutorial. Eseguendo Terraform con il descrittore, crei le seguenti risorse Google Cloud:

• Un repository di codice Cloud Source Repositories per archiviare il descrittore dell'immagine del container e il file di configurazione della build di Cloud Build.
• Un argomento Pub/Sub in cui Cloud Build pubblica messaggi a ogni modifica del codice sorgente.
• Una build di Cloud Build che crea l'immagine container con più architetture.
• Un repository Container Registry per archiviare le immagini container.

In Cloud Shell, segui questi passaggi:

1. Per inizializzare la directory di lavoro Terraform, esegui il comando terraform init:

   cd terraform
   terraform init
   

2. (Facoltativo) Per esaminare le modifiche che Terraform applicherà, esegui il comando terraform plan:

   terraform plan
   

   L'output è un elenco di tutte le azioni che Terraform dovrebbe eseguire per eseguire il provisioning delle risorse nell'ambiente Google Cloud. Il riepilogo di tutte le azioni è simile al seguente:

   Plan: 8 to add, 0 to change, 0 to destroy.
   

   Il numero totale di azioni di aggiunta è 8, senza modifiche o eliminazioni.

3. Esegui il comando terraform apply per creare le risorse nel tuo progetto Google Cloud:

   terraform apply
   

4. Per continuare a eseguire il comando, inserisci yes.

Push dei file di origine in Cloud Source Repositories

Affinché la pipeline di build esegua la build, il Dockerfile e i file di configurazione di Cloud Build devono essere archiviati in un repository di codice sorgente di Cloud Source Repositories.

1. In Cloud Shell, clona il repository di origine:

   cd $HOME
   gcloud source repos clone cross-build
   

2. Copia il Dockerfile e il file di configurazione di Cloud Build nel repository del codice sorgente:

   cp -r "$HOME"/solutions-build-multi-architecture-images-tutorial/terraform/cloud-build/. "$HOME"/cross-build
   

3. Esegui il commit e il push dei file nel repository del codice sorgente:

   cd "$HOME"/cross-build
   git add .
   git commit -m "Initial commit"
   git push
   

Controllo dei risultati

Mentre il job Cloud Build è in esecuzione e dopo il suo completamento, puoi controllare l'esecuzione di ogni passaggio di build nella pagina Cronologia build di Cloud Build.

Build di Cloud Build

Nella pagina Cronologia build viene visualizzata una panoramica dei passaggi della build, insieme al tempo necessario per eseguire ogni passaggio, come mostrato nell'illustrazione seguente.

Se apri un passaggio di build, vedrai l'output di quel passaggio. Ad esempio, i dettagli di compilazione del passaggio di ispezione buildx nel diagramma precedente mostrano la diversa architettura della piattaforma di destinazione supportata dalla piattaforma:

12 Name:      mybuilder0
13 Endpoint:  unix:///var/run/docker.sock
14 Status:    running
15 Platforms: linux/amd64, linux/arm64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6

I dettagli della build per il quarto passaggio mostrano l'output della build per ogni architettura di destinazione:

#8 0.268 I am running on linux/amd64, building for linux/amd64
#12 0.628 I am running on linux/amd64, building for linux/arm/v7
#10 0.279 I am running on linux/amd64, building for linux/arm/v6
#14 0.252 I am running on linux/amd64, building for linux/arm64

Manifest immagine in Container Registry

Una volta completata la build, puoi esaminare il manifest dell'immagine nella pagina Immagini di Container Registry nella console Google Cloud, come illustrato nell'illustrazione seguente.

Se apri il repository test nell'elenco dei repository, vedrai tutte le versioni delle immagini dei container che appartengono al repository test, come mostra la seguente illustrazione.

Puoi aprire l'immagine contrassegnata come latest per aprire la pagina Dettagli sintesi e visualizzare informazioni dettagliate sull'immagine, come mostra la seguente illustrazione.

Nella pagina Dettagli del digest, puoi espandere la sezione Manifest e verificare che tutta l'architettura di destinazione creata dalla build sia indicata nel file, come illustrato nell'esempio seguente:

{
  "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
  "schemaVersion": 2,
  "manifests": [
     {
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "digest": "sha256:839024acb1038509e3bc66f3744857840951d0d512be54fd6670ea1e8babdcb6",
        "size": 735,
        "platform": {
           "architecture": "amd64",
           "os": "linux"
        }
     },
     {
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "digest": "sha256:33489767c29efb805e446a61d91cc55e042d3cfadcd186d9a1c8698f2f12309d",
        "size": 735,
        "platform": {
           "architecture": "arm64",
           "os": "linux"
        }
     },
     {
        "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
        "digest": "sha256:f1958815778ca8c83d324bad3fc68a9e3e9d5ea48b5bb27a8aca7d8da20cf8d4",
        "size": 735,
        "platform": {
           "architecture": "arm",
           "os": "linux",
           "variant": "v7"
        }
     }
  ]
}

Puoi anche visualizzare il manifest dell'immagine direttamente da Cloud Shell.

• In Cloud Shell, visualizza il manifest dell'immagine:

  DOCKER_CLI_EXPERIMENTAL=enabled docker manifest inspect gcr.io/"${DEVSHELL_PROJECT_ID}"/test:latest
  

  L'output è uguale al file manifest che puoi espandere nella pagina Dettagli del digest.

Configurazione del deployment continuo dalla pipeline di build

Per creare l'immagine container per la nuova architettura hardware, devi modificare il file di configurazione della build aggiungendo la nuova architettura di destinazione. Dopo aver eseguito il commit e il push della modifica nel repository di codice sorgente in Cloud Source Repositories, Cloud Build avvia una nuova build. La build produce una nuova versione dell'immagine container multi-architettura, compreso il supporto per l'architettura hardware appena aggiunta.

1. In Cloud Shell, aggiungi la nuova piattaforma di destinazione al file di configurazione della build:

   cd "$HOME"/cross-build
   sed -i -e 's/linux\/arm\/v7/linux\/arm\/v7,linux\/386/g' build-docker-image-trigger.yaml
   

2. Esegui il commit della modifica ed eseguine il push nel repository del codice sorgente:

   git add .
   git commit -m "add a new target platform"
   git push
   

3. Visualizza il manifest più recente per verificare che la nuova piattaforma di destinazione faccia parte dell'immagine container più recente:

   DOCKER_CLI_EXPERIMENTAL=enabled docker manifest inspect gcr.io/${DEVSHELL_PROJECT_ID}/test:latest
   

4. Verifica che la piattaforma di destinazione appena aggiunta sia presente nel file manifest, simile al seguente output:

   {
     "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
     "schemaVersion": 2,
     "manifests": [
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:bc80d063fccb4c370df9b505cbf4f8a814a366d99644de09ebee98af2ef0ff63",
           "size": 735,
           "platform": {
              "architecture": "amd64",
              "os": "linux"
           }
        },
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:be10e4f01f529149815ebad7eb09edaa84ebef5b7d70d51f7d1acb5ceb1f61cd",
           "size": 735,
           "platform": {
              "architecture": "arm64",
              "os": "linux"
           }
        },
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:f6ba5d5d3bc1ea0177e669517ea15a0d4fb97c06c7eca338afa43734d87af779",
           "size": 735,
           "platform": {
              "architecture": "arm",
              "os": "linux",
              "variant": "v7"
           }
        },
        {
           "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
           "digest": "sha256:a3c34621cca10974026f8ad0782af78539cd7bb0ebfa0082a27b2c3ed4418ca0",
           "size": 735,
           "platform": {
              "architecture": "386",
              "os": "linux"
           }
        }
     ]
   }