This is an automated email from the ASF dual-hosted git repository.
kassiez pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 87c63ece059 shard pv used doc (#2353)
87c63ece059 is described below
commit 87c63ece0590ee3374d61cd96114ef67e1b2ff84
Author: smiletan <[email protected]>
AuthorDate: Tue May 27 12:42:09 2025 +0800
shard pv used doc (#2353)
## Versions
- [x] dev
- [x] 3.0
- [x] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
.../install-config-cluster.md | 19 +++++++++++++++++++
.../install-config-cluster.md | 19 +++++++++++++++++++
.../deploy-on-kubernetes/install-config-cluster.md | 21 ++++++++++++++++++++-
.../install-config-cluster.md | 19 +++++++++++++++++++
.../deploy-on-kubernetes/install-config-cluster.md | 20 ++++++++++++++++++++
.../install-config-cluster.md | 19 +++++++++++++++++++
6 files changed, 116 insertions(+), 1 deletion(-)
diff --git
a/docs/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
b/docs/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
index 4b3fd411ac0..e4b0275706c 100644
---
a/docs/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
+++
b/docs/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
@@ -775,3 +775,22 @@ The Doris Operator mounts the krb5.conf file using a
ConfigMap resource and moun
keytabPath: ${keytabPath}
```
${krb5ConfigMapName}: Name of the ConfigMap containing the krb5.conf file.
${keytabSecretName}: Name of the Secret containing the keytab files.
${keytabPath}: The directory path in the container where the Secret mounts the
keytab files. This path should match the directory specified by
hadoop.kerberos.keytab when creating a catalog. For catalog configuration
details, refer to the [Hive Catalog
configuration](../../../lakehouse/catalogs/hive-catalog.md#configuring-catalog)
documentation.
+
+## Configure Shared Storage
+As of version 25.4.0, the Doris Operator supports mounting shared storage with
the ReadWriteMany access mode to all pods across multiple components. Before
using this feature, ensure that the shared storage PersistentVolume and
PersistentVolumeClaim resources have been created. Configure the DorisCluster
resource as shown below before deploying the Doris cluster:
+```yaml
+spec:
+ sharedPersistentVolumeClaims:
+ - mountPath: ${mountPath}
+ persistentVolumeClaimName: ${sharedPVCName}
+ supportComponents:
+ - fe
+ - be
+```
+- `${mountPath}` specifies the absolute path inside the container where the
storage will be mounted.
+- `${sharedPVCName}` refers to the name of the `PersistentVolumeClaim` to be
mounted.
+- `supportComponents` lists the names of the components that require the
shared storage. In the example above, both the FE and BE components will mount
the shared storage. If the supportComponents array is left empty, all deployed
components will mount the shared storage by default.
+
+:::tip Tip
+The `mountPath` parameter can use `${DORIS_HOME}` as a prefix. When
`${DORIS_HOME}` is used, it resolves to `/opt/apache-doris/fe` within FE
containers and `/opt/apache-doris/be` within BE containers.
+:::
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
index 3d6b557f728..a22db46cc54 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
@@ -926,3 +926,22 @@ Doris Operator 使用 `ConfigMap` 资源挂载 krb5.conf 文件，使用 `Secret
```
${krb5ConfigMapName} 为包含要使用的 `krb5.conf` 文件的 ConfigMap
名称。${keytabSecretName} 为包含 keytab 文件的 Secret 名称。${keytabPath} 为 Secret
希望挂载到容器中的路径，这个路径是创建 catalog 时，通过 `hadoop.kerberos.keytab` 指定 keytab 的文件所在目录。创建
catalog 请参考配置 [Hive
Catalog](../../../lakehouse/catalogs/hive-catalog.md#配置-catalog) 文档。
+
+## 配置共享存储
+Doris Operator 从 25.4.0 版本开始支持为多个组件的所有 Pod 挂载一个 `ReadWriteMany`
的共享存储。使用前请提前创建好共享存储 `PersistentVolume` 和 `PersistentVolumeClaim` 资源，在部署 Doris
集群之前按照如下配置 `DorisCluster` 资源：
+```yaml
+spec:
+ sharedPersistentVolumeClaims:
+ - mountPath: ${mountPath}
+ persistentVolumeClaimName: ${sharedPVCName}
+ supportComponents:
+ - fe
+ - be
+```
+- ${mountPath} 指定挂载到容器内的绝对路径。
+- ${sharedPVCName} 表示被挂载的 `PersistentVolumeClaim` 的名称。
+- `supportComponents` 指定需要挂载该共享存储的组件名称，上述实例中，指定 FE，BE 两种组件挂载该共享存储，如果
`supportComponents` 数组为空，表示所有组件部署的的组件都挂载该共享存储。
+
+:::tip 提示
+`mountPath` 支持使用 `${DORIS_HOME}` 作为路径前缀。当 `mountPath` 使用 `${DORIS_HOME}`
作为前缀使用时，在 FE 容器中 `${DORIS_HOME}` 指代 `/opt/apache-doris/fe`; 在 BE 容器中
`${DORIS_HOME}` 指代 `/opt/apache-doris/be`。
+:::
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
index ecf9c76fd74..c26f3304f33 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
@@ -925,4 +925,23 @@ Doris Operator 使用 `ConfigMap` 资源挂载 krb5.conf 文件，使用 `Secret
keytabPath: ${keytabPath}
```
${krb5ConfigMapName} 为包含要使用的 `krb5.conf` 文件的 ConfigMap
名称。${keytabSecretName} 为包含 keytab 文件的 Secret 名称。${keytabPath} 为 Secret
希望挂载到容器中的路径，这个路径是创建 catalog 时，通过 `hadoop.kerberos.keytab` 指定 keytab 的文件所在目录。创建
- atalog 请参考配置 [Hive
Catalog](../../lakehouse/datalake-analytics/hive.md#catalog-配置) 文档。
+ catalog 请参考配置 [Hive
Catalog](../../lakehouse/datalake-analytics/hive.md#catalog-配置) 文档。
+
+## 配置共享存储
+Doris Operator 从 25.4.0 版本开始支持为多个组件的所有 Pod 挂载一个 `ReadWriteMany`
的共享存储。使用前请提前创建好共享存储 `PersistentVolume` 和 `PersistentVolumeClaim` 资源，在部署 Doris
集群之前按照如下配置 `DorisCluster` 资源：
+```yaml
+spec:
+ sharedPersistentVolumeClaims:
+ - mountPath: ${mountPath}
+ persistentVolumeClaimName: ${sharedPVCName}
+ supportComponents:
+ - fe
+ - be
+```
+- ${mountPath} 指定挂载到容器内的绝对路径。
+- ${sharedPVCName} 表示被挂载的 `PersistentVolumeClaim` 的名称。
+- `supportComponents` 指定需要挂载该共享存储的组件名称，上述实例中，指定 FE，BE 两种组件挂载该共享存储，如果
`supportComponents` 数组为空，表示所有组件部署的的组件都挂载该共享存储。
+
+:::tip 提示
+`mountPath` 支持使用 `${DORIS_HOME}` 作为路径前缀。当 `mountPath` 使用 `${DORIS_HOME}`
作为前缀使用时，在 FE 容器中 `${DORIS_HOME}` 指代 `/opt/apache-doris/fe`; 在 BE 容器中
`${DORIS_HOME}` 指代 `/opt/apache-doris/be`。
+:::
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
index ed840d21f83..bbf4bfffbf2 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
@@ -949,3 +949,22 @@ Doris Operator 使用 `ConfigMap` 资源挂载 krb5.conf 文件，使用 `Secret
```
${krb5ConfigMapName} 为包含要使用的 `krb5.conf` 文件的 ConfigMap
名称。${keytabSecretName} 为包含 keytab 文件的 Secret 名称。${keytabPath} 为 Secret
希望挂载到容器中的路径，这个路径是创建 catalog 时，通过 `hadoop.kerberos.keytab` 指定 keytab 的文件所在目录。创建
catalog 请参考配置 [Hive
Catalog](../../../lakehouse/datalake-analytics/hive.md#catalog-配置) 文档。
+
+## 配置共享存储
+Doris Operator 从 25.4.0 版本开始支持为多个组件的所有 Pod 挂载一个 `ReadWriteMany`
的共享存储。使用前请提前创建好共享存储 `PersistentVolume` 和 `PersistentVolumeClaim` 资源，在部署 Doris
集群之前按照如下配置 `DorisCluster` 资源：
+```yaml
+spec:
+ sharedPersistentVolumeClaims:
+ - mountPath: ${mountPath}
+ persistentVolumeClaimName: ${sharedPVCName}
+ supportComponents:
+ - fe
+ - be
+```
+- ${mountPath} 指定挂载到容器内的绝对路径。
+- ${sharedPVCName} 表示被挂载的 `PersistentVolumeClaim` 的名称。
+- `supportComponents` 指定需要挂载该共享存储的组件名称，上述实例中，指定 FE，BE 两种组件挂载该共享存储，如果
`supportComponents` 数组为空，表示所有组件部署的的组件都挂载该共享存储。
+
+:::tip 提示
+`mountPath` 支持使用 `${DORIS_HOME}` 作为路径前缀。当 `mountPath` 使用 `${DORIS_HOME}`
作为前缀使用时，在 FE 容器中 `${DORIS_HOME}` 指代 `/opt/apache-doris/fe`; 在 BE 容器中
`${DORIS_HOME}` 指代 `/opt/apache-doris/be`。
+:::
\ No newline at end of file
diff --git
a/versioned_docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
b/versioned_docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
index 5be7f5a228a..9f7a2cdb9ee 100644
---
a/versioned_docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
+++
b/versioned_docs/version-2.1/install/deploy-on-kubernetes/install-config-cluster.md
@@ -773,3 +773,23 @@ The Doris Operator mounts the krb5.conf file using a
ConfigMap resource and moun
keytabPath: ${keytabPath}
```
${krb5ConfigMapName}: Name of the ConfigMap containing the krb5.conf file.
${keytabSecretName}: Name of the Secret containing the keytab files.
${keytabPath}: The directory path in the container where the Secret mounts the
keytab files. This path should match the directory specified by
hadoop.kerberos.keytab when creating a catalog. For catalog configuration
details, refer to the [Hive Catalog
configuration](../../lakehouse/datalake-analytics/hive.md#catalog-configuration)
documentation.
+
+## Configure Shared Storage
+As of version 25.4.0, the Doris Operator supports mounting shared storage with
the ReadWriteMany access mode to all pods across multiple components. Before
using this feature, ensure that the shared storage PersistentVolume and
PersistentVolumeClaim resources have been created. Configure the DorisCluster
resource as shown below before deploying the Doris cluster:
+```yaml
+spec:
+ sharedPersistentVolumeClaims:
+ - mountPath: ${mountPath}
+ persistentVolumeClaimName: ${sharedPVCName}
+ supportComponents:
+ - fe
+ - be
+```
+- `${mountPath}` specifies the absolute path inside the container where the
storage will be mounted.
+- `${sharedPVCName}` refers to the name of the `PersistentVolumeClaim` to be
mounted.
+- `supportComponents` lists the names of the components that require the
shared storage. In the example above, both the FE and BE components will mount
the shared storage. If the supportComponents array is left empty, all deployed
components will mount the shared storage by default.
+
+:::tip Tip
+The `mountPath` parameter can use `${DORIS_HOME}` as a prefix. When
`${DORIS_HOME}` is used, it resolves to `/opt/apache-doris/fe` within FE
containers and `/opt/apache-doris/be` within BE containers.
+:::
+
diff --git
a/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
b/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
index d77d566c564..3613fba19bb 100644
---
a/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
+++
b/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/install-config-cluster.md
@@ -775,3 +775,22 @@ The Doris Operator mounts the krb5.conf file using a
ConfigMap resource and moun
keytabPath: ${keytabPath}
```
${krb5ConfigMapName}: Name of the ConfigMap containing the krb5.conf file.
${keytabSecretName}: Name of the Secret containing the keytab files.
${keytabPath}: The directory path in the container where the Secret mounts the
keytab files. This path should match the directory specified by
hadoop.kerberos.keytab when creating a catalog. For catalog configuration
details, refer to the [Hive Catalog
configuration](../../../lakehouse/datalake-analytics/hive.md#catalog-configuration)
documentation.
+
+## Configure Shared Storage
+As of version 25.4.0, the Doris Operator supports mounting shared storage with
the ReadWriteMany access mode to all pods across multiple components. Before
using this feature, ensure that the shared storage PersistentVolume and
PersistentVolumeClaim resources have been created. Configure the DorisCluster
resource as shown below before deploying the Doris cluster:
+```yaml
+spec:
+ sharedPersistentVolumeClaims:
+ - mountPath: ${mountPath}
+ persistentVolumeClaimName: ${sharedPVCName}
+ supportComponents:
+ - fe
+ - be
+```
+- `${mountPath}` specifies the absolute path inside the container where the
storage will be mounted.
+- `${sharedPVCName}` refers to the name of the `PersistentVolumeClaim` to be
mounted.
+- `supportComponents` lists the names of the components that require the
shared storage. In the example above, both the FE and BE components will mount
the shared storage. If the supportComponents array is left empty, all deployed
components will mount the shared storage by default.
+
+:::tip Tip
+The `mountPath` parameter can use `${DORIS_HOME}` as a prefix. When
`${DORIS_HOME}` is used, it resolves to `/opt/apache-doris/fe` within FE
containers and `/opt/apache-doris/be` within BE containers.
+:::
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
