Compila CICD para tu integración

En este instructivo, se describe cómo automatizar la promoción de una integración entre diferentes entornos en diferentes proyectos de Google Cloud con variables de configuración (vista previa).

Descripción general

En este instructivo, automatizarás las implementaciones de Application Integration con una variable de configuración para una integración de muestra. Este flujo de integración de muestra llama a una API y publica la respuesta de la API en un tema de Pub/Sub. Este ejemplo tiene como objetivo ilustrar el uso de las tareas Llamar a extremo de REST y Conectores. Puedes almacenar la integración de muestra en repositorios de GitHub que correspondan a los diferentes entornos y Google Cloud proyectos.

Crea un tema de Pub/Sub

  1. En la consola de Google Cloud , ve a la página Temas de Pub/Sub.

    Ir a temas

  2. Haga clic en Crear tema.

  3. En el campo ID de tema, ingresa un ID para tu tema. Para obtener más información sobre cómo asignar nombres a temas, consulta Lineamientos para asignar nombres a temas, suscripciones, esquemas o instantáneas.

  4. Mantén la opción Agregar una suscripción predeterminada.

  5. No selecciones las otras opciones.

  6. Haz clic en Crear un tema.

Configura un conector de Pub/Sub

  1. En la Google Cloud consola, ve a la página Integration Connectors > Connections y, luego, selecciona o crea un Google Cloud proyecto.

    Ir a la página Conexiones

  2. Haz clic en + Crear nuevo para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Pub/Sub de la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa pub-sub-connector.
    4. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    5. ID del proyecto: Google Cloud ID del proyecto en el que reside la instancia de Pub/Sub.
    6. ID del tema: Ingresa el nombre de tu tema de Pub/Sub.
    7. Haz clic en Siguiente.
  5. En la sección Autenticación, haz clic en SIGUIENTE.
  6. Revisa: Revisa tus detalles de conexión y autenticación.
  7. Haz clic en Crear.

Cómo crear una integración nueva

Después de configurar Application Integration, puedes crear una integración nueva:

  1. En la consola de Google Cloud, ve a la página Application Integration.

    Ir a Application Integration

  2. Haz clic en Integraciones en el menú de navegación de la izquierda para abrir la página Integraciones.
  3. Haz clic en Crear integración y proporciona los siguientes detalles en la página Crear integración:
    1. Nombre de la integración: Ingresa un nombre para tu integración. Por ejemplo, build-cicd
    2. Descripción: De manera opcional, ingresa una descripción para tu integración. Por ejemplo, Demo integration created for CICD tutorial
    3. Región: Selecciona la región us-central1 en la lista de regiones aprovisionadas. Si la región que deseas seleccionar no está aprovisionada, consulta Aprovisiona una región nueva. Para ver una lista de las regiones admitidas, consulta Ubicaciones de Application Integration.
    4. Cuenta de servicio: Este campo aparece si habilitaste la gobernanza para tu región. Selecciona la cuenta de servicio para tu integración. Para obtener información sobre cómo habilitar la gobernanza para tu región, consulta Edita la región.
    5. Haz clic en Crear. Esto abrirá la página del editor de integración, en la que podrás agregar las tareas y los activadores para crear tu integración.

Crea un flujo de integración

Agrega un activador de API y un elemento Llamar a extremo de REST

Para agregar un activador del Activador de API, sigue estos pasos:
  1. En la consola de Google Cloud , ve a la página Application Integration.

    Ir a Application Integration

  2. En el menú de navegación, haz clic en Integraciones.

    Aparecerá la página Lista de integraciones, en la que se enumeran todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Selecciona la integración de build-cicd.

    Esto abrirá la integración en la página del editor de integración.

  4. En la barra de navegación del editor de integración, haz clic en Activadores > Activador de API para agregar el activador.
  5. En la barra de navegación del editor de integración, haz clic en Tareas > Llamar a extremo de REST para agregar la tarea.
  6. Agrega una conexión perimetral del elemento activador de API al elemento Llamar al extremo REST. Para ello, coloca el cursor sobre un punto de control en el elemento Activador de API, luego haz clic en una línea y arrástrala hasta un punto de control en el elemento de tarea Llamar al extremo REST.

Crea variables de configuración

Para crear variables de configuración, sigue estos pasos:
  1. En la barra de navegación del editor de integración, haz clic en (Panel de activación) para abrir el panel Variables.
  2. Haz clic en +Crear.
  3. Haz lo siguiente en el panel Crear variable:
    1. En Nombre, ingresa url.

      Application Integration agrega el prefijo `CONFIG_ a las variables de configuración. Si deseas agregar la variable de configuración a tu integración con las APIs, usa el siguiente formato para las variables de configuración: `CONFIG_CONFIG_VARIABLE_NAME`. Para obtener información sobre cómo descargar y subir integraciones, consulta Sube y descarga integraciones.

    2. En Tipo de variable, selecciona Variable de configuración.
    3. En Tipo de datos, selecciona Cadena.
    4. Haz clic en Crear.

      La variable de configuración aparecerá en el panel Variables.

  4. Repite los pasos 2 y 3 para agregar la siguiente variable de configuración:
    • Nombre: connection_name.
    • Tipo de variable: Config Variable
    • Tipo de datos: String

Agrega y configura la tarea Llamar a extremo de REST

Para crear una variable de configuración, sigue estos pasos:
  1. En el editor de integración, haz clic en la tarea Llamar a extremo de REST para abrir el panel de configuración de la tarea. A continuación, haz lo siguiente:
    1. Expande la sección Entrada de tarea.
    2. En la URL base del extremo, haz clic en Variable y agrega $`CONFIG_url`$.

Agrega y configura una tarea Conectores

  1. En la barra de navegación del editor de integración, haz clic en Tarea > Conectores.
  2. Haz clic en Configurar conectores.
  3. En la lista Región, selecciona la región en la que creaste el conector de Pub/Sub.
  4. En el campo Conexión, selecciona el conector de Pub/Sub que creaste en el paso anterior.
  5. En la sección Tipo, selecciona Acciones.
  6. En la sección Configurar entidades/acciones, para Acciones, selecciona publishMessage.
  7. En Valor predeterminado, agrega el valor predeterminado para la variable de configuración.
  8. Haz clic en Crear.
  9. En el panel de configuración de la tarea Connectors, expande la sección Detalles de la conexión para actualizar el siguiente campo:
    1. En el campo Nombre de la conexión, haz clic en Variable y selecciona $`CONFIG_connection_name`$.

Agrega una tarea de asignación de datos

  1. En la barra de navegación del editor de integración, haz clic en Tarea > Asignación de datos.
  2. Agrega una conexión perimetral desde el elemento Llamar al extremo REST al elemento asignación de datos coloca el cursor sobre un punto de control en el elemento Llamar al extremo REST. Luego, haz clic en una línea y arrástrala hasta un punto de control en el elemento de tarea Asignación de datos.
  3. Agrega otra conexión perimetral del elemento Asignación de datos al elemento Conectores. Para ello, coloca el cursor sobre un punto de control del elemento Asignación de datos y, luego, haz clic y arrastra una línea a un punto de control en el elemento de tarea Conectores.
  4. En el panel de configuración de la tarea de Asignación de datos, haz clic en Abrir el Editor de asignaciones de datos.
  5. Asigna la variable de salida de la tarea Call REST Endpoint a la variable de entrada de la tarea Connectors.

Publica la integración

Para publicar la integración, sigue estos pasos:
  1. Para publicar la integración, haz clic en Publicar en la barra de herramientas del editor de integración.

    Aparecerá el diálogo Publicar integración.

  2. En el diálogo Publicar integración, ingresa el valor de las siguientes variables de configuración:
    1. url: Ingresa el nombre de la URL del extremo.
    2. connection_name: Ingresa el nombre del conector de Pub/Sub que creaste en el paso anterior.
  3. Haz clic en Publicar.
  4. Una vez que publiques tu integración de forma correcta, podrás ver e inspeccionar los registros de ejecución de la integración publicada. Para ver registros, haz clic en Registros en la barra de herramientas del editor de integración.

Promueve la integración en todos los entornos

Para promocionar tu integración en todos los entornos, puedes usar la herramienta integrationcli, que es de código abierto y te permite interactuar con las APIs de Application Integration y las APIs de Integration Connectors. Esta herramienta te permite administrar entidades de integración, como integraciones, parámetros de configuración de autenticación, etcétera. Para obtener información sobre cómo generar el código base para la integración y aplicar los cambios que genera el código base, consulta Introducción a integrationcli en el blog de la comunidad.

También puedes promover cambios en diferentes entornos configurando canalizaciones de DevOps, por ejemplo, con Jenkins, GitLab, Cloud Build, etcétera. Para obtener más información, consulta Integración con Cloud Build.

Si no quieres usar integrationcli, puedes descargar y subir la integración de forma manual a un proyecto nuevo. Deberás crear los conectores en el proyecto nuevo de forma manual, ya que actualmente no se pueden descargar. Cuando publicas la integración en el nuevo entorno, Application Integration te permite ingresar valores para las variables de configuración.

¿Qué sigue?