Transfira ficheiros

Esta página descreve como transferir ficheiros individuais de repositórios padrão e remotos do Artifact Registry. O repositório pode ser de qualquer formato de artefacto.

A transferência de ficheiros pode ser útil quando quer transferir ficheiros para o seu ambiente local sem ferramentas específicas de formato. Tenha em atenção que continua a ter de se autenticar no Artifact Registry antes de transferir ficheiros.

Ficheiros transferíveis

Pode transferir qualquer ficheiro de dados ou metadados individual encontrado no seu repositório. Por exemplo, um repositório Maven armazena pacotes Java como artefactos. Todos os ficheiros num pacote Java, como ficheiros JAR e ficheiros pom.xml, estão individualmente disponíveis para transferência.

A utilização desta funcionalidade não é recomendada para artefactos que dependam fortemente de ferramentas do cliente para operações de transferência, como imagens do Docker.

Antes de começar

Funções necessárias

Para obter as autorizações de que precisa para transferir ficheiros armazenados num repositório, peça ao seu administrador que lhe conceda a função do IAM Leitor do Artifact Registry (roles/artifactregistry.reader) no repositório. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Listar ficheiros

Pode listar os ficheiros num repositório para ver o que está disponível para transferência.

consola

  1. Abra a página Repositórios na Google Cloud consola.

    Abra 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 ficheiros transferíveis de todas as versões do pacote, clique no separador Ficheiros.

  5. Para ver ficheiros transferíveis de uma versão específica do pacote, clique no nome da versão e, de seguida, clique no separador Ficheiros.

gcloud

Para todos os comandos seguintes, pode definir um número máximo de ficheiros a devolver adicionando a flag --limit ao comando.

Para listar todos os ficheiros no projeto, repositório e localização predefinidos quando os valores predefinidos estão configurados:

gcloud artifacts files list

Para listar ficheiros num projeto, num repositório e numa localização especificados, execute o comando:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Para listar ficheiros de todas as versões de um pacote específico:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Para listar ficheiros de uma versão específica de um pacote:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Substitua os seguintes valores:

  • LOCATION: a localização regional ou multirregional do repositório.
  • PROJECT: o seu Google Cloud ID do projeto. Se o ID do projeto contiver dois pontos (:), consulte o artigo Projetos com âmbito de domínio.
  • REPOSITORY: o nome do repositório onde a imagem está armazenada.
  • PACKAGE: o nome do pacote.
  • VERSION: a versão do pacote.

Para repositórios do Docker, pode listar ficheiros para uma etiqueta de imagem de contentor específica adicionando o sinalizador --tag ao comando.

Para mais informações, consulte o artigo gcloud artifacts files list.

Transfira ficheiros

Para transferir ficheiros individuais de um repositório, execute o seguinte comando:

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • PROJECT: o seu Google Cloud ID do projeto. Se o ID do projeto contiver dois pontos (:), consulte o artigo Projetos com âmbito de domínio.
  • LOCATION: a localização regional ou multirregional do repositório.
  • REPOSITORY: o nome do repositório onde o artefacto está armazenado.
  • DESTINATION: o caminho para a pasta de destino no seu sistema de ficheiros local. A pasta de destino tem de existir ou o comando falha.
  • FILE: o nome completo do ficheiro. Pode encontrar este valor 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
 Deve ver a transferência começar imediatamente.

API

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT: o seu Google Cloud ID do projeto. Se o ID do projeto contiver dois pontos (:), consulte o artigo Projetos com âmbito de domínio.
  • LOCATION: a localização regional ou multirregional do repositório.
  • REPOSITORY: o nome do repositório onde o artefacto está armazenado.
  • DESTINATION: o caminho para a pasta de destino no seu sistema de ficheiros local. A pasta de destino tem de existir ou o comando falha.
  • FILE: o nome do ficheiro codificado por URL. Pode encontrar este valor executando o comando gcloud artifacts files list e copiando o valor de FILE. Tem de ser convertido para o formato codificado por URL para este comando. Por exemplo, path/to/file.jar tem de ser introduzido 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 o seu pedido, expanda uma destas opções:

Deve ver a transferência começar imediatamente.

O que se segue?