Nesta página, descrevemos como acessar e listar repositórios do Artifact Registry.
Antes de começar
- (Opcional) Configure padrões para comandos gcloud.
Funções exigidas
Para ter as permissões necessárias para visualizar e listar repositórios, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
Acessar e listar todos os repositórios em um projeto do Google Cloud:
Leitor do Artifact Registry (
roles/artifactregistry.reader
) no projeto -
Para acessar um repositório específico:
Leitor do Artifact Registry (
roles/artifactregistry.reader
) no repositório
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esses papéis predefinidos contêm as permissões necessárias para visualizar e listar repositórios. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para visualizar e listar repositórios:
-
artifactregistry.repositories.get
-
artifactregistry.repositories.list
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Como visualizar repositórios
É possível visualizar os repositórios em um projeto do Google Cloud.
Para ver uma lista de repositórios:
Console
Abra a página Repositórios no console do Google Cloud.
A página exibe uma lista dos seus repositórios.
Para filtrar a lista de repositórios do Artifact Registry:
- Acima da lista de repositórios, clique em Filtrar tabela.
- Escolha um filtro na lista de filtros.
- Especifique o valor que você quer usar para filtrar a lista.
gcloud
Para listar os repositórios atuais, execute este comando:
gcloud artifacts repositories list [--project=PROJECT] \ [--location=LOCATION]
Para visualizar o tipo de criptografia configurada para um repositório, execute o seguinte comando:
gcloud artifacts repositories describe REPOSITORY \ [--project=PROJECT] [--location=LOCATION]
Nesses comandos, substitua os seguintes valores:
- PROJECT é o ID do projeto; Se essa sinalização for omitida, o projeto atual ou padrão será usado.
- REPOSITORY é o nome do repositório.
LOCATION é um local regional. Use esta sinalização para ver repositórios em um local específico. Também é possível usar
--location=all
para listar repositórios em todos em vários locais.Se você omitir essa sinalização, o comando usará o local padrão se houver um padrão configurado. Caso contrário, a omissão dessa sinalização lista repositórios em todos os locais.
Para mais informações sobre o comando, execute o seguinte comando:
gcloud artifacts repositories list --help
A seguir
- Configure o acesso aos seus repositórios.
- Fazer o download de arquivos individuais em artefatos armazenados nos repositórios.
- Saiba como restringir downloads de artefatos com regras de download.