diff --git a/content/zh/common/cni-list.md b/content/zh/common/cni-list.md deleted file mode 100644 index 9123228b3..000000000 --- a/content/zh/common/cni-list.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -_build: - render: false ---- \ No newline at end of file diff --git a/content/zh/common/container-runtime-requirements.md b/content/zh/common/container-runtime-requirements.md new file mode 100644 index 000000000..ff069e2c3 --- /dev/null +++ b/content/zh/common/container-runtime-requirements.md @@ -0,0 +1,11 @@ +--- +_build: + render: false +--- + +| 支持的容器运行时 | 版本 | +| ---------------------------------- | ------- | +| Docker | 19.3.8+ | +| containerd（试验版，未经充分测试） | 最新版 | +| CRI-O（试验版，未经充分测试） | 最新版 | +| iSula（试验版，未经充分测试） | 最新版 | diff --git a/content/zh/common/csi-plugins.md b/content/zh/common/csi-plugins.md new file mode 100644 index 000000000..79f773e90 --- /dev/null +++ b/content/zh/common/csi-plugins.md @@ -0,0 +1,13 @@ +--- +_build: + render: false +--- + +Kuberentes 此前已宣布将在 1.21 版本中移除树内 (in-tree) 存储插件。有关更多信息，请参见 [Kubernetes In-Tree to CSI Volume Migration Moves to Beta](https://kubernetes.io/blog/2019/12/09/kubernetes-1-17-feature-csi-migration-beta/)。因此，建议您安装 CSI 插件。 + +支持的 CSI 插件： + +- [neonsan-csi](https://github.com/yunify/qingstor-csi) +- {{< contentLink "docs/installing-on-linux/persistent-storage-configurations/install-qingcloud-csi/" "qingcloud-csi" >}} +- {{< contentLink "docs/installing-on-linux/persistent-storage-configurations/install-ceph-csi-rbd/" "ceph-csi" >}} +- {{< contentLink "docs/installing-on-linux/persistent-storage-configurations/install-nfs-client/" "nfs-client-provisioner" >}} \ No newline at end of file diff --git a/content/zh/common/dependency-requirements.md b/content/zh/common/dependency-requirements.md new file mode 100644 index 000000000..3d783ca98 --- /dev/null +++ b/content/zh/common/dependency-requirements.md @@ -0,0 +1,11 @@ +--- +_build: + render: false +--- + +| 依赖项 | Kubernetes 版本 ≥ 1.18 | Kubernetes 版本 < 1.18 | +| ----------- | ---------------------- | ---------------------- | +| `socat` | 必须 | 可选，但建议安装 | +| `conntrack` | 必须 | 可选，但建议安装 | +| `ebtables` | 可选，但建议安装 | 可选，但建议安装 | +| `ipset` | 可选，但建议安装 | 可选，但建议安装 | diff --git a/content/zh/common/kubernetes-versions.md b/content/zh/common/kubernetes-versions.md new file mode 100644 index 000000000..ec4709d2a --- /dev/null +++ b/content/zh/common/kubernetes-versions.md @@ -0,0 +1,9 @@ +--- +_build: + render: false +--- + +| 安装工具 | KubeSphere 版本 | 支持的 Kubernetes 版本 | +| ------------ | --------------- | ------------------------------------------------------------ | +| KubeKey | v3.1.0 | v1.17.0, v1.17.4, v1.17.5, v1.17.6, v1.17.7, v1.17.8, v1.17.9, v1.18.3, v1.18.5, v1.18.6, v1.18.8, v1.19.0, v1.19.8, v1.19.9, v1.20.4 | +| ks-installer | v3.1.0 | v1.17.x, v1.18.x, v1.19.x, v1.20.x | diff --git a/content/zh/common/network-requirements.md b/content/zh/common/network-requirements.md new file mode 100644 index 000000000..3a6158115 --- /dev/null +++ b/content/zh/common/network-requirements.md @@ -0,0 +1,8 @@ +--- +_build: + render: false +--- + +- 请确保 `/etc/resolv.conf` 中的 DNS 地址可用，否则，可能会导致集群中的 DNS 出现问题。 +- 如果您的网络配置使用防火墙规则或安全组，请务必确保基础设施组件可以通过特定端口相互通信。建议您关闭防火墙。有关更多信息，请参见{{< contentLink "docs/installing-on-linux/introduction/port-firewall/" "端口要求" >}}。 +- 支持的 CNI 插件：Calico 和 Flannel。其他插件也适用（例如 Cilium 和 Kube-OVN 等），但请注意它们未经充分测试。 \ No newline at end of file diff --git a/content/zh/common/system-requirements.md b/content/zh/common/system-requirements.md new file mode 100644 index 000000000..4f6504b8d --- /dev/null +++ b/content/zh/common/system-requirements.md @@ -0,0 +1,12 @@ +--- +_build: + render: false +--- + +| 系统 | 最低要求（每个节点） | +| ------------------------------------------------------------ | -------------------------------- | +| **Ubuntu** *16.04，18.04* | CPU：2 核，内存：4 G，硬盘：40 G | +| **Debian** *Buster，Stretch* | CPU：2 核，内存：4 G，硬盘：40 G | +| **CentOS** *7*.x | CPU：2 核，内存：4 G，硬盘：40 G | +| **Red Hat Enterprise Linux** *7* | CPU：2 核，内存：4 G，硬盘：40 G | +| **SUSE Linux Enterprise Server** *15* **/openSUSE Leap** *15.2* | CPU：2 核，内存：4 G，硬盘：40 G | diff --git a/content/zh/docs/installing-on-linux/introduction/air-gapped-installation.md b/content/zh/docs/installing-on-linux/introduction/air-gapped-installation.md index c914467ec..42f4d82e0 100644 --- a/content/zh/docs/installing-on-linux/introduction/air-gapped-installation.md +++ b/content/zh/docs/installing-on-linux/introduction/air-gapped-installation.md @@ -37,7 +37,6 @@ weight: 3130 - 所有节点必须都能通过 `SSH` 访问。 - 所有节点时间同步。 - 所有节点都应使用 `sudo`/`curl`/`openssl`。 -- 请您务必在离线环境中安装 `docker`。 KubeKey 能够同时安装 Kubernetes 和 KubeSphere。根据要安装的 Kubernetes 版本，需要安装的依赖项可能会不同。您可以参考下方列表，查看是否需要提前在您的节点上安装相关依赖项。 @@ -56,10 +55,15 @@ KubeKey 能够同时安装 Kubernetes 和 KubeSphere。根据要安装的 Kubern {{}} +### 容器运行时 + +您的集群必须有一个可用的容器运行时。在离线环境中创建集群之前，您必须手动安装 Docker 或其他容器运行时。 + +{{< content "common/container-runtime-requirements" >}} + ### 网络和 DNS 要求 -- 请确保 `/etc/resolv.conf` 中的 DNS 地址可用，否则可能会导致集群中的 DNS 出问题。 -- 如果您的网络配置使用防火墙或者安全组，请务必确保基础设施组件能够通过特定端口相互通信。建议您关闭防火墙。有关更多信息，请参考[端口要求](../port-firewall/)。 +{{< content "common/network-requirements" >}} ### 示例机器 diff --git a/content/zh/docs/installing-on-linux/introduction/multioverview.md b/content/zh/docs/installing-on-linux/introduction/multioverview.md index 9538613e5..220f8ed10 100644 --- a/content/zh/docs/installing-on-linux/introduction/multioverview.md +++ b/content/zh/docs/installing-on-linux/introduction/multioverview.md @@ -48,11 +48,16 @@ weight: 3120 - 所有节点必须都能通过 `SSH` 访问。 - 所有节点时间同步。 - 所有节点都应使用 `sudo`/`curl`/`openssl`。 -- `docker` 可以由您自己安装或由 KubeKey 安装。 + +### 容器运行时 + +您的集群必须有一个可用的容器运行时。如果您使用 KubeKey 搭建集群，KubeKey 会默认安装最新版本的 Docker。或者，您也可以在创建集群前手动安装 Docker 或其他容器运行时。 + +{{< content "common/container-runtime-requirements.md" >}} {{< notice note >}} -如果您想在离线环境中部署 KubeSphere，请务必提前安装 `docker`。 +如果您想在离线环境中部署 KubeSphere，请务必提前安装一个容器运行时。 {{}} @@ -69,8 +74,7 @@ KubeKey 可以一同安装 Kubernetes 和 KubeSphere。根据要安装的 Kubern ### 网络和 DNS 要求 -- 请确保 `/etc/resolv.conf` 中的 DNS 地址可用，否则，可能会导致集群中的 DNS 出现问题。 -- 如果您的网络配置使用防火墙规则或安全组，请务必确保基础设施组件可以通过特定端口相互通信。建议您关闭防火墙或遵循指南[端口要求](../../../installing-on-linux/introduction/port-firewall/)。 +{{< content "common/network-requirements.md" >}} {{< notice tip >}} diff --git a/content/zh/docs/installing-on-linux/persistent-storage-configurations/understand-persistent-storage.md b/content/zh/docs/installing-on-linux/persistent-storage-configurations/understand-persistent-storage.md index eefcc8740..1951d05db 100644 --- a/content/zh/docs/installing-on-linux/persistent-storage-configurations/understand-persistent-storage.md +++ b/content/zh/docs/installing-on-linux/persistent-storage-configurations/understand-persistent-storage.md @@ -42,4 +42,8 @@ OpenEBS 本地 PV 动态供应器可以使用节点上的唯一 HostPath（目 ## 多存储解决方案 -如果打算安装多个存储插件，那么只能将其中一个设置为默认存储类型。否则，KubeKey 将无法识别使用哪种存储类型。 \ No newline at end of file +如果打算安装多个存储插件，那么只能将其中一个设置为默认存储类型。否则，KubeKey 将无法识别使用哪种存储类型。 + +## 支持的 CSI 插件 + +{{< content "common/csi-plugins.md" >}} \ No newline at end of file diff --git a/content/zh/docs/quick-start/all-in-one-on-linux.md b/content/zh/docs/quick-start/all-in-one-on-linux.md index 86ce94255..1c2a614c3 100644 --- a/content/zh/docs/quick-start/all-in-one-on-linux.md +++ b/content/zh/docs/quick-start/all-in-one-on-linux.md @@ -38,13 +38,18 @@ weight: 2100 - 节点必须能够通过 `SSH` 连接。 - 节点上可以使用 `sudo`/`curl`/`openssl` 命令。 -- `docker` 可以由您自己安装或由 [KubeKey](https://github.com/kubesphere/kubekey) 安装。 - {{< notice note >}} +### 容器运行时 -如果您想离线安装 KubeSphere，请务必提前安装好 `docker`。 +您的集群必须有一个可用的容器运行时。如果您使用 KubeKey 搭建集群，KubeKey 会默认安装最新版本的 Docker。或者，您也可以在创建集群前手动安装 Docker 或其他容器运行时。 - {{}} +{{< content "common/container-runtime-requirements.md" >}} + +{{< notice note >}} + +如果您想在离线环境中部署 KubeSphere，请务必提前安装一个容器运行时。 + +{{}} ### 依赖项要求 @@ -65,8 +70,7 @@ KubeKey 是用 Go 语言开发的一款全新的安装工具，代替了以前 ### 网络和 DNS 要求 -- 必须确保 `/etc/resolv.conf` 中的 DNS 配置可用，否则集群中的 DNS 可能会有问题。 -- 如果您的网络配置使用了防火墙或安全组，请确保基础设施组件可以通过特定端口相互通信。有关更多信息，请参见[端口要求](../../installing-on-linux/introduction/port-firewall/)关闭防火墙。 +{{< content "common/network-requirements.md" >}} {{< notice tip >}} diff --git a/content/zh/docs/reference/environment-requirements.md b/content/zh/docs/reference/environment-requirements.md new file mode 100644 index 000000000..eb9024e8b --- /dev/null +++ b/content/zh/docs/reference/environment-requirements.md @@ -0,0 +1,37 @@ +--- +title: "环境要求" +keywords: 'KubeSphere, Kubernetes, 配置, 要求' +description: '理解使用和安装 KubeSphere 的各项环境要求。' +linkTitle: "环境要求" +weight: 17500 +--- + +本页面归纳了安装和使用 KubeSphere 的部分要求。 + +## 系统要求 + +{{< content "common/system-requirements.md" >}} + +## 依赖项要求 + +{{< content "common/dependency-requirements.md" >}} + +## 容器运行时要求 + +{{< content "common/container-runtime-requirements.md" >}} + +## 网络要求 + +{{< content "common/network-requirements.md" >}} + +## 支持的 Kubernetes 版本 + +{{< content "common/kubernetes-versions.md" >}} + +## 支持的 CSI 插件 + +{{< content "common/csi-plugins.md" >}} + +## KubeSphere Web 控制台支持的浏览器 + +![console-browser](/images/docs/reference/environment-requirements/console-browser.png) \ No newline at end of file