coreos/torcx

Name: torcx

Owner: CoreOS

Description: torcx is a boot-time addon manager for immutable systems

Created: 2017-03-22 09:05:12.0

Updated: 2018-05-24 14:12:49.0

Pushed: 2018-05-24 14:14:11.0

Homepage:

Size: 12304

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

torcx - a boot-time addon manager

torcx (pronounced “torks”) is a boot-time manager for system-wide ephemeral customization of Linux systems. It has been built specifically to work with an immutable OS such as Container Linux by CoreOS.

torcx focuses on:

• providing a way for users to add additional binaries and services, even if not shipped in the base image
• allowing users to pin specific software versions, in a seamless and system-wide way
• supplying human- and machine-friendly interfaces to work with images and profiles

Getting started

This project provides a very lightweight add-ons manager for otherwise immutable distributions. It applies collections of addon packages (named, respectively, “profiles” and “images”) at boot-time, extracting them on the side of the base OS.

Profiles are simple JSON files, usually stored under /etc/torcx/profiles/ with a .json extension, containing a set of image-references:

ind": "profile-manifest-v1",
alue": {
"images": [
  {
    "name": "foo-addon",
    "reference": "0.1",
    "remote": "com.example.foo"
  }
]

Image archives are looked up in several search paths, called “stores”:

1. Vendor store: usually on a read-only partition, it contains addons distributed together with the OS image
2. User store: usually on a writable partition, it contains images provided by the user
3. Runtime store: additional search path specified at runtime

At boot-time, torcx unpacks and propagates the addons defined in the active profile, specified in /etc/torcx/next-profile. Once done, torcx seals the system into its new state and records its own metadata under /run/metadata/torcx.

License

torcx is released under the Apache 2.0 license. See the LICENSE file for all details.