Questa pagina descrive come scaricare singoli file dai repository standard e remoti di Artifact Registry. Il repository può essere in qualsiasi formato artefatto.
Il download dei file può essere utile quando vuoi ricevere file nel tuo ambiente locale senza strumenti specifici per il formato. Tieni presente che devi comunque eseguire l'autenticazione in Artifact Registry prima di scaricare i file.
File scaricabili
Puoi scaricare qualsiasi singolo file di dati o metadati trovato nel repository. Ad esempio, un repository Maven archivierà i pacchetti Java come artefatti. Tutti i file all'interno di un pacchetto Java, ad esempio i file jar e i file pom.xml, sono disponibili singolarmente per il download.
L'utilizzo di questa funzionalità non è consigliato per gli artefatti che dipendono fortemente dagli strumenti del 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 il ruolo IAM Lettore di Artifact Registry (roles/artifactregistry.reader
) per il repository.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Elenco file
Puoi elencare i file di un repository per vedere quali file sono disponibili per il download.
Per tutti i comandi seguenti, puoi impostare il numero massimo di file da restituire
aggiungendo il flag --limit
al comando.
Per elencare tutti i file nel progetto, nel repository e nella posizione predefiniti quando sono configurati i valori predefiniti:
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 relativi a 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à a livello di una o più regioni del repository.PROJECT
: il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (:
), consulta Progetti con ambito di dominio.REPOSITORY
: il nome del repository in cui è archiviata l'immagine.PACKAGE
: il nome del pacchetto.VERSION
: la versione del pacchetto.
Per i repository Docker, puoi elencare i file relativi a uno specifico tag immagine container aggiungendo il flag --tag
al comando.
Per maggiori informazioni, consulta gcloud artefatti file list.
Scarica i file
Per scaricare singoli file da un repository, esegui questo comando:
gcloud
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
PROJECT
: il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (:
), consulta Progetti con ambito di dominio.LOCATION
: la località a livello di una o più regioni 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 avrà esito negativo.FILE
: il nome completo del file. Puoi trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore perFILE
.
Esegui questo 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, effettua le seguenti sostituzioni:
PROJECT
: il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (:
), consulta Progetti con ambito di dominio.LOCATION
: la località a livello di una o più regioni 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 avrà esito negativo.FILE
: il nome del file con codifica URL. Puoi trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore perFILE
. Deve essere convertito nel formato con codifica URL per questo comando, ad esempiopath/to/file.jar
deve essere inserito comepath%2Fto%2Ffile.jar
.
Metodo HTTP e URL:
GET http://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
- Assegna etichette ai repository
- Repository di tag
- Eliminare i repository