Fazer o download de arquivos

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 transferir arquivos para o ambiente local sem ferramentas específicas de formato. Observe que você ainda precisa fazer a autenticação no Artifact Registry antes de fazer o download de arquivos.

Arquivos para download

Você pode fazer o download de quaisquer dados individuais ou arquivos de metadados encontrados no seu repositório. Por exemplo, um repositório Maven armazenará pacotes Java como artefatos. Todos os arquivos em 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 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 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 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.

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 do projeto, do repositório e do local padrão 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 os 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: 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 do 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 ou o comando falhe.
  • FILE: o nome do arquivo completo. Para encontrar esse valor, execute o comando gcloud artifacts files list e copie o valor para 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 começará imediatamente.

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 ou o comando falhe.
  • FILE: o nome do arquivo codificado pelo URL. Para encontrar esse valor, execute o comando gcloud artifacts files list e copie o valor para FILE. Ele precisa ser convertido em formato codificado de 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 começará imediatamente.

A seguir