-
Notifications
You must be signed in to change notification settings - Fork 7.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
hub: refresh/restructure repo content (#21435)
<!--Delete sections as needed --> ## Description Started refreshing and reorganizing the Hub manual. - Moved & rearranged the content from "Docker Hub > Manage repositories" to "Docker Hub > Repositories > Manage" with the following sections: - repo info: description, overview, categories - access: visibility, collaborators, teams/permissions, roles, OATs - images: tags, software artifacts, push images, move images - Moved the repository features (automated builds, webhooks, vulnerability scanning) under "Repositories > Manage". - Moved/added Create, Delete, and Personal settings to top-level of Repositories - Filled in some content gaps https://deploy-preview-21435--docsdocker.netlify.app/docker-hub/repos/ ## Related issues or tickets ENGDOCS-2227 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig <[email protected]>
- Loading branch information
1 parent
42d97aa
commit 5d12cf6
Showing
54 changed files
with
861 additions
and
413 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -144,7 +144,6 @@ minikube | |
| monorepos? | ||
| musl | ||
| nameserver | ||
| namespace | ||
| npm | ||
| osquery | ||
| osxfs | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,88 +1,54 @@ | ||
| --- | ||
| description: Learn how to manage repositories on Docker Hub | ||
| keywords: Docker, docker, trusted, registry, accounts, plans, Dockerfile, Docker Hub, | ||
| webhooks, docs, documentation, manage, repos | ||
| title: Manage repositories | ||
| keywords: Docker Hub, Hub, repositories | ||
| title: Repositories | ||
| weight: 20 | ||
| aliases: | ||
| - /engine/tutorials/dockerrepos/ | ||
| - /docker-hub/repos/ | ||
| - /docker-hub/repos/configure/ | ||
| --- | ||
|
|
||
| ## Manage default repository settings | ||
|
|
||
| You can manage the default repository settings for your personal account in Docker Hub. Select the **Settings** icon, then select **Repository Settings**. | ||
|
|
||
|  | ||
|
|
||
| Here you can manage the following: | ||
|
|
||
| - Default privacy: set the default repository privacy to either **Public** or **Private**. | ||
| - Linked accounts: for users with a Docker Pro, Team, or Business subscription, manage your source provider accounts to enable Automated Builds. | ||
| - Notifications: for users with a Docker Pro, Team, or Business subscription, manage how you receive notifications from autobuilds. | ||
|
|
||
| ## Change a repository from public to private | ||
|
|
||
| 1. Navigate to your repository. | ||
| 2. Select the **Settings** tab. | ||
| 3. Select **Make private**. | ||
| 4. Enter the name of your repository to confirm. | ||
|
|
||
| You get one free private repository with your Docker Hub user account (not | ||
| available for organizations you're a member of). If you need more private | ||
| repositories for your user account, upgrade your Docker Hub subscription from your [Billing Information](https://hub.docker.com/billing/plan) page. | ||
|
|
||
| ## Move images between repositories | ||
|
|
||
| ### Personal to personal | ||
|
|
||
| When consolidating personal repositories, you can pull private images from the initial repository and push them into another repository owned by you. To avoid losing your private images, perform the following steps: | ||
|
|
||
| 1. Navigate to [Docker Hub](https://hub.docker.com) create a new Docker ID and select a personal subscription. | ||
| 2. Using `docker login` from the CLI, sign in using your original Docker ID and pull your private images. | ||
| 3. Tag your private images with your newly created Docker ID, for example: | ||
|
|
||
| ```console | ||
| $ docker tag namespace1/docker101tutorial new_namespace/docker101tutorial | ||
| ``` | ||
| 4. Using `docker login` from the CLI, sign in with your newly created Docker ID, and push your newly tagged private images to your new Docker ID namespace: | ||
|
|
||
| ```console | ||
| $ docker push new_namespace/docker101tutorial | ||
| ``` | ||
|
|
||
| The private images that existed in your previous account are now available in your new account. | ||
|
|
||
| ### Personal to an organization | ||
|
|
||
| To avoid losing your private images, you can pull your private images from your personal account and push them to an organization that's owned by you. | ||
|
|
||
| 1. Navigate to [Docker Hub](https://hub.docker.com) and select **Organizations**. | ||
| 2. Select the applicable organization and verify that your user account is a member of the organization. | ||
| 3. Sign in to [Docker Hub](https://hub.docker.com) using your original Docker ID, and pull your images: | ||
|
|
||
| ```console | ||
| $ docker pull namespace1/docker101tutorial | ||
| ``` | ||
| 4. Tag your images with your new organization namespace: | ||
|
|
||
| ```console | ||
| $ docker tag namespace1/docker101tutorial <new_org>/docker101tutorial | ||
| ``` | ||
| 5. Push your newly tagged images to your new org namespace: | ||
|
|
||
| ```console | ||
| $ docker push new_org/docker101tutorial | ||
| ``` | ||
|
|
||
| The private images that existed in your user account are now available for your organization. | ||
|
|
||
| ## Delete a repository | ||
|
|
||
| > [!WARNING] | ||
| > | ||
| > Deleting a repository deletes all the images it contains and its build settings. This action can't be undone. | ||
| 1. Navigate to your repository. | ||
| 2. Select the **Settings** tab. | ||
| 3. Select **Delete repository**. | ||
| 4. Enter the name of your repository to confirm. | ||
| A Docker Hub repository is a collection of container images, enabling you to | ||
| store, manage, and share Docker images publicly or privately. Each repository | ||
| serves as a dedicated space where you can store images associated with a | ||
| particular application, microservice, or project. Content in repositories is | ||
| organized by tags, which represent different versions of the same application, | ||
| allowing users to pull the right version when needed. | ||
|
|
||
| In this section, learn how to: | ||
|
|
||
| - [Create](./create.md) a repository. | ||
| - Manage a repository, including how to manage: | ||
|
|
||
| - [Repository information](./manage/information.md): Add descriptions, | ||
| overviews, and categories to help users understand the purpose and usage of | ||
| your repository. Clear repository information aids discoverability and | ||
| usability. | ||
|
|
||
| - [Access](./manage/access.md): Control who can access your repositories with | ||
| flexible options. Make repositories public or private, add collaborators, | ||
| and, for organizations, manage roles and teams to maintain security and | ||
| control. | ||
|
|
||
| - [Images](./manage/hub-images/_index.md): Repositories support diverse | ||
| content types, including OCI artifacts, and allow version control through | ||
| tagging. Push new images and manage existing content across repositories | ||
| for flexibility. | ||
|
|
||
| - [Image security insights](./manage/vulnerability-scanning.md): Utilize | ||
| continuous Docker Scout analysis and static vulnerability scanning to | ||
| detect, understand, and address security issues within container images. | ||
|
|
||
| - [Webhooks](./manage/webhooks.md): Automate responses to repository events | ||
| like image pushes or updates by setting up webhooks, which can trigger | ||
| notifications or actions in external systems, streamlining workflows. | ||
|
|
||
| - [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. | ||
|
|
||
| - [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 | ||
| notifications. |
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.