Nesta página, descrevemos como fazer o download de arquivos individuais do Artifact Registry. repositórios padrão e remotos. O repositório pode ter qualquer formato de artefato.
Fazer o download pode ser útil quando você quer transferir os arquivos para sem ferramentas específicas de formato. 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. Qualquer arquivo em um pacote Java, como arquivos jar e pom.xml, são individualmente disponível 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) Defina 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
o papel do IAM de Leitor de registro de artefatos (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.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Listar arquivos
Você pode listar os arquivos em um repositório para ver o que está disponível para download.
Console
Abra a página Repositórios no console do Google Cloud.
Na lista de repositórios, selecione o repositório.
Clique no nome do pacote.
Para conferir os arquivos para download de todas as versões do pacote, clique na guia Files.
Para acessar os arquivos para download de uma versão específica do seu pacote, clique em o nome da versão e, em seguida, clique na guia Arquivos.
gcloud
Para todos os comandos a seguir, você pode definir 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 quando os valores padrão estiverem 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 são armazenados.PACKAGE
: o nome do pacote.VERSION
: a versão do pacote.
Para repositórios do Docker, você pode listar arquivos para uma tag de imagem de contêiner específica
adicionando a sinalização --tag
ao comando.
Para mais informações, consulte gcloud artifacts files list.
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
: seu Google Cloud ID do projeto. Caso o ID do projeto contenha dois pontos (:
), consulte Projetos com escopo de domínio.LOCATION
: regional ou multirregional. local do repositório.REPOSITORY
: o nome do repositório. onde o artefato está armazenado.DESTINATION
: o caminho para o pasta de destino no seu sistema de arquivos local. A pasta de destino precisa já existir ou o comando vai falhar.FILE
: o nome completo do arquivo. Você encontra este executando o comandogcloud artifacts files list
e copiando o valor deFILE
.
Execute o seguinte comando:
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 abaixo, faça as substituições a seguir:
PROJECT
: seu Google Cloud ID do projeto. Caso o ID do projeto contenha dois pontos (:
), consulte Projetos com escopo de domínio.LOCATION
: regional ou multirregional. local do repositório.REPOSITORY
: o nome do repositório. onde o artefato está armazenado.DESTINATION
: o caminho para o pasta de destino no seu sistema de arquivos local. A pasta de destino precisa já existir ou o comando vai falhar.FILE
: o nome do arquivo codificado por URL. Você pode Para encontrar esse valor, execute o comandogcloud artifacts files list
e copie o valor deFILE
. Deve ser convertido em formato codificado por URL para este 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 deve começar imediatamente.