Copiar imagens do Container Registry

Como parte da transição do Container Registry para o Artifact Registry, você pode copiar as imagens do Container Registry que você quer manter no Artifact Registry.

Visão geral

Há várias opções para copiar imagens do Container Registry para o Artifact Registry. Recomendamos copiar imagens com a ferramenta de migração automática porque ela oferece suporte à cópia de vários projetos, pode copiar suas imagens mesmo se você já redirecionamento ativado e pode lidar com um número maior de imagens do que outros métodos.

Para reduzir custos, faça o seguinte:

  1. Remova imagens antigas e sem tags antes de copiar contêineres para o Artifact Registry.

  2. Se você estiver copiando imagens para um repositório padrão (pkg.dev) do Artifact Registry, desative a verificação automática para o Artifact Registry antes de copiar as imagens para evitar custos de verificação duplicada. Você pode reativar a verificação automática depois de copiar todas as imagens.

    Se você estiver copiando imagens para um repositório gcr.io no Artifact Registry, não será necessário desativar a verificação automática.

    Para mais informações sobre como controlar os custos relacionados à verificação de vulnerabilidades, ver Como controlar os custos de verificação de vulnerabilidades.

Remover imagens sem tags do Container Registry

A remoção de imagens sem tag reduz o custo de armazenamento no Container Registry e do custo de copiar imagens do Container Registry para o Artifact Registry.

Há várias ferramentas disponíveis para identificar e automatizar a remoção de imagens que você não precisa mais. Por exemplo, a ferramenta gcr-cleaner ajuda a encontrar e remover imagens antigas com base em critérios diferentes. A ferramenta gcr-cleaner não é um produto oficial do Google.

Para obter mais informações sobre como configurar e usar a ferramenta, consulte o gcr-cleaner na documentação do Google Cloud.

Copiar imagens com a ferramenta de migração automática (recomendado)

Use a ferramenta de migração automática para fazer a transição do Container Registry para repositórios gcr.io no Artifact Registry ou para repositórios padrão do Artifact Registry ou para copiar suas imagens do Container Registry para o Artifact Registry.

Essa ferramenta só oferece suporte à migração e cópia para a mesma multirregião.

Siga as instruções em Migrar automaticamente para o Artifact Registry para copiar suas imagens do Container Registry para o Artifact Registry.

Copiar imagens com o gcrane

Para copiar imagens para o Artifact Registry, você também pode usar a ferramenta gcrane.

O gcrane permite copiar imagens entre várias regiões, mas tem as seguintes desvantagens:

  • gcrane é mais lento do que as ferramentas automatizadas.
  • gcrane é limitado pela cota do Container Registry.
  • gcrane pode falhar se alguma imagem tiver mais de 10.000 versões ou tags.
  • O gcrane poderá falhar se alguma imagem estiver configurada incorretamente ou com dados ausentes.

Requisitos

Verifique os seguintes requisitos:

  1. você ativou o Artifact Registry nos registros de origem e projetos do Google Cloud de destino.

  2. Você criou um repositório do Docker em Artifact Registry para as imagens que você está copiando.

  3. Você tem as permissões necessárias:

    • Leitor de objetos do Storage (roles/storage.objectViewer) ou um papel com permissões equivalentes no bucket de armazenamento para para o host do Container Registry. Saiba como conceder essas permissões.

    • Gravador do Artifact Registry (roles/artifactregistry.writer) ou um papel com permissões equivalentes para o Artifact Registry repositório de dados. Saiba como conceder essas permissões.

  4. Para usar a opção de cópia rápida, verifique os seguintes requisitos:

    • Use a versão 0.10.0 ou mais recente do gcrane. As instruções de configuração do gcrane nesta documentação incluem etapas para fazer o download da versão mais recente.

      Para verificar a versão de uma instalação do gcrane, execute o comando:

      gcrane version

    • O agente de serviço do Artifact Registry do projeto de destino precisa ter o Leitor de objetos do Storage (roles/storage.objectViewer) ou um papel com permissões equivalentes no projeto de origem. Execute o comando a seguir para conceder o papel de leitor de objetos do Storage ao agente de serviço:

      gcloud projects add-iam-policy-binding SOURCE_PROJECT_ID \
    --member='serviceAccount:service-DEST_PROJECT_NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com' \
    --role='roles/storage.objectViewer'

      Substitua SOURCE_PROJECT_ID pelo ID (por exemplo: "my-project") do Google Cloud. projeto nos hosts do Container Registry.

      Substitua DEST_PROJECT_NUMBER pelo número (por exemplo, 12345) do projeto do Google Cloud com seu repositório do Artifact Registry.

Opções e custos do ambiente

É possível executar gcrane a partir de vários ambientes:

  • Instância do Compute Engine: use esta opção se você tiver um número maior de contêineres para copiar.

    Custos:

    • Tempo de atividade da instância para VM do Compute Engine.
    • Transferência de dados de rede para as imagens copiadas, a menos que você esteja usando a opção de cópia rápida. Para minimizar os custos:
    • Use uma instância de VM no mesmo local que o Container Registry do Google Cloud Storage.
    • Para minimizar custos e maximizar a velocidade de cópia, use um repositório do Artifact Registry na mesma multirregião do Container Registry. Transferência de dados na mesma multirregião não gera cobranças e é muito mais rápido do que copiar entre locais.

  • Cloud Shell: uma opção para copiar pequenos conjuntos de cerca de 40 GB ou menos. Como gcrane pula o upload de camadas de imagem que já foram enviadas, esse limite é para novos dados que você está copiando.

    Copiar repositórios maiores pode fazer com que o Cloud Shell se desconecte após o período de tempo limite da solicitação de 10 minutos.

    Custos: transferência de dados de rede para as imagens copiadas, a menos que você esteja usando a opção de cópia rápida.

    • Não é possível escolher o local de uma sessão do Cloud Shell. Para verificar o local da sessão atual, execute o comando:
    curl metadata/computeMetadata/v1/instance/zone
    • Para minimizar custos e maximizar a velocidade de cópia, use um repositório do Artifact Registry na mesma multirregião do Container Registry. A transferência de dados na mesma multirregião não gera cobranças e é muito mais rápida do que a cópia entre locais.

  • Máquina local: se não for possível usar as outras opções, execute gcrane a partir de uma máquina local.

    Custos: transferência de dados de rede para as imagens copiadas, a menos que você esteja usando a opção de cópia rápida.

    Para minimizar os custos e maximizar a velocidade de cópia, use um Artifact Registry na mesma multirregião que o Container Registry. A transferência de dados na mesma multirregião não gera cobranças e é muito mais rápida do que copiar entre locais.

Como configurar o Compute Engine

Para copiar imagens com gcrane de uma instância de VM do Compute Engine:

  1. Crie uma instância de VM. Para minimizar os custos, crie a instância no mesmo local do registro que você está copiando.

  2. Por padrão, a instância de VM está associada à conta de serviço padrão e tem permissões para extrair imagens. É preciso alterar o escopo de acesso para que a instância de VM poderá enviar imagens.

    1. Pare a instância de VM. Consulte Como interromper uma instância.

    2. Altere o escopo de acesso com o comando a seguir:

      gcloud compute instances set-service-account INSTANCE --scopes=storage-rw

      Substitua INSTANCE pelo nome da instância de VM.

    3. Reinicie a instância de VM. Consulte Como iniciar uma instância interrompida.

  3. Conecte-se à instância de VM usando SSH.

  4. Execute o seguinte comando para fazer o download de gcrane.

    curl -L \
https://github.com/google/go-containerregistry/releases/latest/download/go-containerregistry_Linux_x86_64.tar.gz \
-o go-containerregistry.tar.gz

  5. Execute os seguintes comandos para tornar o comando gcrane executável.

    tar -zxvf go-containerregistry.tar.gz
chmod +x gcrane
sudo mv gcrane /usr/local/bin/

  6. Execute o comando gcrane --help para verificar a instalação.

Agora você já pode copiar imagens. Para continuar:

Como configurar o Cloud Shell

  1. Abra uma janela do Cloud Shell.

    Abrir o Cloud Shell

  2. Defina o projeto padrão. Substitua PROJECT pelo ID do projeto em que o Container Registry e o Artifact Registry estão instalados.

    gcloud config set project PROJECT

  3. Execute o comando a seguir para fazer o download da ferramenta gcrane.

    curl -L \
https://github.com/google/go-containerregistry/releases/latest/download/go-containerregistry_Linux_x86_64.tar.gz \
-o go-containerregistry.tar.gz

  4. Execute os seguintes comandos para tornar o comando gcrane executável.

    tar -zxvf go-containerregistry.tar.gz
chmod +x gcrane
sudo mv gcrane /usr/local/bin/

  5. Execute o comando gcrane --help para verificar a instalação.

Agora você já pode copiar imagens. Para continuar:

Como configurar uma máquina local

  1. Faça o download do gcrane no repositório do GitHub. Por exemplo, o comando a seguir faz o download da distribuição Linux x86-64 na linha de comando.

    curl -L \
https://github.com/google/go-containerregistry/releases/latest/download/go-containerregistry_Linux_x86_64.tar.gz \
-o go-containerregistry.tar.gz

  2. Execute os seguintes comandos para tornar o comando gcrane executável. Os comandos presumem que o arquivo salvo é chamado de go-containerregistry.tar.gz.

    tar -zxvf go-containerregistry.tar.gz
chmod +x gcrane
sudo mv gcrane /usr/local/bin/

  3. Execute o comando gcrane --help para verificar a instalação.

Agora você já pode copiar imagens. Para continuar:

Como identificar imagens a serem copiadas

Depois de instalar o gcrane, é possível listar as imagens atuais no Container Registry para encontrar aquelas que você quer copiar.

Para listar as imagens atuais, execute o comando:

gcrane ls LOCATION.gcr.io/PROJECT

Para listar as tags de uma imagem, execute o comando:

gcrane ls LOCATION.gcr.io/PROJECT/IMAGE

Para listar as imagens recursivamente em um caminho específico, execute o comando:

gcrane ls -r LOCATION.gcr.io/PROJECT/PATH

Para cada um dos comandos:

  • Substitua LOCATION pela multirregião do registro: asia, eu ou us.
  • Substitua PROJECT pelo ID do projeto.

Veja os comandos para copiar suas imagens em Como copiar imagens.

Como copiar imagens

É possível copiar imagens individuais do Container Registry, todas as imagens em um caminho especificado em um local ou todas as imagens armazenadas em um local.

Como copiar uma única imagem

Para copiar uma única imagem com tag, execute o comando:

gcrane cp GCR-LOCATION.gcr.io/PROJECT/IMAGE \
AR-LOCATION.pkg.dev/PROJECT/REPOSITORY/IMAGE

Onde

  • GCR-LOCATION é a multirregião do host do Container Registry: asia, eu ou us.
  • AR-LOCATION é a região ou multirregião do repositório.
  • PROJECT é o ID do projeto;
  • REPOSITORY é o nome do repositório do Artifact Registry.
  • GCR-IMAGE é a imagem que você quer copiar a partir do Container Registry.
  • AR-IMAGE é o nome da imagem no Artifact Registry.

Por exemplo, considere a seguinte imagem de origem e destino:

  • Imagem do Container Registry: eu.gcr.io/my-project/my-image:tag1
  • Imagem do Artifact Registry: europe-docker.pkg.dev/my-project/my-repo/my-image:tag1

Execute o seguinte comando para copiar a imagem:

gcrane cp eu.gcr.io/my-project/my-image:tag1 \
europe-docker.pkg.dev/my-project/my-repo/my-image:tag1

Copiar todas as imagens em um caminho

Para copiar as imagens recursivamente em um caminho específico no Container Registry, execute o comando:

gcrane cp -r GCR-LOCATION.gcr.io/PROJECT/GCR-PATH \
AR-LOCATION.pkg.dev/PROJECT/REPOSITORY/AR-PATH

Onde

  • GCR-LOCATION é a multirregião do host do Container Registry: asia, eu ou us.
  • AR-LOCATION é a região ou multirregião do repositório.
  • PROJECT é o ID do projeto;
  • REPOSITORY é o nome do repositório do Artifact Registry.
  • GCR-PATH é o caminho dos arquivos que você quer copiar.
  • AR-PATH é o caminho das imagens no repositório do Artifact Registry.

Por exemplo, considere os seguintes caminhos de origem e destino:

  • Caminho do Container Registry: eu.gcr.io/my-project/test-images/testing
  • Caminho do Artifact Registry: europe-docker.pkg.dev/my-project/my-repo/test-images/testing

O comando a seguir copia de maneira recursiva todas as imagens em test-images/testing para o repositório my-repo:

gcrane cp -r eu.gcr.io/my-project/test-images/testing \
europe-docker.pkg.dev/my-project/my-repo/test-images/testing

Como copiar todas as imagens de um local do Container Registry

Para copiar todas as imagens de uma multirregião do Container Registry, execute o comando:

gcrane cp -r GCR-LOCATION.gcr.io/PROJECT \
AR-LOCATION.pkg.dev/PROJECT/REPOSITORY

Onde

  • GCR-LOCATION é a multirregião do host do Container Registry: asia, eu ou us.
  • AR-LOCATION é a região ou multirregião do repositório.
  • PROJECT é o ID do projeto;
  • REPOSITORY é o nome do repositório do Artifact Registry.

Se você quiser copiar imagens para mais de um local do Container Registry no projeto, execute o comando uma vez para cada host.

Por exemplo, considere o seguinte registro de origem e o repositório de destino do Artifact Registry. Neste exemplo, o Container Registry e o Artifact Registry estão em projetos diferentes.

  • Host do Container Registry: eu.gcr.io/my-project
  • Imagem do Artifact Registry: europe-docker.pkg.dev/new-project/my-repo

O comando a seguir copia todas as imagens da multirregião eu no projeto my-project para o repositório my-repo no projeto new-project.

gcrane cp -r eu.gcr.io/my-project \
europe-docker.pkg.dev/new-project/my-repo

Como copiar imagens com o Docker

Ao contrário dos métodos de cópia gcrane e gcloud, essa abordagem é um processo de duas etapas.

  1. Extraia uma imagem do Container Registry
  2. Envie a imagem para o repositório do Artifact Registry.

Requisitos

Verifique os seguintes requisitos:

  1. Você criou um repositório do Docker no Artifact Registry para as imagens que está copiando.

  2. Você tem as permissões necessárias:

    • Leitor de objetos do Storage (roles/storage.objectViewer) ou um papel com permissões equivalentes no bucket de armazenamento para para o host do Container Registry. Saiba como conceder essas permissões.

    • Gravador do Artifact Registry (roles/artifactregistry.writer) ou um papel com permissões equivalentes para o Artifact Registry repositório de dados. Saiba como conceder essas permissões.

  3. Você configurou o Docker para autenticação no Container Registry e no Artifact Registry.

Custos

Quando você extrai uma imagem, a transferência de dados de rede é cobrada. O preço específico depende do destino do comando pull. Por exemplo, se você extrair uma imagem de uma sessão do Cloud Shell, o preço é para transferência de dados de rede no Google Cloud. Se você extrair uma imagem para uma máquina fora do Google Cloud, consulte os preços para transferência de dados de rede geral.

Os comandos do Docker que você usa para marcar, enviar e extrair imagens no Artifact Registry são semelhantes aos usados no Container Registry. Há duas diferenças principais:

  • O nome do host para os repositórios do Docker do Artifact Registry incluem um prefixo de local seguido por -docker.pkg.dev. Os exemplos incluem australia-southeast1-docker.pkg.dev, europe-north1-docker.pkg.dev e europe-docker.pkg.dev.
  • Como o Artifact Registry oferece suporte a vários repositórios do Docker em um único é preciso especificar o nome do repositório nos comandos.

Para copiar uma imagem para o Artifact Registry com o Docker, extraia a imagem do Container Registry e envie-a ao repositório do Artifact Registry.

Por exemplo, considere uma imagem do Container Registry na multirregião eu e que você quer copiar para um repositório do Artifact Registry na região europe.

  • Imagem do Container Registry: eu.gcr.io/my-project/my-image:tag1
  • Imagem do Artifact Registry: europe-docker.pkg.dev/my-project/my-repo/my-image:tag1

O comando a seguir extrai a imagem do Container Registry.

docker pull eu.gcr.io/my-project/my-image:tag1

O comando a seguir envia a imagem ao repositório do Artifact Registry chamado my-repo.

docker push europe-north1-docker.pkg.dev/my-project/my-repo/my-image

É possível também enviar imagens para um repositório do Artifact Registry que você configurou em um projeto diferente. Esse exemplo envia a mesma imagem de origem para o repositório my-repo no projeto new-project.

docker push europe-north1-docker.pkg.dev/new-project/my-repo/my-image

Para mais detalhes sobre como enviar e extrair imagens no Artifact Registry, consulte Como enviar e extrair imagens.

Como copiar imagens com a gcloud

Use o comando gcloud container images add-tag para copiar uma imagem do Container Registry para o repositório do Artifact Registry.

Requisitos

Verifique os seguintes requisitos:

  1. Você criou um repositório do Docker em Artifact Registry para as imagens que você está copiando.

  2. Você tem as permissões necessárias:

    • Leitor de objetos do Storage (roles/storage.objectViewer) ou uma função com permissões equivalentes no bucket de armazenamento para o host do Container Registry. Saiba como conceder essas permissões.

    • Gravador do Artifact Registry (roles/artifactregistry.writer) ou um papel com permissões equivalentes para o Artifact Registry repositório de dados. Saiba como conceder essas permissões.

Custos

Se o Container Registry estiver em um local diferente repositório do Artifact Registry, cobranças de transferência de dados de rede se aplicam às imagens copiadas. Se os dois serviços estiverem no mesmo local, a rede a transferência de dados é gratuita.

Execute o seguinte comando para copiar uma imagem do Container Registry para o Artifact Registry:

gcloud container images add-tag GCR-IMAGE AR-IMAGE

Onde

  • GCR-IMAGE é o caminho completo para a imagem do Container Registry.
  • AR-IMAGE é o caminho completo para a imagem no repositório do Artifact Registry.

Por exemplo, considere as seguintes imagens de origem e destino:

  • Imagem do Container Registry: eu.gcr.io/my-project/my-image:tag1
  • Imagem do Artifact Registry: europe-docker.pkg.dev/my-project/my-repo/my-image:tag1

Esse comando copia a imagem do Container Registry na multirregião eu para o repositório my-repo na multirregião europe.

gcloud container images add-tag eu.gcr.io/my-project/my-image:tag1 \
europe-docker.pkg.dev/my-project/my-repo/my-image:tag1

Também é possível copiar imagens para um repositório do Artifact Registry que você configurou em um projeto diferente. Neste exemplo, a mesma imagem de origem é copiada para o repositório my-repo no projeto new-project.

gcloud container images add-tag eu.gcr.io/my-project/my-image:tag1 \
europe-docker.pkg.dev/new-project/my-repo/my-image:tag1

A seguir