Fedora CoreOS Configuration Transpiler (fcct
)
The fcct
utility verifies and converts a human-friendly (YAML) Fedora
CoreOS Configuration (FCC) file into a machine-friendly (JSON) Ignition
configuration file. Upon first boot, Ignition, which runs during the
creation of initramfs, ingests the Ignition configuration file and
provisions the FCOS system as specified in the file.
This guide explains how to obtain and use fcct
.
Unless otherwise noted, new releases of fcct are backwards compatible with
old releases.
|
Getting FCCT
You can run fcct
as a container with docker or podman or download it as a
standalone binary.
Container
This example uses podman, but you can use docker in a similar manner. Note
that the release
tag tracks the most recent release, and the latest
tag
tracks the Git development branch.
-
Pull the container:
podman pull quay.io/coreos/fcct:release
-
Run
fcct
either by using standard in and standard out or by using files. Refer to the examples below.Example runningfcct
using standard in and standard out:podman run -i --rm quay.io/coreos/fcct:release --pretty --strict < your_config.fcc > transpiled_config.ign
Example runningfcct
using files:podman run --rm -v /path/to/your_config.fcc:/config.fcc:z quay.io/coreos/fcct:release --pretty --strict /config.fcc > transpiled_config.ign
fcct
sends its output tostdout
, so the examples above pipe that output to a file namedtranspiled_config.ign
.
Standalone binary
To use the fcct
binary on Linux, follow these steps:
-
If you have not already done so, download the Fedora signing keys and import them:
gpg --import <key>
-
Download the latest version of
fcct
and the detached signature from the releases page. -
Verify it with gpg:
gpg --verify <detached sig> <fcct binary>