Skip to content

Latest commit

 

History

History
88 lines (61 loc) · 3.09 KB

gateway.md

File metadata and controls

88 lines (61 loc) · 3.09 KB

bk-ci 网关部署文档

蓝鲸ci网关服务基于Nginx+OpenResty，部署于微服务与用户设备中间层，提供用户访问验证、访问日志记录、流量控制、防爬虫、后端服务分发功能。

系统要求

  • OpenResty 1.17.8.2版本及以上

安装说明

这里以 CentOS 7.x 环境来对安装已经说明。

OpenResty安装及启动

  • 上传安装和部署文件

在安装和部署网关之前，需要将相关的安装包和部署包上传到相应的服务器，下面是需要上传的文件。

文件名称 文件说明
openresty-openssl111-1.1.1g-3.el7.x86_64.rpm openresty依赖的openssl包
openresty-pcre-8.44-1.el7.x86_64.rpm openresty依赖的pcre包
openresty-zlib-1.2.11-3.el7.centos.x86_64.rpm openresty依赖的zlib包
openresty-1.17.8.2-1.el7.x86_64.rpm openresty安装包
  • 安装openresty

网关部署依赖于lua脚本做鉴权和转发，所以这里需要安装openresty，使用的版本：1.17.8.2。rpm安装包请查看附件，下面是安装命令。

# 修改安装包权限
chmod 644 openresty-1.17.8.2-1.el7.x86_64.rpm
chmod 644 openresty-openssl111-1.1.1g-3.el7.x86_64.rpm
chmod 644 openresty-pcre-8.44-1.el7.x86_64.rpm
chmod 644 openresty-zlib-1.2.11-3.el7.centos.x86_64.rpm
# 开始安装
rpm -ivh openresty-pcre-8.44-1.el7.x86_64.rpm
rpm -ivh openresty-zlib-1.2.11-3.el7.centos.x86_64.rpm
rpm -ivh openresty-openssl111-1.1.1g-3.el7.x86_64.rpm  --replacefiles
rpm -ivh openresty-1.17.8.2-1.el7.x86_64.rpm
# 检测安装情况
cd /usr/local/openresty/nginx && ./sbin/nginx -v

最后提示"nginx version: openresty/1.17.8.2"即安装成功。

部署并启动bk-ci网关

网关主要是配置文件和lua脚本，所以只需要将网关gateway的外链到nginx的conf目录

  • 先配置{{code}}/scripts/bkenv.properties相关参数
  • 执行render命令生成网关的模板文件
    cd {{code}}/scripts
    sh ./render_tpl -m ci ../support-files/templates/gateway*
  • 拷贝渲染后的模板文件到nginx代码目录
cp -rf {{code}}/ci/gateway/core/* {{code}}/src/gateway/core/
  • 将nginx配置文件复制到项目目录下
cp -rf {{code}}/src/gateway/core/* __INSTALL_PATH__/gateway
  • 将__INSTALL_PATH__/gateway的nginx配置目录软连到nginx的conf目录下
rm -rf /usr/local/openresty/nginx/conf
ln -s  __INSTALL_PATH__/gateway /usr/local/openresty/nginx/conf

启动命令

mkdir -p /usr/local/openresty/nginx/run/ # 创建PID目录
cd /usr/local/openresty/nginx # 进入nginx安装目录
./sbin/nginx -t  # 验证nginx的配置是否正确
./sbin/nginx     # 启动nginx
./sbin/nginx -s reload # 重启nginx