Solução de problemas gerais

Saiba mais sobre as etapas de solução de problemas que se aplicam a todos os formatos de artefato ao trabalhar com o Artifact Registry. Para problemas específicos de um formato de artefato, consulte a página específica do formato.

Repositório ou local inválido nos comandos

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

Padrões de localização e repositório do gcloud

Se você definir um repositório e um local padrão na Google Cloud CLI para omitir as sinalizações --location e --repository dos comandos gcloud artifacts, tente executar o comando que falhou com as sinalizações e os valores correspondentes. Para mais detalhes sobre a sintaxe de um comando específico, execute-o com a sinalização --help.

A configuração do repositório padrão não se aplica aos comandos gcloud artifacts em que você especifica um nome de repositório sem a sinalização --repository. Por exemplo, é preciso especificar o nome do repositório em um comando gcloud artefatos repository describe como o seguinte exemplo:

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

Se o comando ainda falhar, talvez seja necessário verificar se você especificou valores válidos para o repositório ou local.

Localização do repositório

Para listar todos os locais compatíveis com o Artifact Registry, execute o comando:

gcloud artifacts locations list

A política da organização pode incluir restrições de local. O Artifact Registry aplica essas restrições no momento da criação do repositório. O Artifact Registry não aplica a política retroativamente em repositórios que antecedem as restrições de local.

Nomes de repositório em comandos gcloud

Você pode listar repositórios para ver os nomes deles em um projeto ou local especificado.

Para listar todos os repositórios em um projeto, execute o comando:

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

Para listar todos os repositórios em um local, execute o comando:

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

Substitua PROJECT-ID pelo ID do projeto do Google Cloud e LOCATION pelo local do repositório.

O comando retorna informações para cada repositório semelhante ao seguinte exemplo:

REPOSITORY: my-repo
FORMAT: MAVEN
DESCRIPTION:
LOCATION: us-east1
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 usado com os comandos gcloud artifacts que incluem o nome do repositório como um parâmetro.

Por exemplo, este comando usa a sinalização --repository:

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

Este comando usa o nome do repositório somente sem uma sinalização:

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

Nomes de repositório com clientes de terceiros

Para clientes de terceiros, geralmente use um caminho de repositório completo ao configurar clientes, como us-east1-docker.pkg.dev/my-project/my-repo. Em seguida, siga as convenções do cliente para fazer o upload e o download de pacotes. Para detalhes sobre uso e configuração do cliente, consulte a documentação do formato em que você está trabalhando.

Se você estiver fazendo a transição do Container Registry, observe que todos os caminhos de imagens precisam incluir um nome de repositório do Artifact Registry. Não é possível 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 ou extrair de repositórios não excluídos

Os repositórios não funcionarão mais corretamente depois que você cancelar a exclusão de um projeto do Google Cloud ou ativar a API Artifact Registry depois de desativá-lo.

Se você desativar a API Artifact Registry ou excluir o projeto, os serviços do Artifact Registry ficarão indisponíveis. O Artifact Registry exclui os dados do repositório após sete dias.

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