Skip to content

Commit 490c49a

Browse files
dhi: add bulk customization (#24850)
<!--Delete sections as needed --> ## Description Added bulk customization for UI. ## Related issues or tickets ENGDOCS-3234 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
1 parent cb20791 commit 490c49a

1 file changed

Lines changed: 23 additions & 1 deletion

File tree

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

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,19 @@ You can create customizations using either the DHI CLI or the Docker Hub web int
4646
customization process. You can continue with the following steps for more
4747
details.
4848

49-
1. Select the image version you want to customize.
49+
1. Select one or more images or Helm charts and versions you want to customize.
50+
51+
When selecting multiple images and versions, all selections must share the
52+
same distribution and distribution version. For example, you can select
53+
`dhi-node:22_alpine3.23` and `dhi-python:3.13_alpine3.23` together (both
54+
Alpine 3.23), but you cannot mix `dhi-node:22_debian` with Alpine images, or
55+
mix different Alpine versions like `alpine3.23` and `alpine3.22`.
56+
57+
Alternatively, you can select multiple Helm chart versions to apply the same
58+
customization to all of them. You cannot mix images and Helm charts in the
59+
same customization.
60+
61+
1. Select **Next**.
5062
1. Optional. Add packages.
5163

5264
1. In the packages drop-down, select the packages you want to add to the
@@ -104,6 +116,11 @@ You can create customizations using either the DHI CLI or the Docker Hub web int
104116

105117
1. Select **Next: Configure** to configure the following image settings:
106118

119+
> [!NOTE]
120+
>
121+
> When customizing multiple images at once, many of these configuration
122+
> options are limited by default and may not be available.
123+
107124
1. Specify the [environment variables](/reference/dockerfile/#env) and their
108125
values that the image will contain.
109126
1. Add [labels](/reference/dockerfile/#label) to the image.
@@ -121,6 +138,11 @@ You can create customizations using either the DHI CLI or the Docker Hub web int
121138
customized image's tag. For example, if you specify `custom` when
122139
customizing the `dhi-python:3.13` image, the customized image will be
123140
tagged as `dhi-python:3.13_custom`.
141+
1. Select the compression format for the image layers. You can choose between
142+
**ZSTD** (default) or **GZIP** compression. **ZSTD** typically provides
143+
faster image pulls and better compression ratios, but may have
144+
compatibility issues with older software. If you need compatibility with
145+
older Docker versions, use **GZIP**.
124146
1. Select the platforms you want to build the image for. You must select at
125147
least one platform.
126148

0 commit comments

Comments
 (0)