The Concourse Genesis Kit provides a streamlined way to deploy a full Concourse CI/CD system. It supports:
- Full deployments with web UI, API, database, and workers
- Small footprint deployments with reduced resource requirements
- Workers-only deployments for satellite sites
- Various authentication methods (Basic, GitHub, CF, SAML/Okta)
- Integration with Vault for secure credential storage
- Metrics with Prometheus for monitoring
To use this kit, you don't even need to clone the repository! Just run the following (using Genesis v2.7.6 or later):
# Create a concourse-deployments repo using the latest version of the concourse kit
genesis init --kit concourse
# Create a concourse-deployments repo using v3.13.0 of the concourse kit
genesis init --kit concourse/3.13.0
# Create a my-concourse-configs repo using the latest version of the concourse kit
genesis init --kit concourse -d my-concourse-configs- Multiple Deployment Types: Full, small-footprint, or workers-only
- Authentication Options: Basic auth, GitHub OAuth, CF UAA, Okta/SAML
- TLS Options: Self-signed certificates, provided certificates, or no TLS
- External Database Support: Use your own PostgreSQL database
- Prometheus Integration: Export metrics for monitoring
- Vault Integration: Use Vault for pipeline credential management
- IaaS Support: Deploy on AWS, Azure, or STACKIT
- OCFP Integration: Deploy as part of an OCFP architecture
For detailed documentation, see:
- Complete Manual - Full documentation
- Configuration Reference - All available parameters
- Features Reference - Available feature flags
- Authentication Methods - Setting up authentication
- Integrations - Third-party integrations (Vault, Prometheus)
- IaaS Guides - IaaS-specific deployment guides
- Examples - Example deployment configurations
- Upgrade Guide - How to upgrade between versions
- Troubleshooting - Common issues and solutions
- Genesis 2.7.6+
- BOSH Director with stemcell support
- Network and cloud config set up for the Concourse VMs
| Version | Release Date | Concourse Version | Notes |
|---|---|---|---|
| 3.13.0 | 2023 | 7.13.0 | STACKIT IaaS support, refactored hooks to Perl modules |
| 3.12.0 | 2023 | 7.12.1 | Various bug fixes |
| 3.11.0 | 2023 | 7.12.0 | New features |
| 2.0.0 | 2019 | ~3.14.1 | First version to support Genesis 2.6 hooks |
This Genesis Kit is released under the MIT License.