安装 OpenResty Edge Node

1. 添加防火墙白名单

如果贵司有网络出口防火墙的话,需要开启如下白名单。

安装过程会访问如下公网地址:

openresty.com 443
openresty.org 443
pkg.openresty.com 443

2. 复制 openresty-edge-config 包到当前目录

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 方式,所以不会有下线时间。

5. 修改 edge-node 的配置文件 /usr/local/oredge-node/conf/config.ini

#
# 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 了。

  1. 登录 Admin 网站:

    网址:https://ADMIN_HOST

    如果您正在试用 Edge,则 Admin 的 URL 和账号密码将随试用邮件发送。

    对于试用版,Admin 是部署在我们的机器上,而对于未来购买的正式版,我们会提供安装包供自主部署。

  2. 登录进去之后,进入“网关集群”选项卡(或者 Gateway Clusters 选项卡,取决于你当前界面语言的设置)。 在那里你会看到新部署的节点发的“加入请求”。你根据“加入请求”中的信息,确认是你自己的节点之后,再点 Approve 。 Approve 的过程即是将新节点加入某一个网关集群的过程。因此在 Approve 之前你需要先在界面上创建一个“集群”,然后 Approve 时就可以选择了。

    未来升级 openresty-edge-node 软件包的步骤见升级文档。

按照以上文档部署好 edge-node 服务,就可以开始使用 OpenResty Edge 了。

开始使用

我们提供有在线的文档, 还有相关博客对应视频

有问题请与我们随时沟通!