vSphere-tools koppelen

Wat u opbouwt

U schakelt de vSphere-endpoints van de controller in, richt govc erop en toont de inventaris met een tool die voor de vSphere-API is geschreven. Dezelfde stappen gelden voor andere tools: ze hebben hetzelfde adres, dezelfde gebruikersnaam en hetzelfde wachtwoord nodig.

Voordat u begint

• Een draaiende controller en een gebruikersnaam met wachtwoord. De vSphere-aanmelding neemt een gebruikersnaam en een wachtwoord en kent geen stap voor een verificatiecode, dus gebruik een gebruiker die er geen nodig heeft.
• Root-toegang tot de controller om zijn configuratie te bewerken.
• govc, de opdrachtregeltool van de Go-bibliotheek voor vSphere, op uw machine.

1. De endpoints inschakelen

De endpoints staan standaard uit. Voeg in /etc/kyvernon/controller.toml de sectie toe:

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

session_timeout is de inactiviteitstijd waarna een toolsessie eindigt; 30 minuten is de standaardwaarde. Controleer het bestand en herstart de controller:

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

Het SOAP-endpoint staat nu op https://<controller>:8443/sdk. De REST-endpoints staan op /api en /rest op hetzelfde adres, naast de native API onder /v1.

Wanneer clients de controller via een reverse proxy bereiken, doen nog twee sleutels van dezelfde sectie ertoe: public_host geeft de host en poort die de endpoints in de adressen zetten die ze teruggeven, en trust_certificate_file geeft het certificaat dat ze publiceren voor clients die het vastpinnen.

2. De omgeving van govc instellen

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

GOVC_INSECURE=1 slaat de controle van het TLS-certificaat over. Gebruik het alleen zolang de controller zijn bootstrapcertificaat heeft, en alleen op een netwerk dat u beheert. Verwijder het wanneer de controller een certificaat heeft dat uw machine vertrouwt.

3. De verbinding controleren

govc about
govc ls

govc about toont de productnaam en de API-versie die het endpoint meldt. govc ls toont de top van de inventaris, die met uw datacenters begint.

4. De inventaris tonen

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

Elke opdracht toont de objecten die Kyvernon bijhoudt, met de namen die u in de webconsole ziet. De tools zien de inventaris met de machtigingen van de gebruiker die zich aanmeldde: een object dat de gebruiker niet mag lezen, wordt niet getoond.

5. Iets wijzigen

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

Het inschakelen is een gewone taak. Open het takenpaneel van de webconsole, of voer kyvernon tasks list --target <id> uit, en de taak verschijnt met de gebruiker die haar startte.

Resultaat

Een tool die voor de vSphere-API is geschreven, leest en wijzigt de inventaris van de controller. Welke tools en bewerkingen zijn geverifieerd, en welke methoden van de vSphere-API het endpoint levert, staat in de gegenereerde referentie.

Volgende stappen

• Ondersteunde methoden somt de geleverde methoden van de vSphere-API op per beheerd object.
• Geverifieerde tools somt de tools en bewerkingen op die tegen de endpoints zijn uitgevoerd.
• Eerste CLI-sessie installeert de Kyvernon-opdrachtregelclient.