<p align="center"> <img src="https://github.com/project-stacker/assets/blob/main/images/logo/stacker-logo-text.png" alt="stacker" height="130"/> </p>

stacker

Stacker is a tool for building OCI images natively via a declarative yaml format.

Features

• Single binary
• Rootless builds
• Hermetically sealed builds using LXC containers
• Also available as a GitHub action

Installation

Stacker has various build and runtime dependencies.

Hacking

See the hacking guide for tips on hacking/debugging stacker.

Usage

See the tutorial for a short introduction to how to use stacker.

See the stacker.yaml specification for full details on the stacker.yaml specification.

Additionally, there are some tips and tricks for common usage.

TODO / Roadmap

• Upstream something to containers/image that allows for automatic detection of compression
• Design/implement OCIv2 drafts + final spec when it comes out

Conference Talks

• An Operator Centric Way to Update Application Containers FOSDEM 2019
  • video
  • slides
• Building OCI Images without Privilege OSS EU 2018
  • slides
• Building OCI Images without Privilege OSS NA 2018
  • slides

(Note that despite the similarity in name of the 2018 talks, the content is mostly disjoint; I need to be more creative with naming.)

License

stacker is released under the Apache License, Version 2.0, and is:

Copyright (C) 2017-2022 Cisco Systems, Inc. and contributors