kryndex / container-linux-config-transpiler

Convert a Container Linux Config into Ignition

Container Linux Config Transpiler

The Config Transpiler ("ct" for short) is the utility responsible for transforming a human-friendly Container Linux Config into a JSON file. This resulting file can be provided to a Container Linux machine when it first boots to provision the machine.

Documentation

If you're looking to begin writing configs for your Container Linux machines, check out the getting started documentation.

The configuration documentation is a comprehensive resource specifying what options can be in a Container Linux Config.

For a more in-depth view of ct and why it exists, take a look at the Overview document.

Please use the bug tracker to report bugs.

Examples

There are plenty of small, self-contained examples in the documentation.

Installation

Prebuilt binaries

The easiest way to get started using ct is to download one of the binaries from the releases page on GitHub.

Building from source

To build from source you'll need to have the go compiler installed on your system.

git clone --branch v0.3.1 https://github.com/coreos/container-linux-config-transpiler
cd container-linux-config-transpiler
make

The ct binary will be placed in ./bin/.

Note: Review releases for new branch versions.

Related projects

• https://github.com/coreos/ignition
• https://github.com/coreos/coreos-metadata/
• https://github.com/coreos/matchbox