Python-Entwicklungsumgebung einrichten

In dieser Anleitung erfahren Sie, wie Sie Ihren lokalen Computer für die Python Entwicklung vorbereiten, einschließlich der Entwicklung von Python-Anwendungen, die in ausgeführt werden Google Cloud.

Wenn Sie bereits eine eingerichtete Entwicklungsumgebung haben, finden Sie unter Python und Google Cloud eine Übersicht zur Ausführung von Python-Anwendungen in 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 den Cloud Code-Tools vorinstalliert.

Ziele

  • Installieren Sie eine unterstützte Version von Python , die mit Google Cloudkompatibel ist.
  • Verwenden Sie venv, um Abhängigkeiten zu isolieren.
  • Editor installieren (optional)
  • Installieren Sie die Google Cloud CLI (optional).
  • Die Cloud-Clientbibliotheken für Python installieren (optional)
  • Andere nützliche Tools installieren
  • Authentifizierung einrichten (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, erstellen Sie eine separate Entwicklungsumgebung und installieren Sie eine unterstützte Version von Python für Google Cloud. Verwenden Sie Homebrew, 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. Informationen zu Python Homebrew finden Sie auf der Seite Homebrew Python-Formeln . Prüfen Sie dann Ihre Version.

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

    pip3 --version

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

    Wenn der vorherige Befehl die Version von pip3 nicht anzeigt, prüfen Sie, ob pip3 korrekt 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. Wenn Sie Python in einer Windows-Umgebung installieren möchten, laden Sie das Installationsprogramm für die benötigte Version von Python von der Python-Website herunter. Weitere Informationen finden Sie unter den unterstützten Versionen von Python 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 installierte Version von Python:

    py

    Mit folgendem Befehl starten Sie die installierte Version von Python 3:

    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 pip Versionshinweisen.

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 dies die 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. Sie enthält gcloud und bq, mit denen Sie über die Befehlszeile auf Compute Engine, Cloud Storage, BigQuery sowie andere Produkte und Dienste zugreifen können. Sie können diese Tools interaktiv oder in automatisierten Skripts ausführen.

Authentifizierung einrichten

Um die Clientbibliothek ausführen zu können, müssen Sie zuerst die Authentifizierung einrichten.

Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzer konto: 

gcloud auth application-default login

Wenn Sie Cloud Shell verwenden, ist dies nicht erforderlich.

Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

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

Nächste Schritte