Merge pull request #13589 from docker/master

Publish updates from master
This commit is contained in:
Usha Mandya 2021-09-23 15:01:03 +01:00 committed by GitHub
commit 93096e908e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 35 additions and 17 deletions

View File

@ -239,3 +239,8 @@ For workarounds and to learn more, see
Docker Desktop supports two types of symlinks: Windows native symlinks and symlinks created inside a container.
The Windows native symlinks are visible within the containers as symlinks, whereas symlinks created inside a container are represented as [mfsymlinks](https://wiki.samba.org/index.php/UNIX_Extensions#Minshall.2BFrench_symlinks){:target="_blank" rel="noopener" class="_"}. These are regular Windows files with a special metadata. Therefore the symlinks created inside a container appear as symlinks inside the container, but not on the host.
### File sharing with Kubernetes and WSL 2
Docker Desktop mounts the Windows host filesystem under `/run/desktop` inside the container running Kubernetes.
See the [Stack Overflow post](https://stackoverflow.com/questions/67746843/clear-persistent-volume-from-a-kubernetes-cluster-running-on-docker-desktop/69273405#69273){:target="_blank" rel="noopener" class="_"} for an example of how to configure a Kubernetes Persistent Volume to represent directories on the host.

View File

@ -4,11 +4,15 @@ description: Learn how to create and manage your personal Docker Hub access toke
keywords: docker hub, hub, security, PAT, personal access token
---
Docker Hub lets you create personal access tokens as alternatives to your password. You can use tokens to access Hub images from the Docker CLI.
Docker Hub lets you create personal access tokens as alternatives to your password.
You can use tokens to access Hub images from the Docker CLI.
Using personal access tokens provides some advantages over a password:
* You can investigate the last usage of the access token and disable or delete it if you find any suspicious activity.
* When using an access token, you can't perform any admin activity on the account, including changing the password. It protects your account if your computer is compromised.
* You can investigate the last usage of the access token and disable or delete
it if you find any suspicious activity.
* When using an access token, you can't perform any admin activity on the account,
including changing the password. It protects your account if your computer is compromised.
>**Important**
>
@ -37,12 +41,13 @@ You can create as many tokens as you need.
3. Select **[Security](https://hub.docker.com/settings/security) > New Access Token**.
4. Add a description for your token. Use something that indicates where
the token will be used, or set a purpose for the token.
4. Add a description for your token. Use something that indicates where the token
will be used, or set a purpose for the token. You can view the following access
permissions from the drop-down:
![PAT Menu](images/hub-create-token.png){:width="700px"}
5. You can view the following permissions from the drop-down:
5. The table below lists the tokens available in each subscription:
| Feature | Personal | Pro | Team | Business |
| --------------------- | ---- | ----- | ----- |----- |
@ -53,7 +58,8 @@ the token will be used, or set a purpose for the token.
>*You can create 1 access token as part of the Docker Personal tier, 5 tokens as part of Docker Pro, and Unlimited tokens as part of Docker Team and Business tier.
For more information, see [Docker Pricing](https://www.docker.com/pricing?utm_source=docker&utm_medium=webreferral&utm_campaign=docs_driven_upgrade){: target="_blank" rel="noopener" class="_"}.
6. Copy the token that appears on the screen and save it. You will not be able to retrieve the token once you close this prompt.
6. Copy the token that appears on the screen and save it. You will not be able
to retrieve the token once you close this prompt.
![Copy Token](images/hub-copy-token.png){:width="700px"}
@ -62,7 +68,9 @@ the token will be used, or set a purpose for the token.
You can use an access token anywhere that requires your Docker Hub
password.
When logging in from your Docker CLI client (`docker login --username <username>`), omit the password in the login command. Instead, enter your token when asked for a password.
When logging in from your Docker CLI client (`docker login --username <username>`),
omit the password in the login command. Instead, enter your token when asked for
a password.
> **Note**
>
@ -75,17 +83,22 @@ When logging in from your Docker CLI client (`docker login --username <username>
You can rename, activate, deactivate, or delete a token as needed.
1. Access your tokens under **[Account Settings > Security](https://hub.docker.com/settings/security){: target="_blank" rel="noopener" class="_"}**.
This page shows an overview of all your tokens. You can also view the number
of tokens that are activated and deactivated in the toolbar.
![Delete or Edit](images/hub-delete-edit-token.png){:width="700px"}
2. Select a token and click **Delete** or **Edit**, or use the menu on
the far right of a token row to bring up the edit screen. You can also
select multiple tokens to delete at once.
![Delete or Edit](images/hub-delete-edit-token.png){:width="700px"}
> **Note**
>
> You can also view the number of tokens that are activated and deactivated in the toolbar.
![Modify Token](images/hub-edit-token.png){:width="700px"}
Docker provides a [Docker Hub CLI](https://github.com/docker/hub-tool#readme){: target="_blank" rel="noopener" class="_"} tool (currently experimental) and an API that allows you to interact with Docker Hub. Browse through the [Docker Hub API](/docker-hub/api/latest/){: target="_blank" rel="noopener" class="_"} documentation to explore the supported endpoints.
3. After modifying the token, click the **Save** button to save your changes.
> **Tip: Docker Hub CLI and API**
>
> Docker provides a [Docker Hub CLI](https://github.com/docker/hub-tool#readme){: target="_blank" rel="noopener" class="_"}
> tool (currently experimental) and an API that allows you to interact with Docker
> Hub. Browse through the [Docker Hub API](/docker-hub/api/latest/){: target="_blank" rel="noopener" class="_"}
> documentation to explore the supported endpoints.