Resolução de problemas gerais

Saiba mais sobre os passos de resolução de problemas que se aplicam a todos os formatos de artefactos quando trabalha com o Artifact Registry. Para problemas específicos de um formato de artefacto, consulte a página específica do formato.

Repositório ou localização inválida nos comandos

Use as seguintes informações para ajudar a diagnosticar erros de localização do repositório inválida ou de nome do repositório inválido.

Predefinições de localização e repositório para o gcloud

Se definir um repositório e uma localização predefinidos na CLI Google Cloud, para poder omitir as flags --location e --repository dos comandos gcloud artifacts, experimente executar o comando com falha com as flags e os valores correspondentes. Para ver detalhes sobre a sintaxe de um comando específico, execute o comando com a flag --help.

A predefinição do repositório não se aplica aos comandos gcloud artifacts quando especifica um nome de repositório sem o sinalizador --repository. Por exemplo, tem de especificar o nome do repositório num comando gcloud artifacts repositories describe, como no exemplo seguinte:

gcloud artifacts repositories describe my-repo --location=us-west1

Se o comando continuar a falhar, pode ter de verificar se especificou valores válidos para o repositório ou a localização.

Localização do repositório

Para apresentar uma lista de todas as localizações do Artifact Registry suportadas, execute o comando:

gcloud artifacts locations list

A política da sua organização pode incluir restrições de localização. O Artifact Registry aplica estas restrições no momento da criação do repositório. O Artifact Registry não aplica a política retroativamente aos repositórios anteriores às restrições de localização.

Nomes de repositórios em comandos gcloud

Pode listar repositórios para ver os nomes dos repositórios num projeto especificado ou localização.

Para apresentar uma lista de todos os repositórios num projeto, execute o comando:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=all

Para apresentar uma lista de todos os repositórios numa localização, execute o comando:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=LOCATION

Substitua PROJECT-ID pelo seu Google Cloud ID do projeto e LOCATION pela localização do repositório.

O comando devolve informações para cada repositório semelhantes ao seguinte exemplo:

REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
LABELS:
ENCRYPTION: Google-managed key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10

O valor de REPOSITORY é o valor que usa com os comandos gcloud artifacts que incluem o nome do repositório como um parâmetro.

Por exemplo, este comando usa a flag --repository:

gcloud artifacts packages list --location=us-west1 --repository=my-repo

Este comando usa apenas o nome do repositório sem um sinalizador:

gcloud artifacts repositories describe my-repo --location=us-west1

Nomes de repositórios com clientes de terceiros

Para clientes de terceiros, geralmente, usa um caminho completo do repositório quando configura clientes, como us-west1-docker.pkg.dev/my-project/my-repo. Em seguida, segue as convenções do cliente para carregar e transferir pacotes. Para ver detalhes de configuração e utilização do cliente, consulte a documentação relativa ao formato com o qual está a trabalhar.

Se estiver a fazer a transição do Container Registry, tenha em atenção que todos os caminhos de imagens têm de incluir um nome de repositório do Artifact Registry. Não pode especificar um caminho de imagem que inclua apenas um ID do projeto.

  • Caminho inválido: us-east1-docker.pkg.dev/my-project/my-image
  • Caminho válido: us-east1-docker.pkg.dev/my-project/my-repo/my-image

Não é possível enviar nem extrair de repositórios não eliminados

Os repositórios deixam de funcionar corretamente depois de anular a eliminação de um projeto ou ativar a API Artifact Registry depois de a desativar. Google Cloud

Se desativar a API Artifact Registry ou eliminar o projeto, os serviços do Artifact Registry ficam indisponíveis. O Artifact Registry elimina os dados do repositório após 7 dias.

Saiba mais sobre a eliminação de dados no Google Cloud.