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 ajudar a diagnosticar erros de local de repositório ou nome de repositório inválido.

Padrões de local e repositório da 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 flags e os valores correspondentes. Para detalhes sobre a sintaxe de um comando específico, execute-o com a sinalização --help.

A configuração de 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, especifique o nome do repositório em um comando gcloudartifact DataStore 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 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 precedem as restrições de local.

Nomes de repositório em comandos gcloud

É possível listar repositórios para visualizar os nomes de repositório 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 exemplo a seguir:

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

Este comando usa o nome do repositório apenas 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 é usado um caminho de repositório completo ao configurar clientes, como us-east1-docker.pkg.dev/my-project/my-repo. Em seguida, você segue as convenções do cliente para fazer upload e download de 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, observe que 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 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 funcionam mais corretamente depois que você cancela a exclusão de um projeto do Google Cloud ou ativa a API Artifact Registry após desativá-la.

Se você desativar a API Artifact Registry ou excluir o projeto, os serviços do Artifact Registry vão ficar 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.