Fazer o download de arquivos

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

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

  1. Abra a página Repositórios no console do Google Cloud.

    Abrir a página Repositórios

  2. Na lista de repositórios, selecione o repositório.

  3. Clique no nome do pacote.

  4. Para conferir os arquivos para download de todas as versões do pacote, clique na guia Files.

  5. 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 comando gcloud artifacts files list e copiando o valor de FILE.

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
O download deve começar imediatamente.

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 comando gcloud artifacts files list e copie o valor de FILE. Deve ser convertido em formato codificado por URL para este comando, por exemplo, path/to/file.jar precisaria ser inserido como path%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.

A seguir