BitOps Docker Image

Naming

Based off how official node docker image (and others) does their tagging:

${VERSION}-${SUBSET}${SUBSET_VERSION}

Where SUBSET and SUBSET_VERSION are optional. This is best illustrated with some examples:

node:18-alpine3.15
node:16-buster
node:lts-gallium
node:current-alpine3.16

---

BitOps uses the image pattern:

${BTIOPS_VERSION}-${PLUGIN_OR_PLUGIN_AGGREGATE}${PLUGIN_OR_PLUGIN_AGGREGATE_VERSION}

Some examples:

bitops:2.0.0
bitops:2.0.0-terraform1.2
bitops:2.0.0-kitchensink
bitops:2.0.0-kitchensink3.1

Versioning

• An image with a version tag equal to a semver (e.g. 2.0.0) is immutable.
• A version tag equal to latest is always mutable and refers to the latest stable release.
• A version tag equal to dev is always mutable and refers to the current development state in the main branch.

To clear up any potential confusion regarding the versioning of the bitovi/bitops image, we use the following table.

For sake of example, assume that 2.0.0 is the latest stable BitOps version.

Image:Tag	BitOps Version	Description
bitops:base-dev	current development (unreleased) base (no plugins)	Changes merged to the repository main branch will result in a new image being deployed on every push.
bitops:dev	current development (unreleased) omnibus version (recommended plugins)	Changes merged to the repository main branch will result in a new image being deployed on every push.
bitops:latest	2.0.0 (latest stable version of BitOps)	This Docker tag is updated when there is a new BitOps release.
bitops:2.0.0	2.0.0	Was deployed based on a recent v2.0.0 BitOps release. Immutable now.
bitops:1.0.18	1.0.18	Was deployed based on a recent v1.0.18 release. Immutable now.

NOTE
We always recommend pinning the stable version of bitops to avoid any breaking changes.
If the security is higher priority for you, use sha256 digest like bitovi/bitops:sha256:82becede498899ec668628e7cb0ad87b6e1c371cb8a1e597d83a47fac21d6af3. See more in the docker documentation.

Official Images

Image Name	PreInstalled Tools	Docker image name	Supported Cloud provider	Additional stable image tags	Development image tags (main branch)
omnibus	Terraform Cloudformation Ansible Helm Kubectl AWS CLI	bitovi/bitops:2.0.0-omnibus	AWS	latest	dev
aws-terraform	Terraform AWS CLI	bitovi/bitops:2.0.0-aws-terraform	AWS
aws-ansible	Ansible AWS CLI	bitovi/bitops:2.0.0-aws-ansible	AWS
aws-helm	Helm Terraform AWS CLI	bitovi/bitops:2.0.0-aws-helm	AWS
base	BitOps source	bitovi/bitops:2.0.0-base	-	base	dev-base

Requesting a new official image

TODO