Skip to content

Commit

Permalink
Add section on using VMware Workstation/Fusion
Browse files Browse the repository at this point in the history
Add a section on using VMware Workstation/Fusion with the ovftool to locally run a CoreOS instance for testing purposes.
  • Loading branch information
Okeanos authored and cgwalters committed Mar 17, 2021
1 parent 4748134 commit 6c36c7e
Showing 1 changed file with 25 additions and 1 deletion.
26 changes: 25 additions & 1 deletion modules/ROOT/pages/provisioning-vmware.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This guide shows how to provision new Fedora CoreOS (FCOS) nodes on the VMware h
Before provisioning a FCOS machine, you must have an Ignition configuration file containing your customizations. If you do not have one, see xref:producing-ign.adoc[Producing an Ignition File].

You also need to have access to a working VMware infrastructure, supporting VMs with at least hardware version 13.
The examples below use the https://github.com/vmware/govmomi/blob/v0.22.2/govc/README.md[govc] command-line tool.
The examples below use the https://github.com/vmware/govmomi/blob/v0.22.2/govc/README.md[govc] command-line tool for remote vSphere provisioning and the https://code.vmware.com/web/tool/4.4.0/ovf[ovftool] for local Workstation or Fusion provisoning.

=== Downloading the OVA

Expand Down Expand Up @@ -37,6 +37,30 @@ For maximum compatibility, it is recommended to use `base64` encoding and to pre
CONFIG_B64=`cat example.ign | base64 -w0 -`
----

== Booting a new VM on Workstation or Fusion

This section shows how to use Workstation and Fusion facilities to configure and run VMs from the command-line. Some steps can potentially be performed via the graphical UI too.

=== Importing the OVA

The downloaded OVA has to be imported into the Workstation or Fusion library locally. At the same time the Ignition has to be provided for it to be applied to the VM.

[source, bash]
----
VM_NAME='fcos-node01'
FCOS_OVA='./ova-templates/fedora-coreos-31.20200210.3.0-vmware.x86_64.ova'
LIBRARY="$HOME/Virtual Machines.localized"
ovftool \
--powerOffTarget \
--name="${VM_NAME}" \
--allowExtraConfig \
--extraConfig:guestinfo.ignition.config.data.encoding="base64" \
--extraConfig:guestinfo.ignition.config.data="${CONFIG_B64}" \
"${FCOS_OVA}" "${LIBRARY}"
----

Afterwards you can refresh the list of VMs in the Workstation or Fusion UI and the new `fcos-node01` VM should appear ready for booting. Its hardware configuration can be further customized at this point, and then powered-up.

== Booting a new VM on vSphere

This section shows how to use vSphere facilities to configure and run VMs from the command-line. Similar steps can be performed via the graphical UI too.
Expand Down

0 comments on commit 6c36c7e

Please sign in to comment.