설치용 vRealize Automation REST API는 vRealize Automation에 대해 순수하게 소프트웨어에서 제어되는 설치를 생성하는 기능을 제공합니다.

설치 API에는 CLI 기반 설치가 ha.properties 응답 파일에서 가져오는 동일한 항목의 JSON 형식의 버전이 필요합니다. 다음 지침은 API의 작동 방식을 안내합니다. 여기에서 vRealize Automation을 설치하기 위한 API에 대한 프로그래밍 방식 호출을 설계할 수 있어야 합니다.

  • API 설명서에 액세스하려면 웹 브라우저를 다음 vRealize Automation 장치 페이지로 가리킵니다.

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

  • API 기반 설치로 실험하려면 다음 PUT 명령을 찾아 확장합니다.

    PUT /vra-install

  • install_json 상자에서 텍스트 편집기로 채워지지 않은 JSON을 복사합니다. ha.properties에 대해 수행하는 것과 동일한 방식으로 응답 값을 입력합니다. JSON 형식의 응답이 준비되면 코드를 다시 install_json으로 복사하고 채워지지 않은 JSON을 덮어씁니다.

    또는 다음 템플릿 JSON을 편집하고 결과를 install_json으로 복사할 수 있습니다.

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

    완료된 ha.properties를 JSON으로 변환하거나 그 반대로 수행할 수도 있습니다.

  • 작업 상자에서 검증을 선택하고 시도를 클릭합니다.

    검증 작업은 vRealize Automation 사전 요구 사항 검사기 및 수정기를 실행합니다.

  • 검증 응답에는 다음 GET 명령에 삽입할 수 있는 영숫자 명령 ID가 포함됩니다.

    GET /commands/command-id/aggregated-status

    GET에 대한 응답에는 검증 작업의 진행률이 포함됩니다.

  • 검증이 성공하면 프로세스를 반복하여 실제 설치를 실행할 수 있습니다. 작업 상자에서 검증 대신 설치를 선택하기만 하면 됩니다.

    배포 크기에 따라 설치에 오랜 시간이 걸릴 수 있습니다. 다시 명령 ID를 찾고 집계된 상태 GET 명령을 사용하여 설치 진행률을 가져옵니다. GET 응답은 다음 예와 유사할 수 있습니다.

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

  • 설치에 문제가 발생하는 경우 다음 명령을 사용하여 모든 노드에 대해 로그 수집을 트리거할 수 있습니다.

    PUT /commands/log-bundle

    설치와 마찬가지로 반환된 영숫자 명령 ID를 사용하여 로그 수집 상태를 모니터링할 수 있습니다.