mirror of https://github.com/docker/docs.git
Engdocs 1260 (#16888)
* rearrange toc * toc updates * edit AIM * edit convert an account * edit deactivate and downgrade subscription * minor tweak * build fix * review edits
This commit is contained in:
Allie Sadler
GitHub
parent
bd36df1cb7
commit
f682965597
|
|
@ -1789,14 +1789,9 @@ manuals:
|
|||
title: Generate a new recovery code
|
||||
- path: /docker-hub/download-rate-limit/
|
||||
title: Download rate limit
|
||||
- sectiontitle: Administration
|
||||
section:
|
||||
- path: /docker-hub/image-management/
|
||||
title: Advanced Image Management dashboard
|
||||
- path: /docker-hub/convert-account/
|
||||
title: Convert an account into an organization
|
||||
- path: /docker-hub/deactivate-account/
|
||||
title: Deactivate an account or an organization
|
||||
- path: /docker-hub/image-management/
|
||||
title: Advanced Image Management
|
||||
|
||||
- sectiontitle: Docker Verified Publisher
|
||||
section:
|
||||
- path: /docker-hub/publish/
|
||||
|
|
@ -1839,6 +1834,8 @@ manuals:
|
|||
title: FAQs
|
||||
- path: /docker-hub/orgs/
|
||||
title: Create your organization
|
||||
- path: /docker-hub/convert-account/
|
||||
title: Convert an account into an organization
|
||||
- path: /docker-hub/manage-a-team/
|
||||
title: Manage a team
|
||||
- path: /docker-hub/members/
|
||||
|
|
@ -1863,6 +1860,8 @@ manuals:
|
|||
title: Domain audit
|
||||
- path: /docker-hub/image-access-management/
|
||||
title: Image Access Management
|
||||
- path: /docker-hub/deactivate-account/
|
||||
title: Deactivate an account or organization
|
||||
|
||||
- sectiontitle: Billing
|
||||
section:
|
||||
|
|
|
|||
|
|
@ -4,60 +4,44 @@ title: Convert an account into an organization
|
|||
keywords: docker hub, hub, organization
|
||||
---
|
||||
|
||||
You can convert an existing user account to an organization. You might want to do this if you need multiple users to access your account and the repositories that it’s connected to. Converting it to an organization gives you better control over permissions for these users through teams.
|
||||
You can convert an existing user account to an organization. This is useful if you need multiple users to access your account and the repositories that it’s connected to. Converting it to an organization gives you better control over permissions for these users through [teams](manage-a-team.md).
|
||||
|
||||
> **Note:**
|
||||
When you convert a user account to an organization, the account
|
||||
is migrated to a Team plan and charged $35 per month for 5 seats. For more information,
|
||||
see [Docker Pricing](https://www.docker.com/pricing){: target="_blank" rel="noopener" class="_"}.
|
||||
|
||||
> **Important**
|
||||
>
|
||||
> Once you convert your account to an organization, you can’t revert it to a user account, so make sure you really want to convert the user account.
|
||||
> Once you convert your account to an organization, you can’t revert it to a user account.
|
||||
{: .important}
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Before you convert a user account to an organization, ensure that you have completed the following steps:
|
||||
Before you convert a user account to an organization, ensure that you meet the following requirements:
|
||||
|
||||
1. The user account that you wish to convert must not be a member of a company or any teams or organizations. You must remove the account from all teams, organizations, or the company.
|
||||
- The user account that you wish to convert must not be a member of a company or any teams or organizations. You must remove the account from all teams, organizations, or the company.
|
||||
|
||||
Go to **Organizations**, select an organization from the list, and then click the Leave organization arrow next to your username in the members list.
|
||||
To do this:
|
||||
1. Navigate to **Organizations** and then select the organization(s) you need to leave.
|
||||
2. Find your username in the **Members** tab.
|
||||
3. Select the **More options** menu and then select **Leave organization**.
|
||||
|
||||
If the user account is the sole owner of any organization or company, add someone to the "owners" team and then remove yourself from the organization or company.
|
||||
|
||||
2. You must have a separate Docker ID ready to assign it as the owner of the organization during conversion.
|
||||
- You must have a separate Docker ID ready to assign it as the owner of the organization during conversion.
|
||||
|
||||
If you wish to convert your user account into an organization account and you do not have any other user accounts, you need to create a new user account to assign it as the owner of the new organization. This user account then becomes the first member of the "owners" team and has full administrative access to configure and manage the organization. You can add more users into the "owners" team after the conversion.
|
||||
|
||||
## Convert a Community account into an organization
|
||||
## Convert an account into an organization
|
||||
|
||||
1. Ensure you have removed your user account from any company or teams or organizations. Also make sure that you have a new Docker ID before you convert an account. See the [Prerequisites](#prerequisites) section for details.
|
||||
|
||||
2. Click on your account name in the top navigation, then go to your **Account Settings**.
|
||||
2. In the top-right of Docker Hub, select your account name and then from the dropdown menu, select **Account Settings**.
|
||||
|
||||
3. Under the **Convert Account** tab, click **Convert to Organization**.
|
||||
3. From the **Convert Account** tab, select **Convert to Organization**.
|
||||
|
||||
4. Carefully review the warning displayed about converting a user account. This cannot be undone and will have considerable implications for your assets and the account.
|
||||
4. Review the warning displayed about converting a user account. This action cannot be undone and has considerable implications for your assets and the account.
|
||||
|
||||
5. As part of the conversion, you must enter a **Docker ID** to set an organization owner. This is the user account that will manage the organization, and the only way to access the organization settings after conversion. You cannot use the same Docker ID as the account you are trying to convert.
|
||||
5. Enter a **Docker ID** to set an organization owner. This is the user account that will manage the organization, and the only way to access the organization settings after conversion. You cannot use the same Docker ID as the account you are trying to convert.
|
||||
|
||||
6. Click **Convert** to confirm. The new owner will receive a notification email. Use that owner account to log into your new organization.
|
||||
|
||||
Your Community account has now been converted to an organization.
|
||||
|
||||
## Convert a Docker Pro tier into an organization
|
||||
|
||||
>**Note:**
|
||||
>
|
||||
> When you convert a Docker Pro subscription to an organization, the account
|
||||
will be migrated to a Team plan and will be charged $35 per month for 5 seats. For more information,
|
||||
see [Docker Pricing](https://www.docker.com/pricing){: target="_blank" rel="noopener" class="_"}.
|
||||
|
||||
1. Ensure you have removed your user account from any company or teams or organizations. Also make sure that you have a new Docker ID before you convert an account. See the [Prerequisites](#prerequisites) section for details.
|
||||
|
||||
2. Click on your account name in the top navigation bar, then go to your **Account Settings**.
|
||||
|
||||
3. Under the **Convert Account** tab, click **Convert to Organization**.
|
||||
|
||||
4. Carefully review the warning displayed about converting a user account. This cannot be undone and will have considerable implications for your assets and the account.
|
||||
|
||||
5. As part of the conversion, you must enter a **Docker ID** to set an organization owner. This is the user account that will manage the organization, and the only way to access the organization settings after conversion. You cannot use the same Docker ID as the account you are trying to convert.
|
||||
|
||||
6. Click **Convert** to confirm. The new owner will receive a notification email. Use that owner account to log into your new organization.
|
||||
|
||||
Your Pro user account has now been converted to an organization.
|
||||
6. Select **Convert and Purchase** to confirm. The new owner receives a notification email. Use that owner account to log in to your new organization.
|
||||
|
|
|
|||
|
|
@ -4,47 +4,65 @@ description: Learn how to deactivate a Docker Hub account or an organization
|
|||
keywords: Docker Hub, delete, deactivate, account, organization
|
||||
---
|
||||
|
||||
Your Docker Hub account or organization may also be linked to other Docker products and services, so deactivating it will also disable access to those products and services.
|
||||
You can deactivate an account at any time.
|
||||
|
||||
## Deactivating an account
|
||||
>**Warning**
|
||||
>
|
||||
> If your Docker Hub account or organization is linked to other Docker products and services, deactivating your account also removes access to those products and services.
|
||||
{: .warning}
|
||||
|
||||
Before deactivating your Docker Hub account, please complete the following:
|
||||
## Deactivate a user account
|
||||
|
||||
1. Download any images and tags you want to keep:
|
||||
`docker pull -a <image>:<tag>`.
|
||||
### Prerequisites
|
||||
|
||||
2. If you belong to any organizations, remove your account from all of them.
|
||||
Before deactivating your Docker Hub account, ensure that you meet the following requirements:
|
||||
|
||||
3. If you are the sole owner of an organization, either add someone to the **owners** team and then remove yourself from the organization, or deactivate the organization. Similarly, if you are the sole owner of a company, either add someone else as a company owner and then remove yourself, or deactivate the company.
|
||||
- You must not be a member of a company or any teams or organizations. You must remove the account from all teams, organizations, or the company.
|
||||
|
||||
4. If you have an active subscription, downgrade it to the **Docker Personal** subscription.
|
||||
To do this:
|
||||
1. Navigate to **Organizations** and then select the organization(s) you need to leave.
|
||||
2. Find your username in the **Members** tab.
|
||||
3. Select the **More options** menu and then select **Leave organization**.
|
||||
|
||||
In Docker Hub, navigate to **_Your Account_** > **Account Settings** > **Billing**.
|
||||
- If you are the sole owner of an organization, either add someone to [the **owners** team](manage-a-team.md#the-owners-team) and then remove yourself from the organization, or deactivate the organization. Similarly, if you are the sole owner of a company, either add someone else as a company owner and then remove yourself, or deactivate the company.
|
||||
|
||||
5. Unlink your [Github and Bitbucket accounts](../docker-hub/builds/link-source.md#unlink-a-github-user-account).
|
||||
- If you have an active subscription, [downgrade it to a Docker Personal subscription](../subscription/downgrade.md).
|
||||
|
||||
Once you have completed all the steps above, you may deactivate your account. On Docker Hub, go to **_Your Account_** > **Accounts Settings** > **Deactivate Account**.
|
||||
- Download any images and tags you want to keep. Use `docker pull -a <image>:<tag>`.
|
||||
|
||||
> This cannot be undone! Be sure you've gathered all the data you need from your account before deactivating it.
|
||||
- Unlink your [Github and Bitbucket accounts](../docker-hub/builds/link-source.md#unlink-a-github-user-account).
|
||||
|
||||
### Deactivate
|
||||
|
||||
Once you have completed all the steps above, you can deactivate your account.
|
||||
|
||||
1. Select your account name in the top-right of Docker Hub and from the dropdown menu, select **Account Settings**.
|
||||
2. From the **Deactivate Account** tab, select **Deactivate account**.
|
||||
|
||||
> This cannot be undone. Be sure you've gathered all the data you need from your account before deactivating it.
|
||||
{: .warning }
|
||||
|
||||
|
||||
## Deactivating an organization
|
||||
## Deactivate an organization
|
||||
|
||||
Before deactivating an organization, please complete the following:
|
||||
|
||||
1. Download any images and tags you want to keep:
|
||||
- Download any images and tags you want to keep:
|
||||
`docker pull -a <image>:<tag>`.
|
||||
|
||||
2. If you have an active subscription, downgrade it to the **Docker Free Team** subscription:
|
||||
- If you have an active subscription, [downgrade it to a **Docker Free Team** subscription](../subscription/downgrade.md).
|
||||
|
||||
In Docker Hub, navigate to **Organizations** > **_Your Organization_** > **Billing**.
|
||||
- Remove all other members, including those in the **Owners** team, within the organization.
|
||||
|
||||
3. Remove all other members, including those in the **Owners** team, within the organization.
|
||||
- Unlink your [Github and Bitbucket accounts](../docker-hub/builds/link-source.md#unlink-a-github-user-account).
|
||||
|
||||
4. Unlink your [Github and Bitbucket accounts](../docker-hub/builds/link-source.md#unlink-a-github-user-account).
|
||||
### Deactivate
|
||||
|
||||
Once you have completed all the steps above, you may deactivate your organization. On Docker Hub, go to **Organizations** > **_Your Organization_** > **Settings** > **Deactivate Org**.
|
||||
Once you have completed all the steps above, you can deactivate your organization.
|
||||
|
||||
> This cannot be undone! Be sure you've gathered all the data you need from your organization before deactivating it.
|
||||
1. On Docker Hub, select **Organizations**.
|
||||
2. Choose the organization you want to deactivate.
|
||||
3. In **Settings**, select the **Deactivate Org** tab and then **Deactivate organization**.
|
||||
|
||||
> This cannot be undone. Be sure you've gathered all the data you need from your organization before deactivating it.
|
||||
{: .warning }
|
||||
|
|
|
|||
|
|
@ -4,69 +4,34 @@ keywords: dashboard, images, image management, inactive
|
|||
title: Advanced Image Management dashboard
|
||||
---
|
||||
|
||||
{% include upgrade-cta.html
|
||||
body="Docker Pro, Team, and Business users can now use Docker Hub's **Advanced Image Management** dashboard. The dashboard enables a new level of access to your content, allowing fine-grained pruning of old data and exploration of old versions of pushed images. Upgrade now to start using the Advanced Image Management dashboard."
|
||||
header-text="This feature requires a paid Docker subscription"
|
||||
target-url="https://www.docker.com/pricing?utm_source=docker&utm_medium=webreferral&utm_campaign=docs_driven_upgrade_image-mgmt"
|
||||
%}
|
||||
{% include upgrade-cta.html %}
|
||||
|
||||
The **Advanced Image Management** dashboard allows you to manage Docker images across all repositories. [Upgrade](https://www.docker.com/pricing?utm_source=docker&utm_medium=webreferral&utm_campaign=docs_driven_upgrade){: target="_blank" rel="noopener" class="_"} your existing subscription to start using the Advanced Image Management dashboard. [Personal Access Tokens](../docker-hub/access-tokens.md) (PATs) are recommended when using automated flows and API integrations for added security. It's easier to manage your account if it becomes compromised and the account owner can remove them from Docker Hub.
|
||||
Advanced Image Management allows you to manage Docker images across all repositories and streamline storage in Docker Hub.
|
||||
|
||||
The Advanced Image Management dashboard provides a snapshot of your existing images and allows you to view, sort, and filter images by tags, activity status, and date, and contains options to clean up your workspace by deleting images that are no longer required.
|
||||
It provides:
|
||||
- A snapshot of your existing images
|
||||
- Allows you to view, sort, and filter images by tags, activity status, and date
|
||||
- Contains options to clean up your workspace by deleting images that are no longer required
|
||||
|
||||
The dashboard provides visibility into the status of the images in your repository and allows you to reduce the number of images stored in Docker Hub by reviewing their active status. An image retains its 'active' status if it is pulled or pushed in the last month. If there isn’t any activity on the image in the last month, it is considered 'inactive'.
|
||||
## Access the Advanced Image Management dashboard
|
||||
|
||||
By displaying the activity status and tags, the dashboard makes it easier for you to review the existing images and take actions to delete images that are not needed anymore. This is particularly helpful when your repository contains a lot of images that you have pushed over time, and you are now trying to streamline storage in Docker Hub.
|
||||
1. Sign in to [Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"}.
|
||||
2. Select **Repositories**.
|
||||
3. Choose a repository.
|
||||
4. Select **General** or **Tags**, and then select **Go to Advanced Image Management**.
|
||||
|
||||
The dashboard also displays the old versions of images you have pushed. When you push an image to Docker Hub, you push a manifest, a list of all the layers of your image, and the layers themselves. When you update an existing tag, only the new layers are pushed, along with the new manifest which references these layers. This new manifest gets the tag you specify when you push the image, such as `myNamespace/mytag:latest`. This does not remove the old manifests or the unique layers referenced by them from Hub. You can still use and reference these using the digest of the manifest if you know the SHA.
|
||||
## Understand image activity status and tags
|
||||
|
||||
With the new Advanced Image Management dashboard, all of this is now simpler and accessible for you to browse, use, and clean up.
|
||||
An image retains its 'active' status if it's pulled or pushed in the last month. If there isn’t any activity on the image in the last month, it's considered 'inactive'.
|
||||
|
||||
To access the Advanced Image Management dashboard:
|
||||
The dashboard also displays the old versions of images you have pushed. When you push an image to Docker Hub, you push a manifest, which is a list of all the layers of your image and the layers themselves. When you update an existing tag, only the new layers are pushed along with the new manifest which references the new layers. This new manifest gets the tag you specify when you push the image, such as `myNamespace/mytag:latest`. This doesn't remove the old manifests or the unique layers referenced by them from Hub. You can still use and reference these using the digest of the manifest if you know the SHA.
|
||||
|
||||
1. Log in to [Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"}.
|
||||
2. Click **Repositories** from the main menu and select a repository from the list.
|
||||
3. Click **General** or **Tags**, and click **Go to Advanced Image Management**.
|
||||
## Deleting a tagged image
|
||||
|
||||
{:width="700px"}
|
||||
A Docker image can contain multiple tags. A tag refers to a combination of artifacts or labels associated with the image. When you attempt to delete a tagged image, it deletes the tag associated with the image. This means, if there are any untagged images in your repository that previously held the same tag, those images will also be deleted even if they are active. Therefore, you must be careful when deleting tagged images.
|
||||
|
||||
4. In the dashboard you can sort and filter by active, inactive and untagged images.
|
||||
|
||||
> **Note**
|
||||
>
|
||||
> You must be logged in as a Docker Pro, Team, or a Business user to use the Advanced Image Management dashboard. Click [Upgrade](https://www.docker.com/pricing?utm_source=docker&utm_medium=webreferral&utm_campaign=docs_driven_upgrade){: target="_blank" rel="noopener"class="_"} to upgrade your existing subscription.
|
||||
|
||||
## View images
|
||||
|
||||
The Advanced Image Management dashboard provides a snapshot of your existing images and allows you to view images by tags, activity status and date, and also allows you to clean up your workspace by deleting images that are no longer required.
|
||||
|
||||
{:width="700px"}
|
||||
|
||||
## Delete images
|
||||
|
||||
You must be logged in as a Docker Pro, Team, or a Business user and have admin access to the repository to delete images. By default, the Advanced Image Management dashboard displays inactive images in the repository.
|
||||
|
||||
To delete an inactive image:
|
||||
|
||||
1. Log in to [Docker Hub](https://hub.docker.com){: target="_blank" rel="noopener" class="_"}.
|
||||
2. Click **Repositories** from the main menu and select a repository from the list.
|
||||
3. Click **General** or **Tags**, and click **Go to Advanced Image Management**.
|
||||
4. Enable the **Inactive** filter to view your inactive tags.
|
||||
|
||||
{:width="700px"}
|
||||
|
||||
5. Select the images that you want to delete from the repository and click the delete icon.
|
||||
|
||||
### Deleting a tagged image
|
||||
|
||||
A Docker image can contain multiple tags. A ‘tag’ refers to a combination of artifacts or labels associated with the image. When you attempt to delete a tagged image, it deletes the tag associated with the image. This means, if there are any untagged images in your repository that previously held the same tag, those images will also be deleted even if they are not inactive. Therefore, you must be careful when deleting tagged images.
|
||||
|
||||
For example, let's assume that Image-A is tagged as ‘latest’. You push another image, Image-B, and tag it as the new 'latest'. If you now delete Image-B, the 'latest' tag will be deleted, along with all images it previously referred to. However, if those images are tagged by another tag - in this case, if Image-B is also tagged with '1.5.0', for example, that tag would prevent its deletion.
|
||||
For example, let's assume that Image A is tagged as ‘latest’. You push another image, Image B, and tag it as the new 'latest'. If you now delete Image-B, the 'latest' tag will be deleted, along with all images it previously referred to. However, if those images are tagged by another tag - in this case, if Image-B is also tagged with '1.5.0', for example, that tag would prevent its deletion.
|
||||
|
||||
## Advanced Image Management API
|
||||
|
||||
The Advanced Image Management API endpoints allow you to manage Docker images across all repositories. For more information, see [Advanced Image management API](../api/latest/).
|
||||
|
||||
## Feedback
|
||||
|
||||
Thank you for trying out the Advanced Image Management dashboard. Your feedback is very important to us. Let us know your feedback by creating an issue in the [hub-feedback](https://github.com/docker/hub-feedback/issues){: target="_blank" rel="noopener" class="_"} GitHub repository.
|
||||
|
|
|
|||
|
|
@ -105,7 +105,7 @@ configure your organization.
|
|||
- **Settings**: Displays information about your
|
||||
organization, and allows you to view and change your repository privacy
|
||||
settings, configure org permissions such as
|
||||
[Image Access Management](image-access-management.md), configure notification settings, and [deactivate](deactivate-account.md#deactivating-an-organization) your
|
||||
[Image Access Management](image-access-management.md), configure notification settings, and [deactivate](deactivate-account.md#deactivate-an-organization) your
|
||||
organization. You can also update your organization name and company name that appear on your organization landing page.
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -24,13 +24,15 @@ Before you downgrade to a free subscription, you may need to reduce the number o
|
|||
|
||||
2. Select your username in the top-right corner and from the dropdown menu select **Billing**.
|
||||
|
||||
3. On the **Plan** tab, select **Change plan**.
|
||||
3. Choose either your personal account or an organization to downgrade.
|
||||
|
||||
4. On the **Change Plan** page, select the plan you'd like to downgrade to.
|
||||
4. On the **Plan** tab, select **Change plan**.
|
||||
|
||||
5. Review the downgrade warning and select **Continue**.
|
||||
5. On the **Change Plan** page, select the plan you'd like to downgrade to.
|
||||
|
||||
6. Optional: Select a reason for your downgrade from the list and select **Send**.
|
||||
6. Review the downgrade warning and select **Continue**.
|
||||
|
||||
7. Optional: Select a reason for your downgrade from the list and select **Send**.
|
||||
The **Billing** page displays a confirmation of the downgrade with details on when the downgrade changes take effect.
|
||||
|
||||
If you want to cancel the downgrade, select **Cancel the downgrade** on the **Plan** tab.
|
||||
|
|
|
|||
Loading…
Reference in New Issue