安装 OpenResty Edge Node
安装前需要准备以下文件/信息
openresty-edge-config.*.rpm
或openresty-edge-config.*.deb
, 如: openresty-edge-config-0.0.1-1.or.noarch.rpm- 您的 Admin 的 IP 和端口,对应下文中的
ADMIN_HOST
和ADMIN_PORT
。 - 您的 Log Server 的 IP 和端口,对应下文中的
LOG_SERVER_HOST
和LOG_SERVER_PORT
。
1. 添加防火墙白名单
如果贵司有网络出口防火墙的话,需要开启如下白名单。
安装过程会访问如下公网地址:
openresty.com 443
openresty.org 443
pkg.openresty.com 443
openresty-edge-config
包到当前目录
2. 复制 3. 下载安装脚本
curl -O https://openresty.com/client/oredge/install-edge-node.sh
如果得到一条类似下面的信息:
curl: command not found
可能是系统里面没有安装 curl
或者是系统的 shell 程序没有包含 curl
的搜索路径。
你可以使用绝对路径来重试:
/usr/bin/curl -O https://openresty.com/client/oredge/install-edge-node.sh
你的系统的路径可能不同,请联系你的网站管理员或使用 which bash
等命令来检查路径以纠正这种情况。
4. 执行安装脚本
sudo /bin/bash install-edge-node.sh
接下来可能需要运行几分钟的时间,请耐心等待。成功安装时,你将会看到这条命令的最后一行输出是
Great! OpenResty Edge Node installed successfully.
这个脚本会自动安 装 openresty-edge-node
包及其依赖项,并自动启动 oredge-node
服务,
同时设置 oredge-node 服务开机自动运行。
具体细节可以参见 install-edge-node.sh
文件里的源码。
值得一提的是,启动 oredge-node 服务的方法是:
sudo systemctl start oredge-node
停止该服务的方法是:
sudo systemctl stop oredge-node
重启的方法是
sudo systemctl start upgrade-oredge-node
重启使用的是 nginx 的 binary upgrade 方式,所以不会有下线时间。
/usr/local/oredge-node/conf/config.ini
为
5. 修改 edge-node 的配置文件 #
# NOTICE: please feel free to edit these configurations if necessary.
#
[admin]
# admin server host, default:
host = "ADMIN_HOST"
port = "ADMIN_PORT"
[log_cluster]
# log server host, default:
host = "LOG_SERVER_HOST"
port = "LOG_SERVER_PORT"
修改完配置文件之后执行 sudo systemctl start upgrade-oredge-node
重启服务。
6. 检查节点上的 nginx 错误日志文件,位于 /usr/local/oredge-node/logs/error.log
tail /usr/local/oredge-node/logs/error.log
如果你看到最后两条错误日志是类似下面这样的,则是完全正常的,因为新部署的节点需要在 Admin 网站上审批通过,才能加进网关集群中去。
2017/05/25 22:19:43 [warn] 2550#2550: *4 [lua] init.lua:112:
init_worker(): node is not registered, contacting admin, context:
init_worker_by_lua*
2017/05/25 22:19:44 [warn] 2554#2554: *5 [lua] privileged.lua:190:
could not establish node identity: awaiting approval, context:
ngx.timer
至此 OpenResty Edge Node 已经安装完成。
接下来,你可以使用安装好的 Edge Node 了。
-
登录 Admin 网站:
网址:
https://ADMIN_HOST
如果您正在试用 Edge,则 Admin 的 URL 和账号密码将随试用邮件发送。
对于试用版,Admin 是部署在我们的机器上,而对于未来购买的正式版,我们会提供安装包供自主部署。
-
登录进去之后,进入“网关集群”选项卡(或者 Gateway Clusters 选项卡,取决于你当前界面语言的设置)。 在那里你会看到新部署的节点发的“加入请求”。你根据“加入请求”中的信息,确认是你自己的节点之后,再点 Approve 。 Approve 的过程即是将新节点加入某一个网关集群的过程。因此在 Approve 之前你需要先在界面上创建一个“集群”,然后 Approve 时就可以选择了。
未来升级 openresty-edge-node 软件包的步骤见升级文档。
按照以上文档部署好 edge-node
服务,就可以开始使用 OpenResty Edge 了。
开始使用
有问题请与我们随时沟通!