L'API REST de vRealize Automation pour l'installation vous donne la possibilité de créer des installations purement contrôlées par logiciel pour vRealize Automation.

L'API d'installation nécessite une version au format JSON des mêmes entrées qu'obtient l'installation depuis l'interface de ligne de commande à partir du fichier de réponse ha.properties. Les directives suivantes vous permettent de vous familiariser avec le fonctionnement de l'API. Vous pourrez ensuite concevoir des appels programmatiques de conception à l'API pour installer vRealize Automation.

  • Pour accéder à la documentation de l'API, allez à la page Web suivante dispositif vRealize Automation.

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

  • Pour expérimenter l'installation basée sur API, localisez et développez la commande PUT suivante.

    PUT /vra-install

  • Copiez le format JSON non renseigné de la zone install_json vers un éditeur de texte. Renseignez les valeurs de réponse de la même manière que vous le feriez pour ha.properties. Lorsque vos réponses au format JSON sont prêtes, recopiez le code dans install_json et remplacez le format JSON non renseigné.

    Vous pouvez également modifier le modèle JSON suivant et copier les résultats dans install_json.

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

    Vous pouvez également convertir un ha.properties renseigné en JSON ou vice versa.

  • Dans la zone d'action, sélectionnez validate et cliquez sur Try It Out.

    L'action de validation exécute l'utilitaire de vérification et de correction des conditions requises de vRealize Automation.

  • La réponse de validation inclut un ID de commande alphanumérique que vous pouvez insérer dans la commande GET suivante.

    GET /commands/command-id/aggregated-status

    La réponse au GET inclut l'avancement de l'opération de validation.

  • Lorsque la validation aboutit, vous pouvez exécuter l'installation proprement dite en recommençant le processus. Dans la zone d'action, sélectionnez simplement install plutôt que validate.

    L'installation peut prendre un certain temps selon la taille du déploiement. De nouveau, localisez l'ID de commande, puis utilisez la commande GET d'état agrégé pour obtenir l'avancement de l'installation. La réponse GET peut ressembler à l'exemple suivant.

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

  • Si l'installation ne se déroule pas correctement, vous pouvez déclencher une collecte de journaux pour tous les nœuds à l'aide de la commande suivante.

    PUT /commands/log-bundle

    À l'instar de l'installation, l'ID de commande alphanumérique renvoyé vous permet de surveiller l'état de collecte de journaux.