VMware-templates omzetten naar STACKIT-images

Stap 1: laat de kolom Template beslissen

Een demo-export, voor deze pagina geschreven en op 4 november 2026 door StackToIT beoordeeld. Links: de eerste rijen van de vInfo-sheet. Rechts: drie regels uit migration/source-target.csv van de run, het bestand dat vastlegt wat elke bronrij is geworden.

VM,Powerstate,Template,CPUs,Memory,NICs,Disks,Provisioned MiB,In use MiB,Primary IP Address,Datacenter,Cluster,Host,Folder,Annotation,OS according to the configuration file,OS according to the VMware Tools,VM UUID
tpl-ubuntu2204,poweredOff,True,2,4096,1,1,40960,7200,,DC-Hamburg,CL-Build,esx21,templates,Ubuntu 22.04 base image 2026-09,Ubuntu Linux (64-bit),,4207-cccc-0001
tpl-win2022,poweredOff,True,4,8192,1,2,92160,31000,,DC-Hamburg,CL-Build,esx21,templates,Windows Server 2022 base image,Microsoft Windows Server 2022 (64-bit),,4207-cccc-0002
tpl-rhel9,poweredOff,True,2,4096,1,1,30720,5400,,DC-Hamburg,CL-Build,esx21,templates,RHEL 9 base image,Red Hat Enterprise Linux 9 (64-bit),,4207-cccc-0003
build-gold01,poweredOff,False,2,4096,1,1,40960,9100,,DC-Hamburg,CL-Build,esx22,templates,Golden image kept as a normal VM - not flagged as template,Debian GNU/Linux 12 (64-bit),,4207-cccc-0004

source_unit,source_type,stackit_target,stackit_resources,drafted_resources,standing,kept,changed,accepted,to_do
vm.build-gold01,vmware_vm,STACKIT Compute Engine,stackit_server; stackit_volume; stackit_network_interface; stackit_image,stackit_server,TARGET,0,6,0,36
vm.tpl-ubuntu2204,vmware_vm,"This draft writes no stackit_image for this unit: VM template: convert the VMDK to qcow2/raw and upload it with stackit_image, or rebuild it from a STACKIT public image.",,,NOT_DRAFTED,0,0,0,37

• Drie templates en één die erop lijkt

  tpl-ubuntu2204, tpl-win2022 en tpl-rhel9 hebben Template=True en krijgen de klasse REPLATFORM met een STACKIT-image als doel. build-gold01 staat in dezelfde map en is uitgeschakeld, maar de kolom Template zegt False, dus die machine wordt als server gepland.

• De vlag telt, niet de map

  StackToIT leest de vlag, niet de mapnaam of de annotatie. Is een golden image in uw ogen een template, markeer die dan in vCenter vóór de export, of besluit bewust dat de machine als server wordt verplaatst.

• Geen Terraform voor een template

  Het bestand zegt het ronduit: het concept schrijft geen stackit_image voor deze drie eenheden. Elke eenheid blijft NOT_DRAFTED totdat een persoon ingrijpt, en daarom noemt index.html ze onder Units left for the architect.

Stap 2: beoordelen en het plan lezen

1. 01

   Voer het assessment uit

   stacktoit assess ./rvtools ./vmware-migration leest de CSV-bestanden op uw eigen computer en schrijft het pakket. De console van deze run: 7 eenheden, 4 uitgewerkt en 3 overgelaten aan de architect.

2. 02

   Zoek het werk voor de templates

   execution/manual/actions.md bevat één item voor de drie templates, werkpakket WP-03, eigenaar Platform Architect. Bij elke template staan 17 open kritieke instellingen, waaronder disk-capacity, guest-os en memory-reservation, die assurance/critical-semantics.json één voor één toelicht.

3. 03

   Zoek wie het image gebruikt

   Elke server in terraform/compute.tf leest zijn bootimage uit een variabele die naar de VM is vernoemd, zoals vm_ci_runner01_image_id. De run weet niet dat ci-runner01 is gekloond uit tpl-ubuntu2204, omdat de annotatie vrije tekst is.

Wat het plan vraagt en waar de image-ID naartoe gaat

Links: de twee regels van de handmatige stap die de beslissing noemen; {resource} is de plaatshouder van het bestand voor elk van de drie templatenamen, die het onder de stap opsomt. Rechts: de server van ci-runner01 en zijn imagevariabele uit terraform/, zonder commentaarregels.

- What: Decide how {resource} (vmware_vm) moves to STACKIT and set its target up by hand, or record that it needs none: the draft writes no resource for it
- Why: VM template: convert the VMDK to qcow2/raw and upload it with stackit_image, or rebuild it from a STACKIT public image.

resource "stackit_server" "vm_ci_runner01" {
  project_id        = var.project_id
  name              = "ci-runner01"
  machine_type      = var.vm_ci_runner01_machine_type
  availability_zone = var.availability_zone
  boot_volume = {
    source_type = "image"
    source_id   = var.vm_ci_runner01_image_id
    size        = 40
  }
  network_interfaces = [stackit_network_interface.vm_ci_runner01_nic1.network_interface_id]
}

variable "vm_ci_runner01_image_id" {
  type        = string
  description = "STACKIT image converted from the boot disk of VM ci-runner01 (qcow2 or raw)."
}

• Eén image, meerdere variabelen

  Elke VM krijgt een eigen imagevariabele, en de omschrijving vraagt om het image dat uit de eigen bootdisk van die VM is geconverteerd. Stelt u in plaats daarvan het templateimage in, dan bouwt u de server opnieuw op uit de template: doe dat alleen waar provisioning alles opnieuw aanmaakt wat op de disk staat, zoals dat bij een CI-runner mogelijk het geval is.

• Alleen de bootdisk

  De omschrijving van de variabele spreekt over de bootdisk. Een tweede disk van een template, zoals de Hard disk 2 van 30 GiB van tpl-win2022, hoort niet bij dat image; beslis of de inhoud daarvan door provisioning opnieuw wordt aangemaakt.

Stap 3: converteren of opnieuw opbouwen, per template

Het plan noemt twee routes. Welke past, hangt af van wat de template bevat en van de licentie.

De run voegt een INFO-opmerking toe aan de Windows-VM's: bereid het image voor op de nieuwe virtuele hardware (opslag- en netwerkdrivers) vóór de conversie, en controleer hoe Windows-licenties op STACKIT worden geleverd.

Stap 4: converteren, uploaden, controleren, delen

Deze stappen volgen de STACKIT-handleiding voor aangepaste images. Het conversiecommando is gangbare praktijk; StackToIT voert het niet uit.

1. 01

   Exporteer en converteer de disk

   Exporteer de VMDK van de template en converteer die naar qcow2 of raw, bijvoorbeeld met qemu-img convert. De STACKIT-pagina toont de raw-conversie.

2. 02

   Maak het imagerecord aan

   Stuur een POST naar het images-endpoint van de IaaS API met de naam, active op true en diskFormat op raw, qcow2 of iso. Het antwoord bevat de image-ID en een upload-URL.

3. 03

   Upload het bestand

   Stuur het geconverteerde bestand met een PUT naar die URL. De URL geldt alleen voor dit image en verloopt na enkele uren; de maximale imagegrootte is 70 GB.

4. 04

   Wacht op AVAILABLE

   Lees het image terug totdat de status AVAILABLE is. Pas dan is het zinvol de ID in de variabele van een server te zetten.

5. 05

   Deel het image waar nodig

   Een image kan worden gedeeld met andere projecten of met de bovenliggende organisatie. Delen werkt alleen binnen één organisatie.

Wijzig dit voordat u toepast

• Image-ID's

  Vul de variabelen vm_*_image_id in review/target-values.tfvars met ID's van images die AVAILABLE zijn, en voer het assessment opnieuw uit op dezelfde uitvoermap.

• Machinetypen

  Elke server vraagt om een machinetype en vermeldt de brongrootte, bijvoorbeeld 4 vCPU en 8 GiB voor app-win01. De pagina met STACKIT-machinetypen noemt de families.

• Netwerkprefix

  RVTools exporteert geen subnetmasker, dus het prefix van PG-Build is een variabele die de waargenomen adressen noemt, 10.40.10.21 en 10.40.10.31.

• De beslissing over de template

  Leg per template vast of die wordt geconverteerd, opnieuw opgebouwd of vervalt. De planstap is klaar als de tegenhanger is ingericht en gecontroleerd, of als u vastlegt dat er geen nodig is.

Vragen over templates

Bronnen

• Aangepaste images gebruiken met de IaaS API (STACKIT Docs)
• Linux-server: images van besturingssystemen (STACKIT Docs)
• Windows Server: images van besturingssystemen (STACKIT Docs)