Container Registry:Crie imagens em uma instância Enterprise Edition

Pré-requisitos

• Você criou uma instância Enterprise Edition do Container Registry. Para mais informações, consulte Criar uma instância Enterprise Edition.

• Seu repositório de código-fonte contém um Dockerfile.

Informações básicas

Etapa 1: Conectar uma plataforma de hospedagem de código

Etapa 2: Criar um namespace

1. Faça login no console do Container Registry.

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

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

4. Na página Instances, clique em na instância Enterprise Edition desejada.

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

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

7. Na barra lateral Create Namespace, defina o nome do Namespace, ative (On) ou desative (Off) a opção Automatically Create Repository e clique em Confirm.

   Se você selecionar On em Automatically Create Repository, siga as orientações abaixo:

   Elemento da interface	Descrição
   Repository Type	Public: Por padrão, os usuários precisam fazer login na instância Enterprise Edition para baixar imagens públicas. Para permitir downloads anônimos, ative o acesso anônimo na instância. Recomendamos definir o tipo de repositório como Private para garantir a segurança dos dados. Private: Para baixar imagens privadas, os usuários devem fazer login na instância Enterprise Edition e possuir as permissões de Pull necessárias.
   Immutable Image Tags	Flexible. Ao selecionar esta opção, tags de imagem neste repositório (exceto latest) não podem ser sobrescritas, o que garante a consistência das tags de imagens de contêiner.
   Accelerated Image	Define se o recurso está Off. Se você marcar a caixa de seleção, uma tag de imagem acelerada com o sufixo _accelerated será gerada automaticamente no repositório.

Etapa 3: Criar um repositório de imagens

Crie um repositório de imagens e vincule-o a um repositório de código-fonte. O serviço enviará as imagens compiladas a partir do código-fonte conectado diretamente para este repositório.

1. Faça login no console do Container Registry.

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

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

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

5. No painel de navegação à esquerda da página de detalhes da instância, 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. Depois, clique em Create Repository.

   Parâmetro	Descrição
   Code Source	Selecione a origem do seu código.
   Build Settings	Criar imagens automaticamente quando o código mudar: Quando ativada, essa opção dispara uma compilação automática sempre que houver um commit na branch especificada. Build With Servers Deployed Outside Chinese Mainland: Este recurso utiliza um link acelerado para buscar dados de fontes fora da China continental durante as compilações. Caso seu projeto use GitHub ou Bitbucket como fonte de código, ou se arquivos no Dockerfile precisem ser baixados de sites fora da China continental e a rede transfronteiriça estiver instável, utilize a opção Build With Servers Deployed Outside Chinese Mainland. Build Without Cache: Ao marcar esta opção, as imagens base de dependências são obrigatoriamente baixadas novamente a cada compilação, o que pode aumentar o tempo do processo. Desativar a opção Build Without Cache ajuda a reduzir o tempo de criação da imagem.

   Na página Repositories, clique em no repositório de imagens alvo. Se a opção Build aparecer no painel de navegação à esquerda, o repositório de imagens foi conectado com sucesso ao repositório de código-fonte.

Etapa 4: Compilar uma imagem

1. Faça login no console do Container Registry.

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

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

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

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

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

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 e clique em Next.

   Parâmetro	Descrição
   Type	Define o tipo de origem para a compilação. Os valores válidos são Branch e Tag.
   Branch/Tag	Selecione ou insira uma branch ou tag. Expressões regulares são suportadas. Por exemplo, se a regex for release-(?<imageTag>\w*), uma alteração no código-fonte release-v1 aciona automaticamente uma compilação para uma imagem com a tag v1. Compilações manuais não são suportadas neste caso. Para mais informações, consulte Grupos de captura nomeados em expressões regulares. Nota Ao configurar uma expressão regular, apenas compilações automáticas são suportadas. Não é possível realizar compilações manuais.
   Build Context Directory	Caminho relativo para o diretório que contém o Dockerfile. O caminho é relativo à raiz da branch ou tag selecionada. Por exemplo, se sua branch for master e o Dockerfile estiver na raiz dessa branch, o diretório de contexto de compilação será /.
   Dockerfile Filename	Nome do arquivo Dockerfile. O valor padrão é Dockerfile.

8. Na etapa Image Version, configure os parâmetros, clique em Save e, em seguida, clique em Next.

   Nota

   Clique em Add Configuration para adicionar mais tags de imagem. O limite máximo é de três tags por imagem.

   Parâmetro	Descrição
   Image Version	Especifique a tag da imagem, como latest. Também é possível utilizar o valor capturado pelo campo Branch/Tag.
   Build Time	Timestamp (UTC+8) do push do código. Dois formatos estão disponíveis: 20201015 e 202010151613. Nota Este parâmetro é opcional. Se selecionado, apenas compilações automáticas são suportadas. Compilações manuais não funcionam com esta opção.
   Commit ID	ID do commit do push de código mais recente. Por padrão, os primeiros 6 caracteres são utilizados. Ajuste o controle deslizante para definir a quantidade de caracteres desejada. Nota Parâmetro opcional. Ao ativá-lo, somente compilações automáticas são permitidas; compilações manuais não são suportadas.

9. Na etapa Build Configurations, defina os parâmetros de compilação e clique em Confirm.

   Parâmetro	Descrição
   Build Architecture	Selecione a arquitetura de compilação. Compilações paralelas são suportadas. Uma única tag de imagem pode corresponder a imagens para múltiplas arquiteturas.
   Build Parameters	Parâmetros de tempo de execução para a criação da imagem. Consistem em pares chave-valor sensíveis a maiúsculas e minúsculas. É possível definir até 20 parâmetros. Utilize-os para modificar variáveis de ambiente no Dockerfile, permitindo gerar saídas diferentes a partir do mesmo arquivo.

10. Acione a regra de compilação.

    Acione uma regra de compilação das seguintes formas:

    • Na página Build, vá até a seção Build Rules, encontre a regra desejada e clique em Build na coluna Actions.

    • Faça um commit de código na branch configurada dentro do repositório de código-fonte.

    Nota

    • Para cancelar uma tarefa, acesse a página Build, vá até a seção Build Log, localize a tarefa e clique em Cancel na coluna Actions.

    • Para visualizar os logs de um processo de compilação, na página Build, acesse a seção Build Log, encontre a tarefa e clique em Log na coluna Actions.

    No painel de navegação à esquerda, clique em Image Version. Se a imagem compilada estiver visível, a criação foi concluída com sucesso.

Exemplo 1: Compilar a partir de uma branch fixa

Uma compilação de imagem é acionada quando ocorrem alterações no código-fonte da branch main ou quando você clica em manualmente em Build. O diretório de trabalho é /, e a compilação utiliza o arquivo chamado Dockerfile localizado nesse diretório. A imagem gerada recebe a tag latest. A regra de compilação é ilustrada na figura a seguir.

Exemplo 2: Compilar a partir de uma branch correspondente a regex

Sempre que você alterar o código-fonte em uma branch cujo nome comece com release-, o sistema iniciará uma compilação de imagem. O contexto de compilação é o diretório raiz (/), e o arquivo utilizado será o Dockerfile presente nesse local.

Por exemplo, considere uma alteração no código-fonte da branch release-v1. A expressão regular release-(?<imageTag>\w*) captura v1 do nome da branch e o atribui à variável imageTag, que o serviço então utiliza para definir a tag da imagem. Após a conclusão da compilação, a tag resultante será v1-202010151625-d4ef3dc3b77a011a5779eec7efdd45. A regra de compilação é mostrada na figura abaixo.

Operações relacionadas