This is an automated email from the ASF dual-hosted git repository.
smiletan 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 5e6d5ed7031 [Docs][k8s][integrated]streamload for doris on k8s|dcr
(#2503)
5e6d5ed7031 is described below
commit 5e6d5ed70319da83797e57f36146851b1b327940
Author: smiletan <[email protected]>
AuthorDate: Wed Jun 18 17:25:33 2025 +0800
[Docs][k8s][integrated]streamload for doris on k8s|dcr (#2503)
## Versions
- [x] dev
- [x] 3.0
- [x] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
.../integrated-storage-compute/access-cluster.md | 13 +++++++++++++
.../integrated-storage-compute/access-cluster.md | 11 +++++++++++
.../install/deploy-on-kubernetes/access-cluster.md | 11 +++++++++++
.../integrated-storage-compute/access-cluster.md | 11 +++++++++++
.../install/deploy-on-kubernetes/access-cluster.md | 13 +++++++++++++
.../integrated-storage-compute/access-cluster.md | 13 +++++++++++++
6 files changed, 72 insertions(+)
diff --git
a/docs/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
b/docs/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
index c24f4658dc8..c15e8a0f467 100644
---
a/docs/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
+++
b/docs/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
@@ -109,3 +109,16 @@ To access Doris through the LoadBalancer, use the external
IP (provided in the E
```shell
mysql -h
ac4828493dgrftb884g67wg4tb68gyut-1137856348.us-east-1.elb.amazonaws.com -P
31545 -uroot
```
+
+## StreamLoad Access to Doris Deployed on Kubernetes
+Doris supports data import using the StreamLoad method. When the client and
the Doris cluster are within the same local network, the client can directly
use the Frontend (FE) address as the request endpoint. The FE service responds
with an HTTP 301 status code and provides the Backend (BE) address, instructing
the client to redirect the request to the BE for data import.
+
+However, when Doris is deployed on Kubernetes, internal communication uses
addresses that are only accessible within the Kubernetes cluster. If the FE
returns a BE address that is only reachable internally via the 301 redirect
mechanism, data import attempts from clients outside the Kubernetes cluster
will fail.
+
+To import data using StreamLoad from a client located outside the Kubernetes
environment, you must configure the import address with a BE address that is
externally accessible.
+
+### Configure External Access to the BE Service
+To enable access to the BE service from outside the Kubernetes cluster,
configure the service as either a
[NodePort](install-config-cluster.md#nodeport) or a
[LoadBalancer](install-config-cluster.md#loadbalancer). Update the
`DorisCluster` resource accordingly to apply these changes.
+
+### Configure the BE Proxy Address
+As the description of [NodePort](#nodeport) or [LoadBalancer](#loadbalancer)
to get an externally accessible address and the corresponding `web_server`
port. Use this address and port as the request endpoint when importing data via
StreamLoad.
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
index b496d47cd15..f47178bd087 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
@@ -144,3 +144,14 @@ doriscluster-sample-be-service LoadBalancer
10.152.183.244 ac4828493dgrft
```shell
mysql -h
ac4828493dgrftb884g67wg4tb68gyut-1137856348.us-east-1.elb.amazonaws.com -P
31545 -uroot
```
+
+## StreamLoad 访问部署在 Kubernetes 的 Doris
+Doris 提供使用 StreamLoad 模式导入数据。客户端和 Doris 集群在同一个局域网内，客户端可直接使用 FE 的地址作为请求地址，FE
服务接收请求并返回 HTTP 301 的状态码以及 BE 的可访问地址，告诉客户端请求 BE 的地址导入数据。在 Kubernetes 上部署的 Doris
集群使用只在 Kubernetes 内部可访问的地址通信，当使用 StreamLoad 方式配置 FE 的可访问地址时，
+FE 通过 301 机制返回的是 BE 只在 Kubernetes 内部可访问的地址，导致在 Kubernetes 外部的客户端导入数据失败。
+
+在 Kubernetes 外部的客户端使用 StreamLoad 模式向部署在 Kubernetes 上的 Doris
集群导入数据时，需要配置可从外部访问的 BE 地址作为 StreamLoad 的导入地址。
+### 配置 BE Service 外部可访问
+按照 [NodePort](install-config-cluster.md#nodeport) 或者
[LoadBalancer](install-config-cluster.md#loadbalancer) 配置 BE 服务的 `Service` 可以从
Kubernetes 集群外部访问。更新部署 Doris 集群的 `DorisCluster` 资源。
+
+### 配置 BE 代理地址
+根据 [NodePort](#nodeport-模式) 或者 [LoadBalancer](#loadbalancer-模式) 获取访问地址的方式，获取可在
Kubernetes 外部访问的地址以及对应的可访问 web_server 服务的端口。将获取到的地址和访问端口配置到使用 StreamLoad
导入数据的请求地址中。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
index b496d47cd15..f47178bd087 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
@@ -144,3 +144,14 @@ doriscluster-sample-be-service LoadBalancer
10.152.183.244 ac4828493dgrft
```shell
mysql -h
ac4828493dgrftb884g67wg4tb68gyut-1137856348.us-east-1.elb.amazonaws.com -P
31545 -uroot
```
+
+## StreamLoad 访问部署在 Kubernetes 的 Doris
+Doris 提供使用 StreamLoad 模式导入数据。客户端和 Doris 集群在同一个局域网内，客户端可直接使用 FE 的地址作为请求地址，FE
服务接收请求并返回 HTTP 301 的状态码以及 BE 的可访问地址，告诉客户端请求 BE 的地址导入数据。在 Kubernetes 上部署的 Doris
集群使用只在 Kubernetes 内部可访问的地址通信，当使用 StreamLoad 方式配置 FE 的可访问地址时，
+FE 通过 301 机制返回的是 BE 只在 Kubernetes 内部可访问的地址，导致在 Kubernetes 外部的客户端导入数据失败。
+
+在 Kubernetes 外部的客户端使用 StreamLoad 模式向部署在 Kubernetes 上的 Doris
集群导入数据时，需要配置可从外部访问的 BE 地址作为 StreamLoad 的导入地址。
+### 配置 BE Service 外部可访问
+按照 [NodePort](install-config-cluster.md#nodeport) 或者
[LoadBalancer](install-config-cluster.md#loadbalancer) 配置 BE 服务的 `Service` 可以从
Kubernetes 集群外部访问。更新部署 Doris 集群的 `DorisCluster` 资源。
+
+### 配置 BE 代理地址
+根据 [NodePort](#nodeport-模式) 或者 [LoadBalancer](#loadbalancer-模式) 获取访问地址的方式，获取可在
Kubernetes 外部访问的地址以及对应的可访问 web_server 服务的端口。将获取到的地址和访问端口配置到使用 StreamLoad
导入数据的请求地址中。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
index b496d47cd15..f47178bd087 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
@@ -144,3 +144,14 @@ doriscluster-sample-be-service LoadBalancer
10.152.183.244 ac4828493dgrft
```shell
mysql -h
ac4828493dgrftb884g67wg4tb68gyut-1137856348.us-east-1.elb.amazonaws.com -P
31545 -uroot
```
+
+## StreamLoad 访问部署在 Kubernetes 的 Doris
+Doris 提供使用 StreamLoad 模式导入数据。客户端和 Doris 集群在同一个局域网内，客户端可直接使用 FE 的地址作为请求地址，FE
服务接收请求并返回 HTTP 301 的状态码以及 BE 的可访问地址，告诉客户端请求 BE 的地址导入数据。在 Kubernetes 上部署的 Doris
集群使用只在 Kubernetes 内部可访问的地址通信，当使用 StreamLoad 方式配置 FE 的可访问地址时，
+FE 通过 301 机制返回的是 BE 只在 Kubernetes 内部可访问的地址，导致在 Kubernetes 外部的客户端导入数据失败。
+
+在 Kubernetes 外部的客户端使用 StreamLoad 模式向部署在 Kubernetes 上的 Doris
集群导入数据时，需要配置可从外部访问的 BE 地址作为 StreamLoad 的导入地址。
+### 配置 BE Service 外部可访问
+按照 [NodePort](install-config-cluster.md#nodeport) 或者
[LoadBalancer](install-config-cluster.md#loadbalancer) 配置 BE 服务的 `Service` 可以从
Kubernetes 集群外部访问。更新部署 Doris 集群的 `DorisCluster` 资源。
+
+### 配置 BE 代理地址
+根据 [NodePort](#nodeport-模式) 或者 [LoadBalancer](#loadbalancer-模式) 获取访问地址的方式，获取可在
Kubernetes 外部访问的地址以及对应的可访问 web_server 服务的端口。将获取到的地址和访问端口配置到使用 StreamLoad
导入数据的请求地址中。
diff --git
a/versioned_docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
b/versioned_docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
index c24f4658dc8..c15e8a0f467 100644
--- a/versioned_docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
+++ b/versioned_docs/version-2.1/install/deploy-on-kubernetes/access-cluster.md
@@ -109,3 +109,16 @@ To access Doris through the LoadBalancer, use the external
IP (provided in the E
```shell
mysql -h
ac4828493dgrftb884g67wg4tb68gyut-1137856348.us-east-1.elb.amazonaws.com -P
31545 -uroot
```
+
+## StreamLoad Access to Doris Deployed on Kubernetes
+Doris supports data import using the StreamLoad method. When the client and
the Doris cluster are within the same local network, the client can directly
use the Frontend (FE) address as the request endpoint. The FE service responds
with an HTTP 301 status code and provides the Backend (BE) address, instructing
the client to redirect the request to the BE for data import.
+
+However, when Doris is deployed on Kubernetes, internal communication uses
addresses that are only accessible within the Kubernetes cluster. If the FE
returns a BE address that is only reachable internally via the 301 redirect
mechanism, data import attempts from clients outside the Kubernetes cluster
will fail.
+
+To import data using StreamLoad from a client located outside the Kubernetes
environment, you must configure the import address with a BE address that is
externally accessible.
+
+### Configure External Access to the BE Service
+To enable access to the BE service from outside the Kubernetes cluster,
configure the service as either a
[NodePort](install-config-cluster.md#nodeport) or a
[LoadBalancer](install-config-cluster.md#loadbalancer). Update the
`DorisCluster` resource accordingly to apply these changes.
+
+### Configure the BE Proxy Address
+As the description of [NodePort](#nodeport) or [LoadBalancer](#loadbalancer)
to get an externally accessible address and the corresponding `web_server`
port. Use this address and port as the request endpoint when importing data via
StreamLoad.
diff --git
a/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
b/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
index c24f4658dc8..c15e8a0f467 100644
---
a/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
+++
b/versioned_docs/version-3.0/install/deploy-on-kubernetes/integrated-storage-compute/access-cluster.md
@@ -109,3 +109,16 @@ To access Doris through the LoadBalancer, use the external
IP (provided in the E
```shell
mysql -h
ac4828493dgrftb884g67wg4tb68gyut-1137856348.us-east-1.elb.amazonaws.com -P
31545 -uroot
```
+
+## StreamLoad Access to Doris Deployed on Kubernetes
+Doris supports data import using the StreamLoad method. When the client and
the Doris cluster are within the same local network, the client can directly
use the Frontend (FE) address as the request endpoint. The FE service responds
with an HTTP 301 status code and provides the Backend (BE) address, instructing
the client to redirect the request to the BE for data import.
+
+However, when Doris is deployed on Kubernetes, internal communication uses
addresses that are only accessible within the Kubernetes cluster. If the FE
returns a BE address that is only reachable internally via the 301 redirect
mechanism, data import attempts from clients outside the Kubernetes cluster
will fail.
+
+To import data using StreamLoad from a client located outside the Kubernetes
environment, you must configure the import address with a BE address that is
externally accessible.
+
+### Configure External Access to the BE Service
+To enable access to the BE service from outside the Kubernetes cluster,
configure the service as either a
[NodePort](install-config-cluster.md#nodeport) or a
[LoadBalancer](install-config-cluster.md#loadbalancer). Update the
`DorisCluster` resource accordingly to apply these changes.
+
+### Configure the BE Proxy Address
+As the description of [NodePort](#nodeport) or [LoadBalancer](#loadbalancer)
to get an externally accessible address and the corresponding `web_server`
port. Use this address and port as the request endpoint when importing data via
StreamLoad.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
