Ejecuta funciones de forma local con Functions Framework
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se muestra cómo instalar y ejecutar
frameworks de funciones para el desarrollo
local.
Antes de comenzar
Si es la primera vez que usas Cloud Run Functions
con Cloud Code, consulta la guía de inicio rápido
Comienza a usar Cloud Run Functions. Una vez que crees y, luego, implementes una función con una
muestra de Cloud Code, puedes volver a esta guía para configurar un
entorno de desarrollo local.
Instala y ejecuta Functions Framework de forma local
Para instalar y ejecutar Functions Framework de forma local, sigue estos pasos:
En
Cloud Shell, haz clic en
Cloud Code y, luego, expande el explorador de Cloud Functions.
Expande tu Google Cloud proyecto, haz clic con el botón derecho en la función implementada que
deseas y selecciona Descargar a un espacio de trabajo nuevo. Esta acción descarga el código fuente de tu función de Google Cloud a tu máquina local y crea un lugar de trabajo nuevo en tu IDE.
Haz clic en Terminal > Nueva terminal para abrir la terminal en Cloud Shell.
Para instalar las dependencias locales en la carpeta local de tu función, navega a la carpeta local de tu función en la terminal y, luego, ejecuta lo siguiente:
Node.js
npminstall
Python
pipinstallfunctions-framework
Para ejecutar el framework de Functions local, ejecuta lo siguiente:
Node.js
npxfunctions-framework--target=entryPoint
Python
functions-framework--target=entryPoint
Para encontrar el entryPoint de tu función, abre el archivo launch.json y
busca el valor asignado de entryPoint.
Por ejemplo, si usas la aplicación de ejemplo Hello World de Cloud Code, la configuración aparece de la siguiente manera:
"entryPoint": "helloHttp",
Para probar tu función, cuando se te solicite, haz clic en Abrir en el navegador o en + Nueva terminal y ejecuta lo siguiente:
curl http://localhost:8080/
Se muestra el contexto de la función en la terminal.
Para obtener más información sobre cómo llamar a funciones que se ejecutan de manera local, consulta
Desarrollo de funciones locales.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis page guides you through installing and running Functions Framework locally for development purposes.\u003c/p\u003e\n"],["\u003cp\u003eBefore getting started, it's recommended to have previously deployed a Cloud Run function using a Cloud Code sample.\u003c/p\u003e\n"],["\u003cp\u003eInstallation involves downloading your function's source code to your local machine and installing the necessary dependencies using \u003ccode\u003enpm install\u003c/code\u003e (for Node.js) or \u003ccode\u003epip install functions-framework\u003c/code\u003e (for Python).\u003c/p\u003e\n"],["\u003cp\u003eYou can run Functions Framework locally using \u003ccode\u003enpx functions-framework --target=entryPoint\u003c/code\u003e (Node.js) or \u003ccode\u003efunctions-framework --target=entryPoint\u003c/code\u003e (Python), with the \u003ccode\u003eentryPoint\u003c/code\u003e specified in your \u003ccode\u003elaunch.json\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eAfter running Functions Framework locally, you can test your function by opening it in a browser, or using \u003ccode\u003ecurl http://localhost:8080/\u003c/code\u003e in a new terminal.\u003c/p\u003e\n"]]],[],null,["# Run locally with Functions Framework\n\nThis page shows you how to install and run\n[Functions Frameworks](/functions/docs/functions-framework) for local\ndevelopment.\n\nBefore you begin\n----------------\n\nIf this is your first time using [Cloud Run functions](/run/docs/functions-with-run)\nwith Cloud Code, see the\n[Get started with Cloud Run functions](/functions/docs/get-started-in-cloud-run)\nquickstart. Once you've created and deployed a function using a\nCloud Code sample, you can return to this guide to setup a local\ndevelopment environment.\n\nInstall and run Functions Framework locally\n-------------------------------------------\n\nTo install and run Functions Framework locally, follow these steps:\n\n1. In\n Cloud Shell, click\n\n **Cloud Code** and then expand the **Cloud Functions** explorer.\n\n2. Expand your Google Cloud project, right-click a deployed function of\n your choice, and select **Download to new workspace**. This downloads the source\n code of your function from Google Cloud to your local machine and\n creates a new workspace in your IDE.\n\n3. Click **Terminal** \\\u003e **New Terminal**\n to open the terminal in Cloud Shell.\n\n4. To install the local dependencies to your function's local folder, navigate\n to your function's local folder in the terminal and then run the following:\n\n ### Node.js\n\n npm install\n\n ### Python\n\n pip install functions-framework\n\n5. To run the local Functions Framework, run the following:\n\n ### Node.js\n\n ```bash\n npx functions-framework --target=entryPoint\n ```\n\n ### Python\n\n ```bash\n functions-framework --target=entryPoint\n ```\n\n To find the `entryPoint` of your function, open your `launch.json` file and\n look for the assigned value of `entryPoint`.\n\n For example, if you're using Cloud Code's Hello World sample\n application, the configuration appears as follows: \n\n \"entryPoint\": \"helloHttp\",\n\n6. To test your function, when prompted, click **Open in Browser** , or click\n **+ New Terminal** and run the following:\n\n curl http://localhost:8080/\n\n | **Note:** By default, your function will be accessible at `localhost:8080`.\n\n This shows the context of the function in the terminal.\n\nFor more information on how to call locally running functions, see\n[Local functions development](/run/docs/local-dev-functions)."]]
Cloud Code y, luego, expande el explorador de Cloud Functions.