Skip to content

Commit fe2a3ec

Browse files
committed
Update documentation
1 parent 946c04f commit fe2a3ec

File tree

1 file changed

+26
-6
lines changed

1 file changed

+26
-6
lines changed

DEVELOPMENT.md

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,35 @@ Any other customizations that are uniquely required can be added to the Dockerfi
3838

3939
## Updating the Docker Image
4040

41-
The `latest` Docker Image will be updated automatically after merging into the `main` branch.
42-
`wpengine/site-deploy:latest`
41+
### Automatic Builds
4342

43+
Docker images are built and pushed automatically:
4444

45-
A versioned Docker Image will be automatically generated for each release of this repository, based on the tag name
46-
`wpengine/site-deploy:{tagName}`
45+
| Trigger | Tags Updated | Source |
46+
|---------|--------------|--------|
47+
| Push to `main` | `latest` | Docker Hub Autobuild |
48+
| New version release | `latest`, `vX`, `vX.Y`, `vX.Y.Z` | Docker Hub Autobuild |
49+
| Monthly schedule (1st of month) | `latest`, `vX`, `vX.Y`, `vX.Y.Z` | GitHub Actions |
4750

48-
Additional Docker Images will be automatically generated for each branch to use in testing.
49-
`wpengine/site-deploy:branch-{branchName}`
51+
The scheduled monthly rebuild ensures security patches are applied even when there are no new releases. This workflow uses `no-cache` to pull fresh base image layers.
52+
53+
### Base Image Maintenance
54+
55+
The Dockerfile uses Alpine Linux as its base image. The base image follows this update pattern:
56+
57+
- **Dependabot** monitors for new Alpine versions and creates PRs automatically
58+
- **Scheduled rebuilds** pick up security patches from `apk upgrade` monthly
59+
- Alpine releases new versions every 6 months (roughly June and December)
60+
61+
When Dependabot opens a PR for a new Alpine version:
62+
63+
1. Review the [Alpine release notes](https://alpinelinux.org/releases/) for breaking changes
64+
2. Add a changeset to the PR (`npx changeset`) so a proper release is created when merged
65+
3. Merge the PR to trigger a new versioned release
66+
67+
### Docker Hub
68+
69+
Images are published to DockerHub: [wpengine/site-deploy](https://hub.docker.com/r/wpengine/site-deploy)
5070

5171
## Manually updating the Docker Image
5272

0 commit comments

Comments
 (0)