diff --git a/content/manuals/dhi/get-started.md b/content/manuals/dhi/get-started.md index 44922acb1ce6..58a6d851e426 100644 --- a/content/manuals/dhi/get-started.md +++ b/content/manuals/dhi/get-started.md @@ -25,7 +25,7 @@ namespace on Docker Hub. 1. Go to [Docker Hub](https://hub.docker.com) and sign in. 2. Select **My Hub** in the top navigation. 3. In the left sidebar, choose your organization that has DHI access. -4. In the left sidebar, select **DHI catalog**. +4. In the left sidebar, select **DHI** > **Catalog**. ![Docker Hub sidebar showing DHI catalog](./images/dhi-catalog.png) diff --git a/content/manuals/dhi/how-to/_index.md b/content/manuals/dhi/how-to/_index.md index f32ec4fccac1..c1af9b23c607 100644 --- a/content/manuals/dhi/how-to/_index.md +++ b/content/manuals/dhi/how-to/_index.md @@ -20,6 +20,10 @@ params: description: Learn how to pull, run, and reference Docker Hardened Images in Dockerfiles, CI pipelines, and standard development workflows. icon: play_arrow link: /dhi/how-to/use/ + - title: Manage Docker Hardened Images + description: Learn how to manage your mirrored and customized Docker Hardened Images in your organization. + icon: reorder + link: /dhi/how-to/manage/ - title: Migrate an existing application to use Docker Hardened Images description: Follow a step-by-step guide to update your Dockerfiles and adopt Docker Hardened Images for secure, minimal, and production-ready builds. icon: directions_run diff --git a/content/manuals/dhi/how-to/customize.md b/content/manuals/dhi/how-to/customize.md index ea3810591b5b..9aa51e0ebba9 100644 --- a/content/manuals/dhi/how-to/customize.md +++ b/content/manuals/dhi/how-to/customize.md @@ -24,9 +24,9 @@ To customize a Docker Hardened Image, follow these steps: 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has a mirrored DHI repository. -4. Select the mirrored DHI repository. -5. Select the **Customizations** tab. -6. Select **Create customization**. +4. Select **DHI** > **Management**. +5. For the mirrored DHI repository you want to customize, select the menu icon in the far right column. +6. Select **Customize**. At this point, the on-screen instructions will guide you through the customization process. You can continue with the following steps for more @@ -100,10 +100,16 @@ To edit or delete a Docker Hardened Image customization, follow these steps: 1. Sign in to [Docker Hub](https://hub.docker.com). 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has a mirrored DHI. -4. Select the mirrored DHI repository. -5. Select the **Customizations** tab. -6. Select **Edit** to edit the customization, or select the trashcan icon to - delete the customization. +4. Select **DHI** > **Management**. +5. Select **Customizations**. + +6. For the customized DHI repository you want to manage, select the menu icon in the far right column. + From here, you can: + + - **Edit**: Edit the customized image. + - **Create new**: Create a new customized image based on the source repository. + - **Delete**: Delete the customized image. + 7. Follow the on-screen instructions to complete the edit or deletion. ## Create an OCI artifact image diff --git a/content/manuals/dhi/how-to/explore.md b/content/manuals/dhi/how-to/explore.md index cf2c69b14ce9..a29a99120728 100644 --- a/content/manuals/dhi/how-to/explore.md +++ b/content/manuals/dhi/how-to/explore.md @@ -28,7 +28,7 @@ To explore Docker Hardened Images (DHI): 1. Go to [Docker Hub](https://hub.docker.com) and sign in. 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has access to DHI. -4. Select **DHI catalog**. +4. Select **DHI** > **Catalog**. On the DHI page, you can browse images, search images, or filter images by category. @@ -40,7 +40,7 @@ To view repository details: 1. Go to [Docker Hub](https://hub.docker.com) and sign in. 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has access to DHI. -4. Select **DHI catalog**. +4. Select **DHI** > **Catalog**. 5. Select a repository in the DHI catalog list. The repository details page provides the following: @@ -67,7 +67,7 @@ To explore image variants: 1. Go to [Docker Hub](https://hub.docker.com) and sign in. 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has access to DHI. -4. Select **DHI catalog**. +4. Select **DHI** > **Catalog**. 5. Select a repository in the DHI catalog list. 6. Select **Tags**. @@ -98,7 +98,7 @@ To explore the details of an image variant: 1. Go to [Docker Hub](https://hub.docker.com) and sign in. 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has access to DHI. -4. Select **DHI catalog**. +4. Select **DHI** > **Catalog**. 5. Select a repository in the DHI catalog list. 6. Select **Tags**. 7. Select the image variant's tag in the table. diff --git a/content/manuals/dhi/how-to/manage.md b/content/manuals/dhi/how-to/manage.md new file mode 100644 index 000000000000..90e3b5364d62 --- /dev/null +++ b/content/manuals/dhi/how-to/manage.md @@ -0,0 +1,53 @@ +--- +title: Manage Docker Hardened Images +linktitle: Manage images +description: Learn how to manage your mirrored and customized Docker Hardened Images in your organization. +keywords: manage docker hardened images, custom hardened images +weight: 45 +--- + +{{< summary-bar feature_name="Docker Hardened Images" >}} + +On the **Management** screen in Docker Hub, you can manage both your mirrored +Docker Hardened Image (DHI) repositories and customized DHI images in your +organization. + +## Manage mirrored Docker Hardened Images + +To manage your mirrored DHI repositories: + +1. Go to the [Docker Hub](https://hub.docker.com) and sign in. +2. Select **My Hub**. +3. In the namespace drop-down, select your organization. +4. Select **DHI** > **Management**. + + On this page, you can view your mirrored DHI + repositories and view which source repositories they are mirrored from. + +5. Select the menu icon in the far right column of the repository you want to manage. + + From here, you can: + + - **Customize**: Create a customized image based on the source repository. + - **Stop mirroring**: Stop mirroring the DHI repository. + +## Manage customized Docker Hardened Images + +To manage your customized DHI repositories: + +1. Go to [Docker Hub](https://hub.docker.com) and sign in. +2. Select **My Hub**. +3. In the namespace drop-down, select your organization. +4. Select **DHI** > **Management**. +5. Select **Customizations**. + + On this page, you can view your customized DHI + repositories. + +6. Select the menu icon in the far right column of the repository you want to manage. + + From here, you can: + + - **Edit**: Edit the customized image. + - **Create new**: Create a new customized image based on the source repository. + - **Delete**: Delete the customized image. \ No newline at end of file diff --git a/content/manuals/dhi/how-to/mirror.md b/content/manuals/dhi/how-to/mirror.md index 7c9b32eff8d1..fbfd445e6f63 100644 --- a/content/manuals/dhi/how-to/mirror.md +++ b/content/manuals/dhi/how-to/mirror.md @@ -31,7 +31,7 @@ To mirror a Docker Hardened Image repository: 1. Go to [Docker Hub](https://hub.docker.com) and sign in. 2. Select **My Hub**. 3. In the namespace drop-down, select your organization that has access to DHI. -4. Select **DHI catalog**. +4. Select **DHI** > **Catalog**. 5. Select a DHI repository to view its details. 6. Select **Mirror to repository** and follow the on-screen instructions. @@ -116,8 +116,12 @@ repository. To stop mirroring an image repository: -1. Go to the mirrored repository in your organization's namespace. -2. Select **Stop mirroring**. +1. Go to [Docker Hub](https://hub.docker.com) and sign in. +2. Select **My Hub**. +3. In the namespace drop-down, select your organization that has access to DHI. +4. Select **DHI** > **Management**. +5. In the far right column of the repository you want to stop mirroring, select the menu icon. +6. Select **Stop mirroring**. Once you have stopped mirroring a repository, you can choose another DHI repository to mirror. diff --git a/content/manuals/dhi/images/dhi-catalog.png b/content/manuals/dhi/images/dhi-catalog.png index 38ffabe91f0a..6e48684784f3 100644 Binary files a/content/manuals/dhi/images/dhi-catalog.png and b/content/manuals/dhi/images/dhi-catalog.png differ diff --git a/content/manuals/dhi/images/dhi-mirror-button.png b/content/manuals/dhi/images/dhi-mirror-button.png index a548de20b4c2..9f103c5a368f 100644 Binary files a/content/manuals/dhi/images/dhi-mirror-button.png and b/content/manuals/dhi/images/dhi-mirror-button.png differ diff --git a/content/manuals/dhi/images/dhi-python-mirror.png b/content/manuals/dhi/images/dhi-python-mirror.png index 9d3252eff9d0..7ec854d20054 100644 Binary files a/content/manuals/dhi/images/dhi-python-mirror.png and b/content/manuals/dhi/images/dhi-python-mirror.png differ diff --git a/content/manuals/dhi/images/dhi-python-search.png b/content/manuals/dhi/images/dhi-python-search.png index ffb58b9e185a..592b4ca240b0 100644 Binary files a/content/manuals/dhi/images/dhi-python-search.png and b/content/manuals/dhi/images/dhi-python-search.png differ