Container Registry:Criação de imagens em uma instância do Container Registry Enterprise Edition

Pré-requisitos

Antes de começar, certifique-se de que:

• Você criou uma instância do Container Registry Enterprise Edition. Para mais informações, consulte a seção "Step 1: Create a Container Registry Enterprise Edition instance" do tópico Push an image to a Container Registry Enterprise Edition instance and pull an image from the instance.

• Seu repositório de código-fonte contém um Dockerfile para a construção de imagens.

Informações gerais

Etapa 1: Vincule sua instância a uma plataforma de hospedagem de código

Etapa 2: Crie um namespace

Crie um namespace para organizar seus repositórios de imagens. Ao ativar a criação automática de repositórios, você pode defina configurações padrão aplicadas a todos os repositórios desse namespace.

1. Faça login no Container Registry console.

2. Na barra de navegação superior, selecione uma região.

3. No painel de navegação à esquerda, clique em Instances.

4. Na página Instances, clique na instância Enterprise Edition para a qual deseja crie um namespace.

5. No painel de navegação à esquerda, escolha Repository > Namespace.

6. Na página Namespace, clique em Create Namespace.

7. Na caixa de diálogo Create Namespace, configure Namespace e defina Automatically Create Repository como On ou Off. Em seguida, clique em Confirm.

   Se você defina Automatically Create Repository como On, configure os seguintes parâmetros:

   Parâmetro	Descrição
   Repository Type	Selecione Public ou Private. Public: por padrão, imagens públicas exigem que os usuários façam login na instância antes de serem baixadas. Para permitir pulls anônimos, ative a configuração de pull anônimo público da instância. Como repositórios públicos podem ser acessados por usuários não autorizados, defina os repositórios como Private para proteger seus dados. Private: os usuários precisam fazer login na instância e ter autorização de permissão Pull antes de baixar imagens privadas.
   Immutable Image Tags	Selecione Flexible ou Immutable. Quando defina como Immutable, todas as tags de imagem, exceto latest, não podem ser substituídas.
   Accelerated Image	Quando ativado, uma versão acelerada de cada imagem é gerada automaticamente após o push. A imagem acelerada recebe o sufixo _accelerated em sua tag.

Etapa 3: Crie um repositório de imagens

Crie um repositório de imagens e vincule-o a um repositório de código-fonte. Todas as imagens compiladas a partir desse repositório de código-fonte são enviadas para este repositório de imagens.

1. Faça login no Container Registry console.

2. Na barra de navegação superior, selecione uma região.

3. No painel de navegação à esquerda, clique em Instances.

4. Na página Instances, clique na instância Enterprise Edition que deseja gerencie.

5. No painel de navegação à esquerda, escolha Repository > Repositories.

6. Na página Repositories, clique em Create Repository.

7. No assistente Repository Info, configure Namespace, Repository Name, Repository Type, Image Version, Accelerated Image, Summary e Description. Em seguida, clique em Next.

8. Na etapa Code Source, configure Code Source, Build Settings e Build Rules, e clique em Create Repository.

9. A tabela a seguir descreve os parâmetros de Build Settings:

   Parâmetro	Descrição
   Automatically Build Images When Code Changes	Quando ativado, a regra de compilação é acionada automaticamente ao fazer commit de código em um branch.
   Build With Servers Deployed Outside Chinese Mainland	Ative esta opção se seu código-fonte estiver no GitHub ou Bitbucket, ou se seu Dockerfile baixar dependências de fora da china e a conexão de rede internacional for instável. O ACR usa um link acelerado para acessar fontes de dados externas durante a compilação. Esta opção está disponível apenas em regiões específicas. Caso não seja exibida ao criar um repositório de imagens, a região atual não oferece suporte a este recurso.
   Build Without Cache	Quando ativado, o ACR baixa a imagem base da source a cada compilação, ignorando as camadas em cache. Isso pode reduzir a velocidade das compilações. Desative esta opção para usar camadas em cache e acelerar as compilações.

   Na página Repositories, clique no repositório de imagens criado. Se Build for exibido no painel de navegação à esquerda da página de gerenciamento do repositório, o repositório de imagens está vinculado ao repositório de código-fonte.

Etapa 4: Compile uma imagem

Configure regras de compilação para defina como e quando o ACR compila imagens a partir do seu repositório, acione uma compilação e verifique o resultado.

1. Faça login no Container Registry console.

2. Na barra de navegação superior, selecione uma região.

3. No painel de navegação à esquerda, clique em Instances.

4. Na página Instances, clique na instância Enterprise Edition que deseja gerencie.

5. No painel de navegação à esquerda da página de detalhes da instância, escolha Repository > Repositories.

6. Na página Repositories, localize o repositório de imagens criado e clique em Manage na coluna Actions.

7. No painel de navegação à esquerda, clique em Build. Na seção Build Rules, clique em Add Build Rule. Na etapa Build Information, configure os parâmetros a seguir e clique em Next.

   Parâmetro	Descrição
   Type	O tipo do repositório de código-fonte. Valores válidos: Branch e Tag.
   Branch/Tag	Selecione ou insira um branch ou tag. Expressões regulares são compatíveis. Por exemplo, ao insira release-(?<imageTag>\w*), o ACR compila automaticamente uma imagem quando o código-fonte do branch release-v1 é atualizado. Para mais informações sobre grupos de captura nomeados, consulte Use regular expressions in named capturing groups. Nota Ao usar uma expressão regular, somente o ACR pode acionar compilações. Compilações manuais não são compatíveis.
   Build Context Directory	O diretório que contém o Dockerfile, relativo à raiz do branch ou tag. Por exemplo, se o branch for master e o Dockerfile estiver na raiz do branch, defina este campo como /.
   Dockerfile Filename	O nome do Dockerfile. O nome padrão é Dockerfile.

8. Na etapa Tag, configure os parâmetros a seguir, clique em salve e em Next.

   Nota

   Clique em Add Configuration para adicionar tags de imagem. É possível adicionar até três tags de imagem.

   Parâmetro	Descrição
   Image Tag	A tag da imagem compilada, por exemplo latest. Grupos de captura nomeados são compatíveis. Se você defina um grupo de captura nomeado em Branch/Tag, referencie o valor capturado aqui.
   Build Time	(Opcional) O horário (UTC+8) em que o código-fonte é enviado. Formatos aceitos: 20201015 ou 202010151613. Nota Ao defina este parâmetro, somente o ACR pode acionar compilações. Compilações manuais não são compatíveis.
   Commit ID	(Opcional) O número de caracteres do commit ID do código enviado mais recentemente. Por padrão, os primeiros seis caracteres são utilizados. Ajuste o controle deslizante para alterar o número. Nota Ao defina este parâmetro, somente o ACR pode acionar compilações. Compilações manuais não são compatíveis.

9. Na etapa Build Configurations, configure os parâmetros a seguir e clique em Next.

   Parâmetro	Descrição
   Build Architecture	Selecione uma ou mais arquiteturas de destino. Ao escolher múltiplas arquiteturas, o ACR gera uma imagem separada para cada arquitetura sob a mesma tag.
   Build Parameters	Pares chave-valor passados ao processo de compilação. Os nomes dos parâmetros diferenciam maiúsculas de minúsculas. Configure até 20 parâmetros de compilação clicando em Add Configuration.

10. Acione uma compilação usando um dos seguintes métodos:

    • Na seção Build Rules da página Build, localize a regra de compilação e clique em Build na coluna Actions.

    • Faça push de um commit de código para o branch configurado do repositório de código-fonte para acionar a regra de compilação automaticamente.

11. Monitore a compilação: na seção Build Log, localize a tarefa de compilação de imagem e clique em Log na coluna Actions para visualize o log de compilação. Para interromper uma compilação em andamento, clique em cancele na coluna Actions.

12. Verifique o resultado: no painel de navegação à esquerda, clique em Image Tag. Se a imagem compilada estiver listada, a compilação foi concluída com êxito.

    No painel de navegação à esquerda, clique em Image Tag. Se a imagem criada for exibida, a compilação foi concluída com sucesso.

Exemplos

Os dois exemplos a seguir ilustram configurações comuns de regras de compilação. O Exemplo 1 apresenta uma configuração simples que suporta compilações manuais e automáticas. O Exemplo 2 usa uma expressão regular para criar tags de imagem versionadas a partir de nomes de branches de release e suporta apenas compilações automáticas.

Próximas etapas