From 2d354df7d7c0c02e17ce3e855a57afdbaa40680b Mon Sep 17 00:00:00 2001
From: Zexi Li <zexi.li@icloud.com>
Date: Fri, 1 Nov 2024 21:14:07 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E6=B7=BB=E5=8A=A0=E9=BB=98=E8=AE=A4=20d?=
 =?UTF-8?q?ns=5Fdomain=20=E5=AF=BC=E8=87=B4=E8=A7=A3=E6=9E=90=E5=A4=B1?=
 =?UTF-8?q?=E8=B4=A5=E7=9A=84=E8=A7=A3=E5=86=B3=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/operations/platform-issues/dns.md    | 51 +++++++++++++++++++++++
 docs/operations/platform-issues/index.mdx |  9 ++++
 2 files changed, 60 insertions(+)
 create mode 100644 docs/operations/platform-issues/dns.md
 create mode 100644 docs/operations/platform-issues/index.mdx

diff --git a/docs/operations/platform-issues/dns.md b/docs/operations/platform-issues/dns.md
new file mode 100644
index 0000000..e92b4c7
--- /dev/null
+++ b/docs/operations/platform-issues/dns.md
@@ -0,0 +1,51 @@
+---
+sidebar_position: 1
+---
+
+# dns_domain 导致虚拟机域名解析失败
+
+因为历史原因遗留问题，在 v3.11.8 版本之前部署的版本会默认设置虚拟机的 `/etc/resolve.conf` 里面的配置为 `search cloud.onecloud.io`。
+
+这样的设置有可能导致虚拟机内部域名解析失败，如果出现此问题，可以通过下面的步骤取消全局 dns_domain 的配置，这样新建的虚拟机 DNS 配置就不会默认添加 `search` 配置。
+
+
+## 取消默认配置
+
+### 1. 取消 configmap 里面的 dns_domain 配置
+
+```bash
+kubectl edit configmap -n onecloud default-region
+
+# 找到 dns_domain: cloud.yunion.io 这行的配置
+...
+    dns_domain: cloud.yunion.io
+...
+# 删掉这行，直接保存退出
+```
+
+### 2. 取消当前 region 服务的配置
+
+```bash
+climc service-config-edit region2
+
+default:
+  ...
+  # 也是删除 dns_domain: cloud.yunion.io 这项
+  dns_domain: office.yunion.io
+  ...
+```
+
+
+### 3. 重启 region 服务
+
+```bash
+kubectl -n onecloud rollout restart deployment default-region
+```
+
+然后等待 default-region pod 变成 Running，新建虚拟机查看 `/etc/resolv.conf` 文件，如果里面没有设置 search 则配置生效。
+
+
+## 对于已有虚拟机的影响
+
+- 如果虚拟机是通过 dhcp 从平台分配的 ip ，则再次重新 dhcp 请求，就会修改 DNS 配置
+- 如果虚拟机是静态配置的网络(比如纳管 vmware 虚拟机或者裸金属)，则需要手工修改
diff --git a/docs/operations/platform-issues/index.mdx b/docs/operations/platform-issues/index.mdx
new file mode 100644
index 0000000..a12c22b
--- /dev/null
+++ b/docs/operations/platform-issues/index.mdx
@@ -0,0 +1,9 @@
+---
+sidebar_position: 11.1
+---
+
+# 平台常见问题
+
+import IndexDocCardList from '@site/src/components/IndexDocCardList';
+
+<IndexDocCardList />