From 7f9758a924d931f18ccc33d14e78129ad336549b Mon Sep 17 00:00:00 2001 From: patrick Date: Thu, 16 Jul 2026 17:01:43 -0400 Subject: [PATCH] document new health check and compose project variables --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index f85e8a6..1ac2f05 100644 --- a/README.md +++ b/README.md @@ -209,7 +209,7 @@ ansible-playbook --tags update site.yml **Update process:** 1. Stops the application -2. Pulls latest images for all services +2. Pulls images according to `app_compose_pull` (defaults to `policy`; set to `always` to force fresh pulls) 3. Recreates containers with new images 4. Runs health checks (if enabled) @@ -309,8 +309,9 @@ The file will be copied as-is to the application directory without Jinja2 proces | `app_compose_file` | - | Static compose file path | | `app_compose_content` | - | Inline compose content | | `app_compose_validate` | `true` | Validate compose syntax | -| `app_compose_pull` | `policy` | Image pull strategy | +| `app_compose_pull` | `policy` | Image pull strategy (also used by `update` — set to `always` to force pulls on update) | | `app_compose_recreate` | `auto` | Container recreate strategy | +| `app_compose_project_name` | `{{ app_dir \| basename }}` | Compose project name; override when your compose file sets a non-default project name | ### Backup Configuration @@ -335,6 +336,7 @@ The file will be copied as-is to the application directory without Jinja2 proces |----------|---------|-------------| | `app_health_check` | `true` | Enable health checks | | `app_health_check_method` | `docker` | Check method (`docker`/`http`) | +| `app_container_name` | `{{ app_name }}` | Container name inspected by the `docker` health check; override when your compose service uses a different `container_name` | | `app_health_check_url` | - | HTTP endpoint for health check | | `app_health_check_retries` | `30` | Number of check retries | | `app_health_check_delay` | `10` | Delay between checks (seconds) |