Connecter des outils vSphere

Ce que vous construisez

Vous activez les points de terminaison vSphere du contrôleur, vous dirigez govc vers eux et vous listez l'inventaire avec un outil écrit pour l'API vSphere. Les mêmes étapes valent pour d'autres outils : ils ont besoin de la même adresse, du même nom d'utilisateur et du même mot de passe.

Avant de commencer

• Un contrôleur en fonctionnement et un nom d'utilisateur avec son mot de passe. La connexion vSphere prend un nom d'utilisateur et un mot de passe et n'a aucune étape pour un code de vérification ; utilisez donc un utilisateur qui n'en a pas besoin.
• Un accès root au contrôleur pour modifier sa configuration.
• govc, l'outil en ligne de commande de la bibliothèque Go pour vSphere, sur votre machine.

1. Activer les points de terminaison

Les points de terminaison sont désactivés par défaut. Dans /etc/kyvernon/controller.toml, ajoutez la section :

[facades]
enabled = true
session_timeout = "30m"

session_timeout est la durée d'inactivité après laquelle une session d'outil se termine ; 30 minutes est la valeur par défaut. Vérifiez le fichier et redémarrez le contrôleur :

sudo kyvernon-controller --config /etc/kyvernon/controller.toml check-config
sudo systemctl restart kyvernon-controller.service

Le point de terminaison SOAP se trouve maintenant à https://<controller>:8443/sdk. Les points de terminaison REST sont à /api et /rest sur la même adresse, à côté de l'API native sous /v1.

Lorsque les clients atteignent le contrôleur par un proxy inverse, deux autres clés de la même section comptent : public_host désigne l'hôte et le port que les points de terminaison placent dans les adresses qu'ils renvoient, et trust_certificate_file désigne le certificat qu'ils publient pour les clients qui l'épinglent.

2. Définir l'environnement de govc

export GOVC_URL=https://controller.example.com:8443/sdk
export GOVC_USERNAME=<user>
export GOVC_PASSWORD=<password>
export GOVC_INSECURE=1

GOVC_INSECURE=1 désactive la vérification du certificat TLS. Utilisez-le seulement tant que le contrôleur a son certificat d'amorçage, et seulement sur un réseau que vous maîtrisez. Retirez-le lorsque le contrôleur a un certificat que votre machine approuve.

3. Vérifier la connexion

govc about
govc ls

govc about affiche le nom du produit et la version d'API que le point de terminaison signale. govc ls liste le sommet de l'inventaire, qui commence par vos datacenters.

4. Lister l'inventaire

govc datastore.info
govc host.info
govc vm.info <name>
govc datastore.ls

Chaque commande affiche les objets que Kyvernon détient, avec les noms que vous voyez dans la console web. Les outils voient l'inventaire avec les autorisations de l'utilisateur connecté : un objet que l'utilisateur ne peut pas lire n'est pas listé.

5. Modifier quelque chose

govc vm.power -on <name>
govc vm.info <name>

La mise sous tension est une tâche ordinaire. Ouvrez le volet des tâches de la console web, ou exécutez kyvernon tasks list --target <id>, et la tâche apparaît avec l'utilisateur qui l'a lancée.

Résultat

Un outil écrit pour l'API vSphere lit et modifie l'inventaire du contrôleur. Les outils et les opérations qui ont été vérifiés, ainsi que les méthodes de l'API vSphere que le point de terminaison sert, figurent dans la référence générée.

Étapes suivantes

• Méthodes prises en charge liste les méthodes servies de l'API vSphere par objet géré.
• Outils vérifiés liste les outils et les opérations qui ont été exécutés sur les points de terminaison.
• Première session CLI installe le client en ligne de commande Kyvernon.