Code Stream proporciona un complemento de REST que le permite integrar Code Stream con otras aplicaciones que utilizan REST API para que pueda desarrollar y distribuir continuamente aplicaciones de software que deben interactuar entre sí. El complemento de REST invoca una API, que envía y recibe información entre Code Stream y otra aplicación.

Con el complemento de REST, puede:

  • Integrar sistemas externos basados en API de REST en una canalización de Code Stream.
  • Integrar una canalización de Code Stream como parte del flujo de sistemas externos.

El complemento de REST funciona con cualquier instancia de REST API y admite los métodos GET, POST, PUT, PATCH y DELETE para enviar o recibir información entre Code Stream y otras aplicaciones.

Tabla 1. Preparar una canalización para comunicarse a través de REST API
Qué hacer Qué sucede como resultado
Agregue una tarea de REST a la canalización.

La tarea de REST comunica información entre aplicaciones y puede proporcionar información de estado para una tarea posterior en la etapa de la canalización.

En la tarea de REST, seleccione la acción REST e incluya la URL.

La tarea de la canalización llama a la URL cuando se ejecuta la canalización.

Para las acciones POST, PUT y PATCH, debe incluir una carga útil. En la carga útil, puede enlazar las propiedades de la canalización y de la tarea cuando se ejecuta la canalización.

Observe este ejemplo.

Ejemplo de uso del complemento de REST:

Puede agregar una tarea de REST para crear una etiqueta en una confirmación de Git para una compilación y hacer que la tarea envíe una solicitud para obtener el identificador de inserción del repositorio. La tarea puede enviar una carga útil al repositorio y crear una etiqueta para la compilación, y el repositorio puede devolver la respuesta con la etiqueta.

Al igual que si usa el complemento de REST para invocar una API, puede incluir una tarea de sondeo en la canalización para invocar REST API y sondearla hasta que finalice y la tarea de la canalización cumpla los criterios de salida.

También puede usar las API de REST para importar y exportar una canalización, y utilizar los scripts de ejemplo para ejecutar una canalización.

Este procedimiento obtiene una dirección URL simple.

Procedimiento

  1. Para crear una canalización, haga clic en Canalizaciones > Nueva canalización > Lienzo en blanco.
  2. En la etapa de la canalización, haga clic en + Tarea secuencial.
  3. En el panel de tareas, agregue la tarea de REST:
    1. Introduzca un nombre para la tarea.
    2. En el menú desplegable Tipo, seleccione REST.
    3. En el área Solicitud de REST, seleccione GET.
      Para que la tarea de REST solicite datos de otra aplicación, seleccione el método GET. Para enviar datos a otra aplicación, seleccione el método POST.
    4. Introduzca la URL que identifica el endpoint de REST API. Por ejemplo, https://www.google.com.
      Para que una tarea de REST importe datos desde otra aplicación, puede incluir la variable de carga útil. Por ejemplo, para una acción de importación, puede introducir ${Stage0.export.responseBody}. Si el tamaño de los datos de respuesta supera los 5 MB, es posible que se produzca un error en la tarea de REST.
    5. Para proporcionar autorización para la tarea, haga clic en Agregar encabezados e introduzca una clave de encabezado y un valor.
    Cuando agregue una tarea de REST y configure la solicitud de REST, seleccione la acción, introduzca la URL y añada los encabezados para la autorización.
  4. Para guardar la canalización, haga clic en Guardar.
  5. En la pestaña Canalización, haga clic en Habilitar canalización.
    Antes de que se pueda ejecutar la canalización, debe habilitarla.
  6. Haga clic en Guardar y, a continuación, haga clic en Cerrar.
  7. Haga clic en Ejecutar.
  8. Para ver la ejecución de la canalización, haga clic en Ejecuciones.
    Después de que la canalización comience a ejecutarse, podrá observar el estado de esta mientras se ejecuta.
  9. Para comprobar que la tarea de REST devuelve la información esperada, examine la ejecución de la canalización y los resultados de la tarea.
    1. Una vez que se complete la canalización, para confirmar que la otra aplicación devolvió los datos solicitados, haga clic en el vínculo a la ejecución de la canalización.
    2. Haga clic en la tarea de REST de la canalización.
    3. En la ejecución de la canalización, haga clic en la tarea, observe los detalles de la tarea y compruebe que la tarea de REST devolvió los resultados esperados.
      Los detalles de la tarea muestran el código de respuesta, el cuerpo, las claves de encabezado y los valores.
      Los detalles de la tarea de REST muestran el estado COMPLETADO, el código de respuesta, el cuerpo de la respuesta y los valores y las claves de encabezado.
  10. Para ver la salida de JSON, haga clic en VER SALIDA DE JSON.
    El resultado de JSON de la tarea de REST muestra los encabezados de respuesta y el cuerpo de la respuesta, e incluye el buscador de rutas para buscar en el contenido.

Resultados

Enhorabuena. Ha configurado una tarea de REST que ha invocado REST API y enviado información entre Code Stream y otra aplicación mediante el complemento de REST.

Qué hacer a continuación

Siga utilizando tareas de REST en las canalizaciones para ejecutar comandos e integrar Code Stream con otras aplicaciones para poder desarrollar y distribuir aplicaciones de software. Considere la posibilidad de usar tareas de sondeo para sondear la API hasta que finalice y la tarea de canalización cumpla los criterios de salida.