Questa pagina descrive come scaricare singoli file dai repository standard e remoti di Artifact Registry. 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 autenticarti ad Artifact Registry prima di scaricare i file.
File scaricabili
Puoi scaricare qualsiasi singolo file di dati o metadati trovato nel tuo repository. Ad esempio, un repository Maven memorizza 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'utilizzo di questa funzionalità non è consigliato per gli elementi che dipendono molto dagli strumenti client per le operazioni di download, come le immagini Docker.
Prima di iniziare
- (Facoltativo) Imposta i valori predefiniti per i comandi gcloud CLI.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per scaricare i file archiviati in un repository,
chiedi all'amministratore di concederti il ruolo IAM Lettore Artifact Registry (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 in un repository per vedere cosa è disponibile per il download.
console
Apri la pagina Repositories (Repositoi) nella console Google Cloud.
Nell'elenco dei repository, seleziona il repository.
Fai clic sul nome del pacchetto.
Per visualizzare i file scaricabili per tutte le versioni del pacchetto, fai clic sulla scheda File.
Per visualizzare i file scaricabili per una versione specifica del pacchetto, fai clic sul nome della versione e poi 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 nella località predefiniti quando i valori predefiniti sono configurati:
gcloud artifacts files list
Per elencare i file in un progetto, un repository e una posizione specificati, 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 di una versione specifica del pacchetto:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--version=VERSION
Sostituisci i seguenti valori:
LOCATION
: la località regionale o multiregionale del repository.PROJECT
: il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:
), consulta Progetti basati sul dominio.REPOSITORY
: il nome del repository in cui è memorizzata l'immagine.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, consulta l'elenco dei file degli elementi gcloud.
Scarica file
Per scaricare singoli file da un repository, esegui il seguente comando:
gcloud
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
PROJECT
: il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:
), consulta Progetti basati sul dominio.LOCATION
: la località regionale o multiregionale del repository.REPOSITORY
: il nome del repository in cui è archiviato l'elemento.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 file completo. Puoi trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore diFILE
.
Esegui il seguente comando:
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
API
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT
: il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:
), consulta Progetti basati sul dominio.LOCATION
: la località regionale o multiregionale del repository.REPOSITORY
: il nome del repository in cui è archiviato l'elemento.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 file codificato come URL. Puoi trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore diFILE
. Per questo comando deve essere convertito in formato con codifica URL. Ad esempio,path/to/file.jar
deve essere inserito comepath%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 di queste opzioni:
Il download dovrebbe iniziare immediatamente.Passaggi successivi
- Visualizzare ed elencare i repository
- Repository delle case discografiche
- Repositori di tag
- Eliminare i repository