refactor: use include spec for docker compose

instead of generating a compose file from `docker compose config`
use the compose files as if they are headers and they are included
in an entrypoint `compose.yml` file.

adapt the jsonschema file for tests.

closes #120

Signed-off-by: Shantanoo 'Shan' Desai <[email protected]>

Author: shantanoo-desai

generate_stack.yml

@@ -2,7 +2,7 @@
 #
 # Komponist - Generate Your Favourite Compose Stack With the Least Effort
 #
-# Copyright (C) 2023  Shantanoo "Shan" Desai <[email protected]>
+# Copyright (C) 2025  Shantanoo "Shan" Desai <[email protected]>
 #
 #   This program is free software: you can redistribute it and/or modify
 #   it under the terms of the GNU Affero General Public License as published
@@ -38,42 +38,29 @@
       with_items:
         - "{{ komponist.configuration.keys() }}"
 
-    - name: "(KOMPONIST) Validation and Generation of docker-compose.yml"
-      block:
-        - name: "(DockerCompose) Validating Docker Compose Services"
-          ansible.builtin.command:
-            cmd: docker compose {{ compose_files }} config --no-interpolate --no-path-resolution --quiet
-          args:
-            chdir: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}"
-          vars:
-            compose_files: >-
-              {{ komponist.configuration.keys() | map('regex_replace', '^(.*)$', ' -f docker-compose.\1.yml') | join | trim }}
-          register: docker_compose_validity
-          changed_when: docker_compose_validity.rc != 0
+    - name: "(KOMPONIST) Generating Entrypoint compose.yml file from Templates"
+      ansible.builtin.template:
+        src: templates/services/compose.yml.j2
+        dest: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}/compose.yml"
+        mode: "0644"
 
-        - name: "(DockerCompose) Generating docker-compose.yml file if all services are valid"
-          ansible.builtin.command:
-            cmd: >
-              docker compose -p {{ komponist.configuration.project_name | default('komponist') }} {{ compose_files }} config
-                --no-interpolate
-                --no-path-resolution
-                -o docker-compose.yml
-          args:
-            chdir: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}"
-          vars:
-            compose_files: >-
-              {{ komponist.configuration.keys() | map('regex_replace', '^(.*)$', ' -f docker-compose.\1.yml') | join | trim }}
-          changed_when: docker_compose_validity.rc != 0
+    - name: "(KOMPONIST) Validating Docker Compose Services"
+      ansible.builtin.command:
+        cmd: docker compose config --no-interpolate --no-path-resolution --quiet
+      args:
+        chdir: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}"
+      register: docker_compose_validity
+      changed_when: docker_compose_validity.rc != 0
 
-        - name: "(KOMPONIST) Update the header for generated docker-compose.yml file"
-          ansible.builtin.blockinfile:
-            block: "{{ lookup('ansible.builtin.template', 'templates/license_header.txt.j2') }}"
-            path: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}/docker-compose.yml"
-            insertbefore: "BOF"
-            marker: ""
+    - name: "(KOMPONIST) Update the header for generated docker-compose.yml file"
+      ansible.builtin.blockinfile:
+        block: "{{ lookup('ansible.builtin.template', 'templates/license_header.txt.j2') }}"
+        path: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}/compose.yml"
+        insertbefore: "BOF"
+        marker: ""
 
-        - name: "(KOMPONIST) Generating the .env file for the Project"
-          ansible.builtin.template:
-            src: config/komponist.env.j2
-            dest: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}/.env"
-            mode: "0644"
+    - name: "(KOMPONIST) Generating the .env file for the Project"
+      ansible.builtin.template:
+        src: config/komponist.env.j2
+        dest: "{{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}/.env"
+        mode: "0644"

templates/services/compose.yml.j2

@@ -0,0 +1,29 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+#
+# Komponist - Generate Your Favourite Compose Stack With the Least Effort
+#
+# Copyright (C) 2025  Shantanoo "Shan" Desai <sdes[email protected]>
+#
+#   This program is free software: you can redistribute it and/or modify
+#   it under the terms of the GNU Affero General Public License as published
+#   by the Free Software Foundation, either version 3 of the License, or
+#   (at your option) any later version.
+#
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#   GNU Affero General Public License for more details.
+#
+#   You should have received a copy of the GNU Affero General Public License
+#   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+{{ ansible_managed | comment }}
+
+{# compose.yml.j2: Jinja2 Template for Main Compose Entrypoint File #}
+
+name: {{ komponist.project_name | default('komponist') }}
+
+include:
+{%for service in komponist.configuration.keys() %}
+  - {{ komponist.deploy_dir | default(ansible_user_dir + '/.komponist') }}/docker-compose.{{ service }}.yml
+{% endfor %}