Guía de inicio rápido de Go

Cloud Functions es un entorno de ejecución sin servidores para compilar y conectar servicios en la nube. Con Cloud Functions, puedes escribir funciones simples de un solo propósito vinculadas a eventos emitidos desde tu infraestructura y servicios de nube. La función se activa cuando ocurre un evento que se está supervisando.

En esta página, se muestra cómo crear y, también, implementar una función de Go de Cloud Functions mediante Cloud Console. Cuando una solicitud HTTP activa esta función, escribe un mensaje como el siguiente:

// Package p contains an HTTP Cloud Function.
package p

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

// HelloWorld prints the JSON encoded "message" field in the body
// of the request or "Hello, World!" if there isn't one.
func HelloWorld(w http.ResponseWriter, r *http.Request) {
  var d struct {
    Message string `json:"message"`
  }
  if err := json.NewDecoder(r.Body).Decode(&d); err != nil {
    fmt.Fprint(w, "Hello World!")
    return
  }
  if d.Message == "" {
    fmt.Fprint(w, "Hello World!")
    return
  }
  fmt.Fprint(w, html.EscapeString(d.Message))
}

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir a la página del selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita las API de Cloud Functions and Cloud Build.

    Habilita las API

Crea una función

  1. Abre la página Descripción general de Cloud Functions en Cloud Console:

    Ir a la página Descripción general de Cloud Functions

    Asegúrate de que el proyecto para el que habilitaste Cloud Functions esté seleccionado.

  2. Haz clic en Crear función (Create function).

  3. Asigna un nombre a tu función.

  4. En el campo Activador (Trigger), selecciona HTTP.

  5. En el campo Autenticación, selecciona Permitir invocaciones no autenticadas.

  6. Haz clic en Guardar para guardar los cambios y, luego, haz clic en Siguiente.

  7. En el campo Código fuente (Source code), selecciona Editor en línea (Inline editor). En este ejercicio, usarás la función predeterminada proporcionada en el editor.

  8. Usa el menú desplegable del Entorno de ejecución (Runtime) para seleccionar el entorno de ejecución de Go deseado.

Implementa la función

  1. En la parte inferior de la página, haz clic en Implementar.

  2. Después de hacer clic en Implementar, Cloud Console se redireccionará a la página Descripción general de Cloud Functions.

    Mientras se implementa la función, aparecerá junto a ella un ícono giratorio pequeño. Cuando termina de implementarse, el ícono giratorio cambia a una marca de verificación color verde.

    Captura de pantalla que muestra el proceso de implementación de funciones

Prueba la función

  1. Despliega el menú de tu función y haz clic en Probar función (Test function).

    Captura de pantalla que muestra el proceso de prueba de funciones

  2. En la página de prueba, haz clic en Probar función.

    La pantalla Resultado muestra el texto "Hello World!"

  3. Ahora, cambia el mensaje. En el campo Evento de activación, ingresa el texto {"message":"Hello, YOUR_NAME!"}, reemplaza YOUR_NAME con un nombre y haz clic en Probar función.

    Por ejemplo, supongamos que ingresaste el nombre “Rowan”. En el campo Resultado, verás el mensaje Hello, Rowan!.

    En el campo Registros (Logs), el código de estado 200 indica que la prueba se realizó con éxito.

    Captura de pantalla que muestra el campo Registros con el código 200 que indica que la prueba se realizó con éxito

Visualiza registros

Revisa los registros para ver tus acciones en el historial de registros:

  • En la página Descripción general de Cloud Functions, despliega el menú de tu función y haz clic en Ver registros.

Aparece tu historial de registros.

Captura de pantalla que muestra el campo Registros con el código 200 que indica que la prueba se realizó con éxito

Próximos pasos