VMware Aria Automation 8.16

8.18 8.17 8.16 8.14 8.13 all
Português (Brasil) 简体中文 Deutsch Español Français Italiano 日本語 한국어 Nederlands Русский 繁體中文 English

How do I use a REST API to integrate
Automation Pipelines
 with other applications

Automation Pipelines
 provides a REST plug-in, which allows you to integrate
Automation Pipelines
 with other applications that use a REST API so that you can continuously develop and deliver software applications that must interact with each other. The REST plug-in invokes an API, which sends and receives information between
Automation Pipelines
 and another application.
With the REST plug-in, you can:
  • Integrate external REST API-based systems into a
    Automation Pipelines
     pipeline.
  • Integrate a
    Automation Pipelines
     pipeline as part of the flow of external systems.
The REST plug-in works with any REST API, and supports GET, POST, PUT, PATCH, and DELETE methods to send or receive information between
Automation Pipelines
 and other applications.
Preparing a pipeline to communicate over the REST API
What you do
What happens as a result
Add a REST task to your pipeline.
The REST task communicates information between applications, and can provide status information for a successive task in the pipeline stage.
In the REST task, select the REST action and include the URL.
The pipeline task calls the URL when the pipeline runs.
For POST, PUT, and PATCH actions, you must include a payload. In the payload, you can bind your pipeline and task properties when the pipeline runs.
Consider this example.
Example use of the REST plug-in:
You can add a REST task to get information that is needed for a subsequent pipeline task.
Similar to using the REST plug-in to invoke an API, you can include a Poll task in your pipeline to invoke a REST API and poll it until it completes and the pipeline task meets the exit criteria. See What types of tasks are available in Automation Pipelines.
You can also use REST APIs to import and export a pipeline, and use the example scripts to run a pipeline.
In this procedure, the REST task gets a build tag from one service and a subsequent CI task uses the build tag to get a CICD build number.
  1. To create a pipeline, click
    Pipelines
    New Pipeline
    Blank Canvas
    .
  2. In your pipeline stage, click
    + Sequential Task
    .
  3. In the task pane, add the REST task:
    1. Enter a name for the task.
    2. In the Type drop-down menu, select
      REST
      .
    3. In the REST Request area, select
      GET
      .
      To have the REST task request data from another application, you select the GET method. To send data to another application, you select the POST method.
    4. Enter the URL that identifies the REST API endpoint used to obtain the build tag. For example: 
      https://devops.mycompany.com:8001/job/service-build/api/json
      Automation Pipelines
       does not support
      %2F
       as URL encoding for
      /
       as in: 
      https://gitlab.com/api/v4/projects/1234567/repository/files/FOLDERNAME%2Ftest.yaml
      When specifying the REST API endpoint, use a basic URL format such as:
      https://gitlab.com/api/v4/projects/1234567/repository/files/FOLDERNAME/test.yaml
      For a REST task to import data from another application, you can include the payload variable. For example, for an import action, you can enter
      ${Stage0.export.responseBody}
      . If the response data size exceeds 5 MB, the REST task might fail.
    5. To provide authorization for the task, click
      Add Headers
       and enter header keys and values, such as:
      Key
      Value
      Accept
      application/json
      Content-Type
      application/json
    When you add a REST task, and configure the REST request, you select the action, enter the URL, and add any headers for authorization.
  4. Add subsequent task that uses information from the REST task response.
  5. To save your pipeline, click
    Save
    .
  6. On the pipeline tab, click
    Enable pipeline
    .
    Before the pipeline can run, you must enable it.
  7. Click
    Save
    , then click
    Close
    .
  8. Click
    Run
    .
  9. To watch the pipeline run, click
    Executions
    .
    After the pipeline starts to run, you can observe the pipeline status as it runs.
  10. To verify that the REST task returns the information you expect, examine the pipeline execution and the task results.
    1. After the pipeline completes, to confirm that the other application returned the data you requested, click the link to the pipeline execution.
    2. Click the REST task in the pipeline.
    3. In the pipeline execution, click the task, observe the task details, and verify that the REST task returned the expected results.
      The task details display the response code, body, header keys, and values.
      The details for the REST task display the status as COMPLETED, the response code, the response body, and header keys and values.
  11. To see the JSON output, click
    VIEW OUTPUT JSON
    .
    The JSON output for the REST task displays the response headers and response body, and includes the path finder for searching the content.
Congratulations! You configured a REST task that invoked a REST API and sent information between
Automation Pipelines
 and another application by using the REST plug-in.
Continue to use REST tasks in your pipelines to run commands and integrate
Automation Pipelines
 with other applications so that you can develop and deliver your software applications. Consider using poll tasks that poll the API until it completes, and the pipeline task meets the exit criteria.

Content feedback and comments