_L2_Full_4C.png){kind=logo}
tl;dr
BitOps is an automated orchestrator for deployment tools using GitOps.
It leverages a way to describe infrastructure for many environments and IaC tools called an Operations Repository.
Features
- Configurable: Configure how you want BitOps to deploy your application with yaml or environment variables.
- Event Hooks: If BitOps doesn't have built-in support for your usecase, execute arbitrary bash scripts at different points using BitOps' lifecycle.
- Pipeline Runner Agnostic: By bundling all logic in BitOps, you can have the same experience regardless of which pipeline service runs your deployment pipeline. You can even run BitOps locally!
- Customizable: Configure what tools you want installed in your BitOps image. Only take what you need, leave the bloat behind.
How it works
BitOps is a deployment tool orchestrator packaged in a Docker image. An Operations Repository is mounted to a BitOps container's /opt/bitops_deployment directory, and BitOps will parse through a given environment directory and;
- Auto-detect BitOps configuration files within tool directories
- Loop through each tool and
- Read in
yamlconfiguration - Run any pre-execute hooks
- Execute the tool
- Run any post-execute hooks
- Read in
Quick Start
BitOps is packaged as a docker image and is available on Dockerhub.
docker pull bitovi/bitops:latest
cd $YOUR_OPERATIONS_REPO
docker run bitovi/bitops:latest -v .:/opt/bitops_deployment
Need an example? We got you! Check out our Example Operation Repos
Configure BitOps
BitOps is configured in 3 steps:
- Define configuration for each tool in your environments
- Configure access to your cloud provider
- Configure how you want your deployment tools to execute
From there, the contents of the tool directories in your environments can exist exactly how the tool expects.
Ready to dive deeper? Check out our Docs
Still not enough? Why not try building and running a local version of BitOps
Need a hand with implementation? We can help
Supported Plugins
- Provision infrastructure with CloudFormation
- Provision infrastructure with Terraform
- Configure infrastructure with Ansible
- Deploy to kubernetes with Helm
Don't see a plugin you want? Submit an issue or build your own!
Supported Cloud Providers
- Amazon Web Services (AWS)
- Microsoft Azure Cloud (Azure) - COMING SOON - #13
- Google Cloud Engine (GCE) - COMING SOON - #14
Support / Contributing
We welcome any contributions from the community with open arms. Take a look at our Contributing guide.
Come hangout with us on Slack!
Updating Documentation
https://bitovi.github.io/bitops/ is auto-generated using MKDocs. Updating markdown in docs/* and ensuring the page is defined in mkdocs.yml will auto update the site when pushed to the master branch.
Testing Documentation Locally with Docker
Using Docker to test the docs is easy. Just run:
docker-compose -f docker-compose.docs.yaml up
Then load http://localhost:8000
Release History
See Releases.