Scarica file

Questa pagina descrive come scaricare singoli file da Artifact Registry repository standard e repository remote. Il repository può essere di qualsiasi formato di artefatto.

Il download dei file può essere utile quando vuoi trasferire file nel tuo ambiente locale senza strumenti specifici per i formati. Tieni presente che devi comunque autenticarsi in Artifact Registry prima di scaricare i file.

File scaricabili

Puoi scaricare qualsiasi singolo file di dati o metadati presente nel tuo repository. Ad esempio, un Repository Maven archivierà i pacchetti Java come artefatti. Tutti i file all'interno di un pacchetto Java, come i file JAR e pom.xml, sono individualmente disponibile per il download.

L'uso di questa funzionalità non è consigliato per gli artefatti che dipendono fortemente di strumenti client per le operazioni di download, come le immagini Docker.

Prima di iniziare

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per scaricare i file archiviati in un repository, chiedi all'amministratore di concederti Ruolo IAM Artifact Registry Reader (roles/artifactregistry.reader) nel repository. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Elenco file

Puoi elencare i file di un repository per verificare quali file sono disponibili per il download.

console

  1. Apri la pagina Repositories (Repositoi) nella console Google Cloud.

    Apri la pagina Repository

  2. Nell'elenco dei repository, seleziona il repository.

  3. Fai clic sul nome del pacchetto.

  4. Per visualizzare i file scaricabili per tutte le versioni del pacchetto, fai clic sulla scheda File.

  5. Per visualizzare i file scaricabili relativi a una versione specifica del pacchetto, fai clic su il nome della versione e poi fai clic sulla scheda File.

gcloud

Per tutti i comandi seguenti, puoi impostare un numero massimo di file da restituire aggiungendo il flag --limit al comando.

Per elencare tutti i file nel progetto, nel repository e posizione quando sono configurati i valori predefiniti:

gcloud artifacts files list

Per elencare i file in un progetto, un repository e una posizione specifici, esegui il comando:

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

Per elencare i file di tutte le versioni di un pacchetto specifico:

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

Per elencare i file per una specifica versione del pacchetto:

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

Sostituisci i seguenti valori:

  • LOCATION: la località del repository a livello di una o più regioni.
  • PROJECT: il tuo ID progetto Google Cloud. Se l'ID progetto contiene due punti (`:`), consulta Progetti basati sul dominio.
  • REPOSITORY: il nome del repository in cui è stata creata l'immagine viene archiviato.
  • PACKAGE: il nome del pacchetto.
  • VERSION: la versione del pacchetto.

Per i repository Docker, puoi elencare i file per un tag immagine container specifico aggiungendo il flag --tag al comando.

Per ulteriori informazioni, vedi gcloud artefatti files list.

Scarica file

Per scaricare singoli file da un repository, esegui il seguente comando:

gcloud

Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:

  • PROJECT: il tuo account Google Cloud ID progetto. Se l'ID progetto contiene due punti (:), consulta Progetti basati sul dominio.
  • LOCATION: a livello di una o più regioni località del repository.
  • REPOSITORY: il nome del repository in cui è archiviato l'artefatto.
  • DESTINATION: il percorso della cartella di destinazione nel file system locale. La cartella di destinazione deve già esistere, altrimenti il comando non andrà a buon fine.
  • FILE: il nome completo del file. Puoi trovare questo valore eseguendo il comando gcloud artifacts files list e copiando il valore di FILE.

Esegui la persone che seguo :

Linux, macOS o 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
 Il download dovrebbe iniziare immediatamente.

API

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (:), consulta Progetti con ambito dominio.
  • LOCATION: a livello di una o più regioni località del repository.
  • REPOSITORY: il nome del repository in cui è archiviato l'artefatto.
  • DESTINATION: il percorso cartella di destinazione nel tuo file system locale. La cartella di destinazione deve esistere già oppure non riuscirà.
  • FILE: il nome file codificato nell'URL. Puoi trovare questo valore eseguendo il comando gcloud artifacts files list e copiando il valore di FILE. Deve essere convertito in formato con codifica URL per questo comando, ad esempio path/to/file.jar deve essere inserito come path%2Fto%2Ffile.jar.

Metodo HTTP e URL: 

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

Per inviare la richiesta, espandi una delle seguenti opzioni:

Il download dovrebbe iniziare immediatamente.

Passaggi successivi