Skip to content

project-stacker/stacker

stacker

stacker Build Status codecov CodeQL Go Reference nightly

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
  • Building OCI Images without Privilege OSS EU 2018
  • Building OCI Images without Privilege OSS NA 2018

(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