Chapter 11. Creating VMDK images for RHEL for Edge

Procedure

1. Create a blueprint in the Tom’s Obvious, Minimal Language (TOML) format, with the following content:

   name = "vmdk-image"
   description = "Blueprint with Ignition for the vmdk image"
   version = "0.0.1"
   packages = ["open-vm-tools"]
   modules = []
   groups = []
   distro = ""
   
   [[customizations.user]]
   name = "admin"
   password = "admin"
   groups = ["wheel"]
   
   [customizations.ignition.firstboot]
   url = http://<IP_address>:8080/config.ig

   Copy to Clipboard Toggle word wrap

   Where:

   • The name is the name and description is the description for your blueprint.
   • The version is the version number according to the Semantic Versioning scheme.
   • The modules and packages describe the package name and matching version glob to be installed into the image. For example, the package name = "open-vm-tools". Notice that currently there are no differences between packages and modules.
   • The groups are packages groups to be installed into the image. For example groups = "anaconda-tools" group package. If you do not know the modules and groups, leave them empty.
   • The customizations.user creates a username and password to log in to the VM.

   • The customizations.ignition.firstboot contains the URL where the Ignition configuration file is being served.

     Note

     By default, the open-vm-tools package is not included in the edge-vsphere image. If you need this package, you must include it in the blueprint customization.

2. Import the blueprint to the image builder server:

   # composer-cli blueprints push <blueprint-name>.toml

   Copy to Clipboard Toggle word wrap

3. List the existing blueprints to check whether the created blueprint is successfully pushed and exists:

   # composer-cli blueprints show <blueprint-name>

   Copy to Clipboard Toggle word wrap

4. Check whether the components and versions listed in the blueprint and their dependencies are valid:

   # composer-cli blueprints depsolve <blueprint-name>

   Copy to Clipboard Toggle word wrap

Procedure

1. Start the compose of a .vmdk image:

   # composer-cli compose start start-ostree <blueprint-name> edge-vsphere --<url>

   Copy to Clipboard Toggle word wrap

   The --<url> is the URL of your repo, for example: http://10.88.0.1:8080/repo.

   A confirmation that the composer process has been added to the queue appears. It also shows a Universally Unique Identifier (UUID) number for the image created. Use the UUID number to track your build. Also, keep the UUID number handy for further tasks.

2. Check the image compose status:

   # composer-cli compose status

   Copy to Clipboard Toggle word wrap

   The output displays the status in the following format:

   $ <UUID> RUNNING date <blueprint-name>  <blueprint-version> edge-vsphere

   Copy to Clipboard Toggle word wrap

3. After the compose process finishes, download the resulting image file:

   # composer-cli compose image <UUID>

   Copy to Clipboard Toggle word wrap

Procedure

1. Navigate to the directory where you downloaded your .vmdk image.

2. Launch the image on vSphere by executing the following steps:

   1. Import the .vmdk image in to vSphere:

      $ govc import.vmdk ./composer-api.vmdk foldername

      Copy to Clipboard Toggle word wrap

   2. Create the VM in vSphere without powering it on:

      govc vm.create \
      -net="VM Network" -net.adapter=vmxnet3 \
      -disk.controller=pvscsi -on=false \
      -m=4096 -c=2 -g=rhel9_64Guest \
      -firmware=efi vm_name govc vm.disk.attach \
      -disk="foldername/composer-api.vmdk” govc vm.power -on\
      -vm vm_name -link=false \
       vm_name

      Copy to Clipboard Toggle word wrap

   3. Power-on the VM:

      govc vm.power -on vmname

      Copy to Clipboard Toggle word wrap

   4. Retrieve the VM IP address:

      HOST=$(govc vm.ip vmname)

      Copy to Clipboard Toggle word wrap

   5. Use SSH to log in to the VM, using the username and password you specified in your blueprint:

      $ ssh admin@HOST

      Copy to Clipboard Toggle word wrap