Files
computer-playbook/roles/docker-container
Kevin Veen-Birkenbach 54d4eeb1ab Fix network alias assignment for DB services
Ensure that the database host alias is only attached to the database
containers themselves, not to dependent application containers. This
avoids DNS collisions where multiple containers expose the same alias
(e.g. 'postgres') on the same network, which led to connection refused
errors in XWiki.

See conversation: https://chatgpt.com/share/68cae4e5-94e4-800f-b291-d2acdb36af21
2025-09-17 18:42:36 +02:00
..
2025-07-08 14:03:51 +02:00

Docker Container

Description

This Ansible role supplies common Jinja2 snippets for composing Docker services consistently. Rather than repeating the same YAML blocks, you include one or more of the provided templates in your docker-compose.yml.j2.

Overview

The following templates are available under roles/docker-container/templates/:

  • base.yml.j2
    Common service settings: restart, env_file, logging.

  • networks.yml.j2
    Conditional network attachments:

    • central_<database_type> when central_database feature is enabled
    • central_ldap when LDAP feature and network are enabled
    • default
  • depends_on_dmbs.yml.j2
    Builds a depends_on: block automatically:

    • If central_database is off, renders an empty list depends_on: []
    • Otherwise, includes database and/or redis with healthcheck conditions
  • healthcheck/
    Four strategies:

    • curl.yml.j2 (HTTP via curl -f)
    • wget.yml.j2 (HTTP via wget --spider)
    • tcp.yml.j2 (TCP socket test)
    • msmtp_curl.yml.j2 (SMTP first, then HTTP via curl; avoids duplicate emails)

Include whichever snippets your service requires to keep your Compose files DRY and maintainable.

Features

  • Modular templates
    Mix only the blocks you need.

  • Featuredriven logic
    Networks and dependencies adjust automatically based on your applications variables.

  • Multiple healthcheck options
    Pick the probe that works best for your containers protocol and requirements.

Further Resources