Zen

Source string Source string

239/10000 · 239

The string is read only.

English Actions
Producing an Ignition Config
Ignition overview
Ignition is a provisioning utility that reads a configuration file (in JSON format) and provisions a Fedora CoreOS 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 (while in the 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 Butane config.
Run Butane to convert the YAML file into a JSON Ignition config.
During the transpilation process, Butane 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.
Try to plan your configuration with the full set of customization details before provisioning a Fedora CoreOS instance. But don't worry if you forgot something as you can fix the configuration and re-deploy the instance from a fresh image.
Getting Butane
You can run Butane as a container with docker or podman or download it as a standalone binary.
Unless otherwise noted, new releases of Butane are backwards compatible with old releases.
Via a container with `podman` or `docker`
You can get Butane from a container hosted on https://quay.io/[quay.io]:
podman pull quay.io/coreos/butane:release
The `release` tag tracks the most recent release, and the `latest` tag tracks the Git development branch.
Run Butane either by using standard input and standard output or by using files:
Example running Butane using standard input and standard output
podman run --interactive --rm quay.io/coreos/butane:release \
--pretty --strict < your_config.bu > transpiled_config.ign
Example running Butane using a file as input and standard output
podman run --interactive --rm --security-opt label=disable \
--volume ${PWD}:/pwd --workdir /pwd quay.io/coreos/butane:release \
--pretty --strict your_config.bu > transpiled_config.ign
To make it simpler to type, you may also add the following alias to your shell configuration:
alias butane='podman run --rm --interactive \
--security-opt label=disable \
--volume ${PWD}:/pwd --workdir /pwd \
quay.io/coreos/butane:release'
Those examples use podman, but you can use docker in a similar manner.

Loading…

User avatar None

String added in the repository
Try to plan your configuration with the full set of customization details before provisioning a Fedora CoreOS instance. But don't worry if you forgot something as you can fix the configuration and re-deploy the instance from a fresh image.
Try to plan your configuration with the full set of customization details before provisioning a Fedora CoreOS instance. But don't worry if you forgot something as you can fix the configuration and re-deploy the instance from a fresh image.
9 months ago
Browse all string changes

Things to check

Long untranslated

The string has not been translated for a long time

Reset

Glossary

English English
No related strings found in the glossary.

17413041 String information

Source string description
type: Plain text
Flags
placeholders:r"`[\w.\/\-_=@&*:$●+~()\] ]*`", read-only
Source string location
./pages/producing-ign.adoc:21
String age
9 months ago
Last updated
9 months ago
Source string age
9 months ago
Translation file
pot/master/pages/producing-ign.pot, string 11