docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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
parent 4cea1c3271 95551ca1af
commit 93096e908e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 35 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
desktop/faqs.md
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. 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. 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.

45
docker-hub/access-tokens.md
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 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: 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** >**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**. 3. Select **[Security](https://hub.docker.com/settings/security) > New Access Token**.
4. Add a description for your token. Use something that indicates where 4. Add a description for your token. Use something that indicates where the token
the token will be used, or set a purpose for 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"} ![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 | | 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. >*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="_"}. 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"} ![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 You can use an access token anywhere that requires your Docker Hub
password. 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** > **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. 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="_"}**. 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
2. Select a token and click **Delete** or **Edit**, or use the menu on of tokens that are activated and deactivated in the toolbar.
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"} ![Delete or Edit](images/hub-delete-edit-token.png){:width="700px"}
> **Note** 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
> You can also view the number of tokens that are activated and deactivated in the toolbar. select multiple tokens to delete at once.
![Modify Token](images/hub-edit-token.png){:width="700px"} ![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.