安装 OpenResty Edge Node 的容器

1. 准备

安装前需要准备以下文件/信息:

  • openresty-edge-config.*.rpmopenresty-edge-config.*.deb, 如: openresty-edge-config-0.0.1-1.or.noarch.rpm
  • 您的 Admin 的 IP 和端口,对应下文中的 ADMIN_HOSTADMIN_PORT
  • 您的 Log Server 的 IP 和端口,对应下文中的 LOG_SERVER_HOSTLOG_SERVER_PORT
  • 镜像地址,对应下文中的 DOCKER_IMAGE
  • 镜像账号及密码,对应下文的 REGISTRY_USERNAMEREGISTRY_PASSWORD

2. 下载镜像

  • 登录 Registry
sudo docker login --username=REGISTRY_USERNAME registry.openresty.com
# 输入密码:REGISTRY_PASSWORD
  • 下载镜像
docker pull DOCKER_IMAGE

# example
docker pull registry.openresty.com/edge/ubuntu/18.04/openresty-edge-node:1.1.0-5

3. 启动容器

  • 新建挂载到容器中的文件夹: custom/

  • 拷贝 openresty-edge-config.*.rpm/debcustom/

  • 生成 Node 的配置文件: custom/config.ini

请把 ADMIN_HOSTADMIN_PORTLOG_SERVER_HOSTLOG_SERVER_PORT 替换成实际的内容。

#
# NOTICE: please feel free to edit these configurations if necessary.
#
# Both [admin] section and [log_cluster] section need to be configured below.
#

[admin]

# admin server host, default:
host = "ADMIN_HOST"
port = "ADMIN_PORT"

# Another admin server host when you have deployed two admin servers.
# The node will choose one of them randomly.
# And node will retry another server automatically when one server is down.
# It is optional, please ignore it when you only deployed one admin.
# host2 = ""


[log_cluster]

# log server host, default:
host = "LOG_SERVER_HOST"
port = "LOG_SERVER_PORT"
  • 启动容器

通常会希望在容器被销毁后,其他 Node 容器可以继承此容器的配置,所以我们把 Node 的数据目录也挂载出来。

假设 custom/ 的绝对路径是 /root/custom/。 假设本地数据路径为 /root/node1-data


docker run -d -p 80:80 -p 443:443 --name openresty-edge-node \
    -v /root/custom/:/usr/local/oredge-node/custom/ \
    -v /root/node1-data/:/usr/local/oredge-node/data/ \
    DOCKER_IMAGE

# 示例:
docker run -d -p 80:80 -p 443:443 --name openresty-edge-node \
    -v /root/custom/:/usr/local/oredge-node/custom/ \
    -v /root/node1-data/:/usr/local/oredge-node/data/ \
    registry.openresty.com/edge/ubuntu/18.04/openresty-edge-node:1.1.0-5
  • 如果出现问题,可以使用以下命令停止并删除容器:
docker stop openresty-edge-node
docker rm openresty-edge-node

至此 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 了。

4. 开始使用

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

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