Skip to content

MottainaiCI/lxd-compose

Repository files navigation

LXD Compose

Build Status CII Best Practices Go Report Card CodeQL codecov Github All Releases

lxd-compose supply a way to deploy a complex environment to an LXD Cluster or LXD standalone installation.

It permits organizing and tracing all infrastructure configuration steps and creating test suites, following the IAAS (Infrastructure As A Code) paradigm.

All configuration files could be created at runtime through two different template engines: Helm or Jinja2 (require j2cli tool).

To keep API changes fast we haven't yet release a major released but we consider the tool pretty stable.

From release v0.33.0 lxd-compose uses by default the Instance API to works with Incus.

At the moment, we doesn't support VMs but we will add support to virtual-machine soon.

Installation

lxd-compose is available as Macaroni OS package and installable in every Linux distro through luet tool with these steps:

$> curl https://raw.githubusercontent.com/geaaru/luet/geaaru/contrib/config/get_luet_root.sh | sudo sh
$> sudo luet install app-emulation/lxd-compose

Upgrade lxd-compose

$> sudo luet repo update
$> sudo luet upgrade

Documentation

The complete lxd-compose documentation is available here.

Examples

We maintain a project that supply ready to build environments at LXD Compose Galaxy.

Community

The lxd-compose devs team is available through the Mottainai Slack channel.