Fazer o download de arquivos

Esta página descreve como fazer o download de arquivos individuais de repositórios padrão e remotos do Artifact Registry. O repositório pode ser de qualquer formato de artefato formato.

O download de arquivos pode ser útil quando você quer transferir arquivos para o ambiente local sem ferramentas específicas de formato. Ainda é necessário fazer a autenticação no Artifact Registry antes de baixar arquivos.

Arquivos disponíveis para download

É possível fazer o download de qualquer arquivo de dados ou metadados individual encontrado no repositório. Por exemplo, um repositório Maven armazena pacotes Java como artefatos. Todos os arquivos em um pacote Java, como arquivos jar e pom.xml, estão disponíveis para download individual.

Não recomendamos o uso desse recurso para artefatos que dependem muito de ferramentas do cliente para operações de download, como imagens do 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 papel do IAM de 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.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Listar arquivos

É possível listar arquivos em um repositório para ver o que está disponível para download.

Console

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

    Abrir a página Repositórios

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

  3. Clique no nome do pacote.

  4. Para ver os arquivos disponíveis para download de todas as versões do pacote, clique na guia Arquivos.

  5. Para ver os arquivos disponíveis para download de uma versão específica do pacote, clique no nome da versão e, em seguida, na guia Arquivos.

gcloud

Para todos os comandos a seguir, é possível definir um número máximo de arquivos a serem retornados adicionando a flag --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 local regional ou multirregional do repositório.
  • PROJECT: o ID do projeto Google Cloud . Se o ID do projeto tiver 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 flag --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. Se o ID do projeto tiver 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. A pasta de destino já precisa existir ou o comando vai falhar.
  • FILE: o nome completo do arquivo. Para encontrar este valor, execute o comando gcloud artifacts files list e copie 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 vai 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. Se o ID do projeto tiver 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. A pasta de destino já precisa existir ou o comando vai falhar.
  • FILE: o nome do arquivo codificado por URL. Para encontrar esse valor, execute o gcloud artifacts files list comando e copie o valor de FILE. Ele precisa ser convertido para o formato codificado por URL para esse 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 vai começar imediatamente.

A seguir