Como criar imagens de contêiner de várias arquiteturas para dispositivos IoT

Como criar o pipeline de criação

O arquivo de modelo do Terraform terraform/main.tf define os recursos criados para este tutorial. Ao executar o Terraform com esse descritor, crie os recursos do Google Cloud a seguir:

• Um repositório de código do Cloud Source Repositories para armazenar o descritor de imagem do contêiner e o arquivo de configuração da compilação do Cloud Build.
• Um tópico do Pub/Sub em que o Cloud Build publica mensagens sobre cada alteração do código-fonte.
• Uma compilação do Cloud Build que cria a imagem do contêiner de várias arquiteturas.
• Um repositório do Container Registry para armazenar imagens de contêiner.

No Cloud Shell, faça o seguinte:

1. Para inicializar o diretório de trabalho do Terraform, execute o comando terraform init:

   cd terraform
   terraform init
   

2. (Opcional) Para revisar as alterações que o Terraform aplicará, execute o comando terraform plan:

   terraform plan
   

   A saída é uma lista de todas as ações que o Terraform deve executar para provisionar recursos no ambiente do Google Cloud. O resumo de todas as ações é semelhante ao seguinte:

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

   O número total de ações de adição é 8, sem alterações e exclusões.

3. Execute o comando terraform apply para criar os recursos no projeto do Cloud:

   terraform apply
   

4. Para continuar executando o comando, digite yes.

Como enviar os arquivos de origem para o Cloud Source Repositories

Para que o pipeline de compilação execute o build, o Dockerfile e os arquivos de configuração do Cloud Build precisam ser armazenados em um repositório de código-fonte do Cloud Source Repositories.

1. No Cloud Shell, clone o repositório de origem:

   cd $HOME
   gcloud source repos clone cross-build
   

2. Copie o Dockerfile e o arquivo de configuração do Cloud Build no repositório de código-fonte:

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

3. Confirme e envie os arquivos ao repositório de código-fonte:

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

Como inspecionar os resultados

Enquanto o job do Cloud Build estiver em execução e após a conclusão, você poderá inspecionar a execução de cada etapa da criação na página Histórico de versões do Cloud Build.

Versão do Cloud Build

Na página Histórico de versões, você tem uma visão geral das etapas de criação com o tempo necessário para executar cada etapa, conforme mostrado na ilustração a seguir.

Se você abrir uma etapa de criação, verá a saída dessa etapa. Por exemplo, os detalhes de criação da etapa buildx inspect no diagrama anterior mostram a arquitetura da plataforma de destino diferente compatível com a plataforma:

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

Os detalhes de criação da quarta etapa mostram a saída do build para cada arquitetura de destino:

#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

Manifesto de imagem no Container Registry

Após a conclusão da compilação, será possível inspecionar o manifesto da imagem na página Imagens do Container Registry no console do Google Cloud, conforme mostrado na ilustração a seguir.

Se você abrir o repositório test na lista de repositórios, verá todas as versões da imagem do contêiner que pertencem ao repositório test, conforme mostrado na ilustração a seguir.

É possível abrir a imagem que tem a tag latest para abrir a página Detalhes do resumo para ver informações detalhadas sobre a imagem, conforme mostrado na ilustração a seguir.

Na página Detalhes do resumo, você pode expandir a seção Manifesto e verificar se toda a arquitetura de destino criada pelo build está indicada no arquivo, conforme mostrado no exemplo a seguir:

{
  "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"
        }
     }
  ]
}

Também é possível ver o manifesto da imagem diretamente do Cloud Shell.

• No Cloud Shell, exiba o manifesto da imagem:

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

  A saída é a mesma do arquivo de manifesto que você pode expandir na página Detalhes do resumo.

Como configurar a implantação contínua do pipeline de compilação

Para criar a imagem do contêiner para a nova arquitetura de hardware, modifique o arquivo de configuração da compilação adicionando a nova arquitetura de destino. Depois de confirmar e enviar a alteração para o repositório de origem no Cloud Source Repositories, o Cloud Build iniciará um novo build. O build produz uma nova versão da imagem de contêiner de várias arquiteturas, incluindo a compatibilidade com a arquitetura de hardware recém-adicionada.

1. No Cloud Shell, adicione a nova plataforma de destino ao arquivo de configuração da compilação:

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

2. Confirme e envie a alteração para o repositório de código-fonte:

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

3. Veja o manifesto mais recente para verificar se a nova plataforma de destino faz parte da imagem de contêiner mais recente:

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

4. Verifique se a plataforma de destino recém-adicionada está no arquivo de manifesto, semelhante à seguinte saída:

   {
     "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"
           }
        }
     ]
   }