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

Criar e implantar uma função do Cloud em HTTP usando Go

Este guia explica o processo de criação de uma Função do Cloud usando o ambiente de execução do Go. Há dois tipos de Funções do Cloud:

Uma função HTTP, que você invoca a partir de solicitações HTTP padrão.
Uma função direcionada a eventos, que você usa para processar eventos da infraestrutura do Cloud, como mensagens em um tópico do Cloud Pub/Sub ou alterações em um bucket do Cloud Storage.

O exemplo mostra como criar uma função HTTP simples.

Estrutura do guia

Como criar um projeto do GCP usando a CLI gcloud

Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

Acessar o seletor de projetos

Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

Ative as APIs Cloud Functions and Cloud Build.

Ative as APIs

No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

Acessar o seletor de projetos

Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

Ative as APIs Cloud Functions and Cloud Build.

Ative as APIs

Instale e inicialize a gcloud CLI.
Atualize e instale os componentes gcloud:
```
gcloud components update
```

Prepare seu ambiente de desenvolvimento.
Acesse o guia de configuração do Go

Como criar uma função

Crie um diretório no seu sistema local para o código de função:

Linux ou macOS

mkdir ~/helloworld
cd ~/helloworld

Windows

mkdir %HOMEPATH%\helloworld
cd %HOMEPATH%\helloworld

Crie um arquivo chamado hello_http.go no diretório helloworld com o seguinte conteúdo:

functions/helloworld/hello_http.go

Acessar no GitHub Feedback


// Package helloworld provides a set of Cloud Functions samples.
package helloworld

import (
	"encoding/json"
	"fmt"
	"html"
	"net/http"

	"github.com/GoogleCloudPlatform/functions-framework-go/functions"
)

func init() {
	functions.HTTP("HelloHTTP", HelloHTTP)
}

// HelloHTTP is an HTTP Cloud Function with a request parameter.
func HelloHTTP(w http.ResponseWriter, r *http.Request) {
	var d struct {
		Name string `json:"name"`
	}
	if err := json.NewDecoder(r.Body).Decode(&d); err != nil {
		fmt.Fprint(w, "Hello, World!")
		return
	}
	if d.Name == "" {
		fmt.Fprint(w, "Hello, World!")
		return
	}
	fmt.Fprintf(w, "Hello, %s!", html.EscapeString(d.Name))
}

Esse exemplo de função recebe um nome fornecido na solicitação HTTP e retorna uma saudação, ou "Hello, World!", quando nenhum nome é fornecido.

Como especificar dependências

Esta função de exemplo usa apenas pacotes da biblioteca padrão do Go. Assim, você não precisa declarar nenhuma dependência além de apenas importar os pacotes.

Para funções que exigem dependências fora da biblioteca padrão, é necessário fornecer as dependências por meio de um arquivo go.mod ou um diretório vendor. Para ver mais detalhes, leia Como especificar dependências no Go.

Como implantar a função

Para implantar a função com um gatilho HTTP, execute o seguinte comando no diretório helloworld, especificando go113 ou go111 como o valor para a sinalização --runtime, dependendo da versão usada:

gcloud functions deploy HelloHTTP --runtime go120 --trigger-http --allow-unauthenticated

A sinalização --allow-unauthenticated permite que você atinja a função sem autenticação. Para exigir autenticação, omita a sinalização.

Como testar a função

Quando a implantação da função estiver concluída, anote a propriedade httpsTrigger.url ou encontre-a usando o seguinte comando:
```
gcloud functions describe HelloHTTP
```
A aparência será semelhante a esta:
```
https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP
```
Visite este URL em seu navegador ou use cURL executando o comando:
```
curl https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP
```
Você verá uma mensagem "Hello World!". Tente passar um nome na solicitação HTTP executando o seguinte comando:
```
curl -X POST https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP -H "Content-Type:application/json"  -d '{"name":"NAME"}'
```
Você verá uma mensagem "Hello, NAME!"

Como visualizar registros

Como usar a ferramenta de linha de comando

Os registros do Cloud Functions são visíveis na IU do Cloud Logging e na Google Cloud CLI.

Para ver os registros da função com a ferramenta gcloud CLI, use o comando logs read, seguido pelo nome da função:

gcloud functions logs read HelloHTTP

A saída será semelhante a esta:

LEVEL  NAME        EXECUTION_ID  TIME_UTC                 LOG
D      HelloHTTP  buv9ej2k1a7r  2019-09-20 13:23:18.910  Function execution started
D      HelloHTTP  buv9ej2k1a7r  2019-09-20 13:23:18.913  Function execution took 4 ms, finished with status code: 200

Como usar o painel do Logging

Também é possível ver os registros do Cloud Functions no console do Google Cloud.