English Spanish (Latin America)
Provisioning Fedora CoreOS on Vultr
This guide shows how to provision new Fedora CoreOS (FCOS) nodes on Vultr. FCOS images are currently not published directly on Vultr, but they can be uploaded as https://www.vultr.com/docs/requirements-for-uploading-an-os-iso-to-vultr[custom images].
Prerequisites
Using a custom snapshot
Vultr supports creating custom snapshots from public raw images.
These steps show how to download a FCOS image and upload it to an existing storage bucket, in order to create a snapshot from that.
See https://www.vultr.com/docs/vultr-object-storage[Vultr documentation] for further details on how to create a bucket and configure `s3cmd` to use it.
Creating a snapshot
Fedora CoreOS comes in three streams, with different update schedules per stream. These steps show the `stable` stream as an example, but can be used for other streams too.
Fetch the latest image suitable for your target stream (or https://getfedora.org/coreos/download/[download and verify] it from the web).
STREAM='stable'
coreos-installer download -s "${STREAM}" -p vultr -f raw.xz --decompress
Create the snapshot from your object URL, and note its ID.
IMAGE_URL='https://...'
VULTR_API_KEY='<token>'
vultr-cli snapshot create-url -u "${IMAGE_URL}"
Launching an instance from a snapshot
You can now create a FCOS Vultr instance using the snapshot ID above.
You'll need to wait for the snapshot to finish processing before using it. Monitor with `*vultr-cli snapshot list*`.
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].
While the Vultr documentation mentions `cloud-init` and scripts, FCOS does not support `cloud-init` or the ability to run scripts from user-data. It accepts only Ignition configuration files.
You also need to have access to a Vultr account. The examples below use the https://github.com/vultr/vultr-cli[vultr-cli] and https://s3tools.org/s3cmd[s3cmd] command-line tools. Both of these tools are available in Fedora and can be installed via `sudo dnf install vultr-cli s3cmd`.
https://www.vultr.com/docs/how-to-use-s3cmd-with-vultr-object-storage[Use s3cmd to upload] the raw image to your bucket, and note its public URL.