Implementa funciones en Cloud Run

Console

1. En la consola de Google Cloud, ve a la página Cloud Run:

   Ir a Cloud Run

2. Haz clic en Escribe una función.

3. En el campo Nombre del servicio, ingresa un nombre para describir tu función. Los nombres de servicios solo deben comenzar con una letra y contener hasta 49 caracteres o menos, incluidas letras, números o guiones. Los nombres de los servicios no pueden terminar con guiones y deben ser únicos por región y proyecto. Un nombre de servicio no se puede cambiar más adelante y es visible de forma pública.

4. En la lista Región, usa el valor predeterminado o selecciona la región en la que quieres implementar la función.

5. En la lista Entorno de ejecución, usa el valor predeterminado o selecciona una versión de entorno de ejecución.

6. De manera opcional, en la sección Activador, haz clic en Agregar activador y selecciona una opción. Se abrirá el panel Activador de Eventarc, en el que podrás modificar los siguientes detalles del activador:

   1. En el campo Nombre del activador, ingresa un nombre para el activador o usa el nombre predeterminado.

   2. Selecciona un tipo de activador de la lista para especificar uno de los siguientes tipos de activador:

      • Fuentes de Google para especificar activadores para Pub/Sub, Cloud Storage, Firestore y otros proveedores de eventos de Google.

      • Personalizado para producir y consumir eventos desde el código de la aplicación. Sigue las instrucciones del panel Activador de Eventarc para crear un canal. Un canal es un recurso que se usa como una canalización para entregar eventos personalizados de los productores a los consumidores. Los eventos personalizados se publican en un canal y un activador de Eventarc se suscribe a esos eventos.

      • Terceros para integrarse a proveedores externos a Google que ofrecen una fuente de Eventarc. Para obtener más información, consulta Eventos de terceros en Eventarc.

   3. Selecciona un Proveedor de eventos de la lista para elegir un producto que proporcione el tipo de evento para activar tu función. Para ver la lista de proveedores de eventos, consulta Proveedores y destinos de eventos.

   4. Selecciona un Tipo de evento de la lista. La configuración del activador varía según el tipo de evento compatible. Para obtener más información, consulta Tipos de eventos.

   5. En el campo Región, selecciona una ubicación para el activador de Eventarc. En general, la ubicación de un activador de Eventarc debe coincidir con la ubicación del recurso de Google Cloud que deseas supervisar para detectar eventos. En la mayoría de los casos, también debes implementar tu función en la misma región. Consulta Información sobre las ubicaciones de Eventarc para obtener más detalles sobre las ubicaciones de activadores de Eventarc.

   6. En el campo Cuenta de servicio, selecciona una cuenta de servicio. Los activadores de Eventarc están vinculados a cuentas de servicio para usarlos como identidad cuando se invoca la función. La cuenta de servicio del activador de Eventarc debe tener el permiso para invocar tu función. De forma predeterminada, Cloud Run usa la cuenta de servicio predeterminada de Compute Engine.

   7. De manera opcional, especifica la ruta de URL del servicio a la que se enviará la solicitud entrante. Esta es la ruta de acceso relativa en el servicio de destino al que se deben enviar los eventos del activador. Por ejemplo, /, /route, route y route/subroute.

   8. Una vez que hayas completado los campos obligatorios, haz clic en Guardar activador.

7. En Autenticación, configura lo siguiente:

   • Si creas una función HTTP pública, por ejemplo, un webhook, selecciona Permitir invocaciones no autenticadas. Si seleccionas esta opción, se asigna la función de invocador de IAM al identificador especial allUser. Puedes usar IAM para editar esta configuración más adelante una vez que hayas creado el servicio. Si no tienes permisos (rol de administrador de Cloud Run) para seleccionar esta opción, el servicio se implementará y requerirá autenticación.

   • Si creas una función activada por eventos, selecciona Solicitar autenticación.

8. De manera opcional, actualiza la siguiente configuración adicional para tus funciones:

   1. Configura la asignación de CPU y los precios según sea necesario.

   2. En Ajuste de escala automático del servicio, especifica las instancias mínimas según sea necesario.

   3. Establece la configuración de Control de entrada según sea necesario.

   4. Expande la sección Contenedores, volúmenes, herramientas de redes y seguridad para establecer otra configuración opcional en las pestañas correspondientes:

      • Simultaneidad
      • Configuración del contenedor
      • Límites de CPU
      • Límites de memoria
      • Tiempo de espera de la solicitud
      • Secretos
      • Variables de entorno
      • Entorno de ejecución
      • HTTP/2
      • Cuentas de servicio
      • Conexiones de Cloud SQL
      • Conexión de VPC

9. Haz clic en Crear y espera a que Cloud Run cree el servicio con una revisión de marcador de posición.

10. La consola te redireccionará a la pestaña Fuente, en la que puedes ver el código fuente de tu función. Haz clic en Guardar y volver a implementar.

11. En la pestaña Fuente, puedes hacer clic de manera opcional en Mostrar carga útil para ver una carga útil de ejemplo de eventos entrantes.

12. Después de la implementación, haz clic en el botón Probar para probar la función creada.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Actualiza los componentes de gcloud a la versión más reciente:

   gcloud components update

3. Ejecuta el siguiente comando en el directorio que contiene el código de muestra:

   gcloud beta run deploy FUNCTION \
          --source . \
          --function FUNCTION_ENTRYPOINT \
          --base-image BASE_IMAGE \
          --region REGION
   

   Reemplaza lo siguiente:

   • Reemplaza FUNCTION por el nombre de la función que implementas. Puedes omitir este parámetro por completo, pero se te solicitará el nombre si lo haces.

   • FUNCTION_ENTRYPOINT por el punto de entrada a tu función en tu código fuente. Este es el código que ejecuta Cloud Run cuando se ejecuta tu función. El valor de esta marca debe ser un nombre de función o un nombre de clase completamente calificado que exista en tu código fuente.

   • BASE_IMAGE por el entorno de la imagen base de tu función. Para obtener más detalles sobre las imágenes base y los paquetes incluidos en cada imagen, consulta Imágenes base de los entornos de ejecución.

   • REGION por la región de Google Cloud en la que deseas implementar tu función. Por ejemplo, us-central1.

   Opcional:

   • Si creas una función de HTTP pública, por ejemplo, un webhook, especifica la marca --allow-unauthenticated. Esta marca asigna el rol de invocador de IAM de Cloud Run al identificador especial allUser. Puedes usar IAM para editar esta configuración más adelante una vez que hayas creado el servicio. Si creas una función activada por eventos o un servicio autenticado, puedes omitir esta marca.

De manera opcional, después de implementar la función, puedes agregar activadores de Eventarc a ella. Para agregar un activador, ejecuta el siguiente comando:

  gcloud eventarc triggers create EVENTARC_TRIGGER_NAME \
      --location=EVENTARC_TRIGGER_LOCATION \
      --destination-run-service=FUNCTION \
      --destination-run-region=REGION \
      --event-filters="type=EVENTARC_FILTER_TYPE" \
      --event-filters="EVENTARC_EVENT_FILTER" \
      --service-account=EVENTARC_TRIGGER_SERVICE_ACCOUNT

Reemplaza lo siguiente:

• EVENTARC_TRIGGER_NAME por el nombre del activador de Eventarc.

• EVENTARC_TRIGGER_LOCATION por la ubicación del activador de Eventarc. En general, la ubicación de un activador de Eventarc debe coincidir con la ubicación del recurso de Google Cloud que deseas supervisar para detectar eventos. En la mayoría de los casos, también debes implementar tu función en la misma región. Consulta Información sobre las ubicaciones de Eventarc para obtener más detalles sobre las ubicaciones de activadores de Eventarc.

• FUNCTION por el nombre de la función implementada.

• REGION por la región de Cloud Run de la función.

• EVENTARC_FILTER_TYPE con los filtros de eventos que supervisa el activador. Un evento que coincida con todos los filtros --event-filters activa llamadas a tu función. Cada activador debe tener un tipo de evento compatible con el formato --event-filters="type=EVENTARC_FILTER_TYPE". Este tipo de evento no se puede cambiar después de la creación. Para cambiar EVENT_FILTER_TYPE, crea un activador nuevo y borra el anterior. De manera opcional, puedes repetir la marca --event-filters con un filtro compatible en el formato ATTRIBUTE=VALUE para agregar más filtros.

• EVENTARC_TRIGGER_SERVICE_ACCOUNT con una cuenta de servicio. Los activadores de Eventarc están vinculados a cuentas de servicio para usarlos como identidad cuando se invoca la función. La cuenta de servicio del activador de Eventarc debe tener el permiso para invocar tu función. De forma predeterminada, Cloud Run usa la cuenta de servicio de procesamiento predeterminada.

Terraform

Para administrar funciones con Terraform, debes compilar el código de tu función en una imagen de contenedor y, luego, definir tu servicio de Cloud Run en una configuración de Terraform con el recurso google_cloud_run_v2_service del proveedor de Google Cloud Platform.

1. Sigue las instrucciones para compilar una función para crear una imagen de contenedor. Copia la ruta de acceso completa de la imagen del contenedor para la variable IMAGE_URL que se usará en el siguiente paso.

2. Crea un archivo main.tf nuevo con este contenido:

   provider "google" {
     project = "PROJECT-ID"
   }
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "SERVICE"
     location = "REGION"
     client   = "terraform"
     template {
       containers {
         image = "IMAGE_URL"
       }
     }
   }
   
   resource "google_cloud_run_v2_service_iam_member" "noauth" {
     location = google_cloud_run_v2_service.default.location
     name     = google_cloud_run_v2_service.default.name
     role     = "roles/run.invoker"
     member   = "allUsers"
   }
   

   Reemplaza lo siguiente:

   • PROJECT-ID por el ID del proyecto de Google Cloud.
   • REGION por la región de Google Cloud.
   • SERVICE por el nombre del servicio de Cloud Run Los nombres de servicios deben tener 49 caracteres o menos, y deben ser únicos por región y proyecto.
   • IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest Si usas Artifact Registry, el repositorio REPO_NAME debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

   Esta configuración permite el acceso público (el equivalente a --allow-unauthenticated). Para que el servicio sea privado, quita la estrofa google_cloud_run_v2_service_iam_member.

3. Inicializa Terraform mediante este comando:

   terraform init

4. Aplica la configuración de Terraform:

   terraform apply

   Ingresa yes para confirmar que deseas aplicar las acciones descritas.

Console

1. En la consola de Google Cloud, ve a la página Cloud Run:

   Ir a Cloud Run

2. Identifica el servicio que deseas actualizar en la lista de servicios y hazle clic para abrir los detalles.

3. Haz clic en Editar e implementar una revisión nueva para mostrar el formulario de implementación de revisión.

4. Modificar cualquier parámetro de configuración

5. Haz clic en Implementar y espera a que finalice la implementación.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Para actualizar uno o más parámetros de configuración del servicio, usa el comando gcloud beta run services update SERVICE con las marcas de línea de comandos de la configuración que deseas actualizar. Reemplaza SERVICE por el nombre del servicio.

Console

1. En la consola de Google Cloud, ve a la página Cloud Run:

   Ir a Cloud Run

2. Busca la función que deseas actualizar en la lista Servicios y haz clic en ella para abrir sus detalles.

3. Navega a la pestaña Fuente y haz clic en Editar fuente.

4. Haz clic en mode Editar actualizaciones de seguridad y entorno de ejecución junto a Imagen base y selecciona un Entorno de ejecución o Entorno diferente de la lista según sea necesario. Luego, haz clic en Guardar.

5. Modifica el Punto de entrada de la función según sea necesario.

6. En la sección Archivos, selecciona add Agregar archivo para crear uno nuevo, mode Cambiar nombre de archivo para cambiar el nombre de un archivo o delete Borrar archivo para borrar uno.

7. En la sección Código, modifica el código fuente según sea necesario.

8. Haz clic en Guardar y volver a implementar y espera a que finalice la implementación.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Ejecuta el siguiente comando en el directorio que contiene el código fuente de la función:

   gcloud beta run deploy FUNCTION \
          --source . \
          --function FUNCTION_ENTRYPOINT \
          --base-image BASE_IMAGE \
          --region REGION
   

   Reemplaza lo siguiente:

   • FUNCTION por el nombre de la función que deseas modificar.

   • FUNCTION_ENTRYPOINT por el punto de entrada a tu función en tu código fuente.

   • BASE_IMAGE por el entorno de la imagen base de tu función. En la mayoría de los casos, puedes especificar el ID del entorno de ejecución, por ejemplo, nodejs22.

     Como alternativa, si deseas usar un paquete de sistema específico en la pila o especificar la región desde la que se descarga la imagen base, puedes especificar una de las siguientes opciones:

     • Es la ruta de acceso completa de la imagen base, como us-central1-docker.pkg.dev/serverless-runtimes/google-22-full/runtimes/nodejs22. Esta opción te permite especificar la imagen base, un paquete del sistema específico en la pila y la región desde la que se descarga la imagen base.
     • Es el alias de la ruta de acceso completa de la imagen base, como google-22/nodejs22 o google-22-full/nodejs22. Esta opción de alias más corta te permite especificar la imagen base y un paquete de sistema específico en la pila.

     Para obtener más detalles sobre las imágenes base y los paquetes incluidos en cada imagen, consulta Imágenes base del entorno de ejecución.

   • REGION por la región de Google Cloud en la que deseas implementar tu función. Por ejemplo, us-central1.

   Marcas opcionales

   Puedes configurar las siguientes marcas opcionales mientras modificas tu función:

   • Marcas de variables de entorno de compilación para especificar variables de entorno durante el paso de compilación, como para configurar certificados o parámetros específicos del tiempo de compilación.

   • Marcas de grupo de trabajadores para especificar qué grupo de trabajadores usar en el contexto de compilación seguro de los Controles del servicio de VPC

   • Marcas de cuentas de servicio de compilación personalizadas para especificar una alternativa a la cuenta de servicio de compilación predeterminada y aumentar la seguridad.

   • Marca Actualizaciones automáticas de imágenes base para inhabilitar las actualizaciones automáticas. De forma predeterminada, las funciones tienen habilitadas las actualizaciones de seguridad automáticas.