Se stai creando una nuova funzione, consulta la guida rapida della console su Cloud Run. I contenuti di questa pagina si applicano solo alle funzioni legacy esistenti create con l'API Cloud Functions v1.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Runtime di Python
Panoramica
La funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo, oltre a pacchetti aggiuntivi, supporto per le lingue e la libreria Functions Framework che supporta e richiama la funzione.
Questo ambiente è identificato dalla versione della lingua ed è noto come ambiente di runtime.
Per iniziare a utilizzare Python nelle funzioni Cloud Run, consulta la guida introduttiva.
Seleziona il runtime
Cloud Run Functions supporta diverse versioni di Python, elencate nella pagina Supporto del runtime. Puoi selezionare il runtime Python preferito per la tua funzione durante l'implementazione.
gcloud
Se utilizzi Google Cloud CLI, specifica il runtime
utilizzando il parametro --runtime. Ad esempio:
Puoi preparare una funzione direttamente dalla Google Cloud console o scriverla sulla tua macchina locale e caricarla. Per preparare la tua macchina locale per lo sviluppo in Python, consulta Configurare un ambiente di sviluppo Python.
Per iniziare rapidamente a utilizzare Python nelle funzioni Cloud Run, consulta la guida rapida.
Struttura del codice sorgente
Affinché le funzioni Cloud Run trovino la definizione della funzione, il codice sorgente deve seguire una struttura specifica. Per ulteriori informazioni, consulta Scrittura di funzioni Cloud Run.
Specifica delle dipendenze
Esistono due modi per specificare le dipendenze per le funzioni Cloud Run scritte in Python: utilizzando il file pip del gestore dei pacchetti pip o impacchettando le dipendenze locali insieme alla funzione.requirements.txt Per ulteriori informazioni, consulta Specificare le dipendenze in Python.
Le funzioni Cloud Run non supportano la specifica delle dipendenze con Pipfile/Pipfile.lock. Il progetto non deve includere questi file.
Variabili di ambiente
Il runtime di Python imposta automaticamente determinate variabili di ambiente per la funzione da utilizzare in base alle esigenze. Per maggiori dettagli, vedi Utilizzare le variabili di ambiente.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[[["\u003cp\u003eCloud Run functions operate within a defined runtime environment that includes the operating system, language support, and the Functions Framework library.\u003c/p\u003e\n"],["\u003cp\u003eUsers can select their preferred Python runtime version during deployment through the Google Cloud CLI using the \u003ccode\u003e--runtime\u003c/code\u003e parameter or via the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003ePython dependencies for Cloud Run functions can be managed through a \u003ccode\u003erequirements.txt\u003c/code\u003e file or by packaging them locally with the function.\u003c/p\u003e\n"],["\u003cp\u003eThe source code structure must adhere to specific guidelines to ensure Cloud Run functions can locate the function's definition.\u003c/p\u003e\n"],["\u003cp\u003ePython Environment variables will automatically be set by the runtime for the function to use.\u003c/p\u003e\n"]]],[],null,["# The Python Runtime\n==================\n\nOverview\n--------\n\nYour Cloud Run function runs in an environment consisting of an operating\nsystem version plus add-on packages, language support, and\nthe Functions Framework library that supports and invokes your function.\nThis environment is identified by the language version, and is known as the\nruntime.\n\nFor information about runtimes in general, and to learn which Ubuntu version\neach Python runtime uses, see the [Cloud Run functions execution\nenvironment](/functions/1stgendocs/concepts/execution-environment#python).\n\nTo get started with Python on Cloud Run functions, see the\n[Quickstart](/functions/1stgendocs/create-deploy-gcloud-1st-gen).\n\nSelect your runtime\n-------------------\n\nCloud Run functions supports several versions of Python, listed on the\n[Runtime support](/functions/1stgendocs/runtime-support#python) page. You can\nselect the preferred Python runtime for your function during deployment. \n\n### gcloud\n\nIf you're using the Google Cloud CLI, specify the runtime\nby using the `--runtime` parameter. For example: \n\n```bash\ngcloud functions deploy NAME --no-gen2 --runtime python312 --trigger-http\n```\n\nFor more deployment parameters, see [Deploy a Cloud Run functions](/functions/1stgendocs/deploy#basics).\n\n### Console\n\nIf you're using the Google Cloud console, see the\n[Google Cloud console instructions](/functions/1stgendocs/deploy#console).\n\nFunction preparation\n--------------------\n\nYou can prepare a function directly from the Google Cloud console or write it on\nyour local machine and upload it. To prepare your local machine for Python\ndevelopment, see [Setting Up a Python Development\nEnvironment](/python/docs/setup).\n\nTo get started quickly with Python on Cloud Run functions, see the\n[Quickstart](/functions/1stgendocs/create-deploy-http-python-1st-gen).\n\nSource code structure\n---------------------\n\nFor Cloud Run functions to find your function's definition, your\nsource code must follow a specific structure. See\n[Writing Cloud Run functions](/functions/1stgendocs/writing#structuring_source_code)\nfor more information.\n\nSpecifying dependencies\n-----------------------\n\nThere are two ways to specify dependencies for Cloud Run functions written\nin Python: using the `pip` package manager's `requirements.txt` file or\npackaging local dependencies alongside your function. For more information, see\n[Specifying dependencies in\nPython](/functions/1stgendocs/writing/specifying-dependencies-python).\n\nCloud Run functions doesn't support specifying dependencies with the\n`Pipfile/Pipfile.lock`. Your project shouldn't include these files.\n\nEnvironment variables\n---------------------\n\nYour Python runtime automatically sets certain environment variables for your\nfunction to use as needed. For details, see [Using Environment\nVariables](/functions/1stgendocs/configuring/env-var#python_37_and_go_111)."]]
