Efetuar push de uma imagem

Azure DevOps Services

Use o Azure Pipelines para efetuar push de uma imagem para um registro de contêiner, como o Registro de Contêiner do Azure, o Docker Hub ou o Registro de Contêiner do Google. O Registro de Contêiner do Azure é um serviço gerenciado de registro baseado no Docker Registry 2.0 de código aberto.

Para obter um tutorial sobre como compilar e enviar imagens por push para um registro de contêiner, Confira Compilar e enviar imagens do Docker por push para o Registro de Contêiner do Azure.

Para saber como compilar uma imagem de contêiner para implantar com o Azure Pipelines, confira Compilar imagens de contêiner para implantar aplicativos.

Sobre a tarefa do Docker

Você usará a tarefa Docker@2 para compilar ou enviar por push imagens do Docker, fazer logon ou logoff, iniciar ou parar contêineres ou executar um comando do Docker.

A tarefa usa uma conexão de serviço de registro do Docker para o Registro de Contêiner do Azure fazer logon e enviar por push para um registro de contêiner. O processo para criar uma conexão de serviço de Registro do Docker é diferente dependendo do registro.

A conexão de serviço de Registro do Docker armazena credenciais no registro de contêiner antes de enviar a imagem por push. Você também pode referenciar diretamente as conexões de serviço no Docker sem uma tarefa de script adicional.

Criar uma conexão de serviço de Registro do Docker

Você precisará seguir um processo diferente para criar uma conexão de serviço para o Registro de Contêiner do Azure, o Docker Hub e o Registro de Contêiner do Google.

Registro de Contêiner do Azure

Com a opção registro de contêiner do Azure, a assinatura (associada à identidade do Microsoft Entra do usuário conectado ao Azure DevOps) e o registro de contêiner dentro da assinatura são usados para criar a conexão de serviço.

Observação

Esse método de conexão de serviço usa uma entidade de serviço e não a federação de identidade de carga de trabalho para autenticação. Para saber como usar a identidade de carga de trabalho com o Registro de Contêiner do Azure, consulte Gerenciar conexões de serviço para o Registro de Contêiner do Azure.

Quando você cria um novo pipeline para um repositório que contém um Dockerfile, o Azure Pipelines detectará o Dockerfile no repositório. Para iniciar esse processo, crie um pipeline e selecione o repositório com o Dockerfile.

1. Na guia Configurar, selecione a tarefa Docker – Compilar e efetuar push de uma imagem para Registro de Contêiner do Azure.

   

2. Selecione sua Assinatura do Azure e escolha Continuar.

3. Selecione o Registro de contêiner no menu suspenso e forneça um Nome de Imagem para a imagem de contêiner.

4. Selecione Validar e configurar quando terminar.

   

   Conforme o Azure Pipelines cria o pipeline, ele fará o seguinte:

   • Criará uma conexão de serviço de registro do Docker para permitir que o pipeline envie imagens por push ao registro de contêiner.

   • Gerará um arquivo azure-pipelines.yml que definirá seu pipeline.

Para obter uma visão geral mais detalhada, confira o documento Compilar e enviar por push para o Registro de Contêiner do Azure.

Docker Hub

Escolha a opção Docker Hub em Conexão de serviço de Registro do Docker e forneça seu nome de usuário e senha para criar uma conexão de serviço do Docker.

Registro de contêiner do Google

Para criar uma conexão de serviço do Docker associada ao Registro de Contêiner do Google:

1. Abra seu projeto no Console do GCP e abra Cloud Shell

2. Para economizar tempo digitando a ID do projeto e as opções de zona do Mecanismo de Computação, defina os valores de configuração padrão executando os seguintes comandos:

   gcloud config set project [PROJECT_NAME]
   gcloud config set compute/zone [ZONE]
   

3. Substitua [PROJECT_NAME] pelo nome do projeto GCP e substitua [ZONE] pelo nome da zona que você usará para criar os recursos. Se você não tiver certeza sobre qual zona escolher, use us-central1-a. Por exemplo:

   gcloud config set project azure-pipelines-test-project-12345
   gcloud config set compute/zone us-central1-a
   

4. Habilite a API de Registro de Contêiner para seu projeto:

   gcloud services enable containerregistry.googleapis.com
   

5. Crie uma conta de serviço no Azure Pipelines para publicar imagens do Docker:

   gcloud iam service-accounts create azure-pipelines-publisher --display-name "Azure Pipelines Publisher"
   

6. Atribua a função IAM de Administração Armazenamento à conta de serviço:

   PROJECT_NUMBER=$(gcloud projects describe \
   $(gcloud config get-value core/project) \
   --format='value(projectNumber)')
   
   AZURE_PIPELINES_PUBLISHER=$(gcloud iam service-accounts list \
       --filter="displayName:Azure Pipelines Publisher" \
       --format='value(email)')
   
   gcloud projects add-iam-policy-binding \
       $(gcloud config get-value core/project) \
       --member serviceAccount:$AZURE_PIPELINES_PUBLISHER \
       --role roles/storage.admin
   

7. Gere uma chave de conta de serviço:

   gcloud iam service-accounts keys create \
   azure-pipelines-publisher.json --iam-account $AZURE_PIPELINES_PUBLISHER
   
   tr -d '\n' < azure-pipelines-publisher.json > azure-pipelines-publisher-oneline.json
   

   Inicie o Editor de Código clicando no botão no canto superior direito do Cloud Shell:

   

8. Abra o arquivo named azure-pipelines-publisher-oneline.json. Você precisará do conteúdo desse arquivo em uma das seguintes etapas:

9. Em sua organização do Azure DevOps, selecione Configurações do projeto e Pipelines –> Conexões de serviço.

10. Selecione Nova conexão de serviço, e escolha Registro do Docker

11. Na caixa de diálogo, insira valores para os seguintes campos:

    • Registro do Docker: https://gcr.io/[PROJECT-ID], onde [PROJECT-ID] é o nome do seu projeto do GCP.
    • ID do Docker: _json_key
    • Senha do Docker: cole o conteúdo de azure-pipelines-publisher-oneline.json
    • Nome da conexão de serviço: gcrServiceConnection

12. Selecione Salvar para criar a conexão de serviço