govc
Définir l'environnement de govc pour le contrôleur, les commandes vérifiées avec Kyvernon et les limites connues.
govc se connecte au point de terminaison SOAP /sdk du contrôleur. Ses commandes de datastore utilisent aussi le point de terminaison de fichiers /folder.
Avant de commencer
- Activez les points de terminaison de compatibilité : Paramètres des points de terminaison de compatibilité.
- Utilisez le compte d'un utilisateur Kyvernon.
- Le contrôleur utilise un certificat que govc ne connaît pas par défaut. Fournissez le certificat à govc avec
GOVC_TLS_CA_CERTS, ou acceptez-le pour un test avecGOVC_INSECURE.
Avec la CLI
export GOVC_URL=https://controller.example.com:8443/sdk
export GOVC_USERNAME=admin
export GOVC_PASSWORD=<password>
export GOVC_TLS_CA_CERTS=/path/to/controller-ca.pem
govc about
govc ls
govc vm.info prod-web-01Prenez le mot de passe dans le coffre de secrets de votre automatisation, pas dans un fichier d'un dépôt. Le premier certificat d'un contrôleur configuré avec [tls] mode = "self_signed" est /var/lib/kyvernon/controller/tls/bootstrap-cert.pem sur le contrôleur.
Commandes vérifiées
Ces commandes ont été exécutées avec Kyvernon sans modification de leurs arguments. La liste complète avec le résultat de chacune figure dans outils vérifiés.
| Domaine | Commandes |
|---|---|
| Connexion | about, about.cert, session.ls, session.logout |
| Inventaire | ls, find, datacenter.info, host.info, cluster.ls, datastore.info, datastore.ls, network.ls, host.vswitch.info, host.portgroup.info, object.collect, object.save |
| Machines virtuelles | vm.create, vm.info, vm.change, vm.power, vm.clone, vm.markastemplate, vm.markasvm, vm.destroy, vm.option.info |
| Périphériques | vm.disk.create, vm.network.add, device.ls, device.cdrom.add, device.serial.add, device.serial.remove |
| Instantanés | snapshot.create, snapshot.tree, snapshot.revert, snapshot.remove |
| Dossiers | folder.create et object.destroy d'un dossier |
| Statistiques | metric.ls, metric.sample pour les machines virtuelles et les hôtes |
| Tâches et événements | tasks, events, alarm.info |
| Rôles et autorisations | role.ls, permissions.ls, fields.ls, option.ls |
| Étiquettes | tags.category.create, tags.create, tags.attach, tags.attached.ls, tags.detach, tags.rm, tags.category.rm |
Les commandes de datastore datastore.upload, datastore.download, datastore.mkdir et datastore.rm utilisent le point de terminaison de fichiers, et datastore.cp d'un fichier de disque fonctionne comme une copie de fichier sur le datastore.
Limites connues
Aucune commande de la vérification enregistrée n'a échoué. Une commande qui a besoin d'une méthode que Kyvernon ne sert pas échoue avec une erreur NotSupported. Par exemple, vm.power -s et vm.power -r appellent ShutdownGuest et RebootGuest, qui ne sont pas servies ; utilisez vm.power -off, ou kyvernon vm shutdown <id> pour un arrêt propre. Les commandes d'import de paquet import.ova et import.ovf utilisent la fonction d'import décrite dans Importer un paquet OVA ou OVF ; elles ne font pas partie de la liste vérifiée.
Voir aussi
Version 0.1. Dernière modification : 2026-11-13