mirror of
https://github.com/F1bonacc1/process-compose.git
synced 2024-08-16 15:00:32 +03:00
4.8 KiB
Executable File
4.8 KiB
Executable File
Process Compose
Process compose is a lightweight utility for building custom workflows and execution sequences. It is optimized for:
- Parallelizing processes execution
- Defining execution dependencies and order
- Defining recovery policies (restart
on-failure
,always
,no
) - Declaring processes arguments
- Declaring processes environment variables
It is heavily inspired by docker-compose, but without the need for containers. The configuration syntax tries to follow the docker-compose specifications, with a few minor additions and lots of subtractions.
Installation
- Download one of the releases
Documentation
- See examples of workflows for best practices
- See below
List of Features and Planned Features
✅ Mostly implemented
❌ Implementation not started (Your feedback and ⭐ will motivate further development 😃)
✅ Launcher
✅ Parallel
process1:
command: "sleep 3"
process2:
command: "sleep 3"
✅ Serial
process1:
command: "sleep 3"
depends_on:
process2:
condition: process_completed_successfully # or "process_completed" if you don't care about errors
process2:
command: "sleep 3"
depends_on:
process3:
condition: process_completed_successfully # or "process_completed" if you don't care about errors
❌ Instance Number
✅ Define process dependencies
process2:
depends_on:
process2:
condition: process_completed_successfully # or "process_started" (default)
process3:
condition: process_completed_successfully
✅ Output Handling
✅ Show process name
✅ Different colors per process
✅ StdErr is printed in Red
![output](/F1bonacc1/process-compose/media/commit/65942f2fe4f66f9f3cb899676e6de04cc36f1e75/imgs/output.png)
❌ Silence specific processes
✅ Logger
✅ Per Process Log Collection
process2:
log_location: ./pc.process2.log #if undefined or empty no logs will be saved
✅ Capture StdOut output
✅ Capture StdErr output
✅ Merge into a single file
processes:
process2:
command: "chmod 666 /path/to/file"
environment:
- 'ABC=42'
log_location: ./pc.global.log #if undefined or empty no logs will be saved (if also not defined per process)
❌ Silence specific processes
✅ Process compose console log level
log_level: info # other options: "trace", "debug", "info", "warn", "error", "fatal", "panic"
processes:
process2:
command: "chmod 666 /path/to/file"
This setting controls the process-compose
log level. The processes log level should be defined inside the process. It is recommended to support its definition with an environment variable that can be defined in process-compose.yaml
❌ Health Checks
❌ Is Alive
❌ Is Ready
❌ Auto Restart if not healthy
✅ Auto Restart on exit
process2:
availability:
restart: on-failure # other options: "always", "no" (default)
backoff_seconds: 2 # default: 1
max_restarts: 5 # default: 0 (unlimited)
✅ Environment Variables
✅ Per Process
process2:
environment:
- 'I_AM_LOCAL_EV=42'
✅ Global
processes:
process2:
command: "chmod 666 /path/to/file"
environment:
- 'I_AM_LOCAL_EV=42'
environment:
- 'I_AM_GLOBAL_EV=42'
❌ System Variables
❌ Process replica number
❌ Monitoring
❌ REST API
✅ Configuration
✅ Support .env file
✅ Override ${var} and $var from environment variables or .env values
❌ Merge 2 or more configuration files with override values
✅ Specify which configuration files to use
process-compose -f "path/to/process-compose-file.yaml"
✅ Auto discover configuration files
The following discovery order is used: compose.yml, compose.yaml, process-compose.yml, process-compose.yaml
. If multiple files are present the first one will be used.