22title : Customize a Docker Hardened Image
33linkTitle : Customize an image
44weight : 25
5- keywords : debug, hardened images, DHI, customize, certificate, artififact
5+ keywords : debug, hardened images, DHI, customize, certificate, artifact
66description : Learn how to customize a Docker Hardened Images (DHI).
77---
88
@@ -35,8 +35,18 @@ To customize a Docker Hardened Image, follow these steps:
3535
3636 1 . In the ** Packages** drop-down, select the packages you want to add to the
3737 image.
38- 2 . In the ** OCI artifacts** drop-down select the OCI artifacts you want to
39- add to the image. The OCI artifacts are images that you have previously
38+
39+ The packages available in the drop-down are OS system packages for the
40+ selected image variant. For example, if you are customizing the Alpine
41+ variant of the Python DHI, the list will include all Alpine system
42+ packages.
43+
44+ 2 . In the ** OCI artifacts** drop-down, first, select the repository that
45+ contains the OCI artifact image. Then, select the tag you want to use from
46+ that repository. Finally, specify the specific paths you want to include
47+ from the OCI artifact image.
48+
49+ The OCI artifacts are images that you have previously
4050 built and pushed to a repository in the same namespace as the mirrored
4151 DHI. For example, you can add a custom root CA certificate or a another
4252 image that contains a tool you need, like adding Python to a Node.js
@@ -45,13 +55,17 @@ To customize a Docker Hardened Image, follow these steps:
4555
4656 When combining images that contain directories and files with the same
4757 path, images later in the list will overwrite files from earlier images.
48- To manage this, you can further select paths to include or exclude from
49- each OCI artifact image. This allows you to control which files are
58+ To manage this, you must select paths to include and optionally exclude
59+ from each OCI artifact image. This allows you to control which files are
5060 included in the final customized image.
5161
62+ By default, no files are included from the OCI artifact image. You must
63+ explicitly include the paths you want. After including a path, you can
64+ then explicitly exclude files or directories underneath it.
65+
5266 > [ !NOTE]
5367 >
54- > When necessary files are overwritten, the image build still
68+ > When files necessary for runtime are overwritten, the image build still
5569 > succeeds, but you may have issues when running the image.
5670
57719 . Select ** Next: Configure** and then configure the following options.
0 commit comments