diff --git a/desktop/faqs.md b/desktop/faqs.md index 8e6fd34fc0..ac0d693213 100644 --- a/desktop/faqs.md +++ b/desktop/faqs.md @@ -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. diff --git a/docker-hub/access-tokens.md b/docker-hub/access-tokens.md index 584fdae340..210706df6e 100644 --- a/docker-hub/access-tokens.md +++ b/docker-hub/access-tokens.md @@ -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 `), 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 `), +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 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. + the far right of a token row to bring up the edit screen. You can also + select multiple tokens to delete at once. ![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.