From 3a28e5d065e07cf478530dfbfe1f4b72eb56e45b Mon Sep 17 00:00:00 2001 From: Craig Date: Mon, 2 Dec 2024 09:31:31 -0800 Subject: [PATCH 1/6] hub: add archive repo Signed-off-by: Craig --- content/manuals/docker-hub/repos/_index.md | 3 +- content/manuals/docker-hub/repos/archive.md | 58 ++++++++++++++++++ .../repos/images/outdated-icon.webp.webp | Bin 0 -> 198 bytes .../docker-hub/repos/manage/information.md | 6 ++ 4 files changed, 66 insertions(+), 1 deletion(-) create mode 100644 content/manuals/docker-hub/repos/archive.md create mode 100644 content/manuals/docker-hub/repos/images/outdated-icon.webp.webp diff --git a/content/manuals/docker-hub/repos/_index.md b/content/manuals/docker-hub/repos/_index.md index 7eb9e73b7c00..5ead03bebe34 100644 --- a/content/manuals/docker-hub/repos/_index.md +++ b/content/manuals/docker-hub/repos/_index.md @@ -46,7 +46,8 @@ In this section, learn how to: - [Automated builds](./manage/builds/_index.md): Integrate with GitHub or Bitbucket for automated builds. Every code change triggers an image rebuild, supporting continuous integration and delivery. - + +- [Archive](./archive.md) an outdated or unsupported repository. - [Delete](./delete.md) a repository. - [Manage personal settings](./settings.md): For your account, you can set personal settings for repositories, including default repository privacy and autobuild diff --git a/content/manuals/docker-hub/repos/archive.md b/content/manuals/docker-hub/repos/archive.md new file mode 100644 index 000000000000..8013a3d893ce --- /dev/null +++ b/content/manuals/docker-hub/repos/archive.md @@ -0,0 +1,58 @@ +--- +description: Learn how to archive or activate a repository on Docker Hub +keywords: Docker Hub, Hub, repositories, archive, activate +title: Archive or activate a repository +linkTitle: Archive +toc_max: 3 +weight: 35 +--- + +You can archive a repository to avoid using outdated or unsupported images in +your workflow. Docker Hub helps you identify outdated repositories that haven't +been updated in over a year by displaying an icon ({{< inline-image +src="./images/outdated-icon.webp.webp" alt="outdated icon" >}}) next to the +repositories on the [**Repositories** page](https://hub.docker.com/repositories/). + +When a repository is archived, the following occurs: + +- The repository information can't be modified. +- New images can't be pushed to the repository. +- An **Archived** label is displayed on the public repository page. +- Users can still pull the images. + +You can activate an archived repository to remove the archived state. When +activated, the following occurs: + +- The repository information can be modified. +- New images can be pushed to the repository. +- The **Archived** label is removed on the public repository page. + +## Archive a repository + +1. Sign in to [Docker Hub](https://hub.docker.com). +2. Select **Repositories**. + + A list of your repositories appears. + +3. Select a repository. + + The **General** page for the repository appears. + +4. Select the **Settings** tab. +5. Select **Archive repository**. +6. Enter the name of your repository to confirm. +7. Select **Archive**. + +## Activate an archived repository + +1. Sign in to [Docker Hub](https://hub.docker.com). +2. Select **Repositories**. + + A list of your repositories appears. + +3. Select a repository. + + The **General** page for the repository appears. + +4. Select the **Settings** tab. +5. Select **Activate image**. \ No newline at end of file diff --git a/content/manuals/docker-hub/repos/images/outdated-icon.webp.webp b/content/manuals/docker-hub/repos/images/outdated-icon.webp.webp new file mode 100644 index 0000000000000000000000000000000000000000..153d3dcea0926d5cb590c3f78ef565921313de43 GIT binary patch literal 198 zcmV;%06G6sNk&G#00012MM6+kP&gp60000m1pu7^Dir_`06vjIn@T04q9LdV0I(7X zYyiFG04~5ckO@zIJcwWxBYrC6)Dhz&5CH!BrYyhpuC83>V)-%aHGiy>uY_p1c(J($ zM7Yac(OM+&LmNz!*Pt4Lm%LGmNjtqg4^1pPr-vWAY3}}VYa@o^nz~a2#?3wypEEw( z`x~Q0f_*lzF9@7f#rC&9zu|>}^<1jZUoyY1cTn|R&G`FU5K%y;zC_uRt^fc40FMt< AP5=M^ literal 0 HcmV?d00001 diff --git a/content/manuals/docker-hub/repos/manage/information.md b/content/manuals/docker-hub/repos/manage/information.md index a6da93c26d79..f48122faea43 100644 --- a/content/manuals/docker-hub/repos/manage/information.md +++ b/content/manuals/docker-hub/repos/manage/information.md @@ -12,6 +12,12 @@ Each repository can include a description, an overview, and categories to help users understand its purpose and usage. Adding clear repository information ensures that others can find your images and use them effectively. +You can only modify the repository information of active repositories. If a +repository is archived, you must activate it to modify the information. For more +details, see [Activate an archived +repository](../archive.md#active-an-archived-repository). + + ## Repository description The description appears in search results when using the `docker search` command From 31e8647fff383a3f14d1655e3b434374ef71f0e1 Mon Sep 17 00:00:00 2001 From: Craig Date: Mon, 2 Dec 2024 09:48:02 -0800 Subject: [PATCH 2/6] fix icon name Signed-off-by: Craig --- content/manuals/docker-hub/repos/archive.md | 2 +- .../{outdated-icon.webp.webp => outdated-icon.webp} | Bin 2 files changed, 1 insertion(+), 1 deletion(-) rename content/manuals/docker-hub/repos/images/{outdated-icon.webp.webp => outdated-icon.webp} (100%) diff --git a/content/manuals/docker-hub/repos/archive.md b/content/manuals/docker-hub/repos/archive.md index 8013a3d893ce..b7041a0a0b93 100644 --- a/content/manuals/docker-hub/repos/archive.md +++ b/content/manuals/docker-hub/repos/archive.md @@ -10,7 +10,7 @@ weight: 35 You can archive a repository to avoid using outdated or unsupported images in your workflow. Docker Hub helps you identify outdated repositories that haven't been updated in over a year by displaying an icon ({{< inline-image -src="./images/outdated-icon.webp.webp" alt="outdated icon" >}}) next to the +src="./images/outdated-icon.webp" alt="outdated icon" >}}) next to the repositories on the [**Repositories** page](https://hub.docker.com/repositories/). When a repository is archived, the following occurs: diff --git a/content/manuals/docker-hub/repos/images/outdated-icon.webp.webp b/content/manuals/docker-hub/repos/images/outdated-icon.webp similarity index 100% rename from content/manuals/docker-hub/repos/images/outdated-icon.webp.webp rename to content/manuals/docker-hub/repos/images/outdated-icon.webp From 8576c9cab818ad10871dbc9ebb5ef09b9d50701b Mon Sep 17 00:00:00 2001 From: Craig Date: Mon, 2 Dec 2024 14:40:40 -0800 Subject: [PATCH 3/6] fix anchor link Signed-off-by: Craig --- content/manuals/docker-hub/repos/manage/information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/information.md b/content/manuals/docker-hub/repos/manage/information.md index f48122faea43..6bb9177a8541 100644 --- a/content/manuals/docker-hub/repos/manage/information.md +++ b/content/manuals/docker-hub/repos/manage/information.md @@ -15,7 +15,7 @@ ensures that others can find your images and use them effectively. You can only modify the repository information of active repositories. If a repository is archived, you must activate it to modify the information. For more details, see [Activate an archived -repository](../archive.md#active-an-archived-repository). +repository](../archive.md#activate-an-archived-repository). ## Repository description From 06d2922eea110c5d91be30cad4cdb4a7655940fc Mon Sep 17 00:00:00 2001 From: Craig Date: Tue, 3 Dec 2024 11:16:13 -0800 Subject: [PATCH 4/6] polish intro Signed-off-by: Craig --- _vale/config/vocabularies/Docker/accept.txt | 1 + content/manuals/docker-hub/repos/archive.md | 15 ++++++++++----- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt index e3cd77f88634..f011af32f5ca 100644 --- a/_vale/config/vocabularies/Docker/accept.txt +++ b/_vale/config/vocabularies/Docker/accept.txt @@ -165,6 +165,7 @@ stdout subnet systemd tmpfs +unarchived? ufw umask ungated diff --git a/content/manuals/docker-hub/repos/archive.md b/content/manuals/docker-hub/repos/archive.md index b7041a0a0b93..2a49aa70ff05 100644 --- a/content/manuals/docker-hub/repos/archive.md +++ b/content/manuals/docker-hub/repos/archive.md @@ -7,11 +7,16 @@ toc_max: 3 weight: 35 --- -You can archive a repository to avoid using outdated or unsupported images in -your workflow. Docker Hub helps you identify outdated repositories that haven't -been updated in over a year by displaying an icon ({{< inline-image -src="./images/outdated-icon.webp" alt="outdated icon" >}}) next to the -repositories on the [**Repositories** page](https://hub.docker.com/repositories/). +You can archive a repository on Docker Hub to mark it as read-only and indicate +that it's no longer actively maintained. This helps prevent the use of outdated +or unsupported images in workflows. Archived repositories can also be unarchived +if needed. + +Docker Hub highlights repositories that haven't been updated in over a year by +displaying an icon ({{< inline-image src="./images/outdated-icon.webp" +alt="outdated icon" >}}) next to them on the [**Repositories** +page](https://hub.docker.com/repositories/). Consider reviewing these +highlighted repositories and archiving them if necessary. When a repository is archived, the following occurs: From 7faad024a1ccc4136fb59621d8a7e01126e26c46 Mon Sep 17 00:00:00 2001 From: Craig Date: Wed, 4 Dec 2024 10:01:31 -0800 Subject: [PATCH 5/6] update UI wording Signed-off-by: Craig --- _vale/config/vocabularies/Docker/accept.txt | 2 +- content/manuals/docker-hub/repos/archive.md | 14 +++++++------- .../manuals/docker-hub/repos/manage/information.md | 8 +++----- 3 files changed, 11 insertions(+), 13 deletions(-) diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt index f011af32f5ca..647372b9f6c1 100644 --- a/_vale/config/vocabularies/Docker/accept.txt +++ b/_vale/config/vocabularies/Docker/accept.txt @@ -124,6 +124,7 @@ Zsh [Ss]warm [Ss]ysfs [Tt]oolchains? +[Uu]narchived? [Vv]irtiofs [Vv]irtualize [Ww]alkthrough @@ -165,7 +166,6 @@ stdout subnet systemd tmpfs -unarchived? ufw umask ungated diff --git a/content/manuals/docker-hub/repos/archive.md b/content/manuals/docker-hub/repos/archive.md index 2a49aa70ff05..18c89bfccc27 100644 --- a/content/manuals/docker-hub/repos/archive.md +++ b/content/manuals/docker-hub/repos/archive.md @@ -1,7 +1,7 @@ --- -description: Learn how to archive or activate a repository on Docker Hub -keywords: Docker Hub, Hub, repositories, archive, activate -title: Archive or activate a repository +description: Learn how to archive or unarchive a repository on Docker Hub +keywords: Docker Hub, Hub, repositories, archive, unarchive +title: Archive or unarchive a repository linkTitle: Archive toc_max: 3 weight: 35 @@ -25,8 +25,8 @@ When a repository is archived, the following occurs: - An **Archived** label is displayed on the public repository page. - Users can still pull the images. -You can activate an archived repository to remove the archived state. When -activated, the following occurs: +You can unarchive an archived repository to remove the archived state. When +unarchived, the following occurs: - The repository information can be modified. - New images can be pushed to the repository. @@ -48,7 +48,7 @@ activated, the following occurs: 6. Enter the name of your repository to confirm. 7. Select **Archive**. -## Activate an archived repository +## Unarchive a repository 1. Sign in to [Docker Hub](https://hub.docker.com). 2. Select **Repositories**. @@ -60,4 +60,4 @@ activated, the following occurs: The **General** page for the repository appears. 4. Select the **Settings** tab. -5. Select **Activate image**. \ No newline at end of file +5. Select **Unarchive repository**. \ No newline at end of file diff --git a/content/manuals/docker-hub/repos/manage/information.md b/content/manuals/docker-hub/repos/manage/information.md index 6bb9177a8541..efca68451ab0 100644 --- a/content/manuals/docker-hub/repos/manage/information.md +++ b/content/manuals/docker-hub/repos/manage/information.md @@ -12,11 +12,9 @@ Each repository can include a description, an overview, and categories to help users understand its purpose and usage. Adding clear repository information ensures that others can find your images and use them effectively. -You can only modify the repository information of active repositories. If a -repository is archived, you must activate it to modify the information. For more -details, see [Activate an archived -repository](../archive.md#activate-an-archived-repository). - +You can only modify the repository information of repositories that aren't +achived. If a repository is archived, you must unarchive it to modify the +information. For more details, see [Unarchive a repository](../archive.md#unarchive-a-repository). ## Repository description From 4418ff1b800b715d8db393f44be32e76c0665d72 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Thu, 5 Dec 2024 14:21:44 -0800 Subject: [PATCH 6/6] Update content/manuals/docker-hub/repos/manage/information.md Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- content/manuals/docker-hub/repos/manage/information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/docker-hub/repos/manage/information.md b/content/manuals/docker-hub/repos/manage/information.md index efca68451ab0..0edff44ca97d 100644 --- a/content/manuals/docker-hub/repos/manage/information.md +++ b/content/manuals/docker-hub/repos/manage/information.md @@ -13,7 +13,7 @@ users understand its purpose and usage. Adding clear repository information ensures that others can find your images and use them effectively. You can only modify the repository information of repositories that aren't -achived. If a repository is archived, you must unarchive it to modify the +archived. If a repository is archived, you must unarchive it to modify the information. For more details, see [Unarchive a repository](../archive.md#unarchive-a-repository). ## Repository description