Configurazione di un ambiente di sviluppo Python

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

Obiettivi

  • Installa una versione di Python supportata compatibile con Google Cloud.
  • Utilizza venv per isolare le dipendenze.
  • (Facoltativo) Installa un editor.
  • Installa Google Cloud CLI (facoltativo).
  • (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 nell'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 pacchetti Python, devi disporre di un compilatore, che puoi ottenere installando gli strumenti da riga di comando di Xcode.

    xcode-select --install

  2. Installa Homebrew seguendo le istruzioni riportate nella home page di Homebrew, e poi usa 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. Una volta completate le 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 e poi 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 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 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 che ti serve 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 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 sull'installazione globale di Python:

    pip install google-cloud-storage

    Se vuoi smettere di utilizzare l'ambiente virtuale e tornare alla versione globale di Python, puoi disattivarlo:

    deactivate

Per saperne di più su venv, consulta la documentazione di venv.

Installare un editor

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

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. Include gcloud e bq, utili per accedere dalla riga di comando a Compute Engine, Cloud Storage, BigQuery e altri prodotti e servizi. 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.

If you're using a local shell, then create local authentication credentials for your user account: 

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Per saperne di più, consulta Autenticati per usare le librerie client.

Passaggi successivi