This is an automated email from the ASF dual-hosted git repository.
dengliming pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/shenyu-website.git
The following commit(s) were added to refs/heads/main by this push:
new c108a85e935 [DOC] update helm deployment doc for Oracle support (#819)
c108a85e935 is described below
commit c108a85e935cb428bebd3f908a8cf482a8ce05f6
Author: Bird <[email protected]>
AuthorDate: Sat Nov 5 21:52:28 2022 +0800
[DOC] update helm deployment doc for Oracle support (#819)
Signed-off-by: Bird <[email protected]>
Signed-off-by: Bird <[email protected]>
---
helm/index.md | 40 ++++++++++++++++++----
.../current/index.md | 32 +++++++++++++++--
2 files changed, 62 insertions(+), 10 deletions(-)
diff --git a/helm/index.md b/helm/index.md
index 006230dadab..5dec3ae6038 100644
--- a/helm/index.md
+++ b/helm/index.md
@@ -5,7 +5,7 @@ description: Helm Deployment
This article introduces the use of `helm` to deploy the `Apache ShenYu`
gateway.
-> Before you read this document, you need to complete some preparations before
deploying Shenyu according to the [Deployment Prerequisites
document](./deployment-before.md).
+> Before you read this document, you need to complete some preparations before
deploying Shenyu according to the [Deployment Prerequisites
document](https://shenyu.apache.org/docs/deployment/deployment-before/).
## Add Helm repository
@@ -24,7 +24,7 @@ Before reading this document, you need to read [Deployment
prerequisites](https:
* **Install the application**: By default, both admin and bootstrap are
installed.
* **Service Exposure**: Use NodePort to expose the service, the default port
is `31095` for admin and `31195` for bootstrap.
-* **Database**: Currently supports h2, MySQL, PostgreSQL as database. Default
is h2.
+* **Database**: Currently supports h2, MySQL, PostgreSQL, Oracle as database.
Default is h2.
### h2 as database
@@ -36,7 +36,7 @@ helm install shenyu shenyu/shenyu -n=shenyu --create-namespace
### MySQL as database
-Modify and copy the following command and execute.
+Modify and copy the following command and execute:
```shell
helm install shenyu shenyu/shenyu -n=shenyu --create-namespace \
@@ -49,7 +49,7 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
### PostgreSQL as database(Version of ShenYu > 2.5.0)
-Modify the following command and copy it to execute.
+Modify the following command and copy it to execute:
```shell
helm install shenyu shenyu/shenyu -n=shenyu --create-namespace \
@@ -60,6 +60,20 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
--set dataSource.pg.password=123456
```
+### Oracle as database
+
+Modify the following command and copy it to execute:
+
+```shell
+helm install shenyu shenyu/shenyu -n=shenyu --create-namespace \
+ --set dataSource.active=oracle \
+ --set dataSource.oracle.ip=127.0.0.1 \
+ --set dataSource.oracle.port=1521 \
+ --set dataSource.oracle.serviceName=shenyu \
+ --set dataSource.oracle.username=root \
+ --set dataSource.oracle.password=123456
+```
+
## Q&A
### 1. you need to modify a lot of configuration information, such as modify
the application.yml, how to install
@@ -148,7 +162,7 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
#### General database configuration
-| configuration-item | type | default | description
|
+| configuration item | type | default | description
|
|------------------------|--------|---------|-------------------------------------------------|
| dataSource.active | string | `"h2"` | Database to use, supports `h2`,
`mysql`, `pg` |
| dataSource.initEnabled | bool | `true` | Initialize the database, only
`h2` is available |
@@ -162,7 +176,7 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
#### MySQL
-| Configuration Item | Type | Default |
Description
|
+| configuration item | Type | Default |
Description
|
|-----------------------------------|--------|------------------------------|-------------------------------------------------------------------------------------------------------|
| dataSource.mysql.ip | string | `""` |
IP
|
| dataSource.mysql.port | int | `3306` |
port
|
@@ -173,7 +187,7 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
### PostgreSQL
-| configuration-item | type | default |
description
|
+| configuration item | type | default |
description
|
|--------------------------------|--------|---------------------------|-------------------------------------------------------------------------------------------------------|
| dataSource.pg.ip | string | `""` | IP
|
| dataSource.pg.port | int | `5432` | port
|
@@ -182,6 +196,18 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
| dataSource.pg.driverClass | string | `"org.postgresql.Driver"` |
PostgreSQL driver class name
|
| dataSource.pg.connectorVersion | string | `"42.2.18"` |
connector version ([maven connector
list](https://repo1.maven.org/maven2/org/postgresql/postgresql/)) |
+### Oracle
+
+| configuration item | type | default |
description
|
+|------------------------------------|--------|------------------------------|----------------------------------------------------------------------------------------------------|
+| dataSource.oracle.ip | string | `""` |
IP
|
+| dataSource.oracle.port | int | `1521` |
port
|
+| dataSource.oracle.username | string | `"root"` |
username
|
+| dataSource.oracle.password | string | `""` |
password
|
+| dataSource.oracle.serviceName | string | `"shenyu"` |
Oracle service name
|
+| dataSource.oracle.driverClass | string | `"oracle.jdbc.OracleDriver"` |
Oracle driver class name
|
+| dataSource.oracle.connectorVersion | string | `"19.3.0.0"` |
connector version([maven connector
list](https://repo1.maven.org/maven2/com/oracle/ojdbc/ojdbc8/)) |
+
### application.yml configuration
| configuration-item | type | default | description
|
diff --git a/i18n/zh/docusaurus-plugin-content-docs-helm/current/index.md
b/i18n/zh/docusaurus-plugin-content-docs-helm/current/index.md
index 43df96ddef1..9371bf56926 100644
--- a/i18n/zh/docusaurus-plugin-content-docs-helm/current/index.md
+++ b/i18n/zh/docusaurus-plugin-content-docs-helm/current/index.md
@@ -6,7 +6,7 @@ description: Helm部署
本文介绍使用 `helm` 来部署 `Apache ShenYu` 网关。
-> 在阅读本文档前，你需要先阅读[部署先决条件](./deployment-before.md)文档来完成部署 `shenyu` 前的环境准备工作。
+>
在阅读本文档前，你需要先阅读[部署先决条件](https://shenyu.apache.org/zh/docs/deployment/deployment-before)文档来完成部署
`shenyu` 前的环境准备工作。
## 添加 Helm 仓库
@@ -21,7 +21,7 @@ helm repo update
* **安装应用**：默认同时安装 admin 与 bootstrap。
* **服务暴露**：使用 NodePort 暴露服务，admin 默认端口为 `31095`, bootstrap 为 `31195`。
-* **数据库**：目前支持 h2, MySQL, PostgreSQL 作为数据库。默认使用 h2。
+* **数据库**：目前支持 h2, MySQL, PostgreSQL, Oracle 作为数据库。默认使用 h2。
### h2 作为数据库
@@ -57,6 +57,20 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
--set dataSource.pg.password=123456
```
+### Oracle 作为数据库
+
+修改以下命令并复制，执行：
+
+```shell
+helm install shenyu shenyu/shenyu -n=shenyu --create-namespace \
+ --set dataSource.active=oracle \
+ --set dataSource.oracle.ip=127.0.0.1 \
+ --set dataSource.oracle.port=1521 \
+ --set dataSource.oracle.serviceName=shenyu \
+ --set dataSource.oracle.username=root \
+ --set dataSource.oracle.password=123456
+```
+
## Q&A
### 1. 需要大量修改配置信息，如修改 application.yml ，如何安装
@@ -131,7 +145,7 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
|-----------------|--------|------------------------------------------------------------------------------------------------------------|--------------|
| admin.nodePort | int | `31095`
| NodePort 端口 |
| admin.javaOpts | string |
[详见这里](https://github.com/apache/shenyu/blob/master/shenyu-dist/shenyu-admin-dist/docker/entrypoint.sh)
| JVM 参数 |
-| admin.resources | dict | `{}`
| K8s 资源配额 |
+| admin.resources | dict | `{}`
| K8s 资源配额 |
### shenyu-bootstrap 配置
@@ -179,6 +193,18 @@ helm install shenyu shenyu/shenyu -n=shenyu
--create-namespace \
| dataSource.pg.driverClass | string | `"org.postgresql.Driver"` |
PostgreSQL driver class 名字
|
| dataSource.pg.connectorVersion | string | `"42.2.18"` |
connector 版本([maven connector
列表](https://repo1.maven.org/maven2/org/postgresql/postgresql/)) |
+### Oracle
+
+| 配置项 | 类型 | 默认值 | 描述
|
+|------------------------------------|--------|------------------------------|------------------------------------------------------------------------------------------------|
+| dataSource.oracle.ip | string | `""` |
IP
|
+| dataSource.oracle.port | int | `1521` |
端口
|
+| dataSource.oracle.username | string | `"root"` |
用户名
|
+| dataSource.oracle.password | string | `""` |
密码
|
+| dataSource.oracle.serviceName | string | `"shenyu"` |
服务名
|
+| dataSource.oracle.driverClass | string | `"oracle.jdbc.OracleDriver"` |
Oracle driver class 名字
|
+| dataSource.oracle.connectorVersion | string | `"19.3.0.0"` |
connector 版本([maven connector
列表](https://repo1.maven.org/maven2/com/oracle/ojdbc/ojdbc8/)) |
+
### application.yml 配置
| 配置项 | 类型 | 默认值 | 描述
|
