80 lines
3.0 KiB
Markdown
80 lines
3.0 KiB
Markdown
# Watchtower Module
|
|
|
|
This module deploys a Watchtower container which automatically updates your running Docker containers when new images become available.
|
|
|
|
## Features
|
|
|
|
- Automatic updates for Docker containers
|
|
- Configurable update schedule
|
|
- Optional cleanup of old images
|
|
- Notification support via shoutrrr
|
|
- Container monitoring options
|
|
|
|
## Usage
|
|
|
|
To use this module in your root module, add the following code:
|
|
|
|
```hcl
|
|
module "watchtower" {
|
|
source = "./modules/20-services-apps/watchtower"
|
|
|
|
# Basic configuration
|
|
container_name = "watchtower"
|
|
image_tag = "latest"
|
|
timezone = "Australia/Sydney"
|
|
|
|
# Update settings
|
|
poll_interval = 86400 # Check once per day (in seconds)
|
|
cleanup = true # Remove old images after updating
|
|
rolling_restart = true # Update containers one by one
|
|
|
|
# Optional notification settings
|
|
enable_notifications = false
|
|
# notification_url = "discord://webhook-id/webhook-token"
|
|
|
|
# Additional settings as needed
|
|
# additional_env_vars = {
|
|
# WATCHTOWER_MONITOR_ONLY = "true"
|
|
# }
|
|
}
|
|
```
|
|
|
|
## Required Resources
|
|
|
|
This module leverages the generic `docker-service` module, which handles the Docker container deployment.
|
|
|
|
## Input Variables
|
|
|
|
| Name | Description | Type | Default |
|
|
|------|-------------|------|---------|
|
|
| container_name | Name for the Watchtower container | string | "watchtower" |
|
|
| image_tag | The tag for the Watchtower container image | string | "latest" |
|
|
| restart_policy | Restart policy for the container | string | "unless-stopped" |
|
|
| timezone | Timezone for the container | string | "Etc/UTC" |
|
|
| cleanup | Remove old images after updating | bool | true |
|
|
| poll_interval | Poll interval (in seconds) for checking updates | number | 86400 |
|
|
| include_stopped | Include stopped containers when checking for updates | bool | false |
|
|
| revive_stopped | Restart stopped containers after updating | bool | false |
|
|
| rolling_restart | Restart containers one by one instead of all at once | bool | true |
|
|
| notification_url | URL for sending update notifications via shoutrrr | string | "" |
|
|
| enable_notifications | Enable shoutrrr notifications | bool | false |
|
|
| additional_env_vars | Additional environment variables for Watchtower | map(string) | {} |
|
|
| additional_volumes | Additional volumes to mount in the container | list(object) | [] |
|
|
| labels | Labels to set on the container | map(string) | {} |
|
|
| ports | Ports to expose (rarely needed for Watchtower) | list(object) | [] |
|
|
| monitoring | Enable monitoring for the container | bool | true |
|
|
|
|
## Outputs
|
|
|
|
| Name | Description |
|
|
|------|-------------|
|
|
| container_name | Name of the created Watchtower container |
|
|
| container_id | ID of the created Watchtower container |
|
|
| image_id | ID of the Watchtower image used |
|
|
|
|
## Notes
|
|
|
|
- Watchtower needs access to the Docker socket to monitor and update containers
|
|
- For security-conscious environments, consider limiting which containers Watchtower can update
|
|
- See the [Watchtower documentation](https://containrrr.dev/watchtower/) for more advanced configuration options
|