Kyvernon

Werkwijze Voor: gebruikers

Hardware bewerken

Wijzig CPU's, geheugen, schijven, netwerkadapters en cd/dvd-stations van een virtuele machine en stel firmware en virtuele TPM in, in de console.

De hardware van een virtuele machine is haar configuratie. Een draaiende machine kan groeien. Voor verkleinen, het wijzigen van de firmware en het toevoegen of verwijderen van schijven, adapters en cd/dvd-stations moet de machine zijn uitgeschakeld. Concepten van virtuele machines noemt de limieten.

In de console

  1. Selecteer in de inventaris de virtuele machine en selecteer Instellingen bewerken. Voor een draaiende machine staat die onder Meer acties. Het bewerkingsdialoogvenster opent, en een opmerking bovenaan zegt wat een draaiende machine accepteert.

    Venster Hardware bewerken met processors, geheugen, schijven en netwerkadapters (Groter weergeven)
  2. Wijzig de Virtuele CPU's en het Geheugen (GiB). Een draaiende machine accepteert alleen hogere waarden.
  3. Voer voor elke schijf een grotere Grootte van harde schijf N (GiB) in, in GiB. Een schijf groeit en krimpt nooit. Modus van harde schijf N biedt Persistent, Independent persistent, dat de schijf buiten snapshots houdt, en Independent nonpersistent, dat bij het uitschakelen ook de schrijfbewerkingen verwerpt.

  4. Selecteer Harde schijf toevoegen om een schijf toe te voegen, voer de Grootte van nieuwe harde schijf N (GiB) in en kies de Datastore van nieuwe harde schijf N. De schijf is thin provisioned.

    Venster Hardware bewerken met een nieuwe harde schijf (Groter weergeven)
  5. Selecteer Harde schijf N verwijderen om een schijf los te koppelen, alleen uitgeschakeld. Het bestand blijft op de datastore staan, tenzij u onder Verwijderde schijven de optie De schijfbestanden van de datastore verwijderen selecteert, waarmee het wordt verwijderd.

  6. Selecteer onder Cd/dvd-stations Cd/dvd-station toevoegen om een station toe te voegen. Kies per station de Datastore van cd/dvd-station N, de map en de ISO-image van station N uit de lijst, of neem een item Uit contentbibliotheek, of typ het ISO-pad van station N, dat eindigt op .iso. ISO uit station N uitwerpen maakt een station leeg en Cd/dvd-station N verwijderen verwijdert het. Op een draaiende machine kunt u de image wijzigen, maar geen station toevoegen of verwijderen, en de wijziging geldt bij de volgende start.

    Dialoogvenster Hardware bewerken van een uitgeschakelde virtuele machine met een nieuwe cd/dvd-drive en de keuze van het ISO-image (Groter weergeven)
  7. Onder Netwerkadapters wijzigen Netwerkadapter toevoegen en Netwerkadapter N verwijderen de adapters, alleen uitgeschakeld. Kies het netwerk en het Model van adapter N van een adapter, en of die bij het inschakelen verbonden is. Publiek IP-adres toewijzen geeft een nieuwe adapter een adres uit de IP-pool van zijn netwerk, zie Publieke adressen. Configureer de nieuwe adapter in de gast: DHCP voor IPv4 en een statisch IPv6-blok.
  8. Stel onder Algemeen de Gastbesturingssysteem, de Cores per socket en de Wijzigingen bijhouden in, waarmee back-ups alleen de gewijzigde blokken kopiëren, en voeg Notities toe. Het besturingssysteem van de gast en de wijzigingsregistratie veranderen alleen als de machine is uitgeschakeld.

  9. Kies onder Firmware en beveiliging de Firmware (UEFI of BIOS) en zet Secure Boot en de Virtuele TPM aan of uit. Deze veranderen alleen als de machine is uitgeschakeld. Secure Boot en de virtuele TPM vereisen UEFI, en de console waarschuwt als de host de mogelijkheid niet biedt.

    Dialoogvenster Hardware bewerken, gescrold naar de instellingen voor firmware, Secure Boot en virtuele TPM (Groter weergeven)
  10. Geavanceerde opties neemt één key=value-paar per regel voor extra configuratie. Het is beschikbaar als uw rol het wijzigen van geavanceerde instellingen toestaat.
  11. Selecteer Opslaan.

Hernoemen, onder Meer acties, wijzigt alleen de naam.

Resultaat

De taak eindigt en het overzicht toont de nieuwe hardware onder Virtuele hardware. Een schijf die is gegroeid, is voor de gast op een draaiende machine meteen groter als de runtime dat kan, anders na de volgende start. De gast vergroot zijn bestandssysteem alleen zelf waar hij daarvoor is ingericht, bijvoorbeeld in cloud-images bij het opstarten.

Automatisering

Met de CLI

Lees de configuratie, wijzig haar en stuur haar terug. Het bestand bevat het object config van de virtuele machine:

Shell
kyvernon inventory vm <id> --json
kyvernon vm reconfigure <id> --config config.json --wait

Kopieer data.config uit het eerste antwoord naar config.json en bewerk het. Laat change_version zoals u het las: Kyvernon voegt uw wijziging samen met wijzigingen die vanaf dezelfde versie zijn gemaakt, en weigert met error.vm.concurrent_modification een wijziging die is begonnen bij een versie die hij niet meer kent. Voorbeelden van wat u in het bestand kunt wijzigen:

  • vCPU's en geheugen: "num_cpus": 4, "memory_mib": 8192.

  • Een grotere eerste schijf: stel capacity_bytes van de schijf in en noem de schijf die moet groeien:

    Shell
    kyvernon vm reconfigure <id> --config config.json --wait \
  --grow-disk '{"datastore":"datastore-1","path":"web-01/web-01.qcow2","sizeBytes":42949672960}'
  • Een nieuwe schijf: voeg een vermelding toe aan disks met de eerstvolgende vrije key, de datastore, een path en capacity_bytes, en maak het bestand aan met --create-disk. Verwijder de vermelding om een schijf los te koppelen; geef de schijf mee met --delete-disk om ook het bestand te verwijderen.
  • Een netwerkadapter: een vermelding in nics met een nieuwe key, network, een nieuw mac_address in kleine letters, "model": "virtio" en "connected": true.
  • Een cd/dvd-station: een vermelding in cdroms met datastore, iso_path en connected. Een lege iso_path is een leeg station.
  • Firmware en beveiliging: "firmware": "uefi" of "bios", "secure_boot": true en "vtpm": true. --firmware bios of --firmware efi stelt de firmware in zonder het bestand te bewerken; stel bij BIOS secure_boot en vtpm in op false.
  • Wijzigingsregistratie: "change_tracking": true.

--name <name> hernoemt de machine in dezelfde aanroep.

Met de API

POST /v1/vms/{id}/reconfigure neemt de configuratie en de schijfbestanden:

JSON
{
  "config": {"num_cpus": 4, "memory_mib": 8192},
  "growDisks": [{"datastore": "datastore-1", "path": "web-01/web-01.qcow2", "sizeBytes": 42949672960}]
}

config is de volledige configuratie zoals gelezen met GET /v1/vms/{id}, met uw wijzigingen erin; het voorbeeld is ingekort. createDisks en deleteDisks bevatten de bestanden die moeten worden gemaakt en verwijderd. Een schijf die uit config.disks is verwijderd en niet in deleteDisks staat, wordt losgekoppeld en haar bestand blijft. name hernoemt de machine. Het antwoord is een taak.

Versie 0.1. Laatst gewijzigd: 2026-11-14