Kyvernon

Werkwijze Voor: gebruikers

Schijven

Maak, vergroot en ontkoppel de schijven van een virtuele machine, koppel een bestaand schijfbestand en vind ongebruikte schijfimages.

Een schijf van een virtuele machine is een imagebestand op een datastore. Een schijf maken, vergroten en ontkoppelen wijzigt de configuratie van de machine, zie Hardware wijzigen voor de regels die gelden terwijl de machine draait. U hebt vrije ruimte op de datastore nodig voor een nieuwe of vergrote schijf.

In de console

  1. Selecteer in de inventaris de virtuele machine en selecteer Instellingen bewerken. Bij een draaiende machine staat de actie onder Meer acties. De schijven staan onder de CPU's en het geheugen, met het bestand van elke schijf.

    Venster Hardware bewerken met processors, geheugen, schijven en netwerkadapters (Groter weergeven)

  2. Om een schijf toe te voegen, selecteert u Harde schijf toevoegen, voert u de grootte in bij Grootte van nieuwe harde schijf N (GiB) en kiest u de datastore bij Datastore van nieuwe harde schijf N. De console maakt de schijf als thin-schijf: ze gebruikt ruimte naarmate de gast schrijft.

    Venster Hardware bewerken met een nieuwe harde schijf (Groter weergeven)
  3. Om een schijf te vergroten, voert u een hogere waarde in bij Grootte van harde schijf N (GiB). De grootte is in GiB, kan niet kleiner zijn dan ze nu is, en de schijf moet op zijn datastore passen. Een draaiende machine kan een schijf vergroten.
  4. Om een schijf te ontkoppelen, selecteert u Harde schijf N verwijderen. Hiervoor moet de machine uitgeschakeld zijn. Het bestand blijft op de datastore staan, tenzij u ook De schijfbestanden van de datastore verwijderen selecteert, waarmee het wordt verwijderd.
  5. Om een schijfbestand te koppelen dat al op een datastore staat, kiest u Bestaande schijf koppelen. Kies de datastore; de lijst Bestaand schijfbestand N biedt de schijfimages die niemand gebruikt, met hun capaciteit, en met de keuze Ander pad typt u een ander pad onder de datastore. Controleer de Capaciteit van bestaande schijf N in GiB, die uit de lijst wordt overgenomen als het bestand daar staat, en kies de schijfmodus. De console verstuurt de schijf zonder een bestand te maken. U hebt de bevoegdheid VirtualMachine.Config.AddExistingDisk op de machine nodig en Datastore.FileManagement op de datastore; een bestand dat de schijf van een andere machine is, vraagt ook VirtualMachine.Provisioning.DiskRandomAccess op die machine en wordt anders geweigerd met error.disk_owned_by_other_vm.
  6. Selecteer Opslaan.

Schijfimages vinden die niemand gebruikt

Schijfimages die geen virtuele machine, sjabloon, snapshot of inhoudsbibliotheek noemt, nemen ruimte in. Om ze te tonen, opent u de datastore in de inventaris en kiest u Meer acties en Ongebruikte schijfimages zoeken. Het dialoogvenster toont elk bestand met zijn indeling, grootte, capaciteit, basisimage en laatste wijziging, en de totalen. Bestanden die in de laatste minuten zijn gewijzigd, blijven weg omdat een taak ze misschien aan het maken is; kies een andere tijd onder Bestanden die zijn gewijzigd binnen deze tijd weglaten om ze te zien. Het rapport wijzigt niets. Verwijderen verwijdert één bestand nadat u zijn naam hebt getypt; controleer eerst, want ook images die zijn geüpload om er schijven van te maken staan in de lijst. U hebt de bevoegdheid Datastore.Browse nodig om het rapport te lezen en Datastore.FileManagement om een bestand te verwijderen.

:::screen datastore-orphans

Resultaat

De machine toont zijn schijven onder Virtuele hardware, met hun groottes en datastores. De gast moet zijn partitie en bestandssysteem laten meegroeien in een grotere schijf, behalve in cloudimages die dat bij het opstarten doen.

Automatisering

Met de CLI

Lees de configuratie, bewerk de lijst disks en pas die toe, zoals beschreven in Hardware wijzigen:

Shell
kyvernon inventory vm <id> --json
kyvernon vm reconfigure <id> --config config.json --wait \
  --create-disk '{"datastore":"datastore-1","path":"web-01/data.qcow2","sizeBytes":10737418240}'

Een schijfvermelding in config.json heeft key, datastore, path, capacity_bytes en optioneel thin, independent en nonpersistent. Gebruik een vrije key.

  • Een schijf maken: voeg de vermelding toe en geef --create-disk mee met het te maken bestand. Voeg sourcePath (en sourceDatastore) toe om hem vanaf een image te starten, en "linked": true voor een gekoppelde kloon van de image op dezelfde datastore.
  • Een schijf vergroten: stel de nieuwe capacity_bytes in en geef --grow-disk mee met hetzelfde bestandspad en de nieuwe sizeBytes. Op een draaiende machine groeit de schijf meteen waar de runtime dat kan, anders bij de volgende start.
  • Een bestaand bestand koppelen: voeg een vermelding toe waarvan het path dat bestand is en geef geen --create-disk mee. U hebt de bevoegdheid Datastore.FileManagement op de datastore ervan nodig. Een bestand dat de schijf van een andere machine is, vraagt VirtualMachine.Provisioning.DiskRandomAccess op die machine.
  • Een schijf ontkoppelen: verwijder de vermelding. Geef de schijf mee met --delete-disk om ook het bestand te verwijderen.

Met de API

POST /v1/vms/{id}/reconfigure draagt dezelfde gegevens: de hele config met de gewijzigde disks, en de lijsten createDisks, growDisks en deleteDisks. Elke lijstvermelding heeft datastore, path en sizeBytes; vermeldingen van createDisks nemen ook sourceDatastore, sourcePath en linked. Groottes zijn in bytes. De taak controleert de ruimte, weigert een verkleining met error.disk.shrink_not_supported en weigert een schijf die bij een andere machine hoort met error.disk_owned_by_other_vm.

Ongebruikte schijfimages vinden

Schijfimages die geen virtuele machine, sjabloon of snapshot gebruikt, nemen ruimte in. Het rapport van verweesde schijven toont ze en wijzigt niets:

Shell
kyvernon datastore orphans <datastore> --min-age-seconds 3600

Het rapport toont images die niet de schijf zijn van een machine, sjabloon of snapshot, geen overlay of basisimage van een in gebruik zijnde schijf, en geen bestand van een contentbibliotheek. Het toont ook bestanden voor wijzigingsregistratie waarvan de image weg is. Bestanden die binnen de laatste --min-age-seconds seconden zijn gewijzigd, blijven buiten het rapport; de standaardwaarde is 300. Elke vermelding heeft zijn pad, formaat, grootte en capaciteit. Images die u hebt geüpload om er schijven van te maken, staan ook in het rapport. Controleer elk bestand voordat u het verwijdert, zie Bestanden op een datastore. GET /v1/datastores/{id}/orphan-disks geeft hetzelfde rapport, met truncated ingesteld wanneer de datastore meer bestanden heeft dan één scan teruggeeft.

Versie 0.1. Laatst gewijzigd: 2026-11-14