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.
- Imagens de contêiner: imagens de contêiner, gráficos do Helm
- Pacotes de linguagens: Java, Node.js, Python
- Pacotes do SO
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.
- Imagens de contêiner: Docker, Helm
- Pacotes de linguagem: Java, Node.js, Python, Go
- Pacotes do SO: Debian, RPM
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.