36 lines
891 B
Markdown
36 lines
891 B
Markdown
# RoleForge Backend
|
|
|
|
Backend for an Ansible orchestration platform.
|
|
|
|
The project is designed to run fully in Docker, without installing Python dependencies on the host.
|
|
|
|
Includes:
|
|
- Playbook execution
|
|
- Molecule-based role/playbook test runs with dynamic container inventory
|
|
- Realtime logs over WebSocket
|
|
|
|
## Structure
|
|
|
|
- `app/` - all application source code, templates, and SQL bootstrap
|
|
- `docs/` - project documentation
|
|
- `k8s/` - Kubernetes manifests
|
|
|
|
## Quick start
|
|
|
|
1. Create local env file:
|
|
- `cp .env.example .env`
|
|
2. Start project:
|
|
- `make up`
|
|
3. Open:
|
|
- `http://localhost:8000/docs`
|
|
|
|
## Main commands
|
|
|
|
- `make up` - start services (`api`, `postgres`, `redis`)
|
|
- `make down` - stop services
|
|
- `make logs` - view logs
|
|
- `make ps` - service status
|
|
- `make db-shell` - open PostgreSQL shell
|
|
- `make api-shell` - shell in API container
|
|
|
|
Detailed usage is in `docs/runbook.md`. |