Merge pull request #469 from zong-zhe/add-qa-docker

feat: add qa about error docker-credential-desktop not found
kcl-lang · Sep 13, 2024 · 9bdb91f · 9bdb91f
2 parents 64702d6 + 069f185
commit 9bdb91f
Show file tree

Hide file tree

Showing 8 changed files with 48 additions and 0 deletions.
diff --git a/docs/user_docs/support/faq-install.md b/docs/user_docs/support/faq-install.md
@@ -48,3 +48,9 @@ The issue is due to KCL requiring write permissions for its default global confi
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## Error on MacOS: docker-credential-desktop: executable file not found in $PATH
+
+The KCL package management tool interacts with the OCI Registry using third-party libraries provided by `Docker`, which will leave the configuration file `~/.docker/config.json`. This error typically occurs when switching from Docker Desktop to Podman without Docker installed locally. This file is used for authentication calls to BuildKit. To resolve this issue, try deleting or renaming the `~/.docker/config.json` file.
+
+For more detailed information about this error, visit: <https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/support/faq-install.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/support/faq-install.md
@@ -48,3 +48,9 @@ xattr -d com.apple.quarantine /path/to/kcl
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## 在 MacOS 出现错误 docker-credential-desktop: executable file not found in $PATH
+
+KCL 的包管理工具底层借助 docker 提供的三方库完成与 OCI Registry 的交互，会产生配置文件 ~/.docker/config.json，这个错误通常发生在从 Docker Desktop 切换到 Podman，而本地没有安装 Docker 的情况下。该文件会被用于在对 BuildKit 进行身份验证的调用中读取。要解决此问题，请尝试删除或重命名 ~/.docker/config.json 文件。
+
+更多关于该错误的详细信息：<https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/...CN/docusaurus-plugin-content-docs/version-0.10/user_docs/support/faq-install.md b/...CN/docusaurus-plugin-content-docs/version-0.10/user_docs/support/faq-install.md
@@ -48,3 +48,9 @@ xattr -d com.apple.quarantine /path/to/kcl
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## 在 MacOS 出现错误 docker-credential-desktop: executable file not found in $PATH
+
+KCL 的包管理工具底层借助 docker 提供的三方库完成与 OCI Registry 的交互，会产生配置文件 ~/.docker/config.json，这个错误通常发生在从 Docker Desktop 切换到 Podman，而本地没有安装 Docker 的情况下。该文件会被用于在对 BuildKit 进行身份验证的调用中读取。要解决此问题，请尝试删除或重命名 ~/.docker/config.json 文件。
+
+更多关于该错误的详细信息：<https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/...-CN/docusaurus-plugin-content-docs/version-0.8/user_docs/support/faq-install.md b/...-CN/docusaurus-plugin-content-docs/version-0.8/user_docs/support/faq-install.md
@@ -40,3 +40,9 @@ xattr -d com.apple.quarantine /path/to/kcl
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## 在 MacOS 出现错误 docker-credential-desktop: executable file not found in $PATH
+
+KCL 的包管理工具底层借助 docker 提供的三方库完成与 OCI Registry 的交互，会产生配置文件 ~/.docker/config.json，这个错误通常发生在从 Docker Desktop 切换到 Podman，而本地没有安装 Docker 的情况下。该文件会被用于在对 BuildKit 进行身份验证的调用中读取。要解决此问题，请尝试删除或重命名 ~/.docker/config.json 文件。
+
+更多关于该错误的详细信息：<https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/...-CN/docusaurus-plugin-content-docs/version-0.9/user_docs/support/faq-install.md b/...-CN/docusaurus-plugin-content-docs/version-0.9/user_docs/support/faq-install.md
@@ -48,3 +48,9 @@ xattr -d com.apple.quarantine /path/to/kcl
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## 在 MacOS 出现错误 docker-credential-desktop: executable file not found in $PATH
+
+KCL 的包管理工具底层借助 docker 提供的三方库完成与 OCI Registry 的交互，会产生配置文件 ~/.docker/config.json，这个错误通常发生在从 Docker Desktop 切换到 Podman，而本地没有安装 Docker 的情况下。该文件会被用于在对 BuildKit 进行身份验证的调用中读取。要解决此问题，请尝试删除或重命名 ~/.docker/config.json 文件。
+
+更多关于该错误的详细信息：<https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/versioned_docs/version-0.10/user_docs/support/faq-install.md b/versioned_docs/version-0.10/user_docs/support/faq-install.md
@@ -48,3 +48,9 @@ The issue is due to KCL requiring write permissions for its default global confi
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## Error on MacOS: docker-credential-desktop: executable file not found in $PATH
+
+The KCL package management tool interacts with the OCI Registry using third-party libraries provided by `Docker`, which will leave the configuration file `~/.docker/config.json`. This error typically occurs when switching from Docker Desktop to Podman without Docker installed locally. This file is used for authentication calls to BuildKit. To resolve this issue, try deleting or renaming the `~/.docker/config.json` file.
+
+For more detailed information about this error, visit: <https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/versioned_docs/version-0.8/user_docs/support/faq-install.md b/versioned_docs/version-0.8/user_docs/support/faq-install.md
@@ -40,3 +40,9 @@ The issue is due to KCL requiring write permissions for its default global confi
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## Error on MacOS: docker-credential-desktop: executable file not found in $PATH
+
+The KCL package management tool interacts with the OCI Registry using third-party libraries provided by `Docker`, which will leave the configuration file `~/.docker/config.json`. This error typically occurs when switching from Docker Desktop to Podman without Docker installed locally. This file is used for authentication calls to BuildKit. To resolve this issue, try deleting or renaming the `~/.docker/config.json` file.
+
+For more detailed information about this error, visit: <https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>
diff --git a/versioned_docs/version-0.9/user_docs/support/faq-install.md b/versioned_docs/version-0.9/user_docs/support/faq-install.md
@@ -48,3 +48,9 @@ The issue is due to KCL requiring write permissions for its default global confi
 ENV KCL_PKG_PATH=/tmp
 ENV KCL_CACHE_PATH=/tmp
 ```
+
+## Error on MacOS: docker-credential-desktop: executable file not found in $PATH
+
+The KCL package management tool interacts with the OCI Registry using third-party libraries provided by `Docker`, which will leave the configuration file `~/.docker/config.json`. This error typically occurs when switching from Docker Desktop to Podman without Docker installed locally. This file is used for authentication calls to BuildKit. To resolve this issue, try deleting or renaming the `~/.docker/config.json` file.
+
+For more detailed information about this error, visit: <https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath>