昆仑中间件

主题

安装 ​

通过本文档可了解昆仑中间件安装前准备及安装方式。

准备 ​

  • JDK 17
  • 数据库：MySQL 或 PostgreSQL
  • 注册中心：etcd 或 Zookeeper

安装 ​

目前可通过二进制包、容器镜像方式部署昆仑中间件：

二进制包部署 ​

bash
# RPM包
rpm -U --force https://w6s-binaries.oss-cn-hangzhou.aliyuncs.com/milestone/kunlun-dapr-2.0.13.noarch.rpm
rpm -U --force https://w6s-binaries.oss-cn-hangzhou.aliyuncs.com/milestone/kunlun-proxy-2.0.13.noarch.rpm
rpm -U --force https://w6s-binaries.oss-cn-hangzhou.aliyuncs.com/milestone/kunlun-pilot-2.0.13.noarch.rpm

# Deb包
dpkg -i https://w6s-binaries.oss-cn-hangzhou.aliyuncs.com/milestone/kunlun-dapr_2.0.13_all.deb
dpkg -i https://w6s-binaries.oss-cn-hangzhou.aliyuncs.com/milestone/kunlun-proxy_2.0.13_all.deb
dpkg -i https://w6s-binaries.oss-cn-hangzhou.aliyuncs.com/milestone/kunlun-pilot_2.0.13_all.deb

镜像部署 ​

待补充...

配置 ​

通过二进制包安装后，可通过以下配置文件修改相关服务配置：

  • /etc/default/kunlun-proxy
  • /etc/default/kunlun-pilot
  • /etc/default/kunlun-dapr

配置 kunlun-proxy ​

bash

# gRPC 监听地址与端口设置
SERVER_GRPC_BIND_HOST=0.0.0.0
SERVER_GRPC_BIND_PORT=19080

# http 监听地址与端口设置
SERVER_HTTP_BIND_HOST=0.0.0.0
SERVER_HTTP_BIND_PORT=9080

# 是否开启 proxy protocol
SERVER_HTTP_USE_PROXY_PROTOCOL=off
SERVER_HTTP_PROXY_PROTOCOL_TIMEOUT=10000

# https 监听地址与端口设置
SERVER_HTTPS_BIND_HOST=0.0.0.0
SERVER_HTTPS_BIND_PORT=9443
SERVER_HTTP_USE_PROXY_PROTOCOL=off
SERVER_HTTP_PROXY_PROTOCOL_TIMEOUT=10000
# 是否启用 ALPN，启用后浏览器可将HTTP 1.1 请求 Upgrade 到 H2
SERVER_HTTPS_USE_ALPN=on

# 数据同步配置
REGISTRY_BACKEND=zookeeper
REGISTRY_NAMESPACE=/io/kunlun
REGISTRY_SERVERS=127.0.0.1:2181
REGISTRY_USERNAME=
REGISTRY_PASSWORD=

配置 kunlun-pilot ​

bash

# 监听地址及端口设置
HTTP_HOST=0.0.0.0
HTTP_PORT=9000
HTTP_CONTEXT=/

# 数据库配置
DB_DRIVER="mysql"
DB_MYSQL_URL="jdbc:mysql://localhost:3306/kunlun?PublicKeyRetrieval=true&useSSL=false&user=kunlun&password=kunlun"
DB_MYSQL_ISOLATION=READ_COMMITTED

# 是否自动建表，DB_TABLE_SCHEMA 需与 DB_MYSQL_URL 中的库名一致
DB_TABLE_SETUP=on
DB_TABLE_SCHEMA=kunlun

更多配置参数及说明请参阅 配置 。

维护 ​

通过二进制包安装后，可通过systemctl管理服务：

bash
# 启用/禁用服务
systemctl enable|disable kunlun-proxy
systemctl enable|disable kunlun-pilot
systemctl enable|disable kunlun-dapr

# 启动/停止/重启服务
systemctl start|stop|restart kunlun-proxy
systemctl start|stop|restart kunlun-pilot
systemctl start|stop|restart kunlun-dapr

服务启用后，首次访问 kunlun-pilot 时，请按向导提示完成相关管理员初始化。

日志 ​

通过二进制包安装后，可通过journalctl查看日志：

bash
# 查看kunlun-proxy日志
journalctl -fn200 -u kunlun-proxy
# 查看kunlun-pilot日志
journalctl -fn200 -u kunlun-pilot
# 查看kunlun-dapr日志
journalctl -fn200 -u kunlun-dapr

访问日志、错误日志及活动日志请参考以下配置项：

  • SERVER_HTTP_LOG_DATA_ACTIVITY
    • 说明：是否记录 HTTP 服务的数据活动日志
    • 可选值：on | off
    • 上下文：kunlun-proxy
  • SERVER_HTTP_LOG_DATA_FORMAT
    • 说明：HTTP 服务的日志数据格式
    • 可选值：hexdump | simple
    • 上下文：kunlun-proxy
  • SERVER_HTTPS_LOG_DATA_ACTIVITY
    • 说明：是否记录 HTTPS 服务的数据活动日志
    • 可选值：on | off
    • 上下文：kunlun-proxy
  • SERVER_HTTPS_LOG_DATA_FORMAT
    • 说明：HTTPS 服务的日志数据格式
    • 可选值：hexdump | simple
    • 上下文：kunlun-proxy
  • SERVER_LOG_DATA_ACTIVITY
    • 说明：是否记录服务的日志数据活动
    • 可选值：on | off
    • 上下文：kunlun-dapr
  • SERVER_LOG_DATA_FORMAT
    • 说明：服务日志数据格式
    • 可选值：hexdump | simple
    • 上下文：kunlun-dapr
  • ACCESS_LOG_DIR
    • 说明：访问日志目录
    • 默认值：/var/log/kunlun-proxy
    • 可选值：无
    • 上下文：kunlun-proxy, kunlun-dapr
  • ACCESS_LOG_AGE
    • 说明：访问日志保留时间
    • 默认值：15d
    • 可选值：无
    • 上下文：kunlun-proxy, kunlun-dapr
  • ERROR_LOG_LEVEL
    • 说明：错误日志级别
    • 默认值：info
    • 可选值：无
    • 上下文：kunlun-proxy, kunlun-dapr
  • ERROR_LOG_DIR
    • 说明：错误日志目录
    • 默认值：/var/log/kunlun-proxy
    • 可选值：无
    • 上下文：kunlun-proxy, kunlun-dapr
  • ERROR_LOG_AGE
    • 说明：错误日志保留时间
    • 默认值：15d
    • 可选值：无
    • 上下文：kunlun-proxy, kunlun-dapr

© 2021-2024 Open Kunlun. All Rights Reserved