部署先决条件

本文介绍在部署 Apache ShenYu 网关前, 所需要准备的一些先决条件。

数据库环境准备

在部署shenyu-admin项目前, 需初始化其所使用的数据库（数据库目前支持: Mysql、PostgreSql、Oracle）, 其中所用到的脚本文件都存放在 项目根目录下的db目录 中, 以下介绍了各数据库的初始步骤.

Mysql

在项目mysql初始化脚本目录 中找到初始化脚本schema.sql, 使用客户端连接工具连接您的Mysql服务并执行, 由此您会得到一个名为shenyu的数据库, 它之后可作为shenyu-admin项目的数据库使用.

• sql脚本: https://github.com/apache/shenyu/tree/v2.7.1/db/init/mysql

• 驱动:

  • maven repository: https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.3.0/
  • homepage: https://www.mysql.com/products/connector/

PostgreSql

在项目pg初始化脚本目录 中找到初始化脚本create-database.sql、create-table.sql, 并使用客户端连接工具连接您的PostgreSql服务依次执行，由此您会得到一个名为shenyu的数据库, 它之后可作为shenyu-admin项目的数据库使用.

• sql脚本: https://github.com/apache/shenyu/tree/v2.7.1/db/init/pg

• 驱动:

  • maven repository: https://mvnrepository.com/artifact/org.postgresql/postgresql/42.5.0
  • homepage: https://jdbc.postgresql.org/download/

Oracle

在项目oracle初始化脚本目录 中找到初始化脚本schema.sql, 使用客户端连接工具连接您的Oracle服务创建一个数据库, 在此数据库上执行schema.sql脚本, 由此您便初始化了shenyu-admin的数据库, 之后可在项目配置文件 中调整您的oracle环境配置.

• sql脚本: https://github.com/apache/shenyu/blob/v2.7.1/db/init/oracle

• 驱动:

  • maven repository: https://mvnrepository.com/artifact/com.oracle.database.jdbc/ojdbc8/19.3.0.0
  • homepage: https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

OpenGauss

在项目openGauss初始化脚本目录 中找到初始化脚本create-table.sql, 使用客户端连接工具连接您的openGauss服务创建一个数据库, 在此数据库上执行create-table.sql脚本, 由此您便初始化了shenyu-admin的数据库, 之后可在项目配置文件 中调整您的openGauss环境配置.

• sql脚本: https://github.com/apache/shenyu/blob/v2.7.1/db/init/og

• 驱动:

  • maven repository: https://mvnrepository.com/artifact/org.opengauss/opengauss-jdbc/5.0.0-og
  • homepage: https://gitee.com/opengauss/openGauss-connector-jdbc

部署安全检查清单

在生产环境部署 Apache ShenYu 前，请确认管理平面已采取以下网络安全措施：

• 通过防火墙规则、安全组、Kubernetes NetworkPolicy 或同等措施，将 ShenYu Admin 监听端口限制在可信内部网络，并仅允许授权运维人员或 Gateway 节点访问。
• 不要将 Admin 的 /websocket 端点暴露到公网或其他不可信网络。该端点用于 ShenYu Admin 与 Gateway 节点之间的数据同步，因此按设计不进行身份认证，必须依靠网络层访问控制进行保护。
• 将 Gateway 数据平面与 Admin 管理平面分开暴露，不要通过公网负载均衡器或 Ingress 发布 Admin 管理平面。