Skip to content

Commit

Permalink
Replace fcct-config by a link to the specification
Browse files Browse the repository at this point in the history
  • Loading branch information
JaimeMagiera authored and jlebon committed Mar 31, 2021
1 parent 929a560 commit 92dd310
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 53 deletions.
2 changes: 1 addition & 1 deletion modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
*** xref:live-booting-ipxe.adoc[Live-booting via iPXE]
** System Configuration
*** xref:producing-ign.adoc[Producing an Ignition File]
*** xref:fcct-config.adoc[FCCT Specification]
*** link:https://coreos.github.io/fcct/specs/[FCCT Specification]
*** xref:remote-ign.adoc[Using a remote Ignition config]
*** xref:storage.adoc[Configuring Storage]
*** xref:managing-files.adoc[Managing Files]
Expand Down
54 changes: 2 additions & 52 deletions modules/ROOT/pages/fcct-config.adoc
Original file line number Diff line number Diff line change
@@ -1,53 +1,3 @@
= Provisioning and Configuration
= Content Moved

This guide introduces the in-depth configuration specification for human-friendly FCOS Configuration (FCC) YAML files.

TIP: Rather than read these detailed instructions, advanced users may want to reference the https://coreos.github.io/fcct/specs/[configuration specification] for an abbreviated list of options.

== Ignition overview
Ignition is a provisioning utility that reads a configuration file (in JSON format) and provisions an FCOS system based on that configuration. Configurable components include storage and filesystems, systemd units, and users.

Ignition runs only once during the first boot of the system (in initramfs). Because Ignition runs so early in the boot process, it can re-partition disks, format filesystems, create users, and write files before the userspace begins to boot. As a result, systemd services are already written to disk when systemd starts, speeding the time to boot.

=== Configuration process
Ignition configurations are formatted as JSON, which is quick and easy for a machine to read. However, these files are not easy for humans to read or write. The solution is a two-step configuration process that is friendly for both humans and machines:

. Produce a YAML-formatted Fedora CoreOS Configuration (FCC) file.
. Run the Fedora CoreOS Configuration Transpiler (`fcct`) to convert the YAML file into a JSON Ignition file.

During the transpilation process, `fcct` verifies the syntax of the YAML file, which can catch errors before you use it to launch the FCOS system.

Once you have an Ignition (`.ign`) file, you can use it to boot an FCOS system in a VM or install it on bare metal.

=== FCC file structure
The FCC file follows YAML syntax and contains the following top-level nodes:

* `variant`: specifies `fcos` as the operating system
* `version`: specifies the version of `fcct`
* `ignition`: specifies a remote configuration (for convenience or for platforms that do not allow for the ingestion of large configuration files)
* `storage`: provisions storage and configures the filesystem
* `systemd`: controls systemd units
* `passwd`: configures users

TIP: YAML files must have consistent indentation. See the https://yaml.org/spec/[YAML Specification] for further details.

== FCC file metadata (`variant` and `version`)

The first two lines of an FCC file define `fcos` as the operating system and the semantic version of the document specification (e.g. `1.3.0`). Both lines are required.

.Example of the FCC file metadata
[source,yaml]
----
variant: fcos
version: 1.3.0
----

include::ign-config-metadata.adoc[leveloffset=1]

include::ign-storage.adoc[leveloffset=1]

include::ign-systemd.adoc[leveloffset=1]

include::ign-passwd.adoc[leveloffset=1]

// https://coreos.com/ignition/docs/latest/operator-notes.html
The content on this page has been moved. For an overview of the FCCT spec, please see the https://coreos.github.io/fcct/specs/[full specification page]. The code examples on this page have been moved to the individual pages for each topic.

0 comments on commit 92dd310

Please sign in to comment.