vRealize Automation Code Stream содержит подключаемый модуль REST, позволяющий интегрировать vRealize Automation Code Stream с другими приложениями, использующими интерфейс REST API. Это дает возможность непрерывно разрабатывать и предоставлять приложения, которым необходимо взаимодействовать друг с другом. Подключаемый модуль REST вызывает API-интерфейс, который осуществляет обмен данными между vRealize Automation Code Stream и другим приложением.

Подключаемый модуль REST позволяет выполнять следующие действия.

  • Интеграция внешних систем на базе интерфейса REST API в конвейер vRealize Automation Code Stream.
  • Интеграция конвейера vRealize Automation Code Stream в процессы внешних систем.

Подключаемый модуль REST работает с любыми интерфейсами REST API и поддерживает методы GET, POST, PUT, PATCH и DELETE при обмене данными между vRealize Automation Code Stream и другими приложениями.

Табл. 1. Подготовка конвейера для обмена данными по интерфейсу REST API
Действия... Результат...
Добавьте задачу REST в конвейер.

Задача REST выполняет передачу данных между приложениями и может предоставлять сведения о состоянии для следующей задачи текущего этапа конвейера.

В задаче REST выберите действие REST и укажите URL-адрес.

В ходе работы конвейера задача конвейера вызывает URL-адрес.

Для действий POST, PUT и PATCH необходимо добавить полезные данные. В полезных данных можно выполнить привязку свойств конвейера и задачи в ходе выполнения конвейера.

Рассмотрим пример.

Пример использования подключаемого модуля REST.

Можно добавить задачу REST, которая будет создавать тег для сборки при отправке кода в Git, и настроить в параметрах задачи отправку запроса на получение идентификатора обновления кода из репозитория. Задача может отправить полезную нагрузку в репозиторий и создать тег для сборки, а репозиторий может отправить ответ, содержащий этот тег.

По аналогии с использованием подключаемого модуля REST для вызова API-интерфейса можно включить в конвейер задачу опроса, которая будет вызывать интерфейс REST API и опрашивать его, пока он не завершит работу и пока задача конвейера не будет удовлетворять выходным критериям.

Кроме того, можно использовать интерфейсы REST API для импорта и экспорта конвейера, а также применять образцы сценариев для запуска конвейера.

Эта процедура позволяет получить обычный URL-адрес.

Процедура

  1. Чтобы создать конвейер, выберите Конвейеры > Создать конвейер > Пустой холст.
  2. В текущем этапе конвейера щелкните Новая последовательная задача.
  3. На панели задач добавьте задачу REST.
    1. а. Введите имя задачи.
    2. б. В раскрывающемся меню «Тип» выберите REST.
    3. в. В области «Запрос REST» выберите GET.
      Чтобы получить данные запроса задачи REST из другого приложения, необходимо выбрать метод GET. Чтобы отправить данные в другое приложение, выберите метод POST.
    4. г. Введите URL-адрес, определяющий конечную точку интерфейса REST API. Например, https://www.google.com.
      Для того чтобы задача REST могла импортировать данные из другого приложения, можно включить в нее переменную полезной нагрузки. Например, для действия «импорт» можно ввести ${Stage0.export.responseBody}. Если размер данных ответа превышает 5 МБ, задача REST может завершиться сбоем.
    5. д. Для авторизации задачи щелкните Добавить заголовки, введите ключ и значение заголовка.
    Добавление и настройка задачи REST в конвейере.
  4. Чтобы сохранить конвейер, щелкните Сохранить.
  5. На вкладке «Конвейер» щелкните Включить конвейер.
    Включение конвейера, содержащего задачу REST.
  6. Щелкните Сохранить, затем Закрыть.
  7. Щелкните Запустить.
  8. Чтобы отслеживать работу конвейера, нажмите Выполняемые элементы.
    Наблюдение за работой конвейера, содержащего задачу REST.
  9. Чтобы убедиться, что подключаемый модуль REST возвращает ожидаемые данные, проверьте выполнение конвейера и результаты задачи.
    1. а. После завершения работы конвейера убедитесь, что другое приложение вернуло запрошенные данные. Для этого щелкните ссылку на ход выполнения конвейера.
    2. б. Щелкните задачу REST в конвейере.
    3. в. В ходе выполнения конвейера щелкните задачу, просмотрите сведения о задаче и убедитесь, что подключаемый модуль REST вернул ожидаемые результаты.
      В сведениях о задаче отображается код ответа, текст, ключи заголовка и значения.
      Сведения о задаче для конвейера, содержащего задачу REST.
  10. Чтобы просмотреть выходные данные JSON, щелкните Просмотреть выходные данные JSON.
    Просмотр выходных данных JSON для задачи REST в конвейере.

Результаты

Поздравляем! Вы настроили задачу REST, которая вызывает интерфейс REST API и осуществляет обмен данными между vRealize Automation Code Stream и другим приложением с помощью подключаемого модуля REST.

Дальнейшие действия

Продолжайте использовать задачи REST в конвейерах для выполнения команд и интеграции vRealize Automation Code Stream с другими приложениями в процессе разработки и предоставления ПО. Оцените возможность использования специальных задач для опроса API-интерфейса, которые опрашивают интерфейс до завершения его работы и до того момента, пока задача конвейера не будет соответствовать выходным критериям.