Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página mostra como instalar e executar
Frameworks de funções para desenvolvimento
local.
Antes de começar
Se esta é a primeira vez que você usa as funções do Cloud Run
com o Cloud Code, consulte o guia de início rápido
Começar a usar as funções do Cloud Run. Depois de criar e implantar uma função usando um exemplo do Cloud Code, volte a este guia para configurar um ambiente de desenvolvimento local.
Instalar e executar o Functions Framework localmente
Para instalar e executar o Functions Framework localmente, siga estas etapas:
No VS Code, clique em
Cloud Code e abra o explorador Cloud Functions.
Abra o Google Cloud projeto, clique com o botão direito do mouse em uma função implantada
de sua escolha e selecione Fazer o download para um novo espaço de trabalho. Isso faz o download do código-fonte
da função de Google Cloud para a máquina local e
cria um novo espaço de trabalho no ambiente de desenvolvimento integrado.
Clique em View > Terminal
para abrir o terminal no VS Code.
Para instalar as dependências locais na pasta local da função, navegue até a pasta local da função no terminal e execute o seguinte:
Node.js
npminstall
Python
pipinstallfunctions-framework
Para executar o Functions Framework local, faça o seguinte:
Node.js
npxfunctions-framework--target=entryPoint
Python
functions-framework--target=entryPoint
Para encontrar o entryPoint da função, abra o arquivo launch.json e
procure o valor atribuído de entryPoint.
Por exemplo, se você estiver usando o aplicativo de exemplo "Hello World" do Cloud Code, a configuração vai aparecer da seguinte maneira:
"entryPoint": "helloHttp",
Para testar a função, clique em Abrir no navegador ou em + Novo terminal e execute o seguinte:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[[["\u003cp\u003eThis page guides you through installing and running Functions Framework locally for development purposes.\u003c/p\u003e\n"],["\u003cp\u003eYou can download a deployed function's source code to your local machine by using the Cloud Code extension in VS Code.\u003c/p\u003e\n"],["\u003cp\u003eInstall the necessary dependencies for your function locally using either \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\u003eRun Functions Framework locally by executing \u003ccode\u003enpx functions-framework --target=entryPoint\u003c/code\u003e (Node.js) or \u003ccode\u003efunctions-framework --target=entryPoint\u003c/code\u003e (Python), with the entry point specified in your \u003ccode\u003elaunch.json\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eYou can test your locally running function by opening it in a browser or by using curl with \u003ccode\u003ehttp://localhost:8080/\u003c/code\u003e.\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 VS Code, 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 **View** \\\u003e **Terminal**\n to open the terminal in VS Code.\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).\n\nGet Support\n-----------\n\nTo send feedback, report issues on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-vscode/issues), or ask a question on [Stack Overflow](https://stackoverflow.com/questions/ask?tags=cloud-code-vscode)."]]
Cloud Code e abra o explorador Cloud Functions.