Archiviare i 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
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry API.
Avvia Cloud Shell
In questa guida rapida utilizzerai Cloud Shell, che è un ambiente shell per la gestione delle risorse ospitate su 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:
Vai alla console Google Cloud.
Nella barra degli strumenti della console Google Cloud, fai clic su Attiva Cloud Shell:
Una sessione di Cloud Shell si apre in un frame nella parte inferiore della 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 pacchetto su Artifact Registry.
In questa guida rapida utilizzerai l'installazione di Python inclusa 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 pacchetti.
Esegui il comando seguente per creare un nuovo repository di pacchetti Python nel progetto corrente denominato
quickstart-python-repo
nella posizioneus-central1
.gcloud artifacts repositories create quickstart-python-repo \ --repository-format=python \ --location=us-central1 \ --description="Python package repository"
Esegui questo comando per verificare che il repository sia stato creato:
gcloud artifacts repositories list
Per semplificare i comandi
gcloud
, imposta il repository predefinito suquickstart-python-repo
e la posizione predefinita suus-central1
. Una volta impostati i valori, non è necessario specificarli nei comandigcloud
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 portachiavi di Artifact Registry trova le tue credenziali utilizzando le 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 l'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
etwine
in modo da non dover configurare pip e Twine con l'URL del repository.
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 sottodirectory dist
del progetto Python. Per semplificare questa guida rapida, download file del pacchetto precompilato.
Crea una cartella del progetto Python denominata
python-quickstart
.mkdir python-quickstart
Crea una sottodirectory denominata
dist
, quindi passa a quella directory.mkdir python-quickstart/dist cd python-quickstart/dist
Scarica i pacchetti Python di esempio utilizzati nel tutorial della Guida utente del packaging di Python Pacchettizzazione di progetti Python.
pip download sampleproject
Il comando scarica il pacchetto
sampleproject
e la relativa dipendenzapeppercorn
.
Carica il pacchetto nel repository
Utilizza Twine per caricare i pacchetti nel repository.
Dalla directory
dist
, passa alla directory principalepython-quickstart
.cd ..
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 comandotwine
è nel percorso di sistema, puoi eseguire senzapython3 -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 riscontri un errore, esegui di nuovo il comando con il flag --verbose
per ottenere un output più dettagliato. Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi relativi ai pacchetti Python.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate su 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:
Per eliminare il repository
quickstart-python-repo
, esegui questo comando:gcloud artifacts repositories delete quickstart-python-repo
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
- Scopri di più sulla configurazione dell'autenticazione
- Scopri di più sulla gestione dei repository
- Scopri di più sulla gestione dei pacchetti
- Leggi le nostre risorse su DevOps ed esplora il nostro programma di ricerca.