Configurazione di un ambiente di sviluppo Python

Questo tutorial mostra come preparare la macchina locale per lo sviluppo Python, incluso lo sviluppo di app Python che vengono 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 Cloud Shell fornisce il supporto IDE per l'intero ciclo di sviluppo delle applicazioni Google Kubernetes Engine e Cloud Run. L'editor Cloud Shell è basato su Code OSS e viene fornito con gli strumenti Google Cloud CLI e Cloud Code preinstallati.

Obiettivi

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

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 installare una versione supportata di Python per Google Cloud. Per installare Python, utilizza homebrew.

  1. Per utilizzare homebrew per installare i pacchetti Python, devi disporre di 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 il comando seguente:

    python3 --version

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

    Per verificare che pip3 sia disponibile, esegui il comando seguente:

    pip3 --version

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

    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 comando seguente:

    python -m pip install --upgrade pip

    Homebrew installa le versioni più recenti di Python disponibili sulla tua piattaforma. I numeri di versione negli output potrebbero essere diversi da le 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 supportate di Python per Google Cloud.

  2. Per accedere alla tua versione di Python, utilizza Python Launcher per Windows.

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

    py

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

    py -3

    Per verificare la versione di pip disponibile, esegui il comando seguente:

    py -m pip --version

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

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

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 dalle dipendenze 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 sull'installazione globale di Python:

    pip install google-cloud-storage

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

    deactivate

Puoi scoprire di più su venv nella venv documentazione.

Installazione di un editor

Per sviluppare app Python, devi disporre di un editor. Ecco alcuni degli editor più diffusi (senza un ordine particolare):

Installazione delle librerie client di Cloud per Python

Le librerie client di Cloud per Python consentono agli sviluppatori Python di integrarsi con Google Cloud servizi 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

La 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.

Configurare l'autenticazione

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

Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente: 

gcloud auth application-default login

Non devi eseguire questa operazione se utilizzi Cloud Shell.

Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

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

Passaggi successivi