English
Provisioning Fedora CoreOS on OpenStack
This guide shows how to provision new Fedora CoreOS (FCOS) nodes on an OpenStack cloud environment, either private, or public (like https://vexxhost.com/[VEXXHOST]).
The steps below were tested against the OpenStack Victoria release.
Prerequisites
Before provisioning an 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].
Fedora CoreOS has a default `core` user that can be used to explore the OS. If you want to use it, finalize its xref:authentication.adoc[configuration] by providing e.g. an SSH key.
If you do not want to use Ignition to get started, you can make use of the https://coreos.github.io/afterburn/platforms/[Afterburn support].
You also need to have access to an OpenStack environment and a functioning https://docs.openstack.org/python-designateclient/latest/user/shell-v2.html[`openstack` CLI]. Typically you'll https://docs.openstack.org/python-openstackclient/latest/configuration/index.html[configure the client] by using a `clouds.yaml` file or via environment variables. If you're starting from scratch, this environment may need networks, SSH key pairs, security groups, etc.. set up. Please consult the https://docs.openstack.org/[OpenStack Documentation] to learn more.
Downloading an OpenStack Image
Fedora CoreOS is designed to be updated automatically, with different schedules per stream. Once you have picked the relevant stream, download, verify, and decompress the latest OpenStack image:
For more information on FCOS stream offerings see xref:update-streams.adoc[Update Streams].
STREAM='stable'
coreos-installer download --decompress -s $STREAM -p openstack -f qcow2.xz
Alternatively, you can manually download an OpenStack image from the https://getfedora.org/coreos/download?tab=cloud_operators[download page]. Verify the download, following the instructions on that page, and decompress it.
Uploading the Image to OpenStack
Create the FCOS image in OpenStack
FILE=fedora-coreos-XX.XXXXXXXX.X.X-openstack.x86_64.qcow2
IMAGE=${FILE:0:-6} # pull off .qcow2
openstack image create --disk-format=qcow2 --min-disk=10 --min-ram=2 --file=$FILE $IMAGE
If you're uploading an `aarch64` disk image then add `--property architecture=aarch64`.
Monitor image creation progress by listing the image
openstack image list --name=$IMAGE
Launching a VM instance