Crea una función de Cloud Run Functions con la consola de Google Cloud

Cloud Run Functions es un entorno de ejecución sin servidores para crear y conectar servicios en la nube. Con Cloud Run 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 o mediante una solicitud HTTP.

En esta página, se muestra cómo crear e implementar una función HTTP con la consola de Google Cloud. Esta página se basa en Node.js, pero el proceso es similar para todos los entornos de ejecución.

En el ejemplo de esta guía de inicio rápido, se usa la siguiente función de Node.js, que muestra un mensaje cuando se activa por una solicitud HTTP:

const functions = require('@google-cloud/functions-framework');

functions.http('helloHttp', (req, res) => {
 res.send(`Hello ${req.query.name || req.body.name || 'World'}!`);
});

Antes de comenzar

  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.

    Go to project selector

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

  4. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

Cree una función

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

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

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

  2. Haz clic en Crear función.

  3. Asigna un nombre a la función, por ejemplo, function-1.

  4. Selecciona una región en la que desees implementar la función.

  5. En el campo HTTPS en Activador, deja seleccionada la opción Solicitar autenticación. Esta es la configuración predeterminada.

    La otra opción, Permitir invocaciones no autenticadas, te permite acceder a la función sin autenticación. Esto es útil para realizar pruebas, pero no se recomienda usar esta configuración en producción, a menos que crees una API pública o un sitio web. Además, es posible que no funcione en tu caso, según la configuración de tu política corporativa. Consulta Autentica para la invocación para obtener detalles sobre cómo invocar una función que requiere autenticación.

  6. 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 para seleccionar el entorno de ejecución de Java deseado. En este ejemplo, se usa nodejs20.

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, la consola de Google Cloud se redireccionará a la página Detalles de la función.

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

Prueba la función

Para probar la función una vez que haya terminado de implementarse, haz lo siguiente:

  1. Abre la pestaña Pruebas.

  2. Desplázate hacia abajo hasta el campo Comando de prueba de la CLI.

  3. Haz clic en Ejecutar en Cloud Shell.

    Se abrirá una ventana de Cloud Shell en la parte inferior de la pantalla, en la que se mostrará el comando curl desde la pestaña Prueba. Es posible que se te solicite autorizar Cloud Shell.

  4. Para ejecutar el comando curl que se muestra en tu ventana de Cloud Shell, presiona Intro.

    Se muestra el mensaje "Hello world".

¿Qué sigue?