This directory contains automated workflows for maintaining and publishing the Docker WebDAV image.
Trigger: Daily at 00:00 UTC (or manually)
Purpose: Automatically checks for new Caddy releases and creates a pull request when updates are available.
Process:
- Fetches the current version from
version.txt - Queries the Caddy GitHub repository for the latest release
- Compares versions and creates a PR if an update is available
- Updates both
version.txtandDockerfilewith the new version
Manual Trigger:
gh workflow run check-updates.ymlTrigger:
- Push to main branch (when
version.txt,Dockerfile, orCaddyfile-*changes) - Pull request to main branch
- Manual dispatch
Purpose: Builds and publishes the Docker image to Docker Hub and creates a GitHub release.
Process:
- Reads version from
version.txt - Builds multi-platform Docker image (amd64, arm64)
- Pushes to Docker Hub with version tag and
latesttag - Creates a GitHub release with version information
Manual Trigger:
gh workflow run docker-publish.ymlTrigger: Weekly on Monday at 00:00 UTC (or manually)
Purpose: Monitors the status of Caddy plugins used in the image.
Process:
- Checks the latest commit of
mholt/caddy-webdav - Checks the latest release/commit of
caddy-dns/cloudflare - Creates/updates a GitHub issue with the plugin status report
Note: Plugins are automatically pulled at their latest versions during the Docker build process with xcaddy. This workflow is informational only.
Manual Trigger:
gh workflow run check-plugin-updates.ymlgraph TD
A[Daily Cron] -->|00:00 UTC| B[Check Updates]
B --> C{New Version?}
C -->|Yes| D[Create PR]
C -->|No| E[Skip]
D --> F[Manual Review]
F --> G[Merge PR]
G --> H[Trigger Build]
H --> I[Build Docker Image]
I --> J[Push to Docker Hub]
I --> K[Create GitHub Release]
L[Weekly Cron] -->|Monday| M[Check Plugins]
M --> N[Create/Update Issue]
O[Manual Trigger] --> H
The following secrets must be configured in the repository settings:
DOCKER_HUB_USERNAME: Docker Hub usernameDOCKER_HUB_ACCESS_TOKEN: Docker Hub access tokenGITHUB_TOKEN: Automatically provided by GitHub Actions
To change how often updates are checked, modify the cron schedule in check-updates.yml:
on:
schedule:
- cron: '0 0 * * *' # Daily at 00:00 UTCCommon cron patterns:
0 0 * * *- Daily at midnight0 0 * * 1- Weekly on Monday0 0 1 * *- Monthly on the 1st
Similarly, modify check-plugin-updates.yml to change the plugin check frequency.
You can test workflows without waiting for scheduled runs:
- Go to Actions tab in GitHub
- Select the workflow you want to test
- Click "Run workflow"
- Choose the branch and click "Run workflow"
- Check workflow runs in the Actions tab
- Review job logs for detailed error messages
- Use
workflow_dispatchtrigger for manual testing
- Automated Updates: Stay up-to-date with the latest Caddy releases automatically
- Multi-platform Support: Builds for both amd64 and arm64 architectures
- Version Tracking: Automatically creates GitHub releases with version information
- Plugin Monitoring: Keep track of plugin updates and changes
- Pull Request Workflow: Review changes before they're merged
- Docker Hub Integration: Automatically publish to Docker Hub with proper tagging