diff --git a/Dockerfile b/Dockerfile index 70e7c47e67..e200af948a 100644 --- a/Dockerfile +++ b/Dockerfile @@ -13,7 +13,7 @@ ENV NODE_ENV=production RUN npm install FROM base AS hugo -ARG HUGO_VERSION=0.122.0 +ARG HUGO_VERSION=0.124.1 ARG TARGETARCH WORKDIR /tmp/hugo RUN wget -O "hugo.tar.gz" "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-${TARGETARCH}.tar.gz" diff --git a/assets/css/toc.css b/assets/css/toc.css index 151bf77b12..91ff92d7cd 100644 --- a/assets/css/toc.css +++ b/assets/css/toc.css @@ -1,12 +1,6 @@ @layer components { #TableOfContents { - nav { - @apply border-l-2 border-divider-light; - } - ul ul { - @apply pl-2; - } - a { + .toc a { @apply block max-w-full truncate py-1 pl-2 hover:font-medium hover:no-underline; &[aria-current="true"], &:hover { diff --git a/content/faq/admin/company-faqs.md b/content/admin/faqs/company-faqs.md similarity index 98% rename from content/faq/admin/company-faqs.md rename to content/admin/faqs/company-faqs.md index 1d37aab2ec..f3e4aa9ad9 100644 --- a/content/faq/admin/company-faqs.md +++ b/content/admin/faqs/company-faqs.md @@ -2,8 +2,10 @@ description: Company FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, company, administration, company management title: FAQs on companies +tags: [FAQ] aliases: - /docker-hub/company-faqs/ +- /faq/admin/company-faqs/ --- ### Are existing subscriptions affected when you create a company and add organizations to it? @@ -61,4 +63,4 @@ See [SCIM](scim.md) and [Group mapping](../../security/for-admins/group-mapping. ### What's the definition of a company vs an organization? -A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together. \ No newline at end of file +A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together. diff --git a/content/faq/admin/general-faqs.md b/content/admin/faqs/general-faqs.md similarity index 97% rename from content/faq/admin/general-faqs.md rename to content/admin/faqs/general-faqs.md index 9d4800cac2..756d4c7df8 100644 --- a/content/faq/admin/general-faqs.md +++ b/content/admin/faqs/general-faqs.md @@ -2,9 +2,11 @@ title: General FAQs for Docker accounts description: Frequently asked Docker account and administration questions keywords: onboarding, docker, teams, orgs, user accounts, organization accounts +tags: [FAQ] aliases: - /docker-hub/general-faqs/ - /docker-hub/onboarding-faqs/ +- /faq/admin/general-faqs/ --- ### What is a Docker ID? @@ -58,7 +60,7 @@ The organization owner can also add additional owners to help them manage users, ### Can I configure multiple SSO identity providers (IdPs) to authenticate users to a single org? Docker SSO allows only one IdP configuration per organization. For more -information, see [Configure SSO](../../security/for-admins/single-sign-on/configure/_index.md) and [SSO FAQs](../security/single-sign-on/faqs.md). +information, see [Configure SSO](../../security/for-admins/single-sign-on/configure/_index.md) and [SSO FAQs](../../security/faqs/single-sign-on/faqs.md). ### What is a service account? @@ -68,4 +70,4 @@ A [service account](../../docker-hub/service-accounts.md) is a Docker ID used fo Only someone with access to the Docker account can deactivate the account. For more details, see [Deactivating an account](../../admin/deactivate-account.md). -If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team). \ No newline at end of file +If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team). diff --git a/content/faq/admin/organization-faqs.md b/content/admin/faqs/organization-faqs.md similarity index 99% rename from content/faq/admin/organization-faqs.md rename to content/admin/faqs/organization-faqs.md index b94ae7f300..8fd8896efb 100644 --- a/content/faq/admin/organization-faqs.md +++ b/content/admin/faqs/organization-faqs.md @@ -2,8 +2,10 @@ description: Organization FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, organizations, administration title: FAQs on organizations +tags: [FAQ] aliases: - /docker-hub/organization-faqs/ +- /faq/admin/organization-faqs/ --- ### What if the Docker ID I want for my organization or company is taken? @@ -88,4 +90,4 @@ organization. See [Configure repository permissions for a team](manage-a-team.md ### Does my organization need to use Docker's registry? -A registry is a hosted service containing repositories of images that responds to the Registry API. Docker Hub is Docker's primary registry, but you can use Docker with other container image registries. You can access the default registry by browsing to [Docker Hub](https://hub.docker.com) or using the `docker search` command. \ No newline at end of file +A registry is a hosted service containing repositories of images that responds to the Registry API. Docker Hub is Docker's primary registry, but you can use Docker with other container image registries. You can access the default registry by browsing to [Docker Hub](https://hub.docker.com) or using the `docker search` command. diff --git a/content/billing/faqs.md b/content/billing/faqs.md index ddeb950400..5345dc70ce 100644 --- a/content/billing/faqs.md +++ b/content/billing/faqs.md @@ -2,6 +2,7 @@ title: Billing FAQs description: Frequently asked questions related to billing keywords: billing, renewal, payments, faq +tags: [FAQ] --- For more information on billing, see [Billing and payments](_index.md). diff --git a/content/build/architecture.md b/content/build/architecture.md index fb11f527f9..a0c81efbea 100644 --- a/content/build/architecture.md +++ b/content/build/architecture.md @@ -90,4 +90,4 @@ For more information about BuildKit, see [BuildKit](buildkit/index.md). The following diagram shows an example build sequence involving Buildx and BuildKit. -![Buildx and BuildKit sequence diagram](./images/build-execution.png) \ No newline at end of file +![Buildx and BuildKit sequence diagram](./images/build-execution.png) diff --git a/content/build/building/secrets.md b/content/build/building/secrets.md index 3813352ab4..31a138f409 100644 --- a/content/build/building/secrets.md +++ b/content/build/building/secrets.md @@ -2,6 +2,7 @@ title: Build secrets description: Manage credentials and other secrets securely keywords: build, secrets, credentials, passwords, tokens, ssh, git, auth, http +tags: [Secrets] --- A build secret is any piece of sensitive information, such as a password or API diff --git a/content/build/ci/github-actions/secrets.md b/content/build/ci/github-actions/secrets.md index e3cd60c049..4a50830903 100644 --- a/content/build/ci/github-actions/secrets.md +++ b/content/build/ci/github-actions/secrets.md @@ -2,6 +2,7 @@ title: Using secrets with GitHub Actions description: Example using secret mounts with GitHub Actions keywords: ci, github actions, gha, buildkit, buildx, secret +tags: [Secrets] --- A build secret is sensitive information, such as a password or API token, consumed as part of the build process. diff --git a/content/build/dockerfile/release-notes.md b/content/build/dockerfile/release-notes.md index 5832652b4e..a89a2e6b09 100644 --- a/content/build/dockerfile/release-notes.md +++ b/content/build/dockerfile/release-notes.md @@ -2,6 +2,7 @@ title: Dockerfile release notes description: Release notes for Dockerfile frontend keywords: build, dockerfile, frontend, release notes +tags: [Release notes] toc_max: 2 --- diff --git a/content/build/release-notes.md b/content/build/release-notes.md index fae34715c7..a9ec1157db 100644 --- a/content/build/release-notes.md +++ b/content/build/release-notes.md @@ -2,6 +2,7 @@ title: Build release notes description: Release notes for Buildx keywords: build, buildx, buildkit, release notes +tags: [Release notes] toc_max: 2 --- diff --git a/content/compose/environment-variables/best-practices.md b/content/compose/environment-variables/best-practices.md index aca402c1ea..575240e1b1 100644 --- a/content/compose/environment-variables/best-practices.md +++ b/content/compose/environment-variables/best-practices.md @@ -3,6 +3,7 @@ title: Best practices for working with environment variables in Docker Compose description: Explainer on the best ways to set, use, and manage environment variables in Compose keywords: compose, orchestration, environment, env file, environment variables +tags: [Best practices] --- #### Handle sensitive information securely diff --git a/content/compose/faq.md b/content/compose/faq.md index ac410fc8dd..c9a96f04fa 100644 --- a/content/compose/faq.md +++ b/content/compose/faq.md @@ -2,6 +2,7 @@ description: Frequently asked questions for Docker Compose keywords: documentation, docs, docker, compose, faq, docker compose vs docker-compose title: Compose FAQs +tags: [FAQ] --- {{< include "compose-eol.md" >}} @@ -105,4 +106,4 @@ supports hot code reloading or live-reload. There may be cases where you want to use both. You can have the image include the code using a `COPY`, and use a `volume` in your Compose file to include the code from the host during development. The volume overrides -the directory contents of the image. \ No newline at end of file +the directory contents of the image. diff --git a/content/compose/install/_index.md b/content/compose/install/_index.md index 452cf5115d..8afef908f7 100644 --- a/content/compose/install/_index.md +++ b/content/compose/install/_index.md @@ -48,4 +48,4 @@ You can [install the Compose standalone](standalone.md) on Linux or on Windows S > **Warning** > >This install scenario is not recommended and is only supported for backward compatibility purposes. -{ .warning } \ No newline at end of file +{ .warning } diff --git a/content/compose/release-notes.md b/content/compose/release-notes.md index 4cede5d1f7..e8b9f04269 100644 --- a/content/compose/release-notes.md +++ b/content/compose/release-notes.md @@ -2,6 +2,7 @@ title: Docker Compose release notes description: Release notes for Docker Compose keywords: release notes, compose +tags: [Release notes] toc_max: 2 aliases: - /release-notes/docker-compose/ diff --git a/content/compose/samples-for-compose.md b/content/compose/samples-for-compose.md index 5a16218307..5af465fa14 100644 --- a/content/compose/samples-for-compose.md +++ b/content/compose/samples-for-compose.md @@ -39,4 +39,4 @@ These samples focus specifically on Docker Compose: ## Awesome Compose samples -The Awesome Compose samples provide a starting point on how to integrate different frameworks and technologies using Docker Compose. All samples are available in the [Awesome-compose GitHub repo](https://github.com/docker/awesome-compose) and are ready to run with `docker compose up`. \ No newline at end of file +The Awesome Compose samples provide a starting point on how to integrate different frameworks and technologies using Docker Compose. All samples are available in the [Awesome-compose GitHub repo](https://github.com/docker/awesome-compose) and are ready to run with `docker compose up`. diff --git a/content/compose/use-secrets.md b/content/compose/use-secrets.md index 36b9eea715..00ccd16e4f 100644 --- a/content/compose/use-secrets.md +++ b/content/compose/use-secrets.md @@ -2,6 +2,7 @@ title: How to use secrets in Docker Compose description: How to use secrets in Compose and their benefits keywords: secrets, compose, security, environment variables +tags: [Secrets] --- A secret is any piece of data, such as a password, certificate, or API key, that shouldn’t be transmitted over a network or stored unencrypted in a Dockerfile or in your application’s source code. diff --git a/content/config/daemon/troubleshoot.md b/content/config/daemon/troubleshoot.md index 105aedcf9d..3669f9e8b9 100644 --- a/content/config/daemon/troubleshoot.md +++ b/content/config/daemon/troubleshoot.md @@ -2,6 +2,7 @@ title: Troubleshooting the Docker daemon description: Learn how to troubleshoot errors and misconfigurations in the Docker daemon keywords: docker, daemon, configuration, troubleshooting, error, fail to start +tags: [ Troubleshooting ] --- This page describes how to troubleshoot and debug the daemon if you run into diff --git a/content/contribute/components/call-outs.md b/content/contribute/components/call-outs.md index 34178e351e..c0f991606f 100644 --- a/content/contribute/components/call-outs.md +++ b/content/contribute/components/call-outs.md @@ -16,7 +16,7 @@ We support these broad categories of callouts: ## Examples -{{< introduced buildx 0.10.4 "../../release-notes.md#0104" >}} +{{< introduced buildx 0.10.4 >}} > **Note** > @@ -114,4 +114,4 @@ For both of the following callouts, consult [the Docker release lifecycle](/rele > Docker Scout is an [early access](/release-lifecycle/#early-access-ea) > product. { .restricted } -``` \ No newline at end of file +``` diff --git a/content/desktop/_index.md b/content/desktop/_index.md index 53ddf8f624..1e072ff1e6 100644 --- a/content/desktop/_index.md +++ b/content/desktop/_index.md @@ -6,37 +6,33 @@ keywords: how to use docker desktop, what is docker desktop used for, what does title: Overview of Docker Desktop grid: - title: Install Docker Desktop - description: 'Install Docker Desktop on - + description: | + Install Docker Desktop on [Mac](/desktop/install/mac-install/), - [Windows](/desktop/install/windows-install/), or - [Linux](/desktop/install/linux-install/). - - ' icon: download - title: Explore Docker Desktop description: Navigate Docker Desktop and learn about its key features. icon: feature_search - link: /desktop/use-desktop + link: /desktop/use-desktop/ - title: View the release notes description: Find out about new features, improvements, and bug fixes. icon: note_add - link: /desktop/release-notes + link: /desktop/release-notes/ - title: Browse common FAQs description: Explore general FAQs or FAQs for specific platforms. icon: help link: /desktop/faqs/ - title: Find additional resources - description: Find information on networking features, deploying on Kubernetes, and - more. + description: | + Find information on networking features, deploying on Kubernetes, and more. icon: category - link: /desktop/kubernetes + link: /desktop/kubernetes/ - title: Give feedback description: Provide feedback on Docker Desktop or Docker Desktop features. icon: sms - link: /desktop/feedback + link: /desktop/feedback/ aliases: - /desktop/opensource/ - /docker-for-mac/dashboard/ @@ -52,17 +48,16 @@ It provides a straightforward GUI (Graphical User Interface) that lets you manag Docker Desktop reduces the time spent on complex setups so you can focus on writing code. It takes care of port mappings, file system concerns, and other default settings, and is regularly updated with bug fixes and security updates. - {{< tabs >}} {{< tab name="What's included in Docker Desktop?" >}} -- [Docker Engine](../engine/index.md) +- [Docker Engine](../engine/_index.md) - Docker CLI client - [Docker Scout](../scout/_index.md) (additional subscription may apply) -- [Docker Build](../build/index.md) -- [Docker Extensions](extensions/index.md) -- [Docker Compose](../compose/index.md) -- [Docker Content Trust](../engine/security/trust/index.md) +- [Docker Build](../build/_index.md) +- [Docker Extensions](./extensions/_index.md) +- [Docker Compose](../compose/_index.md) +- [Docker Content Trust](../engine/security/trust/_index.md) - [Kubernetes](https://github.com/kubernetes/kubernetes/) - [Credential Helper](https://github.com/docker/docker-credential-helpers/) diff --git a/content/desktop/extensions-sdk/design/mui-best-practices.md b/content/desktop/extensions-sdk/design/mui-best-practices.md index 59b10c0633..4de8039a4f 100644 --- a/content/desktop/extensions-sdk/design/mui-best-practices.md +++ b/content/desktop/extensions-sdk/design/mui-best-practices.md @@ -47,4 +47,4 @@ Some of the above options require you to extend our MUI theme. See the MUI docum ## What's next? - Take a look at our [UI styling guide](index.md). -- Learn how to [publish your extension](../extensions/index.md). \ No newline at end of file +- Learn how to [publish your extension](../extensions/index.md). diff --git a/content/desktop/extensions-sdk/quickstart.md b/content/desktop/extensions-sdk/quickstart.md index 5b9321b2ea..fd579608e5 100644 --- a/content/desktop/extensions-sdk/quickstart.md +++ b/content/desktop/extensions-sdk/quickstart.md @@ -90,4 +90,4 @@ $ docker extension rm - Learn how to [test and debug](dev/test-debug.md) your extension. - Learn how to [setup CI for your extension](dev/continuous-integration.md). - Learn more about extensions [architecture](architecture/index.md). -- Learn more about [designing the UI](design/design-guidelines.md). \ No newline at end of file +- Learn more about [designing the UI](design/design-guidelines.md). diff --git a/content/desktop/faqs/general.md b/content/desktop/faqs/general.md index 445611efd1..fce2a5a391 100644 --- a/content/desktop/faqs/general.md +++ b/content/desktop/faqs/general.md @@ -2,6 +2,7 @@ description: Frequently asked Docker Desktop questions for all platforms keywords: desktop, mac, windows, faqs title: General FAQs for Desktop +tags: [FAQ] aliases: - /mackit/faqs/ - /docker-for-mac/faqs/ diff --git a/content/desktop/faqs/linuxfaqs.md b/content/desktop/faqs/linuxfaqs.md index ab0c506433..bf87494587 100644 --- a/content/desktop/faqs/linuxfaqs.md +++ b/content/desktop/faqs/linuxfaqs.md @@ -2,6 +2,7 @@ description: Frequently asked questions for Docker Desktop for Linux keywords: desktop, linux, faqs title: FAQs for Docker Desktop for Linux +tags: [FAQ] aliases: - /desktop/linux/space/ --- diff --git a/content/desktop/faqs/macfaqs.md b/content/desktop/faqs/macfaqs.md index 766fba6678..71149e7360 100644 --- a/content/desktop/faqs/macfaqs.md +++ b/content/desktop/faqs/macfaqs.md @@ -2,6 +2,7 @@ description: Frequently asked questions for Docker Desktop for Mac keywords: desktop, mac, faqs title: FAQs for Docker Desktop for Mac +tags: [FAQ] aliases: - /desktop/mac/space/ - /docker-for-mac/space/ diff --git a/content/desktop/faqs/releases.md b/content/desktop/faqs/releases.md index 6bc898a1c9..240f5e26ff 100644 --- a/content/desktop/faqs/releases.md +++ b/content/desktop/faqs/releases.md @@ -2,6 +2,7 @@ description: Frequently asked Docker Desktop questions for all platforms keywords: desktop, mac, windows, faqs title: FAQs on Docker Desktop releases +tags: [FAQ] --- ### How frequent will new releases be? diff --git a/content/desktop/faqs/windowsfaqs.md b/content/desktop/faqs/windowsfaqs.md index f46d0461f2..b477993d26 100644 --- a/content/desktop/faqs/windowsfaqs.md +++ b/content/desktop/faqs/windowsfaqs.md @@ -2,6 +2,7 @@ description: Frequently asked questions for Docker Desktop for Windows keywords: desktop, windows, faqs title: FAQs for Docker Desktop for Windows +tags: [FAQ] --- ### Can I use VirtualBox alongside Docker Desktop? diff --git a/content/desktop/hardened-desktop/enhanced-container-isolation/_index.md b/content/desktop/hardened-desktop/enhanced-container-isolation/_index.md index 94b7fb80f4..ba9b3360e7 100644 --- a/content/desktop/hardened-desktop/enhanced-container-isolation/_index.md +++ b/content/desktop/hardened-desktop/enhanced-container-isolation/_index.md @@ -59,7 +59,7 @@ For more information on how Enhanced Container Isolation work, see [How does it > > Enhanced Container Isolation does not yet fully protect Docker builds, > Kubernetes pods and Extension containers. For more information on known -> limitations and workarounds, see [FAQs](../../../faq/security/eci-faq.md). +> limitations and workarounds, see [FAQs](../../../security/faqs/eci-faq.md). {.important } ### What host OSes / platforms is Enhanced Container Isolation supported on? @@ -87,7 +87,7 @@ To enable Enhanced Container Isolation as a developer: > **Important** > -> Enhanced Container Isolation does not protect containers created prior to enabling ECI. For more information on known limitations and workarounds, see [FAQs](../../../faq/security/eci-faq.md). +> Enhanced Container Isolation does not protect containers created prior to enabling ECI. For more information on known limitations and workarounds, see [FAQs](../../../security/faqs/eci-faq.md). { .important } #### As an admin diff --git a/content/desktop/hardened-desktop/enhanced-container-isolation/how-eci-works.md b/content/desktop/hardened-desktop/enhanced-container-isolation/how-eci-works.md index 631a8bfdc1..7df0261004 100644 --- a/content/desktop/hardened-desktop/enhanced-container-isolation/how-eci-works.md +++ b/content/desktop/hardened-desktop/enhanced-container-isolation/how-eci-works.md @@ -16,7 +16,7 @@ When [Enhanced Container Isolation is enabled](index.md#how-do-i-enable-enhanced created by users through `docker run` or `docker create` are automatically launched using Sysbox instead of the standard OCI runc runtime. Users need not do anything else and can continue to use containers as usual. For exceptions, -see [FAQs](../../../faq/security/eci-faq.md). +see [FAQs](../../../security/faqs/eci-faq.md). Even containers that use the insecure `--privileged` flag can now be run securely with Enhanced Container Isolation, such that they can no longer be used diff --git a/content/desktop/install/archlinux.md b/content/desktop/install/archlinux.md index e069538e4a..9c03a798f9 100644 --- a/content/desktop/install/archlinux.md +++ b/content/desktop/install/archlinux.md @@ -53,4 +53,4 @@ $ sudo pacman -S gnome-terminal - Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application. - [Explore Docker Desktop](../use-desktop/index.md) and all its features. -- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker. \ No newline at end of file +- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker. diff --git a/content/desktop/release-notes.md b/content/desktop/release-notes.md index 5c61f7693b..fa4111875b 100644 --- a/content/desktop/release-notes.md +++ b/content/desktop/release-notes.md @@ -2,6 +2,7 @@ description: Release notes for Docker Desktop for Mac, Linux, and Windows keywords: Docker desktop, release notes, linux, mac, windows title: Docker Desktop release notes +tags: [Release notes] toc_max: 2 aliases: - /docker-for-mac/release-notes/ diff --git a/content/desktop/troubleshoot/known-issues.md b/content/desktop/troubleshoot/known-issues.md index a53dd24b01..9cd6c21648 100644 --- a/content/desktop/troubleshoot/known-issues.md +++ b/content/desktop/troubleshoot/known-issues.md @@ -2,6 +2,7 @@ description: Find known issues for Docker Desktop keywords: mac, troubleshooting, known issues, Docker Desktop title: Known issues +tags: [ Troubleshooting ] --- {{< tabs >}} @@ -72,4 +73,4 @@ title: Known issues - `ping` from inside a container to the Internet does not work as expected. To test the network, use `curl` or `wget`. See [docker/for-mac#5322](https://github.com/docker/for-mac/issues/5322#issuecomment-809392861). - Users may occasionally experience data drop when a TCP stream is half-closed. {{< /tab >}} -{{< /tabs >}} \ No newline at end of file +{{< /tabs >}} diff --git a/content/desktop/troubleshoot/overview.md b/content/desktop/troubleshoot/overview.md index 6982af444d..7efee58036 100644 --- a/content/desktop/troubleshoot/overview.md +++ b/content/desktop/troubleshoot/overview.md @@ -13,6 +13,7 @@ aliases: - /windows/troubleshoot/ - /docker-for-win/troubleshoot/ - /docker-for-windows/troubleshoot/ +tags: [ Troubleshooting ] --- This page contains information on how to diagnose and troubleshoot Docker Desktop, and how to check the logs. @@ -312,4 +313,4 @@ to learn how to view the Docker Daemon logs. - View specific [troubleshoot topics](topics.md). - Implement [workarounds for common problems](workarounds.md) -- View information on [known issues](known-issues.md) \ No newline at end of file +- View information on [known issues](known-issues.md) diff --git a/content/desktop/troubleshoot/topics.md b/content/desktop/troubleshoot/topics.md index 62f59ac2e4..b98f230efa 100644 --- a/content/desktop/troubleshoot/topics.md +++ b/content/desktop/troubleshoot/topics.md @@ -3,6 +3,7 @@ description: Explore common troubleshooting topics for Docker Desktop keywords: Linux, Mac, Windows, troubleshooting, topics, Docker Desktop title: Troubleshoot topics for Docker Desktop toc_max: 4 +tags: [ Troubleshooting ] --- > **Tip** diff --git a/content/desktop/troubleshoot/workarounds.md b/content/desktop/troubleshoot/workarounds.md index 50feb4ad06..7af6aa899f 100644 --- a/content/desktop/troubleshoot/workarounds.md +++ b/content/desktop/troubleshoot/workarounds.md @@ -2,6 +2,7 @@ description: Common workarounds keywords: linux, mac, windows, troubleshooting, workarounds, Docker Desktop title: Workarounds for common problems +tags: [ Troubleshooting ] --- ### Reboot @@ -44,4 +45,4 @@ typically occurs after a Windows update and manifests as an error response from the Docker daemon and a Docker Desktop start failure. For a temporary workaround, uninstall the anti-virus software, or -explore other workarounds suggested on Docker Desktop forums. \ No newline at end of file +explore other workarounds suggested on Docker Desktop forums. diff --git a/content/desktop/wsl/best-practices.md b/content/desktop/wsl/best-practices.md index b4d8689fc2..37e36279f5 100644 --- a/content/desktop/wsl/best-practices.md +++ b/content/desktop/wsl/best-practices.md @@ -2,6 +2,7 @@ title: Best practices description: Best practices for using Docker Desktop with WSL 2 keywords: wsl, docker desktop, best practices +tags: [Best practices] --- - Always use the latest version of WSL. At a minimum you must use WSL version 1.1.3.0., otherwise Docker Desktop may not work as expected. Testing, development, and documentation is based on the newest kernel versions. Older versions of WSL can cause: @@ -17,4 +18,4 @@ keywords: wsl, docker desktop, best practices - Instead, from a Linux shell use a command like `docker run -v ~/my-project:/sources ` where `~` is expanded by the Linux shell to `$HOME`. - If you have concerns about the size of the docker-desktop-data VHDX, or need to change it, take a look at the [WSL tooling built into Windows](https://learn.microsoft.com/en-us/windows/wsl/disk-space). -- If you have concerns about CPU or memory usage, you can configure limits on the memory, CPU, and swap size allocated to the [WSL 2 utility VM](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#global-configuration-options-with-wslconfig). \ No newline at end of file +- If you have concerns about CPU or memory usage, you can configure limits on the memory, CPU, and swap size allocated to the [WSL 2 utility VM](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#global-configuration-options-with-wslconfig). diff --git a/content/develop/dev-best-practices.md b/content/develop/dev-best-practices.md index 99cb4ae0e2..2095b76010 100644 --- a/content/develop/dev-best-practices.md +++ b/content/develop/dev-best-practices.md @@ -2,6 +2,7 @@ title: Docker development best practices description: Rules of thumb for making your life easier as a Docker application developer keywords: application, development +tags: [Best practices] --- The following development patterns have proven to be helpful for people diff --git a/content/develop/develop-images/dockerfile_best-practices.md b/content/develop/develop-images/dockerfile_best-practices.md index 08cf2f7acd..f9be76c157 100644 --- a/content/develop/develop-images/dockerfile_best-practices.md +++ b/content/develop/develop-images/dockerfile_best-practices.md @@ -8,6 +8,7 @@ aliases: - /docker-cloud/getting-started/intermediate/optimize-dockerfiles/ - /docker-cloud/tutorials/optimize-dockerfiles/ - /engine/userguide/eng-image/dockerfile_best-practices/ +tags: [Best practices] --- This topic covers recommended best practices and methods for building diff --git a/content/develop/develop-images/guidelines.md b/content/develop/develop-images/guidelines.md index aadda5d3e4..2f712ffab8 100644 --- a/content/develop/develop-images/guidelines.md +++ b/content/develop/develop-images/guidelines.md @@ -2,6 +2,7 @@ description: Hints, tips and guidelines for writing clean, reliable Dockerfiles keywords: parent image, images, dockerfile, best practices, hub, official image title: General best practices for writing Dockerfiles +tags: [Best practices] --- ## Use multi-stage builds diff --git a/content/develop/security-best-practices.md b/content/develop/security-best-practices.md index d6474d408d..698b865a4d 100644 --- a/content/develop/security-best-practices.md +++ b/content/develop/security-best-practices.md @@ -4,6 +4,7 @@ description: Image security best practices guide keywords: docker, images, containers, vulnerability, cve aliases: - /develop/scan-images/ +tags: [Best practices] --- You can take a few steps to improve the security of your diff --git a/content/docker-hub/builds/troubleshoot.md b/content/docker-hub/builds/troubleshoot.md index 93a8f441f8..6f8739b8d4 100644 --- a/content/docker-hub/builds/troubleshoot.md +++ b/content/docker-hub/builds/troubleshoot.md @@ -2,6 +2,7 @@ title: Troubleshoot your autobuilds description: How to troubleshoot Automated builds keywords: docker hub, troubleshoot, automated builds, autobuilds +tags: [ Troubleshooting ] --- > **Note** @@ -66,4 +67,4 @@ system access to the repositories. > **Note** > > You must configure your private git submodules using git clone over SSH -> (`git@submodule.tld:some-submodule.git`) rather than HTTPS. \ No newline at end of file +> (`git@submodule.tld:some-submodule.git`) rather than HTTPS. diff --git a/content/docker-hub/quickstart.md b/content/docker-hub/quickstart.md index 000aecaa4e..d8b3dbb86d 100644 --- a/content/docker-hub/quickstart.md +++ b/content/docker-hub/quickstart.md @@ -216,4 +216,4 @@ You've successfully: - Automatically build container images from code through [builds](builds/index.md). - [Explore](https://hub.docker.com/explore) official & publisher images. - [Upgrade your subscription](https://www.docker.com/pricing) to push additional private Docker images to -Docker Hub. \ No newline at end of file +Docker Hub. diff --git a/content/docker-hub/release-notes.md b/content/docker-hub/release-notes.md index 40fe2c6d95..31d331b4a8 100644 --- a/content/docker-hub/release-notes.md +++ b/content/docker-hub/release-notes.md @@ -5,6 +5,7 @@ description: Learn about the new features, bug fixes, and breaking changes for D keywords: docker hub, whats new, release notes toc_min: 1 toc_max: 2 +tags: [Release notes] --- Here you can learn about the latest changes, new features, bug fixes, and diff --git a/content/engine/install/linux-postinstall.md b/content/engine/install/linux-postinstall.md index 4c46d3c446..7bd20dcadd 100644 --- a/content/engine/install/linux-postinstall.md +++ b/content/engine/install/linux-postinstall.md @@ -142,4 +142,4 @@ options: - Read the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application. - Review the topics in [Develop with Docker](../../develop/index.md) to learn - how to build new applications using Docker. \ No newline at end of file + how to build new applications using Docker. diff --git a/content/engine/install/troubleshoot.md b/content/engine/install/troubleshoot.md index 999c2d77a9..857ada15ac 100644 --- a/content/engine/install/troubleshoot.md +++ b/content/engine/install/troubleshoot.md @@ -2,6 +2,7 @@ title: Troubleshoot Docker Engine installation description: Learn how to diagnose and resolve error messages related to the Docker Engine installation. keywords: Docker Engine, troubleshooting, error, Linux, install Docker Engine +tags: [ Troubleshooting ] --- This page contains instructions for troubleshooting and diagnosing the Docker @@ -288,4 +289,4 @@ Docker isn't running. An error occurs if your GRUB configuration file has incorrect syntax. In this case, repeat steps 2 and 3. - The changes take effect when you reboot the system. \ No newline at end of file + The changes take effect when you reboot the system. diff --git a/content/engine/swarm/secrets.md b/content/engine/swarm/secrets.md index e263ac3c2e..3e3df24030 100644 --- a/content/engine/swarm/secrets.md +++ b/content/engine/swarm/secrets.md @@ -3,6 +3,7 @@ title: Manage sensitive data with Docker secrets description: How to securely store, retrieve, and use sensitive data with Docker services keywords: swarm, secrets, credentials, sensitive strings, sensitive data, security, encryption, encryption at rest +tags: [Secrets] --- ## About secrets diff --git a/content/faq/_index.md b/content/faq/_index.md deleted file mode 100644 index 4bc187b6d4..0000000000 --- a/content/faq/_index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Frequently asked questions -description: Landing page to common FAQ topics -keywords: faqs, desktop, Hub, Scout, Engine, Build, Extensions -grid: -- title: Subscription - icon: contact_page - link: /subscription/faq/ -- title: Billing - icon: credit_score - link: /billing/faqs/ -- title: Docker account - icon: lan - link: /faq/admin/general-faqs/ -- title: Enforcing Single Sign-On - icon: key - link: /single-sign-on/enforcement-faqs/ -- title: Single Sign-On and IdPs - icon: checklist - link: /single-sign-on/idp-faqs/ -- title: Docker Desktop - icon: explore - link: /desktop/faqs/general/ ---- - -Explore popular FAQ topics. - -{{< grid >}} \ No newline at end of file diff --git a/content/release-notes.md b/content/release-notes.md deleted file mode 100644 index 8d82b97949..0000000000 --- a/content/release-notes.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -description: Release notes for Docker -keywords: docker, documentation, about, technology, understanding, release, scout, desktop, hub, compose, build, engine -title: Release notes for Docker -grid: -- title: Docker Desktop - icon: web_asset - link: /desktop/release-notes/ -- title: Docker Engine - icon: developer_board - link: /engine/release-notes/ -- title: Docker Compose - icon: storage - link: /compose/release-notes/ -- title: Docker Build - icon: construction - link: /build/release-notes/ -- title: Docker Hub - icon: widgets - link: /docker-hub/release-notes/ -- title: Docker Scout (platform) - icon: query_stats - link: /scout/release-notes/platform/ -- title: Docker Scout (CLI) - icon: query_stats - link: /scout/release-notes/cli/ ---- - -Find out what's new in Docker. Release notes contain information about new -features, improvements, known issues, and bug fixes in each release. You can -find release notes for each component in the Manuals section. We suggest -that you regularly visit the release notes to learn about updates. - -{{< grid >}} diff --git a/content/scout/release-notes/platform.md b/content/scout/release-notes/platform.md index bfe3a60f54..7e8167174a 100644 --- a/content/scout/release-notes/platform.md +++ b/content/scout/release-notes/platform.md @@ -4,6 +4,7 @@ description: Learn about the latest features of Docker Scout keywords: docker scout, release notes, changelog, features, changes, delta, new, releases aliases: - /scout/release-notes/ +tags: [Release notes] --- This page contains information about the new features, improvements, known diff --git a/content/faq/security/eci-faq.md b/content/security/faqs/eci-faq.md similarity index 99% rename from content/faq/security/eci-faq.md rename to content/security/faqs/eci-faq.md index 1f9c0925b5..d08221948f 100644 --- a/content/faq/security/eci-faq.md +++ b/content/security/faqs/eci-faq.md @@ -3,8 +3,10 @@ title: Enhanced Container Isolation (ECI) FAQs description: Frequently asked questions for Enhanced Container Isolation keywords: enhanced container isolation, security, faq, sysbox, Docker Desktop toc_max: 2 +tags: [FAQ] aliases: - /desktop/hardened-desktop/enhanced-container-isolation/faq/ +- /faq/security/eci-faq/ --- ### Do I need to change the way I use Docker when ECI is switched on? diff --git a/content/faq/security/general.md b/content/security/faqs/general.md similarity index 99% rename from content/faq/security/general.md rename to content/security/faqs/general.md index 5f1ca94ced..a552481f54 100644 --- a/content/faq/security/general.md +++ b/content/security/faqs/general.md @@ -2,6 +2,9 @@ description: Find the answers to common security related FAQs keywords: Docker, Docker Hub, Docker Desktop secuirty FAQs, secuirty, platform, Docker Scout, admin, security title: General security FAQs +tags: [FAQ] +aliases: +- /faq/security/general/ --- ### How do I report a vulnerability? diff --git a/content/faq/security/networking-and-vms.md b/content/security/faqs/networking-and-vms.md similarity index 95% rename from content/faq/security/networking-and-vms.md rename to content/security/faqs/networking-and-vms.md index ac3e693fc1..105065169d 100644 --- a/content/faq/security/networking-and-vms.md +++ b/content/security/faqs/networking-and-vms.md @@ -2,6 +2,9 @@ description: Find the answers to FAQs related to networking and virtualization keywords: Docker, Docker Hub, Docker Desktop secuirty FAQs, secuirty, platform, networks, vms title: Network and VM FAQs +tags: [FAQ] +aliases: +- /faq/security/networking-and-vms/ --- ### How can I limit the type of internet access allowed by the container when it runs, to prevent it from being able to exfiltrate data or download malicious code? @@ -30,4 +33,4 @@ On Mac it is an unprivileged operation to start a VM, so that is not enforced by ### How does Docker Desktop achieve network level isolation when Hyper-V and/or WSL2 is used? -The VM processes are the same for both WSL 2 (running inside the `docker-desktop` distro) and Hyper-V (running inside the `DockerDesktopVM`). Host/VM communication uses `AF_VSOCK` hypervisor sockets (shared memory). It does not use Hyper-V network switches or network interfaces. All host networking is performed using normal TCP/IP sockets from the `com.docker.vpnkit.exe` and `com.docker.backend.exe` processes. For more information see [How Docker Desktop networking works under the hood](https://www.docker.com/blog/how-docker-desktop-networking-works-under-the-hood/). \ No newline at end of file +The VM processes are the same for both WSL 2 (running inside the `docker-desktop` distro) and Hyper-V (running inside the `DockerDesktopVM`). Host/VM communication uses `AF_VSOCK` hypervisor sockets (shared memory). It does not use Hyper-V network switches or network interfaces. All host networking is performed using normal TCP/IP sockets from the `com.docker.vpnkit.exe` and `com.docker.backend.exe` processes. For more information see [How Docker Desktop networking works under the hood](https://www.docker.com/blog/how-docker-desktop-networking-works-under-the-hood/). diff --git a/content/faq/security/single-sign-on/domain-faqs.md b/content/security/faqs/single-sign-on/domain-faqs.md similarity index 95% rename from content/faq/security/single-sign-on/domain-faqs.md rename to content/security/faqs/single-sign-on/domain-faqs.md index cefa17b8ee..2d170288f0 100644 --- a/content/faq/security/single-sign-on/domain-faqs.md +++ b/content/security/faqs/single-sign-on/domain-faqs.md @@ -2,8 +2,10 @@ description: Single Sign-on domain FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, domains, domain verification title: Domains +tags: [FAQ] aliases: - /single-sign-on/domain-faqs/ +- /faq/security/single-sign-on/domain-faqs/ --- ### Can I add sub-domains? @@ -28,4 +30,4 @@ Runtime for Docker Desktop if they configure Docker Desktop to require authentic ### Do you support IdP-initiated authentication (e.g., Okta tile support)? -We don't support IdP-initiated authentication. Users must initiate login through Docker Desktop or Hub. \ No newline at end of file +We don't support IdP-initiated authentication. Users must initiate login through Docker Desktop or Hub. diff --git a/content/faq/security/single-sign-on/enforcement-faqs.md b/content/security/faqs/single-sign-on/enforcement-faqs.md similarity index 98% rename from content/faq/security/single-sign-on/enforcement-faqs.md rename to content/security/faqs/single-sign-on/enforcement-faqs.md index f8da057720..1707ae1326 100644 --- a/content/faq/security/single-sign-on/enforcement-faqs.md +++ b/content/security/faqs/single-sign-on/enforcement-faqs.md @@ -2,8 +2,10 @@ description: Single Sign-on enforcement FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, enforce SSO, SSO enforcement title: Enforcement +tags: [FAQ] aliases: - /single-sign-on/enforcement-faqs/ +- /faq/security/single-sign-on/enforcement-faqs/ --- ### We currently have a Docker Team subscription. How do we enable SSO? diff --git a/content/faq/security/single-sign-on/faqs.md b/content/security/faqs/single-sign-on/faqs.md similarity index 95% rename from content/faq/security/single-sign-on/faqs.md rename to content/security/faqs/single-sign-on/faqs.md index cb4187d842..2b98c54692 100644 --- a/content/faq/security/single-sign-on/faqs.md +++ b/content/security/faqs/single-sign-on/faqs.md @@ -2,8 +2,10 @@ description: Single Sign-on FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, administration, security title: General FAQs on SSO +tags: [FAQ] aliases: - /single-sign-on/faqs/ +- /faq/security/single-sign-on/faqs/ --- ### Is Docker SSO available for all paid subscriptions? @@ -32,4 +34,4 @@ Yes, all users in your organization must upgrade to Docker Desktop version 4.4.2 ### Can I retain my Docker ID when using SSO? -For a personal Docker ID, a user is the account owner. A Docker ID is associated with access to the user's repositories, images, assets. An end user can choose to have a company domain email on the Docker account. When enforcing SSO, the account is connected to the organization account. When enforcing SSO for an organization(s) or company, any user logging in without an existing account using verified company domain email will automatically have an account provisioned, and a new Docker ID created. \ No newline at end of file +For a personal Docker ID, a user is the account owner. A Docker ID is associated with access to the user's repositories, images, assets. An end user can choose to have a company domain email on the Docker account. When enforcing SSO, the account is connected to the organization account. When enforcing SSO for an organization(s) or company, any user logging in without an existing account using verified company domain email will automatically have an account provisioned, and a new Docker ID created. diff --git a/content/faq/security/single-sign-on/idp-faqs.md b/content/security/faqs/single-sign-on/idp-faqs.md similarity index 98% rename from content/faq/security/single-sign-on/idp-faqs.md rename to content/security/faqs/single-sign-on/idp-faqs.md index 6e20843215..fb58305d65 100644 --- a/content/faq/security/single-sign-on/idp-faqs.md +++ b/content/security/faqs/single-sign-on/idp-faqs.md @@ -2,8 +2,10 @@ description: Single Sign-on IdP FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, IdP title: Identity providers +tags: [FAQ] aliases: - /single-sign-on/idp-faqs/ +- /faq/security/single-sign-on/idp-faqs/ --- ### Is it possible to use more than one IdP with Docker SSO? diff --git a/content/faq/security/single-sign-on/saml-faqs.md b/content/security/faqs/single-sign-on/saml-faqs.md similarity index 90% rename from content/faq/security/single-sign-on/saml-faqs.md rename to content/security/faqs/single-sign-on/saml-faqs.md index f2cd75d9c4..2cda96e1db 100644 --- a/content/faq/security/single-sign-on/saml-faqs.md +++ b/content/security/faqs/single-sign-on/saml-faqs.md @@ -2,8 +2,10 @@ description: Single Sign-on SAML FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on, SAML title: SAML +tags: [FAQ] aliases: - /single-sign-on/saml-faqs/ +- /faq/security/single-sign-on/saml-faqs/ --- ### Does SAML authentication require additional attributes? @@ -20,4 +22,4 @@ At runtime for Docker Desktop if it’s configured to require authentication to ### Do you have any information on how to use the Docker Desktop application in accordance with the SSO users we provide? How can we verify that we're handling the licensing correctly? -Verify that your users have downloaded the latest version of Docker Desktop. An enhancement in user management observability and capabilities will become available in the future. \ No newline at end of file +Verify that your users have downloaded the latest version of Docker Desktop. An enhancement in user management observability and capabilities will become available in the future. diff --git a/content/faq/security/single-sign-on/users-faqs.md b/content/security/faqs/single-sign-on/users-faqs.md similarity index 99% rename from content/faq/security/single-sign-on/users-faqs.md rename to content/security/faqs/single-sign-on/users-faqs.md index ed8502032f..a8fe3c294b 100644 --- a/content/faq/security/single-sign-on/users-faqs.md +++ b/content/security/faqs/single-sign-on/users-faqs.md @@ -2,8 +2,10 @@ description: Single Sign-on user management FAQs keywords: Docker, Docker Hub, SSO FAQs, single sign-on title: Manage users +tags: [FAQ] aliases: - /single-sign-on/users-faqs/ +- /faq/security/single-sign-on/users-faqs/ --- ### How do I manage users when using SSO? diff --git a/content/security/for-admins/single-sign-on/_index.md b/content/security/for-admins/single-sign-on/_index.md index 8947d42a02..06aa767e3c 100644 --- a/content/security/for-admins/single-sign-on/_index.md +++ b/content/security/for-admins/single-sign-on/_index.md @@ -37,4 +37,4 @@ In addition, you should add all email addresses to your IdP. ## What's next? - Start [configuring SSO](configure/_index.md) in Docker -- Explore the [FAQs](../../../faq/security/single-sign-on/faqs.md) +- Explore the [FAQs](../../../security/faqs/single-sign-on/faqs.md) diff --git a/content/storage/troubleshooting_volume_errors.md b/content/storage/troubleshooting_volume_errors.md index bf0a68aaf4..164d377322 100644 --- a/content/storage/troubleshooting_volume_errors.md +++ b/content/storage/troubleshooting_volume_errors.md @@ -4,6 +4,7 @@ keywords: cadvisor, troubleshooting, volumes, bind-mounts title: Troubleshoot storage errors aliases: - /engine/admin/troubleshooting_volume_errors/ +tags: [ Troubleshooting ] --- This topic discusses errors which may occur when you use Docker volumes or bind @@ -58,4 +59,4 @@ $ sudo lsof /var/lib/docker/containers/74bef250361c7817bee19349c93139621b272bc8f ``` To work around this problem, stop the container which bind-mounts -`/var/lib/docker` and try again to remove the other container. \ No newline at end of file +`/var/lib/docker` and try again to remove the other container. diff --git a/content/subscription/faq.md b/content/subscription/faq.md index 037f45e610..1fe0e525a4 100644 --- a/content/subscription/faq.md +++ b/content/subscription/faq.md @@ -2,6 +2,7 @@ description: FAQs on Docker subscriptions keywords: Docker, Docker Hub, subscription FAQs, subscription, platform title: Subscription FAQs +tags: [FAQ] --- For more information on Docker subscriptions, see [Docker subscription overview](_index.md). diff --git a/content/support.md b/content/support.md index b8caa18f53..97c1b67ecc 100644 --- a/content/support.md +++ b/content/support.md @@ -98,10 +98,4 @@ For more information, see [Docker Data Processing Agreement](https://www.docker. Before seeking support, you can perform basic troubleshooting. See [Diagnose and troubleshooting](../desktop/troubleshoot/overview.md) for more information. -You can also see if an answer already exists in the following FAQs: -- [Docker Business or Team onboarding](faq/admin/general-faqs.md) -- [Docker Desktop](../desktop/faqs/general.md) -- [Docker Desktop for Linux](../desktop/faqs/linuxfaqs.md) -- [Docker Desktop for Mac](../desktop/faqs/macfaqs.md) -- [Docker Desktop for Windows](../desktop/faqs/windowsfaqs.md) -- [Single Sign-on](faq/security/single-sign-on/faqs.md) \ No newline at end of file +You can also see if an answer already exists in the [FAQs](/tags/faq/). diff --git a/content/tags/_index.md b/content/tags/_index.md new file mode 100644 index 0000000000..b502c2f650 --- /dev/null +++ b/content/tags/_index.md @@ -0,0 +1,5 @@ +--- +title: Tags +--- + +Here you can browse Docker docs by tag. diff --git a/content/tags/best-practices/_index.md b/content/tags/best-practices/_index.md new file mode 100644 index 0000000000..76591b1b2c --- /dev/null +++ b/content/tags/best-practices/_index.md @@ -0,0 +1,8 @@ +--- +title: Best practices +icon: star +description: Optimal patterns for Docker +--- + +Best practices articles describe methods and techniques that are generally +the most idiomatic and optimized way to do something. diff --git a/content/tags/faq/_index.md b/content/tags/faq/_index.md new file mode 100644 index 0000000000..7c0d6243a3 --- /dev/null +++ b/content/tags/faq/_index.md @@ -0,0 +1,9 @@ +--- +title: FAQ +icon: quiz +description: Frequently asked questions +--- + +FAQs contain frequently asked questions about all things Docker, from accounts +and administration to organization management, Docker Desktop, Docker Compose, +and more. diff --git a/content/tags/release-notes/_index.md b/content/tags/release-notes/_index.md new file mode 100644 index 0000000000..3cafaa0a4f --- /dev/null +++ b/content/tags/release-notes/_index.md @@ -0,0 +1,10 @@ +--- +title: Release notes +icon: note_stack_add +description: Find out about the latest features +aliases: +- /release-notes/ +--- + +Release notes describe corrections, changes or enhancements made to a product +product in a given release. diff --git a/content/tags/secrets/_index.md b/content/tags/secrets/_index.md new file mode 100644 index 0000000000..383adbf49c --- /dev/null +++ b/content/tags/secrets/_index.md @@ -0,0 +1,11 @@ +--- +title: Secrets +icon: password +description: Use sensitive information in containers securely +--- + +A secret is a piece of data, such as a password, SSH private key, SSL +certificate, or anything that should not be transmitted over a network or +stored unencrypted in a Dockerfile or in your application's source code. + +Docker provides specially designated features for managing secrets. diff --git a/content/tags/troubleshooting/_index.md b/content/tags/troubleshooting/_index.md new file mode 100644 index 0000000000..16889090b8 --- /dev/null +++ b/content/tags/troubleshooting/_index.md @@ -0,0 +1,8 @@ +--- +title: Troubleshooting +icon: troubleshoot +description: Fix common issues +--- + +Troubleshooting articles contain guidelines for solving common problems and +pitfalls that you might encounter with Docker products. diff --git a/data/toc.yaml b/data/toc.yaml index c82d247d0d..ffeedb23be 100644 --- a/data/toc.yaml +++ b/data/toc.yaml @@ -1016,103 +1016,100 @@ Reference: title: Version 2 - path: /glossary/ title: Glossary - - - -Samples: -- path: /samples/ - title: Overview -- sectiontitle: Databases +- sectiontitle: Samples section: - - path: /samples/mariadb/ - title: MariaDB - - path: /samples/mongodb/ - title: MongoDB - - path: /samples/ms-sql/ - title: MS-SQL - - path: /samples/mysql/ - title: MySQL - - path: /samples/postgres/ - title: PostgreSQL - - path: /samples/redis/ - title: Redis -- sectiontitle: Frameworks - section: - - path: /samples/dotnet/ - title: .NET - - path: /samples/angular/ - title: Angular - - path: /samples/django/ - title: Django - - path: /samples/express/ - title: Express - - path: /samples/fastapi/ - title: FastAPI - - path: /samples/flask/ - title: Flask - - path: /samples/nodejs/ - title: Node.js - - path: /samples/react/ - title: React - - path: /samples/rails/ - title: Rails - - path: /samples/spark/ - title: Spark - - path: /samples/spring/ - title: Spring Boot - - path: /samples/vuejs/ - title: Vue.js -- sectiontitle: Languages - section: - - path: /samples/go/ - title: Go - - path: /samples/java/ - title: Java - - path: /samples/javascript/ - title: JavaScript - - path: /samples/php/ - title: PHP - - path: /samples/python/ - title: Python - - path: /samples/ruby/ - title: Ruby - - path: /samples/rust/ - title: Rust - - path: /samples/typescript/ - title: TypeScript -- sectiontitle: Platforms - section: - - path: /samples/gitea/ - title: Gitea - - path: /samples/nextcloud/ - title: Nextcloud - - path: /samples/portainer/ - title: Portainer - - path: /samples/prometheus/ - title: Prometheus - - path: /samples/wordpress/ - title: WordPress -- sectiontitle: Other samples - section: - - path: /samples/ai-ml/ - title: AI/ML - - path: /samples/cloudflared/ - title: Cloudflared - - path: /samples/elasticsearch/ - title: Elasticsearch / Logstash / Kibana - - path: /samples/minecraft/ - title: Minecraft - - path: /samples/nginx/ - title: NGINX - - path: /samples/pi-hole/ - title: Pi-hole - - path: /samples/plex/ - title: Plex - - path: /samples/traefik/ - title: Traefik - - path: /samples/wireguard/ - title: Wireguard - + - path: /samples/ + title: Overview + - sectiontitle: Databases + section: + - path: /samples/mariadb/ + title: MariaDB + - path: /samples/mongodb/ + title: MongoDB + - path: /samples/ms-sql/ + title: MS-SQL + - path: /samples/mysql/ + title: MySQL + - path: /samples/postgres/ + title: PostgreSQL + - path: /samples/redis/ + title: Redis + - sectiontitle: Frameworks + section: + - path: /samples/dotnet/ + title: .NET + - path: /samples/angular/ + title: Angular + - path: /samples/django/ + title: Django + - path: /samples/express/ + title: Express + - path: /samples/fastapi/ + title: FastAPI + - path: /samples/flask/ + title: Flask + - path: /samples/nodejs/ + title: Node.js + - path: /samples/react/ + title: React + - path: /samples/rails/ + title: Rails + - path: /samples/spark/ + title: Spark + - path: /samples/spring/ + title: Spring Boot + - path: /samples/vuejs/ + title: Vue.js + - sectiontitle: Languages + section: + - path: /samples/go/ + title: Go + - path: /samples/java/ + title: Java + - path: /samples/javascript/ + title: JavaScript + - path: /samples/php/ + title: PHP + - path: /samples/python/ + title: Python + - path: /samples/ruby/ + title: Ruby + - path: /samples/rust/ + title: Rust + - path: /samples/typescript/ + title: TypeScript + - sectiontitle: Platforms + section: + - path: /samples/gitea/ + title: Gitea + - path: /samples/nextcloud/ + title: Nextcloud + - path: /samples/portainer/ + title: Portainer + - path: /samples/prometheus/ + title: Prometheus + - path: /samples/wordpress/ + title: WordPress + - sectiontitle: Other samples + section: + - path: /samples/ai-ml/ + title: AI/ML + - path: /samples/cloudflared/ + title: Cloudflared + - path: /samples/elasticsearch/ + title: Elasticsearch / Logstash / Kibana + - path: /samples/minecraft/ + title: Minecraft + - path: /samples/nginx/ + title: NGINX + - path: /samples/pi-hole/ + title: Pi-hole + - path: /samples/plex/ + title: Plex + - path: /samples/traefik/ + title: Traefik + - path: /samples/wireguard/ + title: Wireguard Manuals: - path: /manuals/ @@ -1247,6 +1244,18 @@ Manuals: title: Uninstall Docker Desktop - path: /desktop/feedback/ title: Give feedback + - sectiontitle: Desktop FAQs + section: + - path: /desktop/faqs/general/ + title: General + - path: /desktop/faqs/macfaqs/ + title: Mac + - path: /desktop/faqs/windowsfaqs/ + title: Windows + - path: /desktop/faqs/linuxfaqs/ + title: Linux + - path: /desktop/faqs/releases/ + title: Releases - path: /desktop/release-notes/ title: Release notes - sectiontitle: Previous versions @@ -2050,6 +2059,8 @@ Manuals: title: Give feedback - path: /compose/migrate/ title: Migrate to Compose V2 + - path: /compose/faq/ + title: Compose FAQ - path: /compose/release-notes/ title: Release notes @@ -2136,6 +2147,14 @@ Manuals: title: Manage users - path: /admin/company/owners/ title: Manage company owners + - sectiontitle: Account and admin FAQ + section: + - path: /admin/faqs/general-faqs/ + title: General + - path: /admin/faqs/organization-faqs/ + title: Organization + - path: /admin/faqs/company-faqs/ + title: Company - path: /admin/convert-account/ title: Convert an account into an organization - path: /admin/deactivate-account/ @@ -2189,6 +2208,28 @@ Manuals: title: Generate a new recovery code - path: /security/security-announcements/ title: Security announcements + - sectiontitle: Security FAQs + section: + - path: /security/faqs/general/ + title: General + - path: /security/faqs/networking-and-vms/ + title: Networking and VMs + - path: /security/faqs/eci-faq/ + title: Enhanced Container Isolation + - sectiontitle: Single Sign-On + section: + - path: /security/faqs/single-sign-on/faqs/ + title: General + - path: /security/faqs/single-sign-on/saml-faqs/ + title: SAML + - path: /security/faqs/single-sign-on/idp-faqs/ + title: Identity providers + - path: /security/faqs/single-sign-on/domain-faqs/ + title: Domains + - path: /security/faqs/single-sign-on/enforcement-faqs/ + title: Enforcement + - path: /security/faqs/single-sign-on/users-faqs/ + title: Manage users - sectiontitle: Billing section: @@ -2208,6 +2249,8 @@ Manuals: title: Docker Build Cloud billing - path: /billing/scout-billing/ title: Docker Scout billing + - path: /billing/faqs/ + title: Billing FAQs - sectiontitle: Subscription section: @@ -2235,6 +2278,8 @@ Manuals: title: Docker Scout subscriptions and features - path: /subscription/desktop-license/ title: Docker Desktop license agreement + - path: /subscription/faq/ + title: Subscription FAQ - sectiontitle: Trusted content section: @@ -2255,61 +2300,7 @@ Manuals: - path: /trusted-content/insights-analytics/ title: Insights and analytics -- path: /release-notes/ - title: Release notes - path: /support/ title: Get support - path: /release-lifecycle/ title: Product release lifecycle - -FAQ: - - path: /faq/ - title: Overview - - path: /billing/faqs/ - title: Billing - - path: /compose/faq/ - title: Compose - - sectiontitle: Desktop - section: - - path: /desktop/faqs/general/ - title: General - - path: /desktop/faqs/macfaqs/ - title: Mac - - path: /desktop/faqs/windowsfaqs/ - title: Windows - - path: /desktop/faqs/linuxfaqs/ - title: Linux - - path: /desktop/faqs/releases/ - title: Releases - - sectiontitle: Docker account and admin - section: - - path: /faq/admin/general-faqs/ - title: General - - path: /faq/admin/organization-faqs/ - title: Organization - - path: /faq/admin/company-faqs/ - title: Company - - path: /subscription/faq/ - title: Subscription - - sectiontitle: Security - section: - - path: /faq/security/general/ - title: General - - path: /faq/security/networking-and-vms/ - title: Networking and VMs - - path: /faq/security/eci-faq/ - title: Enhanced Container Isolation - - sectiontitle: Single Sign-On - section: - - path: /faq/security/single-sign-on/faqs/ - title: General - - path: /faq/security/single-sign-on/saml-faqs/ - title: SAML - - path: /faq/security/single-sign-on/idp-faqs/ - title: Identity providers - - path: /faq/security/single-sign-on/domain-faqs/ - title: Domains - - path: /faq/security/single-sign-on/enforcement-faqs/ - title: Enforcement - - path: /faq/security/single-sign-on/users-faqs/ - title: Manage users diff --git a/hugo.yaml b/hugo.yaml index e37c7e5036..005001292e 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -4,9 +4,9 @@ refLinksErrorLevel: ERROR enableGitInfo: true disablePathToLower: true enableInlineShortcodes: true -disableKinds: - - taxonomy - - term + +taxonomies: + tag: tags markup: tableOfContents: @@ -126,12 +126,6 @@ menus: - name: Reference url: /reference/ weight: 3 - - name: Samples - url: /samples/ - weight: 4 - - name: FAQ - url: /faq/ - weight: 5 footer: - url: https://www.docker.com/products @@ -236,7 +230,7 @@ module: proxy: https://proxy.golang.org,direct hugoVersion: extended: false - min: "0.116.1" + min: "0.124.1" mounts: - source: assets target: assets diff --git a/hugo_stats.json b/hugo_stats.json index 5738f8fb0c..d0b091363c 100644 --- a/hugo_stats.json +++ b/hugo_stats.json @@ -150,6 +150,7 @@ "build-push-action", "chroma", "cls-1", + "cursor-not-allowed", "cursor-pointer", "dark:bg-accent-dark", "dark:bg-amber-dark", @@ -159,6 +160,7 @@ "dark:bg-blue-dark-400", "dark:bg-gray-dark-100", "dark:bg-gray-dark-200", + "dark:bg-gray-dark-300", "dark:bg-gray-dark-300/50", "dark:bg-gray-dark-400", "dark:bg-green-dark", @@ -178,6 +180,7 @@ "dark:hover:bg-blue-dark", "dark:hover:bg-blue-dark-500", "dark:hover:bg-gray-dark-500", + "dark:hover:text-white", "dark:prose-invert", "dark:syntax-dark", "dark:text-blue-dark", @@ -186,6 +189,7 @@ "dark:text-gray-dark-500", "dark:text-gray-dark-600", "dark:text-gray-dark-700", + "dark:text-gray-dark-800", "dark:text-violet-dark", "dark:text-white", "dark:to-blue-dark-100", @@ -206,6 +210,7 @@ "flex-col-reverse", "flex-initial", "flex-row-reverse", + "flex-wrap", "font-medium", "footnote-backref", "footnote-ref", @@ -246,8 +251,10 @@ "hover:drop-shadow-lg", "hover:opacity-75", "hover:opacity-90", + "hover:text-black", "hover:underline", "hub-api", + "icon-lg", "icon-sm", "icon-svg", "important", @@ -264,10 +271,14 @@ "justify-self-end", "leading-snug", "left-0", + "lg:block", "lg:grid-cols-2", "lg:grow-0", "lg:hidden", + "lg:link", + "lg:pb-0", "lg:px-4", + "lg:text-base", "lg:w-full", "link", "lntable", @@ -300,8 +311,10 @@ "ml-auto", "mt-1", "mt-20", + "mt-auto", "mx-auto", "my-0", + "my-2", "my-4", "no-underline", "no-wrap", @@ -319,6 +332,7 @@ "p-6", "p-8", "p-[2px]", + "pb-0.5", "pb-2", "pb-4", "pl-1", @@ -331,6 +345,7 @@ "pt-0", "px-1", "px-2", + "px-3", "px-4", "py-1", "py-2", @@ -393,6 +408,7 @@ "to-blue-light-500", "to-magenta-light-400", "to-transparent", + "toc", "top-0", "top-16", "top-3", diff --git a/layouts/_default/list.html b/layouts/_default/list.html index 857d46c2f5..4b2a1fba2b 100644 --- a/layouts/_default/list.html +++ b/layouts/_default/list.html @@ -8,6 +8,9 @@ {{ with .Title }}

{{ . }}

{{ end }} + {{ .Content }} {{ end }} diff --git a/layouts/_default/single.html b/layouts/_default/single.html index 857d46c2f5..615ddf4cfb 100644 --- a/layouts/_default/single.html +++ b/layouts/_default/single.html @@ -8,6 +8,10 @@ {{ with .Title }}

{{ . }}

{{ end }} + {{ .Content }} {{ end }} diff --git a/layouts/index.html b/layouts/index.html index b7b7b36ba9..5f4b1ce0ad 100644 --- a/layouts/index.html +++ b/layouts/index.html @@ -190,6 +190,16 @@ {{ end }} +
+

Browse by tag

+
+ {{ $tags := slice }} + {{- range site.Taxonomies.tags }} + {{ $tags = $tags | append .Page }} + {{ end }} + {{ partial "tags.html" $tags }} +
+
{{ partial "github-links.html" . }} - {{ partial "toc-default.html" . }} +
+ {{ partial "pagemeta.html" . }} +
diff --git a/layouts/partials/category-links.html b/layouts/partials/category-links.html new file mode 100644 index 0000000000..e69de29bb2 diff --git a/layouts/partials/pagemeta.html b/layouts/partials/pagemeta.html new file mode 100644 index 0000000000..36f29bd0ee --- /dev/null +++ b/layouts/partials/pagemeta.html @@ -0,0 +1,41 @@ +{{- $toc := false }} +{{- with .Fragments }} + {{- $toc = and (ne page.Params.notoc true) .Headings }} +{{- end }} +{{- $tags := .GetTerms "tags" }} +{{- if or $toc $tags }} +
+ {{- with $tags }} +
+ Tags +
+ {{- partial "tags.html" . -}} +
+
+ {{- end }} + {{- with $toc }} +
Table of contents
+ + {{- end }} +
+{{- end }} + +{{- define "walkHeadingFragments" }} + {{- $min := 2 }} + {{- $max := 3 }} +
    + {{- range . }} + {{- if and (ge .Level $min) (le .Level $max) }} +
  • + {{ .Title }} +
    • + {{- end }} + {{- with .Headings }} + {{ template "walkHeadingFragments" . }} + {{- end }} + {{- end }} +
+{{- end }} diff --git a/layouts/partials/pagination.html b/layouts/partials/pagination.html new file mode 100644 index 0000000000..a3f203e264 --- /dev/null +++ b/layouts/partials/pagination.html @@ -0,0 +1,70 @@ +{{- if gt .Paginator.TotalPages 1 }} + {{ $selectable := "cursor-pointer" }} + {{ $active := "hover:text-black dark:hover:text-white underline underline-offset-8" }} + {{ $disabled := "cursor-not-allowed text-gray-light dark:text-gray-dark" }} + +{{- end }} + diff --git a/layouts/partials/tags.html b/layouts/partials/tags.html new file mode 100644 index 0000000000..9846805e05 --- /dev/null +++ b/layouts/partials/tags.html @@ -0,0 +1,13 @@ +{{- /* + List of tag "chips" as links + Context: page.Pages + */ -}} +{{- range . -}} +{{- if eq .File nil }} + {{- errorf "[tags] Undefined tag: '%s' in %s" (urlize (strings.ToLower .Title)) page.File.Filename }} +{{- end }} + +
{{ partialCached "icon" .Params.icon .Params.icon }}
+
{{ .LinkTitle }}
+ +{{- end -}} diff --git a/layouts/partials/toc-default.html b/layouts/partials/toc-default.html deleted file mode 100644 index 4c06b1245b..0000000000 --- a/layouts/partials/toc-default.html +++ /dev/null @@ -1,8 +0,0 @@ -{{ if ne .Params.notoc true }} - {{ if gt (len .TableOfContents) 32 }} -
-
{{ T "tableOfContents" }}
- {{ .TableOfContents }} -
- {{ end }} -{{ end }} diff --git a/layouts/partials/top-nav.html b/layouts/partials/top-nav.html index 4098638e2b..adcfb2c324 100644 --- a/layouts/partials/top-nav.html +++ b/layouts/partials/top-nav.html @@ -4,7 +4,7 @@