Container Registry:Compile imagens em uma instância do Container Registry Enterprise Edition

Pré-requisitos

Antes de começar, verifique se:

• Você criou uma instância do Container Registry Enterprise Edition. Para obter 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 source contém um Dockerfile para a compilaçã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ê 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 barra lateral 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 devem 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 Images	Quando ativado, uma versão acelerada de cada imagem é gerada automaticamente após o push. A imagem acelerada recebe o sufixo _accelerated na sua tag.

Etapa 3: Crie um repositório de imagens

Crie um repositório de imagens e vincule-o a um repositório source. Todas as imagens compiladas a partir desse repositório source serã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. Na etapa Repository Info, configure Namespace, Repository Name, Repository Type, Tags, 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 confirme código em um branch.
   Build With Servers Deployed Outside Chinese Mainland	Ative esta opção se o seu repositório source estiver no GitHub ou Bitbucket, ou se o 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 baixar fontes de dados externas durante a compilação. Esta opção está disponível apenas em regiões específicas. Se a opção não for exibida ao crie um repositório de imagens, a região atual não é compatível com esse recurso.
   Build Without Cache	Quando ativado, o ACR baixa a imagem base do 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 source.

Etapa 4: Compile uma imagem

Configure regras de compilação para defina como e quando o ACR compila imagens 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 seguintes parâmetros e clique em Next.

   Parâmetro	Descrição
   Type	O tipo do repositório source. 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 inserir release-(?<imageTag>\w*), o ACR compila automaticamente uma imagem quando o código-fonte no branch release-v1 é atualizado. Para obter mais informações sobre grupos de captura nomeados, consulte Use regular expressions in named capturing groups. Nota Ao usar uma expressão regular, apenas 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 como /.
   Dockerfile Filename	O nome do Dockerfile. O nome padrão é Dockerfile.

8. Na etapa Tag, configure os seguintes parâmetros, clique em salve e depois 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 Se este parâmetro for defina, apenas o ACR pode acionar compilações. Compilações manuais não são compatíveis.
   Commit id	(Opcional) O número de caracteres a utilizar do commit id do código enviado mais recentemente. Por padrão, os primeiros seis caracteres são usados. Ajuste o controle deslizante para alterar o número. Nota Se este parâmetro for defina, apenas o ACR pode acionar compilações. Compilações manuais não são compatíveis.

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

   Parâmetro	Descrição
   Build Architecture	Selecione uma ou mais arquiteturas de destino. Ao selecione 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.

    • Envie um commit de código para o branch configurado do repositório source 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 imagens 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 permite 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 permite apenas compilações automáticas.

Próximas etapas