Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

provisioning: Document Podman Machine #515

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions modules/ROOT/pages/platforms.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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

Expand Down
15 changes: 15 additions & 0 deletions modules/ROOT/pages/provisioning-podman-machine.adoc
Original file line number Diff line number Diff line change
@@ -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