Nesta página, descrevemos como fazer o download de arquivos individuais de repositórios padrão e remotos do Artifact Registry. O repositório pode ter qualquer formato de artefato.
O download de arquivos pode ser útil quando você quer colocar arquivos no ambiente local sem ferramentas específicas de formato. Observe que você ainda precisa autenticar no Artifact Registry antes de fazer o download de arquivos.
Arquivos para download
É possível fazer o download de qualquer arquivo de metadados ou dados individuais encontrados no repositório. Por exemplo, um repositório Maven armazena pacotes Java como artefatos. Todos os arquivos dentro de um pacote Java, como arquivos jar e pom.xml, estão disponíveis individualmente para download.
O uso desse recurso não é recomendado para artefatos que dependem muito de ferramentas de cliente para operações de download, como imagens Docker.
Antes de começar
- (Opcional) Definir padrões para comandos da CLI gcloud.
Funções exigidas
Para receber as permissões necessárias para fazer o download de arquivos armazenados em um repositório,
peça ao administrador para conceder a você o papel do IAM de
Leitor do Artifact Registry (roles/artifactregistry.reader
) no repositório.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
Listar arquivos
Você pode listar os arquivos em um repositório para ver o que está disponível para download.
Para todos os comandos a seguir, defina um número máximo de arquivos a serem retornados adicionando a sinalização --limit
ao comando.
Para listar todos os arquivos no projeto, repositório e local padrão quando os valores padrão forem configurados:
gcloud artifacts files list
Para listar arquivos em um projeto, repositório e local especificados, execute o comando:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION
Para listar arquivos de todas as versões de um pacote específico:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE
Para listar arquivos de uma versão específica do pacote:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--version=VERSION
Substitua os seguintes valores:
LOCATION
: o regional ou multirregional local do repositório.PROJECT
: seuID de projeto no Google Cloud. Caso o ID do projeto contenha dois pontos (`:`), consulte Projetos com escopo de domínio.REPOSITORY
: o nome do repositório em que a imagem está armazenada.PACKAGE
: o nome do pacote.VERSION
: a versão do pacote.
Para repositórios do Docker, é possível listar arquivos de uma tag de imagem de contêiner específica adicionando a sinalização --tag
ao comando.
Para mais informações, consulte a lista de arquivos de artefatos da gcloud.
Fazer o download de arquivos
Para fazer o download de arquivos individuais de um repositório, execute o seguinte comando:
gcloud
Antes de usar os dados do comando abaixo, faça estas substituições:
PROJECT
: o ID do projeto do Google Cloud. Caso o ID do projeto contenha dois pontos (:
), consulte Projetos com escopo de domínio.LOCATION
: o local regional ou multirregional do repositório.REPOSITORY
: o nome do repositório em que o artefato está armazenado.DESTINATION
: o caminho para a pasta de destino no sistema de arquivos local. É necessário que a pasta de destino já exista. Caso contrário, o comando falhará.FILE
: o nome completo do arquivo. Para encontrar esse valor, execute o comandogcloud artifacts files list
e copie o valor deFILE
.
Execute o comando a seguir:
Linux, macOS ou Cloud Shell
gcloud artifacts files download \ --project=PROJECT \ --location=LOCATION \ --repository=REPOSITORY \ --destination=DESTINATION \ FILE
Windows (PowerShell)
gcloud artifacts files download ` --project=PROJECT ` --location=LOCATION ` --repository=REPOSITORY ` --destination=DESTINATION ` FILE
Windows (cmd.exe)
gcloud artifacts files download ^ --project=PROJECT ^ --location=LOCATION ^ --repository=REPOSITORY ^ --destination=DESTINATION ^ FILE
API
Antes de usar os dados da solicitação, faça as substituições a seguir:
PROJECT
: o ID do projeto do Google Cloud. Caso o ID do projeto contenha dois pontos (:
), consulte Projetos com escopo de domínio.LOCATION
: o local regional ou multirregional do repositório.REPOSITORY
: o nome do repositório em que o artefato está armazenado.DESTINATION
: o caminho para a pasta de destino no sistema de arquivos local. É necessário que a pasta de destino já exista. Caso contrário, o comando falhará.FILE
: o nome de arquivo codificado pelo URL. Para encontrar esse valor, execute o comandogcloud artifacts files list
e copie o valor deFILE
. Ele precisa ser convertido em um formato codificado para uso em URLs para esse comando. Por exemplo,path/to/file.jar
precisaria ser inserido comopath%2Fto%2Ffile.jar
.
Método HTTP e URL:
GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media
Para enviar a solicitação, expanda uma destas opções:
O download começará imediatamente.