2023-12-19 09:55:34 +00:00
# Docker Compose GitOps (dc-ops)
2023-12-15 19:49:46 +00:00
2023-12-19 09:55:34 +00:00
`dc-ops` is a simple python script that automates the update and deployment of multiple Docker Compose applications.
2023-12-15 19:49:46 +00:00
## How does it work?
2023-12-19 09:55:34 +00:00
It reads a list of git repositories from a YAML configuration file (`config.yml`), pulls the latest changes for each repo, and runs `docker compose up` for each specified `docker-compose.yml` file.
2023-12-15 19:49:46 +00:00
2023-12-19 09:55:34 +00:00
## Features
- Automatically checks for updates in git repositories
- Supports multiple Docker Compose files per repository
- Can be configured to skip certain repositories
2023-12-15 19:49:46 +00:00
2023-12-19 09:55:34 +00:00
## Requirements
See `requirements.txt`
2023-12-15 19:49:46 +00:00
## Usage
2023-12-19 09:55:34 +00:00
1. Install the required Python packages: `pip install -r requirements.txt`
2. Adapt `config.yml.example` to your needs and save it as `config.yml`
3. Run `dc-ops` from the shell or from a cron job
2023-12-15 19:49:46 +00:00
2023-12-19 09:55:34 +00:00
## Detailed process
For each enabled stack in the config file, the following process will be executed:
1. Checking directory existence
2. Fetching latest changes from remote repository
3. If there is a new commit, it will pull the changes
4. Running Docker Compose with the defined or default compose-file(s)