A general-purpose DevOps automation image built to accelerate CI/CD pipelines.
Optimized for use with the StageFreight GitLab component, but designed to grow beyond GitLab-specific tooling.
StageFreight (OCI) is a Docker image designed to serve as a flexible, prebuilt environment for running infrastructure-as-code and DevOps automation pipelines — especially where fast runtime and broad tooling support are essential.
It is built with a GitLab-first mindset but with a clear path toward platform independence (e.g., GitHub Actions, Gitea CI, Forgejo, and other CI/CD platforms). While the image is currently used internally by the StageFreight GitLab component, it is being developed into a standalone DevOps utility image.
Notice: We are not even in "BETA", this is early stages. I am actually very new to CI/CD. And this project was heavily AI enhanced. StageFreight-OCI specifically, is very much so an idea at this point. We have strong ambitions, but this would take time. This image is used in our GitLab component to enforce consistency in our release cycle and our first priority is to achieve desired features within the GitLab component. We hope you like GitLab, cause it may be a minute otherwise.
- ✅ Preinstalled DevOps toolchain: Includes
bash,coreutils,curl,docker-cli,git,jq,python3,rsync,tree,yq, and other essential utilities — ready out of the box. - ⚡ Zero bootstrapping time: Skip installing dependencies in your
before_script; everything is already available. - 🧩 Tailored for CI jobs: Ideal for release workflows, documentation generation, templating, and file patching tasks.
- 🔄 Integrated with StageFreight GitLab component: Used as the base image for jobs like release note generation, README injection, and badge updates.
- 🔧 Flexible beyond GitLab: Designed to eventually support other CI platforms by encapsulating logic in portable scripts and tools.
- 🐳 Built as a foundation image: Intended for both direct usage and extension into more specialized CI/CD containers.
❗ Note: For Ansible-specific automation (playbook runs, inventory management, etc.), we recommend using our dedicated image:
ansible-oci
| Use Case | Description |
|---|---|
| 🔖 GitLab Release Management | Used by the StageFreight component to generate release notes, create releases, and update release metadata |
| 📝 Markdown & README Automation | Injects dynamic tables and documentation into component READMEs |
| 🧪 CI/CD Utility Image | Drop-in toolset for scripting, patching, and infrastructure validation |
| 🔄 Badge Generation | Used to build and push dynamic SVG badges for component health & release status |
| 🚀 Platform-Agnostic Extension | Future target is to ship core tools for release workflows across GitHub, Gitea, Forgejo, etc. |
- Ansible (Gitlab Component)
- Ansible OCI – Docker runtime image for Ansible workflows
- StageFreight GitLab Component – GitLab component that provides CI pipeline orchestration for releases
- ✅ General DevOps tools (
bash,coreutils,curl,docker-cli (w/ buildx),git,jq,python3,rsync,tree,yq, etc.) - ✅ Markdown formatting and file manipulation utilities
- ✅ Portable release automation scripts (e.g. changelog, badge generation)
- ✅ Compatibility with the StageFreight GitLab Component
- ❌ Ansible and related modules (see ansible-oci)
- ❌ CI platform dependencies (i.e., it does not install GitLab Runner, GitHub Actions CLI, etc.)
generate_release_notes:
image: registry.prplanit.com/tools/stagefreight:latest
script:
- ./scripts/gitlab/generate-release_notes.sh > release.md- 🛠 Migrate all component-side tooling from GitLab CI jobs into this image (self-contained workflows)
- 🌐 Provide scripts and CLIs that are CI/CD platform-agnostic
- 🧰 Make it easy to use StageFreight’s features in GitHub Actions, Forgejo Pipelines, Drone CI, and more
- 📦 Package the image for distribution via container registries (e.g., Docker Hub, GHCR)
- If you'd like to contribute tools, scripts, or improvements:
- Fork the repository at StageFreight OCI
- Submit Merge Requests
- Open issues with ideas, bugs, or feature requests
- Distributed under the GNU-2.0 License.