Ihre Cloud Run-Funktion wird in einer Umgebung ausgeführt, die aus einer Betriebssystemversion mit Add-on-Paketen, Sprachunterstützung und der Python Functions Framework-Bibliothek besteht, die Ihre Funktion unterstützt und aufruft. Diese Umgebung wird durch die Sprachversion identifiziert und als Laufzeit-ID bezeichnet.
Funktionsvorbereitung
Sie können eine Funktion direkt über die Google Cloud -Console vorbereiten oder auf Ihren lokalen Computer schreiben und hochladen. Informationen zum Vorbereiten Ihres lokalen Computers für die Python-Entwicklung finden Sie unter Python-Entwicklungsumgebung einrichten.
Unterstützte Python-Laufzeiten und Basis-Images
| Laufzeit | Laufzeit-ID | Stacks | Laufzeit-Basis-Image | Einstellung | Aus dem Betrieb nehmen |
|---|---|---|---|---|---|
| Python 3.15 (Vorabversion) |
python315 |
|
|
||
| Python 3.14 | python314 |
|
|
2030-10-10 | 2031-04-10 |
| Python 3.13 | python313 |
|
|
2029-10-10 | 2030-04-10 |
| Python 3.12 | python312 |
|
|
2028-10-02 | 2029-04-02 |
| Python 3.11 | python311 |
|
|
2027-10-24 | 2028-04-24 |
| Python 3.10 | python310 |
|
|
2026-10-04 | 2027-04-04 |
| Python 3.9 | python39 | google-18-full | google-18-full/python39 | 2025-10-05 | 2026-04-05 |
| Python 3.8 | python38 | google-18-full | google-18-full/python38 | 2024-10-14 | 2025-10-14 |
| Python 3.7 | python37 | google-18-full | google-18-full/python37 | 2024-01-30 | 2025-01-30 |
Laufzeit auswählen
Sie können während der Bereitstellung eine der unterstützten Python-Laufzeiten für Ihre Funktion auswählen.
Sie können eine Laufzeitversion mit der Google Cloud Console oder der gcloud CLI auswählen. Klicken Sie auf den Tab, um eine Anleitung zum Verwenden des gewünschten Tools zu erhalten.
gcloud
Geben Sie das Python-Basis-Image für Ihre Funktion mit dem Flag --base-image an, während Sie die Funktion bereitstellen. Beispiel:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image python314
Ersetzen Sie:
FUNCTION durch den Namen der Funktion, die Sie bereitstellen. Sie können diesen Parameter auch weglassen, werden dann jedoch nach dem Namen gefragt.
FUNCTION_ENTRYPOINT durch den Einstiegspunkt zur Funktion in Ihrem Quellcode. Dies ist der Code, den Cloud Run beim Ausführen der Funktion ausführt. Der Wert dieses Flags muss ein Funktionsname oder ein voll qualifizierter Klassenname sein, der in Ihrem Quellcode vorhanden ist.
Eine ausführliche Anleitung zum Bereitstellen einer Funktion mit der gcloud CLI finden Sie unter Funktionen in Cloud Run bereitstellen.
Console
Sie können eine Laufzeitversion auswählen, wenn Sie eine Cloud Run-Funktion in der Google Cloud Console erstellen oder aktualisieren. Eine ausführliche Anleitung zum Bereitstellen einer Funktion finden Sie unter Funktionen in Cloud Run bereitstellen.
So wählen Sie beim Erstellen einer Funktion in der Google Cloud Console eine Laufzeit aus:
Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:
Klicken Sie auf Funktion schreiben.
Wählen Sie in der Liste Laufzeit eine Python-Laufzeitversion aus.
Klicken Sie auf Erstellen und warten Sie, bis der Dienst in Cloud Run mit einer Platzhalter-Überarbeitung erstellt wurde.
Die Console leitet Sie zum Tab Quelle weiter, auf dem Sie den Quellcode Ihrer Funktion sehen. Klicken Sie auf Speichern und wieder bereitstellen.
Eine ausführliche Anleitung zum Aktualisieren der Laufzeitversion nach der Bereitstellung der Funktion finden Sie unter Neuen Quellcode noch einmal bereitstellen.
Struktur des Quellcodes
Damit Cloud Run Functions die Definition Ihrer Funktion findet, muss Ihr Quellcode einer bestimmten Struktur entsprechen. Weitere Informationen finden Sie unter Cloud Run-Funktionen schreiben.
Abhängigkeiten angeben
Es gibt mehrere Möglichkeiten, Abhängigkeiten für Cloud Run-Funktionen in Python anzugeben: Verwenden Sie die Datei requirements.txt eines Paketmanagers, konfigurieren Sie eine pyproject.toml-Datei als Standardprojektdefinitionsdatei oder verpacken Sie lokale Abhängigkeiten zusammen mit Ihrer Funktion. Weitere Informationen finden Sie unter Abhängigkeiten in Python angeben.
Cloud Run Functions unterstützt nicht die Angabe von Abhängigkeiten mit Pipfile/Pipfile.lock. Ihr Projekt sollte diese Dateien daher nicht enthalten.
Umgebungsvariablen
Ihre Python-Laufzeit legt automatisch bestimmte Umgebungsvariablen fest, die Ihre Funktion nach Bedarf verwenden kann. Weitere Informationen finden Sie unter Umgebungsvariablen konfigurieren.