From ee7bb6d40ec5ab0655d3f63f837bf034870abe47 Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Wed, 22 Mar 2023 13:48:14 -0400 Subject: [PATCH] provisioning: Document Podman Machine I was watching https://containerplumbing.org/sessions/2023/when_podman_desktop_eats which demoed customizing the FCOS OS image, and I think it's long overdue that we cross-link Podman Machine from the FCOS docs! --- modules/ROOT/pages/platforms.adoc | 2 ++ .../ROOT/pages/provisioning-podman-machine.adoc | 15 +++++++++++++++ 2 files changed, 17 insertions(+) create mode 100644 modules/ROOT/pages/provisioning-podman-machine.adoc diff --git a/modules/ROOT/pages/platforms.adoc b/modules/ROOT/pages/platforms.adoc index bceeceb2..ea9badce 100644 --- a/modules/ROOT/pages/platforms.adoc +++ b/modules/ROOT/pages/platforms.adoc @@ -19,6 +19,7 @@ The currently supported platforms and their identifiers are listed below. * Bare metal (`metal`): With BIOS, UEFI or network boot, with standard or 4k Native disks. See xref:bare-metal.adoc[Installing on Bare Metal] or xref:live-booting-ipxe.adoc[Live-booting via iPXE]. * Nutanix (`nutanix`): Hypervisor. * OpenStack (cloud platform): `openstack`): Cloud platform. See xref:provisioning-openstack.adoc[Booting on OpenStack]. +* Podman Machine (local): See xref:provisioning-podman-machine.adoc[Booting on Podman] * QEMU (`qemu`): Hypervisor. See xref:provisioning-libvirt.adoc[Booting on libvirt] * VirtualBox ('virtualbox'): Hypervisor. See xref:provisioning-virtualbox.adoc[Booting on VirtualBox]. * VMware ESXi, Fusion, and Workstation (`vmware`): Hypervisor. See xref:provisioning-vmware.adoc[Booting on VMware]. Fedora CoreOS images currently use https://kb.vmware.com/s/article/1003746[hardware version] 17, supporting VMware ESXi 7.0 or later, Fusion 12.0 or later, and Workstation 16.0 or later. @@ -30,6 +31,7 @@ The currently supported platforms and their identifiers are listed below. * Bare metal (`metal`): With UEFI or network boot, with standard or 4k Native disks. See xref:bare-metal.adoc[Installing on Bare Metal] or xref:live-booting-ipxe.adoc[Live-booting via iPXE] and xref:provisioning-raspberry-pi4.adoc[Booting on the Raspberry Pi 4]. * QEMU (`qemu`): Hypervisor. See xref:provisioning-libvirt.adoc[Booting on libvirt] * OpenStack (cloud platform): `openstack`): Cloud platform. See xref:provisioning-openstack.adoc[Booting on OpenStack]. +* Podman Machine (local): See xref:provisioning-podman-machine.adoc[Booting on Podman] === s390x diff --git a/modules/ROOT/pages/provisioning-podman-machine.adoc b/modules/ROOT/pages/provisioning-podman-machine.adoc new file mode 100644 index 00000000..f399fc64 --- /dev/null +++ b/modules/ROOT/pages/provisioning-podman-machine.adoc @@ -0,0 +1,15 @@ += Provisioning Fedora CoreOS via Podman Machine + +The [podman machine](https://docs.podman.io/en/latest/markdown/podman-machine.1.html) project uses Fedora CoreOS on the backend. + +This project will be particularly useful for people who want to spin up a local virtual machine using Fedora CoreOS on non-Linux platforms (e.g. MacOS X). + +Please see the documentation of that project for more details. + +== Using Podman Machine to test Ignition configuration + +When developing Ignition (or Butane) configuration, there can be a trial-and-error process. Using local virtual machines instead of cloud resources can speed up iteration. + +[source, bash] +---- +podman machine init --ignition-path /path/to/config.ign