Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

【documentation】 更新存储系统相关文档 #3218

Merged
merged 9 commits into from
Dec 9, 2024
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,23 @@ weight: 01
|CPU:8 核,内存:16 GB,硬盘:200 GB
|===

== 存储要求

* 集群中必须存在一个可用的默认存储类。
+
--
ifeval::["{file_output_type}" == "html"]
存储类定义了可供容器使用的一类存储卷。如果您在安装{ks_product_both}时未设置外部持久化存储系统,{ks_product_right}将使用集群节点的本地存储系统作为持久化存储系统,并自动创建对应的 **local** 存储类。如果使用外部持久化存储系统,您需要为{ks_product_both}集群安装存储插件,并创建存储类以定义可供使用的存储卷类型。有关如何安装存储插件,请联系您的存储系统提供商或参阅link:../04-configure-external-persistent-storage[配置外部持久化存储]。
endif::[]

ifeval::["{file_output_type}" == "pdf"]
存储类定义了可供容器使用的一类存储卷。如果您在安装{ks_product_both}时未设置外部持久化存储系统,{ks_product_right}将使用集群节点的本地存储系统作为持久化存储系统,并自动创建对应的 **local** 存储类。如果使用外部持久化存储系统,您需要为{ks_product_both}集群安装存储插件,并创建存储类以定义可供使用的存储卷类型。有关如何安装存储插件,请联系您的存储系统提供商或参阅link:../04-configure-external-persistent-storage[配置外部持久化存储]。
endif::[]
--

* {ks_product_right}的各个组件只需要存储系统提供创建/删除持久卷声明模板(PVC)的能力,不依赖扩容,克隆,快照等高级能力。
zhuxiujuan28 marked this conversation as resolved.
Show resolved Hide resolved


== 依赖项要求

[%header,cols="1a,4a,4a"]
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "配置开源存储系统"
keywords: "Kubernetes, KubeSphere, 安装, 准备, 持久化存储, 开源存储, Ceph, GlusterFS, OpenEBS, Longhorn"
description: "介绍如何在生产环境中为 KubeSphere 集群配置开源存储系统。"
weight: 07
---

KubeSphere 支持众多第三方开源存储系统,包括:
zhuxiujuan28 marked this conversation as resolved.
Show resolved Hide resolved

* link:https://github.com/ceph/ceph-csi[Ceph CSI]

* link:https://docs.gluster.org/en/latest/[GlusterFS]

* link:https://openebs.io/[OpenEBS]

* link:https://longhorn.io/[Longhorn]

* ... 等等
zhuxiujuan28 marked this conversation as resolved.
Show resolved Hide resolved

若要在{ks_product_both}平台安装第三方开源存储系统,请到存储系统的官方网站进行下载安装。
zhuxiujuan28 marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -16,3 +16,20 @@ include::../../../../../_ks_components/admonitions/note.adoc[]
{ks_product_right}外部持久化存储配置仅支持同时安装 Kubernetes 和{ks_product_both}的场景。如果您在现有的 Kubernetes 集群上安装{ks_product_left},{ks_product_right}安装完成后将使用 Kubernetes 集群现有的持久化存储配置。

include::../../../../../_ks_components/admonitions/admonEnd.adoc[]

== 如何安装存储系统

link:../../02-install-kubesphere/02-install-kubernetes-and-kubesphere/[安装{ks_product_both}]时,可以安装不同的存储系统作为插件。KubeKey 会为集群创建一个配置文件(默认为 `config-sample.yaml`),其中包含定义不同资源(包括存储插件)的全部必要参数。若要让 KubeKey 以预期的方式来安装这些存储系统,就必须为 KubeKey 提供这些存储系统的必要配置。

通常,有两种方法能使 KubeKey 应用即将安装的存储系统的配置。

. 直接在 `config-sample.yaml` 中的 `addons` 字段下输入必要的参数。
. 为插件创建一个单独的配置文件,列出所有必要的参数,并在 `config-sample.yaml` 中提供文件的路径,以便 KubeKey 在安装过程中引用该路径。

有关更多信息,请参见link:https://github.com/kubesphere/kubekey/blob/master/docs/addons.md[插件]。

== 默认存储类

* KubeKey 支持安装不同的存储插件和存储类型。无论您要安装哪种存储系统,都可以在其配置文件中指定是否设为默认存储类。

* 如果打算安装多个存储插件,那么只能将其中一个设置为默认存储类。否则,KubeKey 将无法识别使用哪种存储类型。