Интерфейс REST API для установки vRealize Automation позволяет выполнять установки vRealize Automation, управляемые исключительно программным обеспечением.

Для API установки требуется, чтобы в формате JSON предоставлялись те же записи, которые при установке через командную строку принимаются из файла ответов ha.properties. Приведенные далее инструкции помогут ознакомиться с принципом работы API и научиться составлять программные вызовы API для установки vRealize Automation.

  • Чтобы получить доступ к документации по API, задайте для веб-браузера указание на следующую страницу Устройство vRealize Automation.

    https://vrealize-automation-appliance-FQDN:5480/config

  • Чтобы испробовать различные варианты установки с помощью API, найдите и разверните следующую команду PUT.

    PUT /vra-install

  • Скопируйте незаполненные параметры в формате JSON из поля install_json в текстовый редактор. Введите значения ответов так же, как это делается в ha.properties. Когда ответы в формате JSON будут готовы, скопируйте и вставьте код в install_json, заменив им незаполненные параметры в формате JSON.

    Альтернативный способ: отредактировать указанный далее шаблон данных JSON и скопировать результат в install_json.

    /usr/lib/vcac/tools/install/installationProperties.json

    Можно также преобразовать заполненный файл ha.properties в формат JSON и наоборот.

  • В поле действия введите проверить и щелкните элемент Испробовать.

    Действие проверки запускает в vRealize Automation проверку обязательных условий и исправление неполадок.

  • Ответ на действие проверки содержит буквенно-цифровой код команды, который следует вставить в указанную далее команду GET.

    GET /commands/command-id/aggregated-status

    Ответ на команду GET содержит информацию о ходе выполнения проверки.

  • После успешного завершения проверки можно запустить саму установку, повторив процесс. Для этого в поле действия просто выберите вместо варианта проверить вариант установить.

    В зависимости от масштаба развертывания установка может занять значительное время. Чтобы проверить ход ее выполнения, найдите снова код команды и воспользуйтесь командой GET для получения суммарного состояния. В примере ниже показано, как может выглядеть ответ на команду GET.

    "progress": "78%", "counts": {"failed": 0, "completed": 14, "total": 18, "queued": 3, "processing": 1}, "failed-commands": 0

  • Если возникли проблемы с установкой, можно запустить сбор данных журнала для всех узлов с помощью указанной далее команды.

    PUT /commands/log-bundle

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