skonfig

skonfig is a configuration management system forked from cdist (after e250024).

We have three main repositories:

• skonfig - implementation of the skonfig tool and quick getting started bits,
• base - explorer and types for general use,
• extra - special purpose types and incubator for new types.

You can find us in #skonfig:matrix.org (matrix?).

Documentation

Most parts of cdist documentation apply, but there are differences:

• skonfig does only config (see skonfig -h),
• types are managed in sets,
• type manifest can be directory of manifests,
• gencode-* can be directory of scripts,
• some types behave differently and it's recommended to consult manuals in base and extra.

Split between base and extra

Base explorers and types are used to change the state of the operating system or core components of it and are not for some specific piece of software. Furthermore, the quality requirements for inclusion in base are higher than for extra.

Extra contains types for specific purposes like configuring software or services which don't belong to the operating system and also serves as an incubator for new types.

Getting Started

# clone skonfig itself
git clone \
    https://github.com/skonfig/skonfig \
    ~/.skonfig/skonfig

# get base types and explorers
git clone \
    https://github.com/skonfig/base \
    ~/.skonfig/set/base

# and extra goodies
git clone \
    https://github.com/skonfig/extra \
    ~/.skonfig/set/extra

# add skonfig to path
ln -s ~/.skonfig/skonfig/bin/skonfig \
    ~/.local/bin/skonfig

# place for your own files, types and manifests
mkdir -p \
    ~/.skonfig/files \
    ~/.skonfig/type \
    ~/.skonfig/manifest

# copy example initial manifest
cp ~/.skonfig/skonfig/docs/examples/init-manifest \
    ~/.skonfig/manifest/init