Dirigir eventos a un endpoint HTTP interno en una red de VPC

Consola

1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.

   Ir al selector de proyectos

2. Habilita las APIs Cloud Logging y Eventarc.

   Habilitar las APIs

3. Si procede, habilita la API relacionada con los eventos directos. Por ejemplo, para los eventos de Cloud Run Functions, habilita cloudfunctions.googleapis.com.

4. Si aún no tienes una, crea una cuenta de servicio gestionada por el usuario y, a continuación, concédele los roles y permisos necesarios para que Eventarc pueda gestionar eventos de tu servicio de destino.

   1. En la Google Cloud consola, ve a la página Crear cuenta de servicio.

      Ir a Crear cuenta de servicio

   2. Selecciona el proyecto.

   3. En el campo Nombre de cuenta de servicio, escribe un nombre. La Google Cloud consola rellena el campo ID de cuenta de servicio con este nombre.

      En el campo Descripción de la cuenta de servicio, escribe una descripción. Por ejemplo, Service account for event trigger.

   4. Haz clic en Crear y continuar.

   5. Para proporcionar el acceso adecuado, en la lista Seleccionar un rol, elige los roles de gestión de identidades y accesos (IAM) que quieras conceder a tu cuenta de servicio. Para obtener más información, consulta Roles y permisos de un endpoint HTTP interno en una red de VPC.

      Para añadir más roles, haz clic en add Añadir otro rol y añade cada rol adicional.

   6. Haz clic en Continuar.

   7. Para terminar de crear la cuenta, haga clic en Hecho.

5. Si vas a crear un activador para recibir eventos directos de Cloud Storage, otorga el rol de editor de Pub/Sub (roles/pubsub.publisher) al agente de servicio de Cloud Storage:

   1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

      Ir a IAM

   2. Selecciona la casilla Incluir concesiones de roles proporcionadas por Google.

   3. En la columna Principal, busque el agente de servicio de Cloud Storage con el formato service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com, y, a continuación, haga clic en edit Editar principal en la fila correspondiente.

   4. Haz clic en add Añadir rol o en add Añadir otro rol.

   5. En la lista Selecciona un rol, busca Pub/Sub Publisher y, a continuación, selecciona el rol.

   6. Haz clic en Guardar.

6. Si el URI del endpoint HTTP interno de la red de VPC usa el nombre de DNS interno de un servicio que se puede resolver mediante Cloud DNS, asigna el rol de peer de DNS (roles/dns.peer) en el proyecto host de la VPC al agente de servicio de Eventarc.

   Ten en cuenta que, en función de cómo hayas configurado la red de VPC, el proyecto host de la VPC también puede ser tu proyecto de activador de Eventarc.

   1. En la Google Cloud consola, en la página del selector de proyectos, selecciona el proyecto host de VPC.

      Ir al selector de proyectos

   2. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

      Ir a IAM

   3. Selecciona la casilla Incluir concesiones de roles proporcionadas por Google.

   4. Modifica o añade el agente de servicio de Eventarc como principal:

      • Si el agente de servicio de Eventarc ya tiene otros roles en el proyecto, busca la fila que contiene la cuenta principal con el formato service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com, haz clic en edit Editar cuenta principal en esa fila y, a continuación, haz clic en add Añadir otro rol.

      • Si el agente de servicio de Eventarc no tiene ningún rol en el proyecto, haz clic en person_add Conceder acceso y, a continuación, introduce la dirección de correo en el formulario service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com.

      Sustituye PROJECT_NUMBER por el Google Cloud número de proyecto de tu proyecto de activador de Eventarc. Puedes encontrar el número de tu proyecto en la página Bienvenido de la consola Google Cloud o ejecutando el siguiente comando:

      gcloud projects describe PROJECT_ID --format='value(projectNumber)'

   5. En la lista Selecciona un rol, filtra por Peer de DNS y, a continuación, selecciona el rol.

   6. Haz clic en Guardar.

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. Habilita las APIs Cloud Logging, Eventarc y Eventarc Publishing.

   gcloud services enable logging.googleapis.com \
     eventarc.googleapis.com \
     eventarcpublishing.googleapis.com

3. Si procede, habilita la API relacionada con los eventos. Por ejemplo, para los eventos de Cloud Run Functions, habilita cloudfunctions.googleapis.com.

4. Si aún no tienes una, crea una cuenta de servicio gestionada por el usuario y, a continuación, concédele los roles y permisos necesarios para que Eventarc pueda gestionar los eventos de tu servicio de destino.

   1. Crea la cuenta de servicio:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Sustituye SERVICE_ACCOUNT_NAME por el nombre de la cuenta de servicio. Debe tener entre 6 y 30 caracteres, y puede contener caracteres alfanuméricos en minúscula y guiones. Una vez que hayas creado una cuenta de servicio, no podrás cambiar su nombre.

   2. Concede los roles o permisos de Gestión de Identidades y Accesos (IAM) necesarios. Para obtener más información, consulta Roles y permisos de un endpoint HTTP interno en una red de VPC.

5. Si el URI del endpoint HTTP interno de la red de VPC usa el nombre de DNS interno de un servicio que se puede resolver mediante Cloud DNS, asigna el rol de peer de DNS (roles/dns.peer) en el proyecto host de VPC al agente de servicio de Eventarc.

   Ten en cuenta que, en función de cómo hayas configurado la red de VPC, el proyecto host de la VPC también puede ser tu proyecto de activador de Eventarc.

   gcloud projects add-iam-policy-binding VPC_HOST_PROJECT_ID \
       --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com \
       --role=roles/dns.peer

   Haz los cambios siguientes:

   • VPC_HOST_PROJECT_ID: el Google Cloud ID de proyecto del proyecto host de la VPC.
   • PROJECT_NUMBER: el Google Cloud número de proyecto de tu proyecto de activador de Eventarc. Puedes encontrar el número de tu proyecto en la página Bienvenido de la consola Google Cloud o ejecutando el siguiente comando:

   gcloud projects describe PROJECT_ID --format='value(projectNumber)'

6. Si vas a crear un activador para eventos directos de Cloud Storage, otorga el rol Publicador de Pub/Sub (roles/pubsub.publisher) en el proyecto al agente de servicio de Cloud Storage:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com \
       --role=roles/pubsub.publisher

Consola

1. En la Google Cloud consola, ve a la página Triggers (Activadores) de Eventarc.

   Ir a Activadores

2. Haz clic en add_box Crear activador.
3. Escribe un Nombre del activador.

   Es el ID del activador y debe empezar por una letra. Puede contener hasta 63 letras minúsculas, números o guiones.

4. En Tipo de activador, seleccione Fuentes de Google o Terceros.
5. Selecciona un proveedor de eventos.

   Es el servicio que es la fuente de los eventos. En el caso de una fuente de Google, se puede hacer directamente o a través de sus registros de auditoría.

6. En función del tipo de evento que estés enrutando, haz una de las siguientes acciones:
   1. Eventos directos: en la lista Tipo de evento, en los eventos Directos, seleccione un tipo de evento.
      1. En el caso de los eventos directos de Cloud Pub/Sub, en la lista Seleccionar un tema de Cloud Pub/Sub, elija un tema o acepte el valor predeterminado Ninguno para que se cree un tema.
      2. En el caso de los eventos directos de Cloud Storage, especifica o busca el identificador único global del segmento de Cloud Storage.
   2. Eventos de registro de auditoría: en la lista Tipo de evento, en los eventos a través de los registros de auditoría de Cloud, seleccione un tipo de evento y, a continuación, una de las siguientes opciones:
      • Cualquier recurso: es el valor predeterminado e incluye recursos creados dinámicamente que tienen identificadores generados en el momento de la creación.
      • Recurso específico: debes proporcionar el nombre completo del recurso.
      • Patrón de ruta: puedes filtrar recursos mediante un patrón de ruta. Por ejemplo, escribe projects/_/buckets/eventarc-bucket/objects/random.txt o projects/_/buckets/**/r*.txt.
   3. Eventos de terceros: en la lista Canal, seleccione un canal y, a continuación, en la lista Tipo de evento, seleccione un evento.

      Para obtener más información, consulta el artículo Crear un canal y obtener sus detalles.

7. Si procede, en la lista Tipo de contenido de datos de evento, seleccione application/json o application/protobuf para especificar la codificación de la carga útil del evento.

   Ten en cuenta que una carga útil de evento con formato JSON es más grande que una con formato Protobuf. Esto puede afectar a la fiabilidad en función del destino de los eventos y sus límites de tamaño. Para obtener más información, consulta Problemas conocidos.

8. Si procede, haga clic en Añadir filtro y especifique lo siguiente:
   1. En el campo Atributo 1, en función del evento directo que haya elegido, seleccione un ID de recurso que pueda actuar como filtro de eventos.
   2. Selecciona un operador:
      • Igual
      • Patrón de ruta

        Para obtener más información, consulta Información sobre los patrones de ruta.

   3. En el campo Valor del atributo 1, en función del operador que haya elegido, escriba el valor exacto o aplique un patrón de ruta.
   4. Si se aplica el campo Atributo 2, especifica los valores correspondientes.
9. En la lista Región, selecciona una ubicación.

   Para evitar problemas de rendimiento y de residencia de datos, la ubicación debe coincidir con la del Google Cloud servicio que genera los eventos Google Cloud .

   Ten en cuenta que, en este destino de evento, solo se admiten las siguientes ubicaciones:

   • asia-east1
   • europe-north1
   • europe-west1
   • us-east1

   Para obtener más información, consulta Ubicaciones de Eventarc.

10. Selecciona la cuenta de servicio que invocará tu servicio.

    También puedes crear una cuenta de servicio.

    Especifica el correo electrónico de la cuenta de servicio de gestión de identidades y accesos asociada al activador y a la que has concedido roles específicos necesarios para Eventarc.

11. En la lista Event destination (Destino de eventos), selecciona HTTP endpoint (internal) (Endpoint HTTP [interno]).
    1. Especifica el URI de destino. Es el URI del endpoint HTTP interno de la red VPC que recibe los eventos del activador. El URI puede ser una dirección IP interna estática en la red VPC a la que se dirige la vinculación de red o el nombre de DNS interno de un servicio que se puede resolver mediante Cloud DNS.

       Si el endpoint HTTP usa un nombre de DNS interno, Eventarc crea automáticamente zonas de peering de DNS y reenvía las solicitudes de DNS a las zonas de DNS de la red VPC de destino. El emparejamiento de DNS te permite enviar solicitudes de registros que proceden del espacio de nombres de una zona a otra red de VPC. Para obtener más información, consulta Zonas de peering y Crear una zona de peering.

       Ten en cuenta que no puedes crear más de un activador para el mismo nombre de DNS.

    2. En la lista Network attachment (Adjunto de red), selecciona un identificador para el recurso de adjunto de red. Este identificador se genera después de crear un archivo adjunto de red. Para obtener más información, consulta el artículo Crear archivos adjuntos de red.

       Las vinculaciones de red permiten que las redes de VPC de los productores de servicios inicien conexiones con las redes de VPC de los consumidores. Eventarc usa la vinculación de red para establecer una conexión con el endpoint HTTP interno alojado en la red de VPC del consumidor y publicar eventos.

       Cuando creas un adjunto de red, puedes autorizar explícitamente una conexión mediante listas de aceptación y rechazo de productores. En cualquier caso, Eventarc puede actualizar la lista de aceptación de un adjunto de red con el ID de proyecto adecuado y sin que tengas que hacer nada.

12. Haz clic en Crear.

Una vez creado un activador, no se pueden modificar los filtros de origen de eventos. En su lugar, cree un activador nuevo y elimine el anterior. Para obtener más información, consulta Gestionar activadores.

gcloud

Para crear un activador, ejecuta un comando gcloud eventarc triggers create junto con las marcas obligatorias y opcionales.

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-http-endpoint-uri=ENDPOINT_URI \
    --network-attachment=NETWORK_ATTACHMENT_ID \
    --event-filters="type=EVENT_FILTER_TYPE" \
    --event-filters="COLLECTION_ID=RESOURCE_ID" \
    --event-filters-path-pattern="COLLECTION_ID=PATH_PATTERN" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-http-endpoint-uri=http://my-vm.us-central1-a.c.my-project.internal \
    --network-attachment="projects/my-project/regions/us-central1/networkAttachments/my-attachment-name" \
    --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
    --service-account=my-service-account@my-project.iam.gserviceaccount.com

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-http-endpoint-uri=ENDPOINT_URI \
    --network-attachment=NETWORK_ATTACHMENT_ID \
    --event-filters="type=google.cloud.audit.log.v1.written" \
    --event-filters="serviceName=SERVICE_NAME" \
    --event-filters="methodName=METHOD_NAME" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-http-endpoint-uri=http://10.10.10.2 \
    --network-attachment="projects/my-project/regions/us-central1/networkAttachments/my-attachment" \
    --event-filters="type=google.cloud.audit.log.v1.written" \
    --event-filters="serviceName=eventarc.googleapis.com" \
    --event-filters="methodName=google.cloud.eventarc.v1.Eventarc.GetTrigger" \
    --event-filters="resourceName=projects/my-project/locations/us-central1/triggers/my-trigger" \
    --service-account=my-service-account@my-project.iam.gserviceaccount.com

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-http-endpoint-uri=ENDPOINT_URI \
    --network-attachment=NETWORK_ATTACHMENT_ID \
    --event-filters="type=EVENT_FILTER_TYPE" \
    --channel=CHANNEL_NAME \
    --project=PROJECT_ID \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-http-endpoint-uri=http://my-vm.us-central1-a.c.my-project.internal \
    --network-attachment="projects/my-project/regions/us-central1/networkAttachments/my-attachment-name" \
    --event-filters="type=third-party-event-type" \
    --channel=my-channel \
    --project=my-project-ID \
    --service-account=my-service-account@my-project.iam.gserviceaccount.com

Consola

1. En la Google Cloud consola, ve a la página Triggers (Activadores) de Eventarc.

   Ir a Activadores

   En esta página se muestran todos tus activadores de todas las ubicaciones, así como detalles como nombres, regiones, proveedores de eventos, destinos y más.

2. Para filtrar tus activadores, sigue estos pasos:

   1. Haz clic en filter_list Filtrar o en el campo Activar filtros.
   2. En la lista Propiedades, seleccione una opción para filtrar los activadores.

   Puede seleccionar una sola propiedad o usar el operador lógico OR para añadir más propiedades.

3. Para ordenar los activadores, junto al encabezado de cualquier columna admitida, haz clic en arrow_upward Ordenar.

gcloud

Ejecuta el siguiente comando para ver una lista de tus activadores:

gcloud eventarc triggers list --location=-

Este comando muestra los activadores de todas las ubicaciones e incluye detalles como nombres, tipos, destinos y estados.