Docker-compose Role¶
Description: No description available
Variables¶
author: Kevin Veen-Birkenbach
description: Manages Docker Compose project structure and execution logic on Arch Linux.
license: Infinito.Nexus NonCommercial License
license_url: https://s.infinito.nexus/license
company: Kevin Veen-Birkenbach
Consulting & Coaching Solutions https://www.veen.world
min_ansible_version: 2.9
platforms: [{‘name’: ‘Archlinux’, ‘versions’: [‘rolling’]}]
galaxy_tags: [‘docker’, ‘compose’, ‘container’, ‘infrastructure’, ‘devops’, ‘automation’, ‘archlinux’]
repository: https://s.infinito.nexus/code
issue_tracker_url: https://s.infinito.nexus/issues
documentation: https://docs.infinito.nexus/
README¶
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_RESETis 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
sys-svc-proxyand other Infinito.Nexus service roles.
Administration Tips¶
For administration tips checkout this.