Criar e implantar uma função do Cloud em Python

Guia de início rápido: criar e implantar uma função do Cloud em Python

Criar e implantar uma função do Cloud em Python

O Cloud Functions é um ambiente de execução sem servidor para criar e conectar serviços em nuvem. Com ele, é possível escrever funções simples que têm uma única finalidade e que são vinculadas a eventos emitidos pela infraestrutura e pelos serviços em nuvem. A função é acionada quando um evento em análise é disparado.

Saiba como criar e implantar um Cloud Function do Python usando o Console do Cloud.

---

Para receber orientações passo a passo sobre esta tarefa diretamente no Console do Cloud, clique em Orientação:

Orientações

---

As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Quando a função é acionada por uma solicitação HTTP, ela grava a seguinte mensagem:

def hello_world(request):
    """Responds to any HTTP request.
    Args:
        request (flask.Request): HTTP request object.
    Returns:
        The response text or any set of values that can be turned into a
        Response object using
        `make_response <https://flask.palletsprojects.com/en/1.1.x/api/#flask.Flask.make_response>`.
    """
    request_json = request.get_json()
    if request.args and 'message' in request.args:
        return request.args.get('message')
    elif request_json and 'message' in request_json:
        return request_json['message']
    else:
        return f'Hello World!'

Observação: para aprender como escrever uma função do Cloud a partir do zero e usar a CLI do Google Cloud para implantá-la e testá-la, consulte Sua primeira função: Python.

Antes de começar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

Criar uma função

1. Abra a página Visão geral das funções no Console do Cloud:

   Acessar a página Visão geral do Cloud Functions

   Verifique se o projeto com o Cloud Functions ativado foi selecionado.

2. Clique em Criar função.

3. Nomeie a função.

4. No campo Gatilho, selecione HTTP.

5. No campo Autenticação, selecione Permitir invocações não autenticadas.

6. Clique em Salvar para salvar as alterações e, depois, em Próxima.

7. No campo Código-fonte, selecione Editor in-line. Neste exercício, você usará a função padrão fornecida no editor.

8. Use o menu suspenso Ambiente de execução para selecionar um ambiente de execução do Python.

Implantar a função

1. Na parte inferior da página, clique em Implantar.

2. Depois de clicar em Implantar, o Console do Cloud será redirecionado para a página de visão geral do Cloud Functions.

   Enquanto a função é implantada, o ícone ao lado dela fica girando. Depois de concluída a implantação, o ícone muda para uma marca de seleção verde.

   

Testar a função

1. Veja o menu da função e clique em Testar função.

   

2. Na página de teste, clique em Testar a função.

   A tela Saída exibe o texto "Hello World!"

3. Altere a mensagem. No campo Evento acionador, insira o texto {"message":"Hello, YOUR_NAME!"}, substituindo YOUR_NAME por um nome e clique em Testar a função.

   Vamos supor que você inseriu o nome "Rowan". No campo Saída é exibida a mensagem Hello, Rowan!.

   No campo Registros, um código de status 200 indica êxito.

   

Ver registros

Verifique os registros para ver as ações no histórico de registros:

• De volta à página "Visão geral do Cloud Functions", veja o menu da função e clique em Exibir registros.

O histórico de registros é exibido.

A seguir

• Saiba como gravar uma função do zero.
• Saiba mais sobre como escrever Cloud Functions.
• Saiba mais sobre como implantar Cloud Functions.
• Saiba mais sobre como chamar Cloud Functions.
• Saiba mais sobre como monitorar Cloud Functions.
• Explore os tutoriais mais avançados do Cloud Functions.