Questa pagina descrive come scaricare singoli file da Artifact Registry repository standard e repository remote. Il repository può essere in qualsiasi formato di artefatto.
Scaricare file può essere utile quando vuoi inserire file nel tuo senza strumenti specifici per il formato. 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 trovato nel tuo repository. Ad esempio, un Repository Maven archivierà i pacchetti Java come artefatti. Qualsiasi file all'interno di un pacchetto Java, come i file jar e pom.xml, sono individualmente disponibili 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
- (Facoltativo) Imposta i valori predefiniti per gcloud CLI comandi.
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.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
Elenco file
Puoi elencare i file di un repository per verificare quali file sono disponibili per il download.
console
Apri la pagina Repository nella console Google Cloud.
Seleziona il repository nell'elenco.
Fai clic sul nome del pacchetto.
Per visualizzare i file scaricabili per tutte le versioni del pacchetto, fai clic sull'icona File .
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 per 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
: il una o più regioni località del repository.PROJECT
: il tuo account Google Cloud ID progetto. Se l'ID progetto contiene i due punti (":"), vedi Progetti con ambito 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 questo 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 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 completo del file. Puoi trovare questo eseguendo il comandogcloud artifacts files list
e copiando il valore diFILE
.
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
API
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT
: il tuo account Google Cloud ID progetto. 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 per trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore perFILE
. Deve essere convertito in formato con codifica URL per questo comando, ad esempiopath/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 delle seguenti opzioni:
Il download dovrebbe iniziare immediatamente.