Gastbewerkingen

Controleer de gastagent, beheer bestanden en voer programma's uit in een draaiende gast via de gastagent, in de console; de CLI en de API volgen.

Gastbewerkingen lezen en schrijven bestanden en voeren programma's uit in een draaiende gast, zonder netwerkverbinding ermee. Ze lopen via de gastagent, een kleine service in het besturingssysteem van de gast. De console toont de status van de agent en de gast die hij meldt; ze heeft ook een scherm voor de bewerkingen zelf. De gast moet draaien en zijn agent moet het soort bewerking toestaan dat u wilt. De agent van de RHEL-familie blokkeert bijvoorbeeld standaard het uitvoeren van programma's.

In de console

Selecteer in de inventaris de virtuele machine en open het tabblad Overzicht.
Lees op de kaart Gast de Gastagent. Die toont Actief, Niet actief of Niet geïnstalleerd. Als de agent draait, toont de kaart ook de Hostnaam, het IP-adressen en het Gastbesturingssysteem die hij meldt.

(Groter weergeven)
Grotere weergave sluiten
Als de agent niet is geïnstalleerd, installeer hem dan in de gast, of voeg hem met cloud-init toe aan een image, zie Gastaanpassing. Voor een nieuwe machine neemt de wizardstap Gastaanpassing de gebruikersgegevens daarvoor aan.
Als de agent bewerkingen weigert, wijzigt u de gasttoegang met Gasttoegang bewerken onder Meer acties, zoals beschreven in Gastaanpassing. De API meldt welke soorten de agent toestaat, en een opmerking met de oplossing als een bewerking wordt geweigerd.
Om in de gast te werken, kiest u Meer acties en Gastbewerkingen. De actie wordt aangeboden voor een draaiende gast met een draaiende agent en zegt anders waarom zij is uitgeschakeld. Kies Gastbewerkingen controleren om te zien of gastbewerkingen beschikbaar zijn.

(Groter weergeven)
Grotere weergave sluiten
Voer onder Bestanden een Map in de gast in en kies Tonen; maak de lijst nauwer met een Naampatroon. Een map opent als u haar naam kiest, en Omhoog gaat naar de bovenliggende map. Lezen toont een bestand, Verwijderen verwijdert een bestand of een map met alles erin nadat u de naam hebt getypt, Map maken maakt een map in de geopende map, en de uploadknop zet een bestand van uw computer erin. Bestanden reizen in het verzoek mee, dus het scherm verwerkt bestanden tot 1 MiB.
Voer onder Programma's het absolute Programma in, eventueel Argumenten en Werkmap, en kies Programma starten. De tabel toont de programma's die via gastbewerkingen zijn gestart; Beëindigen beëindigt er één na een bevestiging.

Lezen vereist de bevoegdheid VirtualMachine.GuestOperations.Query, schrijven VirtualMachine.GuestOperations.Modify en programma's uitvoeren VirtualMachine.GuestOperations.Execute; een knop die uw rol niet toestaat, is uitgeschakeld.

Resultaat

De kaart toont een draaiende agent met de gegevens van de gast, en de opdrachten van de sectie Automatisering antwoorden in plaats van te mislukken met error.guest_operations_unavailable.

Automatisering

Met de CLI

Shell

kyvernon vm guest validate <id> --username <user>
kyvernon vm guest list-files <id> --path /etc --match-pattern "*.conf"
kyvernon vm guest read-file <id> --path /etc/hostname
kyvernon vm guest write-file <id> --path /tmp/app.conf --from app.conf
kyvernon vm guest mkdir <id> --path /var/lib/app/data --parents
kyvernon vm guest start <id> --program /usr/bin/systemctl \
  --arguments "restart app" --username <user>
kyvernon vm guest list <id>
kyvernon vm guest terminate <id> <pid>

validate test of gastbewerkingen beschikbaar zijn. De overige opdrachten:

Bestanden: read-file, write-file (vervangt tenzij --no-overwrite), list-files, mkdir, delete-file, rmdir --recursive, move-file --src --dst --overwrite, move-dir, change-attrs, temp-file en temp-dir.
Programma's: start, list (programma's die via gastbewerkingen zijn gestart) en terminate. env leest de omgevingsvariabelen van de gast.
Bestandsinhoud reist als Base64 in JSON, dus ze is geschikt voor configuratiebestanden en kleine artefacten, niet voor grote images.

Paden volgen het besturingssysteem van de gast.

Met de API

Bewerking	Verzoek
Testen	`POST /v1/vms/{id}/guest/credentials/validate`, `acquire`, `release`
Een bestand lezen	`POST /v1/vms/{id}/guest/files/read`
Een bestand schrijven	`POST /v1/vms/{id}/guest/files/write`
Weergeven, maken, verplaatsen, verwijderen	`POST /v1/vms/{id}/guest/files/list`, `mkdir`, `move`, `move-dir`, `delete`, `rmdir`, `attrs`, `temp-file`, `temp-dir`
Een programma starten	`POST /v1/vms/{id}/guest/processes`
Programma's weergeven of beëindigen	`GET /v1/vms/{id}/guest/processes`, `DELETE /v1/vms/{id}/guest/processes/{pid}`
Omgeving	`GET /v1/vms/{id}/guest/environment`

De bewerkingen antwoorden direct; het zijn geen taken. De API meldt files_allowed, processes_allowed en een opmerking in operations_note. Een geweigerde bewerking geeft error.guest_operations_unavailable of een van de gastbestandsfouten terug, die de oorzaak noemen. Tools van de vSphere-API bereiken dezelfde functies via de guest operations manager.