Skip to content

Commit 2f6af4a

Browse files
dhi: add auto build info for customization (#23651)
<!--Delete sections as needed --> ## Description Added when customized images are rebuilt based on https://www.docker.com/blog/the-next-evolution-of-docker-hardened-images Updated topics: - https://deploy-preview-23651--docsdocker.netlify.app/dhi/how-to/customize/ - https://deploy-preview-23651--docsdocker.netlify.app/dhi/features/patching/#automatic-patching-for-customized-images ## Related issues or tickets [ENGDOCS-3098](https://docker.atlassian.net/browse/ENGDOCS-3098) https://docker.slack.com/archives/C04M34MRQS1/p1762150009971479?thread_ts=1762149292.279889&cid=C04M34MRQS1 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Editorial review - [ ] Product review [ENGDOCS-3098]: https://docker.atlassian.net/browse/ENGDOCS-3098?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ Signed-off-by: Craig Osterhout <[email protected]>
1 parent 1762a2f commit 2f6af4a

File tree

2 files changed

+24
-5
lines changed

2 files changed

+24
-5
lines changed

content/manuals/dhi/features/patching.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,4 +39,15 @@ Docker Hardened Images are automatically rebuilt and tested.
3939
Updated images are published with cryptographic provenance attestations to
4040
support verification and compliance workflows. This automated process reduces
4141
the operational burden of manual patching and helps teams stay aligned with
42-
secure software development practices.
42+
secure software development practices.
43+
44+
## Automatic patching for customized images
45+
46+
When you [customize a Docker Hardened Image](../how-to/customize.md), your
47+
customized images also benefit from automatic patching. When the base Docker
48+
Hardened Image receives a security update, Docker automatically rebuilds your
49+
customized images in the background, ensuring they stay current with the latest
50+
security patches without requiring manual intervention.
51+
52+
This means your customizations maintain continuous compliance and protection by
53+
default, with no additional operational overhead.

content/manuals/dhi/how-to/customize.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,16 +8,24 @@ description: Learn how to customize a Docker Hardened Images (DHI).
88

99
You can customize a Docker Hardened Image (DHI) to suit your specific needs
1010
using the Docker Hub UI. This allows you to select a base image, add packages,
11-
add artifacts, and configure settings. In addition, the build pipeline ensures that
12-
your customized image is built securely and includes attestations.
11+
add OCI artifacts (such as custom certificates or additional tools), and
12+
configure settings. In addition, the build pipeline ensures that your customized
13+
image is built securely and includes attestations.
14+
15+
Your customized images stay secure automatically. When the base Docker Hardened
16+
Image receives a security patch or your OCI artifacts are updated, Docker
17+
automatically rebuilds your customized images in the background. This ensures
18+
continuous compliance and protection by default, with no manual work required.
19+
The rebuilt images are signed and attested to the same SLSA Build Level 3
20+
standard as the base images, ensuring a secure and verifiable supply chain.
21+
22+
## Customize a Docker Hardened Image
1323

1424
To add a customized Docker Hardened Image to your organization, an organization
1525
owner must first [mirror](./mirror.md) the DHI repository to your organization.
1626
Once the repository is mirrored, any user with access to the mirrored DHI
1727
repository can create a customized image.
1828

19-
## Customize a Docker Hardened Image
20-
2129
To customize a Docker Hardened Image, follow these steps:
2230

2331
1. Sign in to [Docker Hub](https://hub.docker.com).

0 commit comments

Comments
 (0)