Emitir uma imagem

Serviços de DevOps do Azure

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

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

Para saber como criar uma imagem de contêiner para implantar com o Azure Pipelines, consulte Criar imagens de contêiner para implantar aplicativos.

Sobre a tarefa do Docker

Você usará a tarefa Docker@2 para criar ou enviar por push imagens do Docker, fazer login ou logout, 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 para 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 difere dependendo do seu registro.

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

Criar uma conexão de serviço 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 Hub do Docker e o Registro de Contêiner do Google.

Azure Container Registry

Com a opção Registro de Contêiner do Azure, a assinatura (associada à identidade 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.

Nota

Esse método de conexão de serviço usa uma entidade de serviço e não uma federação de identidade de carga de trabalho para autenticação. Para saber como usar a identidade da carga de trabalho em vez disso 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 detetará o Dockerfile no repositório. Para iniciar esse processo, crie um novo pipeline e selecione o repositório com seu Dockerfile.

1. Na guia Configurar, selecione a tarefa Docker - Criar e enviar uma imagem por push para o Registro de Contêiner do Azure.

   

2. Selecione a sua Subscrição do Azure e, em seguida, selecione Continuar.

3. Selecione o registro do contêiner no menu suspenso e, em seguida, forneça um Nome da imagem para a imagem do contêiner.

4. Selecione Validar e configurar quando terminar.

   

   À medida que o Azure Pipelines cria seu pipeline, ele irá:

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

   • Gere um arquivo azure-pipelines.yml , que define seu pipeline.

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

Hub do Docker

Escolha a opção Docker Hub em Conexão do 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 Google Container Registry:

1. Abra seu projeto no Console do GCP e, em seguida, abra o Cloud Shell

2. Para economizar tempo digitando o ID do projeto e as opções de zona do Compute Engine, 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 seu projeto GCP e substitua [ZONE] pelo nome da zona que você usará para criar recursos. Se 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 para o 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 de administrador de armazenamento do IAM à 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ódigos clicando no botão no canto superior direito do Cloud Shell:

   

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

9. Na sua organização do Azure DevOps, selecione Configurações do projeto e, em seguida, selecione 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 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