English Chinese (Simplified) (zh_CN)
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].
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] and provide an SSH key via the cloud provider and continue from there.
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
Monitor image creation progress by listing the image
openstack image list --name=$IMAGE
Launching a VM instance
Now that you have an image created in your account you can launch a VM instance. You’ll have to specify several pieces of information in the command, such as instance flavor, network information, SSH key, etc...
You'll also need the Ignition config you created earlier. Here it is represented in the example command as `./example.ign`, which indicates a file in the current directory named `example.ign`.