diff --git a/Dockerfile b/Dockerfile index 70e7c47e678d..e200af948a8d 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 151bf77b128a..91ff92d7cd99 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 1d37aab2ec27..f3e4aa9ad98f 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 9d4800cac2eb..756d4c7df8f3 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 b94ae7f300d2..8fd8896efb39 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 ddeb950400bf..5345dc70cef4 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 fb11f527f9b2..a0c81efbeaa8 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 3813352ab466..31a138f40915 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 e3cd60c04920..4a50830903ae 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 5832652b4eae..a89a2e6b091b 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 fae34715c7c9..a9ec1157db67 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 aca402c1eafc..575240e1b1c5 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 ac410fc8dd08..c9a96f04faec 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 452cf5115d20..8afef908f778 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 4cede5d1f722..e8b9f04269b9 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 5a1621830734..5af465fa1437 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 36b9eea71576..00ccd16e4f7f 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 105aedcf9d24..3669f9e8b916 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 34178e351ebf..c0f991606f58 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 53ddf8f624a6..1e072ff1e64d 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 59b10c0633ff..4de8039a4fff 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 5b9321b2ea48..fd579608e5d4 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 445611efd14e..fce2a5a39174 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 ab0c5064331b..bf87494587c2 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 766fba66788a..71149e736011 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 6bc898a1c932..240f5e26ff57 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 f46d0461f259..b477993d26a8 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 94b7fb80f424..ba9b3360e79e 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 631a8bfdc190..7df02610041b 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 e069538e4a6e..9c03a798f940 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 5c61f7693b88..fa4111875b8b 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 a53dd24b0190..9cd6c21648cc 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 6982af444da0..7efee580362e 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 62f59ac2e47f..b98f230efadd 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 50feb4ad06ab..7af6aa899f32 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 b4d8689fc275..37e36279f50d 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 99cb4ae0e22c..2095b76010d5 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 08cf2f7acda5..f9be76c15758 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 aadda5d3e4ce..2f712ffab872 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 d6474d408da7..698b865a4dc7 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 93a8f441f8ca..6f8739b8d48b 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 000aecaa4eff..d8b3dbb86d94 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 40fe2c6d9595..31d331b4a81f 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 4c46d3c446e1..7bd20dcadd1f 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 999c2d77a909..857ada15acba 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 e263ac3c2e81..3e3df24030ce 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 4bc187b6d4c5..000000000000 --- 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 8d82b97949b5..000000000000 --- 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 bfe3a60f549e..7e8167174a15 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 1f9c0925b5e1..d08221948fb2 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 5f1ca94ced32..a552481f54cf 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 ac3e693fc1cd..105065169dfb 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 cefa17b8ee10..2d170288f055 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 f8da0577205d..1707ae132647 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 cb4187d842c9..2b98c546921b 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 6e20843215ef..fb58305d656c 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 f2cd75d9c4f4..2cda96e1db08 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 ed8502032f4b..a8fe3c294bab 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 8947d42a02d8..06aa767e3c54 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 bf0a68aaf49f..164d3773222e 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 037f45e61047..1fe0e525a47a 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 b8caa18f53b7..97c1b67ecca8 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 000000000000..b502c2f6503a --- /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 000000000000..76591b1b2c81 --- /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 000000000000..7c0d6243a31f --- /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 000000000000..3cafaa0a4f84 --- /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 000000000000..383adbf49c57 --- /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 000000000000..16889090b829 --- /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 c82d247d0d9f..ffeedb23be51 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 - 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 +- sectiontitle: Samples 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 e37c7e50362e..005001292e04 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 5738f8fb0c3f..d0b091363c74 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 857d46c2f521..4b2a1fba2b76 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 857d46c2f521..615ddf4cfb06 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 b7b7b36ba99d..5f4b1ce0adbe 100644 --- a/layouts/index.html +++ b/layouts/index.html @@ -190,6 +190,16 @@

Browse by section

{{ 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 000000000000..e69de29bb2d1 diff --git a/layouts/partials/pagemeta.html b/layouts/partials/pagemeta.html new file mode 100644 index 000000000000..36f29bd0ee4e --- /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 000000000000..a3f203e264ae --- /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 000000000000..9846805e0592 --- /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 4c06b1245bd7..000000000000 --- 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 4098638e2b41..adcfb2c324a2 100644 --- a/layouts/partials/top-nav.html +++ b/layouts/partials/top-nav.html @@ -4,7 +4,7 @@