Python-Entwicklungsumgebung einrichten

In dieser Anleitung wird beschrieben, wie Sie Ihren lokalen Computer für die Entwicklung mit Python vorbereiten, einschließlich der Entwicklung von Python-Anwendungen, die auf Google Cloudausgeführt werden.

Wenn Sie bereits eine Entwicklungsumgebung eingerichtet haben, finden Sie unter Python und Google Cloud eine Übersicht zur Ausführung von Python-Anwendungen auf Google Cloud.

Tipp: Wenn Sie schnell starten möchten, bietet der Cloud Shell-Editor IDE-Unterstützung für den gesamten Entwicklungszyklus von Google Kubernetes Engine- und Cloud Run-Anwendungen. Der Cloud Shell-Editor basiert auf Code OSS und ist mit der Google Cloud CLI und Cloud Code-Tools vorinstalliert.

Ziele

  • Installieren Sie eine unterstützte Version von Python, die mit Google Cloudkompatibel ist.
  • Abhängigkeiten mit venv isolieren.
  • Editor installieren (optional)
  • Installieren Sie die Google Cloud CLI (optional).
  • Die Cloud-Clientbibliotheken für Python installieren (optional)
  • Andere nützliche Tools installieren
  • Richten Sie die Authentifizierung ein (optional).

Python installieren

Die Installationsanleitungen von Python sind je nach Betriebssystem unterschiedlich. Folgen Sie der Anleitung für das Betriebssystem, das Sie in Ihrer Entwicklungsumgebung verwenden, macOS, Windows oder Linux.

macOS

MacOS enthält standardmäßig eine Version von Python und verwendet sie für eigene Zwecke. Um Beeinträchtigungen von macOS zu vermeiden, empfehlen wir, eine separate Entwicklungsumgebung zu erstellen und eine unterstützte Version von Python für Google Cloudzu installieren. Homebrew verwenden, um Python zu installieren.

  1. Wenn Sie Python-Pakete mit Homebrew installieren möchten, benötigen Sie einen Compiler, den Sie durch Installieren der Befehlszeilentools von Xcode abrufen können.

    xcode-select --install

  2. Installieren Sie Homebrew, indem Sie der Anleitung auf der Homebrew-Website folgen, und installieren Sie dann Python mit Homebrew:

    brew install pyenv
pyenv install PYTHON_VERSION

    Die Python-Versionsnummer muss das Format x.y haben. Beispiel:

    pyenv install 3.12

  3. Prüfen Sie nach Abschluss der Installationen, ob Python 3 als python und python3 verfügbar und pip ebenfalls installiert ist.

    Mit folgendem Befehl überprüfen Sie, ob Python verfügbar ist:

    python3 --version

    Die Ausgabe zeigt die Version. Weitere Informationen zu Python Homebrew finden Sie auf der Seite Homebrew Python-Formeln. Dort können Sie auch Ihre Version prüfen.

    Mit folgendem Befehl überprüfen Sie, ob pip3 verfügbar ist:

    pip3 --version

    Wenn das Tool installiert ist, wird in der Ausgabe die pip3-Version angezeigt. Weitere Informationen zur neuesten Version von pip3 finden Sie in den pip-Versionshinweisen.

    Wenn im vorherigen Befehl die pip3-Version nicht angezeigt wird, prüfen Sie, ob pip3 richtig installiert ist. Wenn pip3 installiert ist, aber nicht funktioniert, führen Sie mit dem folgenden Befehl ein Upgrade auf die neueste Version durch:

    python -m pip install --upgrade pip

    Homebrew installiert die neuesten Versionen von Python, die auf Ihrer Plattform verfügbar sind. Die Versionsnummern in den Ausgaben können von den neuesten offiziellen Versionen von Python abweichen.

Windows

  1. Um Python in einer Windows-Umgebung zu installieren, laden Sie das Installationsprogramm für die benötigte Version von Python von der Python-Website herunter. Weitere Informationen finden Sie unter Unterstützte Python-Versionen für Google Cloud.

  2. Verwenden Sie den Python Launcher für Windows, um auf Ihre Version von Python zuzugreifen.

    Mit folgendem Befehl starten Sie die Version von Python, die Sie installiert haben:

    py

    Mit folgendem Befehl starten Sie die Version von Python 3, die Sie installiert haben:

    py -3

    Mit folgendem Befehl prüfen Sie, welche Version von pip verfügbar ist:

    py -m pip --version

    Die Ausgabe zeigt die Version von C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Informationen zur neuesten Version von pip finden Sie in den Versionshinweisen zu pip.

Linux

Die meisten Linux-Distributionen enthalten neue Versionen von Python.

  1. Wenn Sie Python in einer Linux-Umgebung installieren möchten, installieren Sie die entsprechenden Pakete für Ihre Distribution. Für Debian und Ubuntu sind diese Pakete python3, python3-dev, python3-venv und python3-pip.

    Installieren Sie diese Pakete mit den folgenden Befehlen:

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

  2. Prüfen Sie nach Abschluss der Installationen, ob Sie pip installiert haben:

    pip3 --version

    Informationen zur neuesten Version von pip finden Sie in den Versionshinweisen zu pip.

Abhängigkeiten mit venv isolieren

venv ist ein Tool, das isolierte Python-Umgebungen erstellt. Diese isolierten Umgebungen können separate Versionen von Python-Paketen haben, was bedeutet, dass Sie die Abhängigkeiten eines Projekts von den Abhängigkeiten anderer Projekte isolieren können. Wir empfehlen, dass Sie immer eine virtuelle Umgebung pro Projekt verwenden, wenn Sie lokal mit Python entwickeln.

  1. Verwenden Sie den Befehl venv, um eine virtuelle Kopie der gesamten Python-Installation zu erstellen. In dieser Anleitung wird eine virtuelle Kopie in einem Ordner namens env erstellt. Sie können jedoch einen beliebigen Namen für den Ordner angeben.

    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. Legen Sie in der Shell die Verwendung der venv-Pfade für Python fest, indem Sie die virtuelle Umgebung aktivieren:

    macOS

    source env/bin/activate

    Windows

    .\env\Scripts\activate

    Linux

    source env/bin/activate

  3. Jetzt können Sie Pakete installieren, ohne dass dies Auswirkungen auf andere Projekte oder Ihre globale Python-Installation hat:

    pip install google-cloud-storage

    Wenn Sie die virtuelle Umgebung nicht mehr verwenden und zu Ihrem globalen Python zurückkehren möchten, können Sie sie deaktivieren:

    deactivate

Weitere Informationen zu venv finden Sie in den venv - Dokumenten.

Editor installieren

Sie benötigen einen Editor, um Python-Anwendungen zu entwickeln. Hier sind einige der gängigsten Editoren (in keiner bestimmten Reihenfolge):

Cloud-Clientbibliotheken für Python installieren

Die Cloud-Clientbibliotheken für Python bieten die Möglichkeit, Python-Entwickler in Google Cloud -Dienste wie Datastore und Cloud Storage einzubinden. Zum Installieren des Pakets für eine einzelne API wie Cloud Storage können Sie einen Befehl wie den folgenden verwenden:

pip install --upgrade google-cloud-storage

gcloud CLI installieren

Die gcloud CLI ist eine Reihe von Befehlszeilentools für Google Cloud. Es enthält gcloud und bq, mit denen Sie über die Befehlszeile auf Compute Engine, Cloud Storage, BigQuery und andere Produkte und Dienste zugreifen können. Sie können diese Tools interaktiv oder in automatisierten Skripts ausführen.

Authentifizierung einrichten

Wenn Sie die Clientbibliothek verwenden möchten, müssen Sie zuerst die Authentifizierung einrichten.

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.

Weitere Informationen finden Sie unter Für die Verwendung von Clientbibliotheken authentifizieren.

Nächste Schritte