Skip to content

Commit e88c1a9

Browse files
clarify packages and oci artifacts steps
Signed-off-by: Craig <[email protected]>
1 parent 5ee2eb4 commit e88c1a9

File tree

1 file changed

+20
-6
lines changed

1 file changed

+20
-6
lines changed

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

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Customize a Docker Hardened Image
33
linkTitle: Customize an image
44
weight: 25
5-
keywords: debug, hardened images, DHI, customize, certificate, artififact
5+
keywords: debug, hardened images, DHI, customize, certificate, artifact
66
description: 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
5771
9. Select **Next: Configure** and then configure the following options.

0 commit comments

Comments
 (0)