Configurazione di un ambiente di sviluppo Python

Questo tutorial mostra come preparare la tua macchina locale per lo sviluppo con Python, incluso lo sviluppo di app Python eseguite su Google Cloud.

Se hai già configurato un ambiente di sviluppo, consulta Python e Google Cloud per una panoramica su come eseguire app Python su Google Cloud.

Suggerimento: se vuoi iniziare rapidamente, l'editor di Cloud Shell fornisce il supporto IDE per l'intero ciclo di sviluppo delle applicazioni Google Kubernetes Engine e Cloud Run. L'editor di Cloud Shell si basa su Code OSS e viene fornito con Google Cloud CLI e gli strumenti di Cloud Code preinstallati.

Obiettivi

  • Installa una versione di Python supportata compatibile con Google Cloud.
  • Utilizza venv per isolare le dipendenze.
  • Installa un editor (facoltativo).
  • Installa Google Cloud CLI (facoltativo).
  • (Facoltativo) Installa le librerie client di Cloud per Python.
  • Installa altri strumenti utili.
  • Configura l'autenticazione (facoltativo).

Installazione di Python

Le istruzioni di installazione di Python variano in base al sistema operativo. Segui la guida per il sistema operativo in esecuzione nel tuo ambiente di sviluppo, macOS, Windows o Linux.

macOS

macOS include una versione di Python per impostazione predefinita e la utilizza per i propri scopi. Per evitare interferenze con macOS, ti consigliamo di creare un ambiente di sviluppo separato e di installare una versione supportata di Python per Google Cloud. Per installare Python, utilizza homebrew.

  1. Per utilizzare Homebrew per installare i pacchetti Python, devi avere un compilatore, che puoi ottenere installando gli strumenti a riga di comando di Xcode.

    xcode-select --install

  2. Installa Homebrew seguendo le istruzioni riportate nella home page di Homebrew, quindi utilizza Homebrew per installare Python come segue:

    brew install pyenv
pyenv install PYTHON_VERSION

    Il numero di versione di Python deve essere nel formato x.y. Ad esempio:

    pyenv install 3.12

  3. Al termine delle installazioni, verifica che Python 3 sia disponibile come python e python3 e che sia installato anche pip.

    Per verificare che Python sia disponibile, esegui questo comando:

    python3 --version

    L'output mostra la versione. Puoi scoprire di più su Python Homebrew nella pagina Homebrew Python Formulae, quindi controllare la tua versione.

    Per verificare che pip3 sia disponibile, esegui questo comando:

    pip3 --version

    Se è installato, l'output mostra la versione di pip3. Per saperne di più sull'ultima versione di pip3, consulta le note di rilascio di pip.

    Se il comando precedente non mostra la versione di pip3, assicurati che pip3 sia installato correttamente. Se pip3 è installato, ma non funziona, esegui l'upgrade all'ultima versione utilizzando il seguente comando:

    python -m pip install --upgrade pip

    Homebrew installa le ultime versioni di Python disponibili sulla tua piattaforma. I numeri di versione negli output potrebbero essere diversi dalle ultime release ufficiali di Python.

Windows

  1. Per installare Python in un ambiente Windows, scarica il programma di installazione per la versione di Python di cui hai bisogno dal sito web di Python. Per saperne di più, consulta le versioni di Python supportate per Google Cloud.

  2. Per accedere alla tua versione di Python, utilizza il programma di avvio di Python per Windows.

    Per avviare la versione di Python che hai installato, esegui questo comando:

    py

    Per avviare la versione di Python 3 che hai installato, esegui questo comando:

    py -3

    Per verificare la versione di pip disponibile, esegui questo comando:

    py -m pip --version

    L'output mostra la versione di C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Puoi scoprire di più sull'ultima versione di pip nelle note di rilascio di pip.

Linux

La maggior parte delle distribuzioni Linux include versioni recenti di Python.

  1. Per installare Python in un ambiente Linux, installa i pacchetti appropriati per la tua distribuzione. Per Debian e Ubuntu, questi pacchetti sono python3, python3-dev, python3-venv e python3-pip,

    Installa questi pacchetti utilizzando i seguenti comandi:

    sudo apt update
sudo apt install python3 python3-dev python3-venv python3-pip

  2. Al termine delle installazioni, verifica di aver installato pip:

    pip3 --version

    Puoi scoprire di più sull'ultima versione di pip nelle note di rilascio di pip.

Utilizzo di venv per isolare le dipendenze

venv è uno strumento che crea ambienti Python isolati. Questi ambienti isolati possono avere versioni separate dei pacchetti Python, il che ti consente di isolare le dipendenze di un progetto da quelle di altri progetti. Ti consigliamo di utilizzare sempre un ambiente virtuale per progetto quando sviluppi localmente con Python.

  1. Utilizza il comando venv per creare una copia virtuale dell'intera installazione di Python. Questo tutorial crea una copia virtuale in una cartella denominata env, ma puoi specificare qualsiasi nome per la cartella.

    macOS

    cd your-project
python -m venv env

    Windows

    cd your-project
py -m venv env

    Linux

    cd your-project
python3 -m venv env

  2. Imposta la shell in modo che utilizzi i percorsi venv per Python attivando l'ambiente virtuale:

    macOS

    source env/bin/activate

    Windows

    .\env\Scripts\activate

    Linux

    source env/bin/activate

  3. Ora puoi installare i pacchetti senza influire su altri progetti o sulla tua installazione globale di Python:

    pip install google-cloud-storage

    Se vuoi interrompere l'utilizzo dell'ambiente virtuale e tornare al tuo Python globale, puoi disattivarlo:

    deactivate

Puoi scoprire di più su venv nella documentazione di venv.

Installazione di un editor

Per sviluppare app Python, devi avere un editor. Ecco alcuni degli editor più popolari (in ordine sparso):

Installazione delle librerie client di Cloud per Python

Le librerie client di Cloud per Python consentono agli sviluppatori Python di integrarsi con i servizi Google Cloud come Datastore e Cloud Storage. Per installare il pacchetto per una singola API come Cloud Storage, utilizza un comando simile al seguente:

pip install --upgrade google-cloud-storage

Installazione di gcloud CLI

gcloud CLI è un insieme di strumenti a riga di comando per Google Cloud. Contiene gcloud e bq, che puoi utilizzare per accedere a Compute Engine, Cloud Storage, BigQuery e altri prodotti e servizi dalla riga di comando. Puoi eseguire questi strumenti in modo interattivo o nei tuoi script automatizzati.

Configura l'autenticazione

Per utilizzare la libreria client, devi prima configurare l'autenticazione.

Crea credenziali di autenticazione locali per il tuo account utente: 

gcloud auth application-default login

Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per l'utilizzo delle librerie client.

(Facoltativo) Osservabilità

Google Cloud Observability include servizi di osservabilità che ti aiutano a comprendere il comportamento, l'integrità e le prestazioni delle tue applicazioni Python. Per saperne di più, consulta Google Cloud Observability per Python.

Passaggi successivi