Questa pagina descrive come archiviare artefatti immutabili con controllo delle versioni che non rispettano un formato di pacchetto specifico nei repository di formato generico di Artifact Registry.
Per acquisire familiarità con l'archiviazione di artefatti generici in Artifact Registry, puoi provare la guida rapida.
Gli artefatti generici sono file di qualsiasi formato, inclusi, a titolo esemplificativo:
- File compressi, come file tar e zip
- File di configurazione, come i file YAML e TOML
- File di testo e PDF
- Programmi binari
- Archivi
- File multimediali
A differenza di altri formati, gli artefatti archiviati nei repository in formato generico non sono destinati a essere utilizzati da Docker, dai gestori di pacchetti o da altri client di terze parti.
Prima di iniziare
- Crea un repository di formati generici.
- Verifica di disporre delle autorizzazioni richieste per il repository.
- (Facoltativo) Configura le impostazioni predefinite per i comandi Google Cloud CLI.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire gli artefatti generici, chiedi all'amministratore di concederti i seguenti ruoli IAM nel repository:
-
Visualizza artefatti:
Lettore Artifact Registry (
roles/artifactregistry.reader
) -
Scarica artefatti:
Lettore Artifact Registry (
roles/artifactregistry.reader
) -
Carica gli artefatti in un repository:
Scrittore Artifact Registry (
roles/artifactregistry.writer
) -
Elimina artefatti:
Amministratore repository Artifact Registry (
roles/artifactregistry.repoAdmin
)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Caricare artefatti generici
Puoi caricare artefatti generici singolarmente per file o in multipli per directory. Durante il caricamento, è necessario specificare un nome di pacchetto e un numero di versione. Puoi anche specificare il percorso nella struttura dei file di destinazione in cui caricarli. Se non viene specificato alcun percorso di destinazione, gli artefatti vengono caricati al livello principale per impostazione predefinita.
Per caricare artefatti generici nel repository, esegui questo 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 posizione regionale o multiregionale del repository.REPOSITORY
: il nome del repository in cui è archiviato l'artefatto.SOURCE
: la posizione e il nome del file che stai
caricando.PACKAGE
: il nome del pacchetto del file che stai
caricando.VERSION
: la versione del file che stai caricando.Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud artifacts generic upload \ --project=PROJECT \ --source=SOURCE \ --package=PACKAGE \ --version=VERSION \ --location=LOCATION \ --repository=REPOSITORY
Windows (PowerShell)
gcloud artifacts generic upload ` --project=PROJECT ` --source=SOURCE ` --package=PACKAGE ` --version=VERSION ` --location=LOCATION ` --repository=REPOSITORY
Windows (cmd.exe)
gcloud artifacts generic upload ^ --project=PROJECT ^ --source=SOURCE ^ --package=PACKAGE ^ --version=VERSION ^ --location=LOCATION ^ --repository=REPOSITORY
--destination-path=PATH
per il caricamento in una cartella specificata all'interno del pacchetto e della versione. Verranno create anche le cartelle che non esistono.--source-directory=SOURCE_DIR
per sostituire il flag--source
e caricare una directory anziché un singolo file.--skip-existing
quando utilizzi il flag--source-directory
per ignorare i file già esistenti. In caso contrario, il comando avrà esito negativo quando si tenta di caricare un file già esistente.
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 posizione regionale o multiregionale del repository.
- REPOSITORY è il nome del repository in cui è archiviato l'artefatto.
- SOURCE è la posizione e il nome del file che stai caricando.
- PACKAGE è il nome del pacchetto del file che stai caricando.
- VERSION è la versione del file che stai caricando.
- NAME è il nuovo nome del file nel repository.
Metodo HTTP e URL:
POST https://artifactregistry.googleapis.com/upload/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/genericArtifacts:create?alt=json
curl (Linux, macOS o Cloud Shell)
Per inviare la richiesta, esegui questo comando:
curl -v \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-F "meta={'filename':'NAME','package_id':'PACKAGE','version_id':'VERSION'};type=application/json" \
-F "blob=@SOURCE" \
https://artifactregistry.googleapis.com/upload/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSTIORY/genericArtifacts:create?alt=json
Elenca artefatti
console
Puoi visualizzare gli artefatti per i repository in formato generico nella consoleGoogle Cloud .
Apri la pagina Repository 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, quindi sulla scheda File.
gcloud
Puoi elencare gli artefatti in un repository con il comando gcloud artifacts files list
.
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 posizione regionale o multiregionale del repository.REPOSITORY
: il nome del repository in cui è archiviato l'artefatto.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud artifacts files list \ --project=PROJECT \ --location=LOCATION \ --repository=REPOSITORY
Windows (PowerShell)
gcloud artifacts files list ` --project=PROJECT ` --location=LOCATION ` --repository=REPOSITORY
Windows (cmd.exe)
gcloud artifacts files list ^ --project=PROJECT ^ --location=LOCATION ^ --repository=REPOSITORY
FILE: my-package:1.0.0:hello.yaml CREATE_TIME: 2023-03-09T20:55:07 UPDATE_TIME: 2023-03-09T20:55:07 SIZE (MB): 0.000 OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0
È anche possibile ordinare per versione e pacchetto aggiungendo uno o entrambi i seguenti flag:
--package=PACKAGE
per mostrare solo i file di un pacchetto specifico.--version=VERSION
per mostrare solo i file di una versione specifica.
Scarica artefatti generici
Per scaricare artefatti generici dal repository, esegui questo comando:
gcloud
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
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.LOCATION
: la posizione regionale o multiregionale del repository.REPOSITORY
: il nome del repository in cui è archiviato l'artefatto.PACKAGE
: il pacchetto del file da scaricare.VERSION
: la versione del file da scaricare.NAME
(facoltativo): il nome del file da scaricare. Senza questo flag, il comando scaricherà tutti i file per il pacchetto e la versione specificati e creerà le directory necessarie nella destinazione.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud artifacts generic download \ --destination=DESTINATION \ --location=LOCATION \ --repository=REPOSITORY \ --package=PACKAGE \ --version=VERSION \ --name=NAME
Windows (PowerShell)
gcloud artifacts generic download ` --destination=DESTINATION ` --location=LOCATION ` --repository=REPOSITORY ` --package=PACKAGE ` --version=VERSION ` --name=NAME
Windows (cmd.exe)
gcloud artifacts generic download ^ --destination=DESTINATION ^ --location=LOCATION ^ --repository=REPOSITORY ^ --package=PACKAGE ^ --version=VERSION ^ --name=NAME
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 posizione regionale o multiregionale 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 file codificato come URL. Puoi trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore diFILE
. Deve essere convertito nel formato con codifica URL per questo comando. Ad esempio,path/to/file.jar
dovrà 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.Eliminare gli artefatti generici
Per eliminare gli artefatti generici dal repository, esegui il comando gcloud artifacts
files delete
. Questo comando è disponibile solo per i repository in formato generico.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
FILE
: il nome completo del file. Puoi trovare questo valore eseguendo il comandogcloud artifacts files list
e copiando il valore diFILE
.LOCATION
: la posizione regionale o multiregionale del repository.REPOSITORY
: il nome del repository in cui è archiviato l'artefatto.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud artifacts files delete \ FILE \ --location=LOCATION \ --repository=REPOSITORY
Windows (PowerShell)
gcloud artifacts files delete ` FILE ` --location=LOCATION ` --repository=REPOSITORY
Windows (cmd.exe)
gcloud artifacts files delete ^ FILE ^ --location=LOCATION ^ --repository=REPOSITORY