Archiviare altri formati in Artifact Registry

Archiviare altri formati in Artifact Registry

Scopri come configurare un repository di formato generico di Artifact Registry e caricare un file YAML.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire i repository di pacchetti di Artifact Registry, chiedi all'amministratore di concederti il ruolo IAM Artifact Registry Administrator (roles/artifactregistry.admin) sul tuo progetto. 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.

Avvia Cloud Shell

Nella Google Cloud console, attiva Cloud Shell.

Attiva Cloud Shell

Nella parte inferiore della Google Cloud console viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

In questa guida rapida utilizzerai Cloud Shell per eseguire i comandi gcloud.

Crea un repository generico

1. Per creare un repository di formato generico denominato quickstart-generic-repo nella località us-central1 con la descrizione Generic repository, esegui il comando seguente:

   gcloud artifacts repositories create quickstart-generic-repo \
       --repository-format=generic \
       --location=us-central1 \
       --description="Generic repository"
   

2. Per verificare che il repository sia stato creato, esegui il comando seguente:

   gcloud artifacts repositories list
   

3. Per semplificare i comandi gcloud, esegui i comandi seguenti per impostare il repository predefinito su quickstart-generic-repo e la località predefinita su us-central1.

   1. Per impostare il repository predefinito su quickstart-generic-repo, esegui il comando seguente:

      gcloud config set artifacts/repository quickstart-generic-repo
      

   2. Per impostare la località predefinita su us-central1, esegui il comando seguente:

      gcloud config set artifacts/location us-central1
      

   Una volta impostati i valori, non è necessario specificarli nei comandi gcloud che richiedono un repository o una località.

Carica un artefatto nel repository

1. Nella tua directory home, crea un file da caricare nel repository:

   echo "hello world" > hello.yaml
   

2. Per caricare il file come artefatto nel repository, esegui il comando seguente:

   gcloud artifacts generic upload \
       --source=hello.yaml \
       --package=my-package \
       --version=1.0.0
   

   Dove:

   • hello.yaml è il percorso del file da caricare.
   • my-package è il pacchetto da caricare.
   • 1.0.0 è la versione dell'artefatto. Non puoi sovrascrivere una versione esistente nel repository.

Visualizza gli artefatti nel repository

Per verificare che l'artefatto sia stato aggiunto al repository, puoi elencare tutti gli artefatti eseguendo il comando seguente:

gcloud artifacts files list

La risposta include i dettagli del file nel formato PACKAGE:VERSION:FILE_NAME.

Nell'esempio seguente, hello.yaml è FILE_NAME:

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

Scarica un artefatto generico

Per scaricare un artefatto generico dal repository, esegui il comando seguente:

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

Dove:

• hello.yaml è il nome del file da scaricare.
• my-package è il pacchetto da scaricare.
• 1.0.0 è la versione dell'artefatto.

Sostituisci DESTINATION con la directory nel file system locale in cui vuoi salvare il download. La cartella di destinazione deve già esistere, altrimenti il comando non andrà a buon fine.

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse, oppure mantieni il progetto ed elimina il repository.

Elimina il progetto

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

Elimina un Google Cloud progetto:

gcloud projects delete PROJECT_ID

Elimina il repository

Prima di rimuovere un repository, assicurati che tutti i pacchetti che vuoi conservare siano disponibili in un'altra posizione.

1. Per eliminare il repository quickstart-generic-repo, esegui il comando seguente:

   gcloud artifacts repositories delete quickstart-generic-repo
   

2. Se vuoi rimuovere il repository predefinito e le impostazioni di localizzazione configurate per la configurazione gcloud attiva, esegui i comandi seguenti:

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

Passaggi successivi

• Scopri di più sugli artefatti generici