Executar localmente com o Functions Framework

Nesta página, mostramos como instalar e executar o Functions Frameworks para desenvolvimento local.

Antes de começar

Se esta for a primeira vez que você usa o Cloud Functions com o Cloud Code, consulte o guia de início rápido Criar e implantar uma função. 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:

  1. No Cloud Shell, clique em Cloud Code e expanda o explorador Cloud Functions.

  2. Expanda seu projeto do Google Cloud, 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 do Google Cloud para a máquina local e cria um novo espaço de trabalho no ambiente de desenvolvimento integrado.

  3. Clique em Terminal > Novo terminal para abrir o terminal no Cloud Shell.

  4. 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

    npm install
    

    Python

    pip install functions-framework
    
  5. Para executar o Functions Framework local, execute o seguinte:

    Node.js

    npx functions-framework --target=entryPoint
    

    Python

    functions-framework --target=entryPoint
    

    Para encontrar o entryPoint da sua 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 será exibida da seguinte maneira:

    "entryPoint": "helloHttp",
    
  6. Para testar a função, quando solicitado, clique em Abrir no navegador ou em + Novo terminal e execute o seguinte:

      curl http://localhost:8080/
    

    Isso mostra o contexto da função no terminal.

Para mais informações sobre como chamar funções em execução localmente, consulte Como executar funções com frameworks de função.