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 local ou nome de repositório inválidos.

Padrões de local e repositório para gcloud

Se você definir um repositório e um local padrão na Google Cloud CLI para omitir as sinalizações --location e --repository gcloud artifacts, tente executar o comando que falhou com os flags e valores correspondentes. Para obter detalhes sobre a sintaxe de uma determinada execute o comando 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 flag --repository. Para exemplo, é necessário especificar o nome do repositório em um O comando gcloud artifacts repositories describe, como o exemplo a seguir:

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

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

Localização do repositório

Para listar todos os locais do Artifact Registry com suporte, execute o comando:

gcloud artifacts locations list

A política da sua 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 aos repositórios que antecedem as restrições de localização.

Nomes de repositórios em comandos gcloud

É possível listar repositórios para conferir os nomes 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 da seguinte forma: 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 comandos gcloud artifacts que incluem o nome do repositório como parâmetro.

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

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

Esse comando usa apenas o nome do repositório sem uma flag:

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

Nomes de repositórios com clientes de terceiros

Para clientes de terceiros, geralmente é necessário usar um caminho completo do repositório ao configuração de clientes, como us-east1-docker.pkg.dev/my-project/my-repo. Você e seguir as convenções do cliente para upload e download pacotes. Para detalhes de configuração e uso do cliente, consulte a documentação do formato com que você está trabalhando.

Se você estiver fazendo a transição do Container Registry, todos os caminhos de imagem precisam incluir um nome de repositório do Artifact Registry. Não é possível especificar um caminho de imagem que inclua apenas um ID de 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 funcionam mais corretamente depois que você desfaz a exclusão de um projeto do Google Cloud ou ativa a API Artifact Registry depois de desativá-la.

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

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