Implementa una función de Cloud Run 1ª gen. con la consola de Google Cloud

Cloud Run Functions es un entorno de ejecución sin servidores que sirve para compilar y conectar servicios en la nube. Con Cloud Run Functions, puedes escribir funciones de un solo propósito que se vinculan a eventos emitidos desde tu infraestructura y tus servicios de nube. La función se activa cuando ocurre un evento que se está observando, o a través de una solicitud HTTP.

En esta página, se muestra cómo crear e implementar una función HTTP de 1ª gen. con la consola deGoogle Cloud . Ten en cuenta que solo puedes crear funciones de 1ª gen. nuevas en proyectos existentes, no en proyectos nuevos. En el caso de proyectos nuevos, consulta la Guía de inicio rápido de la consola para Cloud Run Functions.

Para seguir la guía paso a paso sobre esta tarea directamente en la consola de Google Cloud , haz clic en Guiarme:

Guiarme

Antes de empezar

  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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Functions and Cloud Build APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Functions and Cloud Build APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

    Crea 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 Cloud Run Functions

      Asegúrate de que el proyecto para el que habilitaste Cloud Run Functions esté seleccionado. Solo se puede acceder a este vínculo para proyectos existentes. De lo contrario, se te redireccionará a la consola de Google Cloud para Cloud Run. Para aprender a crear e implementar funciones con la consola de Google Cloud para Cloud Run, consulta la Guía de inicio rápido de la consola para Cloud Run Functions.

    2. Haz clic en Crear función.

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

      El nombre puede incluir letras minúsculas, números y guiones.

    4. En el campo Activador, selecciona HTTP.

    5. En el campo Autenticación, elige Necesita autenticación.

      La otra opción, Permitir invocaciones no autenticadas, 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 o un sitio web públicos. 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 Guardar para guardar los cambios y, luego, en Siguiente.

    7. En el campo Código fuente, selecciona Editor directo. En este ejercicio, usarás la función predeterminada “Hello World” proporcionada en el editor.

    8. Usa el menú desplegable Entorno de ejecución para elegir el entorno de ejecución de tu lenguaje elegido.

    Implementa la función

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

    2. Haz clic en el ícono para volver a la página Descripción general de Cloud Run 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 la función y elige Probar función.

      Captura de pantalla en la que se muestra el proceso de prueba de las funciones

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

      En la pantalla de resultados, se mostrará 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 en la que se 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 Run Functions, despliega el menú de la función y haz clic en Ver registros.

    Aparecerá tu historial de registros.

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

    Próximos pasos