Gestisci i pacchetti Conda

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Dopo aver creato un repository Conda in Artifact Registry, potrai installare i pacchetti Conda nel nuovo repository. Questa pagina descrive come installare, visualizzare ed eliminare i pacchetti Conda.

Prima di iniziare

1. Installa e inizializza Google Cloud CLI.

   Per eseguire i comandi per i repository Conda è necessaria la versione 354.0.0 o successive di Google Cloud CLI. Puoi controllare la versione con il comando:

   gcloud version
   

2. Per utilizzare Conda CLI all'interno del tuo ambiente Google Cloud , installa uno dei seguenti gestori di pacchetti Conda:

   • Conda
   • Mamba
   • Micromamba
   • Miniforge

3. Se non hai un repository Conda in Artifact Registry, allora crea un repository di pacchetti Conda.

4. (Facoltativo) Imposta i valori predefiniti per i comandi gcloud.

Artifact Registry supporta i repository Conda standard e remoti. Puoi utilizzare uno dei seguenti indirizzi per i tuoi repository remoti.

• https://repo.anaconda.com/pkgs/main
• https://repo.anaconda.com/pkgs/r
• https://repo.anaconda.com/pkgs/msys2
• https://conda.anaconda.org/conda-forge
• https://conda.anaconda.org/bioconda

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i pacchetti Conda, chiedi all'amministratore di concederti i seguenti ruoli IAM sul repository:

• Visualizza pacchetti o file nei pacchetti: Artifact Registry Reader (roles/artifactregistry.reader)
• Scaricare o installare pacchetti: Artifact Registry Reader (roles/artifactregistry.reader)
• Aggiungi pacchetti a un repository: Artifact Registry Writer (roles/artifactregistry.writer)
• Elimina pacchetti: 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.

Gestisci i pacchetti Conda

Dopo aver aggiunto un pacchetto Conda al repository Artifact Registry, puoi installarlo nel tuo ambiente Conda e visualizzare i dettagli del pacchetto utilizzando Google Cloud.

Aggiungere pacchetti a un repository Artifact Registry

Per aggiungere un pacchetto Conda al repository Artifact Registry, esegui questo comando:

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Dove:

• REPO_NAME è l'ID del repository.
• PROJECT è l'ID del progetto contenente il repository.
• LOCATION è la posizione regionale o multiregionale del repository.

Per aggiungere più pacchetti contemporaneamente:

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Dove:

• DIRECTORY è l'indirizzo di una cartella locale contenente i tuoi pacchetti Conda.

Installa pacchetti

Modalità repository: standard, remoto

Per installare l'ultima release stabile di un pacchetto nel tuo ambiente Conda, esegui questo comando:

Conda

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Miniforge

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Mamba

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Micromamba

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Dove:

• ENVIRONMENT_NAME è il nome del tuo ambiente Conda. Se hai già attivato un ambiente e stai installando il pacchetto direttamente nell'ambiente, puoi omettere -n ENVIRONMENT_NAME.

• PACKAGE_NAME è il nome del pacchetto Conda.

  Per installare una versione specifica di un pacchetto nell'ambiente Conda, includi VERSION dopo il nome del pacchetto.

Per i repository standard, scarichi un pacchetto direttamente dal repository.

Per un repository remoto, scarichi una copia memorizzata nella cache del pacchetto e delle relative dipendenze. Se non esiste una copia memorizzata nella cache, il repository remoto scarica il pacchetto dalla sorgente upstream e lo memorizza nella cache prima di fornirtelo. Puoi verificare che il repository remoto abbia recuperato i pacchetti dalla sorgente upstream visualizzando l'elenco dei pacchetti nel repository.

Visualizzare pacchetti e versioni

Modalità repository: standard, remoto

Per visualizzare i pacchetti e le versioni dei pacchetti utilizzando la Google Cloud console o gcloud:

Console

1. Apri la pagina Repository nella Google Cloud console.

   Apri la pagina Repositori

2. Nell'elenco dei repository, fai clic sul repository appropriato.

   La pagina Pacchetti elenca i pacchetti nel repository.

3. Fai clic su un pacchetto per visualizzarne le versioni.

gcloud

Per elencare i pacchetti in un repository, esegui questo comando:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Sostituisci quanto segue:

• REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.
• LOCATION è la località regionale o multiregionale del repository. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare quella predefinita.

Per visualizzare le versioni di un pacchetto, esegui questo comando:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Sostituisci quanto segue:

• PACKAGE è l'ID del pacchetto o l'identificatore completo del pacchetto.
• REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.
• LOCATION è la località regionale o multiregionale del repository. Utilizza questo flag per visualizzare i repository in una località specifica. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare quella predefinita.

Per i repository remoti, l'elenco restituito mostra solo i pacchetti memorizzati nella cache.

Elenco file

Modalità repository: standard, remoto

Per i repository remoti, l'elenco restituito mostra solo i pacchetti Conda memorizzati nella cache e i file indice.

Puoi elencare i file in un repository, i file in tutte le versioni di un pacchetto specificato o i file in una versione specifica di un pacchetto.

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 posizione predefiniti quando sono configurati i valori predefiniti:

gcloud artifacts files list

Per elencare i file in un progetto, un repository e una località 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 versione specifica del pacchetto:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Sostituisci i seguenti valori:

• LOCATION: la posizione 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 è archiviata l'immagine.
• PACKAGE: il nome del pacchetto.
• VERSION: la versione del pacchetto.

Esempi

Considera le seguenti informazioni sul pacchetto:

• Progetto: my-project
• Repository: my-repo
• Posizione del repository: us-west1
• Pacchetto: my-app

Il comando seguente elenca tutti i file nel repository my-repo nella posizione us-west1 all'interno del progetto predefinito:

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

Il comando seguente elenca i file nella versione 1.0 del pacchetto.

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

Elimina pacchetti e versioni

Modalità repository: standard, remoto

Puoi eliminare un pacchetto e tutte le relative versioni oppure eliminare una versione specifica. I pacchetti eliminati non possono essere ripristinati.

Prima di eliminare un pacchetto o una versione del pacchetto, verifica di aver comunicato o risolto eventuali dipendenze importanti.

Per eliminare un pacchetto:

Console

1. Apri la pagina Repository nella Google Cloud console.

   Apri la pagina Repositori

2. Nell'elenco dei repository, fai clic sul repository appropriato.

   La pagina Pacchetti elenca i pacchetti nel repository.

3. Seleziona il pacchetto che vuoi eliminare.

4. Fai clic su ELIMINA.

5. Nella finestra di dialogo di conferma, fai clic su ELIMINA.

gcloud

Esegui questo comando:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Sostituisci quanto segue:

• PACKAGE è il nome del pacchetto nel repository.
• REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, allora puoi omettere questo flag per utilizzare quello predefinito.
• LOCATION è la località regionale o multiregionale del repository. Utilizza questo flag per visualizzare i repository in una località specifica. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare quella predefinita.

Il flag --async fa sì che il comando venga restituito immediatamente, senza attendere il completamento dell'operazione in corso.

Per eliminare le versioni di un pacchetto:

Console

1. Apri la pagina Repository nella Google Cloud console.

   Apri la pagina Repositori

2. Nell'elenco dei repository, fai clic sul repository appropriato.

   La pagina Pacchetti elenca i pacchetti nel repository.

3. Fai clic su un pacchetto per visualizzarne le versioni.

4. Seleziona le versioni che vuoi eliminare.

5. Fai clic su ELIMINA.

6. Nella finestra di dialogo di conferma, fai clic su ELIMINA.

gcloud

Esegui questo comando:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Sostituisci quanto segue:

• VERSION è il nome della versione da eliminare.
• PACKAGE è il nome del pacchetto nel repository.
• REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, allora puoi omettere questo flag per utilizzare quello predefinito.
• LOCATION è la località regionale o multiregionale del repository. Utilizza questo flag per visualizzare i repository in una località specifica. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare quella predefinita.

Il flag --async fa sì che il comando venga restituito immediatamente, senza attendere il completamento dell'operazione in corso.

Per i repository remoti, Artifact Registry elimina i dati di memorizzazione nella cache per i pacchetti selezionati, inclusi file e versioni dei pacchetti.

Passaggi successivi

• Scopri di più sulla gestione delle immagini container
• Scaricare singoli file all'interno di un pacchetto