Archiviare pacchetti Python in Artifact Registry

Questa guida rapida illustra come configurare un repository Python di Artifact Registry privato, caricare un pacchetto e poi installarlo.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Artifact Registry API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Artifact Registry API.

    Enable the API

    8.

Avvia Cloud Shell

In questa guida rapida utilizzerai Cloud Shell, che è un ambiente shell per la gestione delle risorse in hosting in Google Cloud.

Cloud Shell include Google Cloud CLI e Python preinstallati. Google Cloud CLI fornisce l'interfaccia a riga di comando principale per Google Cloud.

Avvia Cloud Shell:

  1. Vai alla console Google Cloud.

    Console Google Cloud

  2. Nella barra degli strumenti della console Google Cloud, fai clic su Attiva Cloud Shell:

Si apre una sessione di Cloud Shell all'interno di un frame più in basso nella console. Utilizza questa shell per eseguire i comandi gcloud.

Installa i pacchetti richiesti

Twine è uno strumento per la pubblicazione di pacchetti Python. Utilizzerai Twine per caricare un pacco su Artifact Registry.

In questa guida rapida, utilizzerai l'installazione Python inclusa con in Cloud Shell. Questa installazione predefinita include il backend della chiave dell'Artifact Registry per gestire l'autenticazione con Artifact Registry. Se crei un ambiente virtuale o configuri Python al di fuori di Cloud Shell, devi installare il backend keyring per l'autenticazione. Per maggiori dettagli, vedi Autenticarsi con il portachiavi.

Per installare Twine, esegui il comando:

pip install twine

Ora puoi configurare Artifact Registry.

Crea un repository

Crea il repository per i tuoi pacchetti.

  1. Esegui questo comando per creare un nuovo repository di pacchetti Python nel progetto attuale denominato quickstart-python-repo nella località us-central1.

    gcloud artifacts repositories create quickstart-python-repo \
    --repository-format=python \
    --location=us-central1 \
    --description="Python package repository"

  2. Esegui questo comando per verificare che il repository sia stato creato:

    gcloud artifacts repositories list

  3. Per semplificare i comandi gcloud, imposta il repository predefinito su quickstart-python-repo e la località predefinita è us-central1. Una volta impostati i valori, non è necessario specificarli nei comandi gcloud che richiedono un repository o una posizione.

    Per impostare il repository, esegui il comando:

    gcloud config set artifacts/repository quickstart-python-repo

    Per impostare la località, esegui il comando:

    gcloud config set artifacts/location us-central1

    Per ulteriori informazioni su questi comandi, consulta la documentazione di gcloud config set.

Configura autenticazione

Il backend del keyring di Artifact Registry trova le tue credenziali utilizzando Credenziali predefinite dell'applicazione (ADC), una strategia che cerca le credenziali nel tuo ambiente.

In questa guida rapida imparerai a:

  • Genera le credenziali utente per ADC. In un ambiente di produzione, devi utilizzare un account di servizio e fornire le credenziali con la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS.
  • Includi l'URL del repository Artifact Registry nei comandi pip e twine in modo che non sia necessario configurare pip e Twine con il repository URL.

Per generare le credenziali per ADC, esegui il seguente comando:

gcloud auth application-default login

Per informazioni dettagliate sui metodi di autenticazione e sull'aggiunta di repository alla configurazione di pip e Twine, consulta Configurare l'autenticazione nei repository dei pacchetti Python.

Ottenere un pacchetto di esempio

Quando crei un progetto Python, i file di distribuzione vengono salvati in una dist sottodirectory del progetto Python. Per semplificare questa guida rapida, per scaricare file di pacchetti predefiniti.

  1. Crea una cartella del progetto Python denominata python-quickstart.

    mkdir python-quickstart

  2. Crea una sottodirectory denominata dist e passa alla directory.

    mkdir python-quickstart/dist
cd python-quickstart/dist

  3. Scarica i pacchetti Python di esempio utilizzati nel pacchetto Python Tutorial della guida dell'utente sulla creazione di pacchetti di progetti Python.

    pip download sampleproject

    Il comando scarica il pacchetto sampleproject e la sua dipendenza, peppercorn.

Carica il pacchetto nel repository

Usa Twine per caricare i pacchetti nel tuo repository.

  1. Dalla directory dist, passa alla directory python-quickstart principale .

    cd ..

  2. Carica i pacchetti nel repository dalla directory dist.

    python3 -m twine upload --repository-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/ dist/*

    Quando esegui il comando con python3 -m, Python individua twine e lo esegue. Se il comando twine è nel percorso di sistema, puoi eseguire senza python3 -m.

Twine carica sia sampleproject che peppercorn nel tuo repository.

Visualizza il pacchetto nel repository

Per verificare che il pacchetto sia stato aggiunto, elenca i pacchetti nel repository quickstart-python-repo.

Esegui questo comando:

gcloud artifacts packages list --repository=quickstart-python-repo

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

gcloud artifacts versions list --package=PACKAGE

Dove PACKAGE è l'ID pacchetto.

Installa il pacchetto

Esegui il seguente comando per installare il pacchetto:

pip install --index-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/simple/ sampleproject

Risoluzione dei problemi

Per impostazione predefinita, strumenti come pip e Twine non restituiscono messaggi di errore dettagliati. Se si verifica un errore, esegui nuovamente il comando con il flag --verbose per ottenere un output più dettagliato. Consulta: Risoluzione dei problemi per i pacchetti Python per ulteriori informazioni.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina, segui questi passaggi.

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

Per eliminare il repository:

  1. Per eliminare il repository quickstart-python-repo, esegui questo comando:

    gcloud artifacts repositories delete quickstart-python-repo

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

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

Passaggi successivi