govc
De omgeving van govc instellen voor de controller, de opdrachten die tegen Kyvernon zijn geverifieerd en de bekende lacunes.
govc maakt verbinding met het SOAP-endpoint op /sdk van de controller. De datastore-opdrachten gebruiken ook het bestandsendpoint op /folder.
Voordat u begint
- Schakel de compatibiliteitsendpoints in: Instellingen van de compatibiliteitsendpoints.
- Gebruik het account van een Kyvernon-gebruiker.
- De controller gebruikt een certificaat dat govc standaard niet kent. Geef govc het certificaat met
GOVC_TLS_CA_CERTS, of accepteer het voor een test metGOVC_INSECURE.
Met de 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-01Haal het wachtwoord uit de geheimenopslag van uw automatisering, niet uit een bestand in een repository. Het eerste certificaat van een controller met [tls] mode = "self_signed" is /var/lib/kyvernon/controller/tls/bootstrap-cert.pem op de controller.
Geverifieerde opdrachten
Deze opdrachten zijn tegen Kyvernon uitgevoerd zonder wijziging van hun argumenten. De volledige lijst met het resultaat van elke opdracht staat in geverifieerde tools.
| Onderdeel | Opdrachten |
|---|---|
| Verbinding | about, about.cert, session.ls, session.logout |
| Inventaris | ls, find, datacenter.info, host.info, cluster.ls, datastore.info, datastore.ls, network.ls, host.vswitch.info, host.portgroup.info, object.collect, object.save |
| Virtuele machines | vm.create, vm.info, vm.change, vm.power, vm.clone, vm.markastemplate, vm.markasvm, vm.destroy, vm.option.info |
| Apparaten | vm.disk.create, vm.network.add, device.ls, device.cdrom.add, device.serial.add, device.serial.remove |
| Snapshots | snapshot.create, snapshot.tree, snapshot.revert, snapshot.remove |
| Mappen | folder.create en object.destroy van een map |
| Statistieken | metric.ls, metric.sample voor virtuele machines en hosts |
| Taken en gebeurtenissen | tasks, events, alarm.info |
| Rollen en machtigingen | role.ls, permissions.ls, fields.ls, option.ls |
| Tags | tags.category.create, tags.create, tags.attach, tags.attached.ls, tags.detach, tags.rm, tags.category.rm |
De datastore-opdrachten datastore.upload, datastore.download, datastore.mkdir en datastore.rm gebruiken het bestandsendpoint, en datastore.cp van een schijfbestand werkt als bestandskopie op de datastore.
Bekende lacunes
Geen opdracht van de vastgelegde verificatie is mislukt. Een opdracht die een methode nodig heeft die Kyvernon niet aanbiedt, mislukt met een NotSupported-fout. Bijvoorbeeld vm.power -s en vm.power -r roepen ShutdownGuest en RebootGuest aan, die niet worden aangeboden; gebruik vm.power -off, of kyvernon vm shutdown <id> voor een nette afsluiting. De pakketimportopdrachten import.ova en import.ovf gebruiken de importfunctie die is beschreven in Een OVA- of OVF-pakket importeren; ze staan niet in de geverifieerde lijst.
Zie ook
Versie 0.1. Laatst gewijzigd: 2026-11-13