wnology/edge-agent

Wnology Edge Agent

WEGnology Edge Agent是安装在每台WEGnology边缘计算设备上的服务，用于管理边缘工作流的部署和执行。

支持的标签

多架构

• 1.54.0, 1.54.0-alpine, latest, latest-alpine

amd64架构

• 1.54.0-amd64, 1.54.0-alpine-amd64

arm64架构

• 1.54.0-arm64, 1.54.0-alpine-arm64

arm32架构

• 1.54.0-arm, 1.54.0-alpine-arm

快速参考

获取帮助：

• WEGnology网关边缘代理安装教程
• WEGnology网关边缘代理使用教程
• WEGnology文档
• WEGnology论坛

维护者：

• WEGnology, Inc

支持的架构：

amd64, arm, arm64

如何使用此镜像

有关安装Docker和拉取此镜像的帮助，请查看安装说明。您还可以找到使用Docker命令管理代理的简要说明。

启动wnology Edge Agent实例 (文档)

docker run -d --name myAgent \
  -e 'DEVICE_ID=<your-device-id>' \
  -e 'ACCESS_KEY=<your-access-key>' \
  -e 'ACCESS_SECRET=<your-access-secret>' \
  docker.xuanyuan.run/wnology/edge-agent

启动并挂载持久存储 (文档)

docker run -d --name myAgent \
  -e 'DEVICE_ID=<your-device-id>' \
  -e 'ACCESS_KEY=<your-access-key>' \
  -e 'ACCESS_SECRET=<your-access-secret>' \
  -v /docker/host/dir:/data \
  docker.xuanyuan.run/wnology/edge-agent

默认情况下，持久数据存储在卷/data中，可通过--volumes-from some-volume-container或-v /docker/host/dir:/data使用（参见Docker卷文档）。

启动并暴露HTTP端点以用于触发 (文档)

docker run -d --name myAgent \
  -e 'DEVICE_ID=<your-device-id>' \
  -e 'ACCESS_KEY=<your-access-key>' \
  -e 'ACCESS_SECRET=<your-access-secret>' \
  -p <host port>:8080 \
  wnology/edge-agent

默认情况下，WEGnology Agent在端口8080暴露HTTP端点，可使用-p将其暴露到本地主机端口（参见https://docs.docker.com/engine/reference/commandline/run/#publish-or-expose-port--p-expose%EF%BC%89%E3%80%82

使用自定义代理配置文件 (文档)

您可以按以下方式挂载自己的配置文件：

docker run -d --name myAgent \
  -v /host/dir/custom-config.toml:/etc/wegnology/wegnology-edge-agent-config.toml \
  docker.xuanyuan.run/wnology/edge-agent

/etc/wegnology/wegnology-edge-agent-config.toml文件是代理配置示例文件，是创建自定义配置文件的良好起点。

所有可用选项

大多数选项可通过环境变量（Docker最常用）、配置文件或命令行标志设置。选项优先级：命令行标志 > 环境变量 > 配置文件。以下是各选项详情：

选项详情

• DEVICE_ID: 必填
  代理的WEGnology设备ID，对应WEGnology账户中边缘计算设备的ID。

• ACCESS_KEY: 必填
  代理使用的WEGnology访问密钥，应为与指定设备ID对应的设备访问密钥的密钥部分。

• ACCESS_SECRET: 必填
  代理使用的WEGnology访问密钥秘钥，应为与指定设备ID对应的设备访问密钥的秘钥部分。

• CONF_PATH:
  代理配置文件路径，默认为/etc/wegnology/wegnology-edge-agent-config.toml（示例配置文件）。

• LOGGER_OUT:
  日志输出目标，可为console或文件路径，默认为console。

• LOGGER_LEVEL:
  日志级别，可选error、warn、info或verbose，默认为info。

• STORE_PATH:
  代理持久存储目录路径，默认为/data/wegnology-edge-agent-store.db。

• UDP_ADDRESS:
  代理绑定UDP触发端口的地址，默认为0.0.0.0（绑定所有网络接口）。

• QUEUE_OFFLINE_MESSAGES:
  离线时是否队列化消息以便稍后发送，默认为true。

• WEBSERVER_ENABLED:
  是否启用代理Web服务器，默认为启用（true）。

• WEBSERVER_PORT:
  Web服务器端口，默认为8080。

• WEBSERVER_ADDRESS:
  Web服务器绑定地址，默认为0.0.0.0（绑定所有网络接口）。

• WEBSERVER_USERNAME:
  Web服务器基本认证用户名，默认无。若未配置用户名和密码，则无需认证。

• WEBSERVER_PASSWORD:
  Web服务器基本认证密码，默认无。若未配置用户名和密码，则无需认证。

• WEBSERVER_SSL_KEY_PATH:
  Web服务器SSL密钥文件路径，默认无。若提供SSL密钥，必须同时提供SSL证书。

• WEBSERVER_SSL_KEY:
  Web服务器SSL密钥内容，可直接设置密钥内容（替代文件路径），默认无。若提供，必须同时提供SSL证书，优先级高于WEBSERVER_SSL_KEY_PATH。

• WEBSERVER_SSL_CERT_PATH:
  Web服务器SSL证书文件路径，默认无。若提供SSL证书，必须同时提供SSL密钥。

• WEBSERVER_SSL_CERT:
  Web服务器SSL证书内容，可直接设置证书内容（替代文件路径），默认无。若提供，必须同时提供SSL密钥，优先级高于WEBSERVER_SSL_CERT_PATH。

• WEBSERVER_SSL_BUNDLE_PATH:
  Web服务器SSL证书 bundle 文件路径，默认无（非SSL必需）。若未提供SSL证书或密钥，此选项忽略。

• WEBSERVER_SSL_BUNDLE:
  Web服务器SSL bundle 内容，可直接设置 bundle 内容（替代文件路径），默认无。若未提供SSL证书或密钥，此选项忽略，优先级高于WEBSERVER_SSL_BUNDLE_PATH。

• LOCAL_BROKER_ENABLED:
  是否启用本地代理 broker，默认为禁用（false）。

• LOCAL_BROKER_PORT:
  本地 broker 端口，默认为1883。

• LOCAL_BROKER_ADDRESS:
  本地 broker 绑定地址，默认为0.0.0.0（绑定所有网络接口）。

• LOCAL_BROKER_USERNAME:
  本地 broker 客户端连接认证用户名，默认无。若未配置用户名和密码，则无需认证。

• LOCAL_BROKER_PASSWORD:
  本地 broker 客户端连接认证密码，默认无。若未配置用户名和密码，则无需认证。

• LOCAL_BROKER_SSL_KEY_PATH:
  本地 broker SSL密钥文件路径，默认无。若提供SSL密钥，必须同时提供SSL证书。

• LOCAL_BROKER_SSL_KEY:
  本地 broker SSL密钥内容，可直接设置密钥内容（替代文件路径），默认无。若提供，必须同时提供SSL证书，优先级高于LOCAL_BROKER_SSL_KEY_PATH。

• LOCAL_BROKER_SSL_CERT_PATH:
  本地 broker SSL证书文件路径，默认无。若提供SSL证书，必须同时提供SSL密钥。

• LOCAL_BROKER_SSL_CERT:
  本地 broker SSL证书内容，可直接设置证书内容（替代文件路径），默认无。若提供，必须同时提供SSL密钥，优先级高于LOCAL_BROKER_SSL_CERT_PATH。

• LOCAL_BROKER_SSL_BUNDLE_PATH:
  本地 broker SSL证书 bundle 文件路径，默认无（非SSL必需）。若未提供SSL证书或密钥，此选项忽略。

• LOCAL_BROKER_SSL_BUNDLE:
  本地 broker SSL bundle 内容，可直接设置 bundle 内容（替代文件路径），默认无。若未提供SSL证书或密钥，此选项忽略，优先级高于LOCAL_BROKER_SSL_BUNDLE_PATH。

• -V, --version:
  输出WEGnology Edge Agent版本。

• -h:
  输出可用命令行选项帮助。