kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-08-30 23:38:13 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
b3dfb8bf22945e221eb06315d7de06535136295d
computer-playbook/roles/docker-compose
History
Kevin Veen-Birkenbach 2fccebbd1f Enforce uppercase README.md and TODO.md filenames 
- Renamed all Readme.md → README.md
- Renamed all Todo.md → TODO.md
- Added integration test (tests/integration/test_filename_conventions.py) to automatically check naming convention.

Background:
Consistency in file naming (uppercase README.md and TODO.md) avoids issues with case-sensitive filesystems and ensures desktop cards (e.g. Pretix) are properly included.
Ref: https://chatgpt.com/share/68b1d135-c688-800f-9441-46a3cbfee175
2025-08-29 18:11:53 +02:00
..
defaults
Replaced nginx native with openresty for logout injection. Right now still buggy on nextcloud and espocrm
2025-07-24 03:19:16 +02:00
handlers
Solved path bugs and optimized them
2025-08-29 14:13:59 +02:00
meta
Replaced .infinito.service and .infinito.timer by SOFTWARE_NAME suffix, optimized LICENSE link and update OIDC Realm and ID conf
2025-08-14 14:39:18 +02:00
tasks
Added logic to start docker compose pull just once per directory
2025-08-20 07:02:27 +02:00
templates
Refactor: migrate cmp/* and srv/* roles into sys-stk/* and sys-svc/* namespaces
2025-08-28 22:23:09 +02:00
users
Restructured users
2025-07-09 02:26:50 +02:00
vars
Solved unit performance tests
2025-08-20 04:35:46 +02:00
Administration.md
Added journalctl logging for docker up's and execute portfolio just once condition
2025-05-16 15:26:51 +02:00
Debug.md
Solved bbb bugs
2025-04-06 09:09:41 +02:00
README.md
Renamed webserver roles to more speakable names
2025-08-20 08:54:17 +02:00
TODO.md
Enforce uppercase README.md and TODO.md filenames
2025-08-29 18:11:53 +02:00

README.md

Docker Compose

Description

This Ansible role manages Docker Compose project structures and workflows for applications on Arch Linux. It creates dedicated instance directories, manages .env and docker-compose.yml files, and provides automation logic for project reset, rebuild, and startup sequences.

Refer to the Docker Compose documentation, the Arch Wiki – Docker, and Compose CLI reference for more details.

Overview

This role creates a flexible directory layout for managing Docker Compose projects across environments. It ensures directories are initialized, optionally reset, and kept clean using internal flags like MODE_RESET or MODE_CLEANUP.

Purpose

To offer a centralized, extensible system for managing containerized applications using Docker Compose within the Infinito.Nexus architecture. The role allows easy integration of services, secrets, configurations, and custom behaviors per application.

Features

  • Dynamic Directory Structure: Creates per-application instance folders for Compose setups.
  • Reset Logic: Cleans previous Compose project files and data when MODE_RESET is enabled.
  • Handlers for Runtime Control: Automatically builds, sets up, or restarts containers based on handlers.
  • Template-ready Service Files: Predefined service base and health check templates.
  • Integration Support: Compatible with srv-proxy-core and other Infinito.Nexus service roles.

Administration Tips

For administration tips checkout this.

Credits 📝

Developed and maintained by Kevin Veen-Birkenbach
Learn more at www.veen.world

Part of the Infinito.Nexus Project
License: Infinito.Nexus NonCommercial License