Skip to main content
版本:Next

EventMesh Runtime Docker 快速开始

您可以使用 Docker 部署 EventMesh Runtime。本文将以 RocketMQ 事件存储为例,您也可以选择其它 EventMesh 支持的事件存储

1. 前提

  1. 建议使用 64 位的 Linux / Unix 系统。
  2. 请预先安装 Docker Engine。Docker 的安装过程可以参考 Docker 官方文档
  3. 建议掌握基础的 Docker 概念和命令行,例如注册中心、挂载等等。不过这不是必须的,因为本次操作所需的命令都已为您列出。
  4. 若您选择非 standalone 模式,请确保 RocketMQ 已成功启动 并且可以使用 IP 地址访问到;若您保持默认的 standalone 模式,则无需启动 RocketMQ。

2. 获取 EventMesh Runtime 镜像

首先,您可以打开一个命令行,并且使用下面的 pull 命令从 Docker Hub 中下载 最新版本的 EventMesh

sudo docker pull apache/eventmesh:latest

您可以使用以下命令列出并查看本地已有的镜像。

sudo docker images

如果终端显示如下所示的镜像信息,则说明 EventMesh 镜像已经成功下载到本地。

$ sudo docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
apache/eventmesh latest f32f9e5e4694 2 days ago 917MB

3. 挂载配置文件

如果您使用 standalone 模式启动 EventMesh Runtime,并且没有自定义配置,可以跳转至下一步骤。

首先,在宿主机上创建 EventMesh 的配置文件目录。此目录可以自由指定:

sudo mkdir -p /data/eventmesh/conf
cd /data/eventmesh/conf

3.1 EventMesh Runtime 配置

此配置文件中包含 EventMesh Runtime 环境和集成的插件的配置。

下载配置文件(替换下载链接中的1.10.0为您正在使用的版本):

sudo wget https://raw.githubusercontent.com/apache/eventmesh/1.10.0-prepare/eventmesh-runtime/conf/eventmesh.properties

编辑 eventmesh.properties

sudo vim eventmesh.properties

指定事件存储为 RocketMQ:

# storage plugin
eventMesh.storage.plugin.type=rocketmq

请检查配置文件里的默认端口是否已被占用,如果被占用,请修改为未被占用的端口:

属性默认值备注
eventMesh.server.tcp.port10000TCP 监听接口
eventMesh.server.http.port10105HTTP 监听接口
eventMesh.server.grpc.port10205gRPC 监听接口
eventMesh.server.admin.http.port10106HTTP 管理接口

3.2 事件存储配置

以 RocketMQ 为例,配置文件中包含连接 RocketMQ namesrv 所需的参数。

下载配置文件(替换下载链接中的1.10.0为您正在使用的版本):

sudo wget https://raw.githubusercontent.com/apache/eventmesh/1.10.0-prepare/eventmesh-storage-plugin/eventmesh-storage-rocketmq/src/main/resources/rocketmq-client.properties

编辑 rocketmq-client.properties

sudo vim rocketmq-client.properties

如果您正在运行的 namesrv 地址不是配置文件中的默认值,请将其修改为实际正在运行的 namesrv 地址。

属性默认值备注
eventMesh.server.rocketmq.namesrvAddr127.0.0.1:9876;127.0.0.1:9876RocketMQ namesrv address

如果您无法使用给出的链接下载配置文件,您可以在 EventMesh 二进制发行版的conf路径下找到所有的配置文件。

4. 运行 EventMesh Runtime 容器

使用以下命令启动 EventMesh 容器:

sudo docker run -d --name eventmesh -p 10000:10000 -p 10105:10105 -p 10205:10205 -p 10106:10106 -v /data/eventmesh/conf/eventmesh.properties:/data/app/eventmesh/conf/eventmesh.properties -v /data/eventmesh/conf/rocketmq-client.properties:/data/app/eventmesh/conf/rocketmq-client.properties -t apache/eventmesh:latest

docker run命令参数介绍:

  • -p <宿主机端口>:<容器端口>:绑定容器端口和宿主机端口。如果您修改过 EventMesh Runtime 配置中的默认端口,或者宿主机的端口已被占用,请相应地修改为您指定的端口。

  • -v <宿主机路径>:<容器路径>:将宿主机中的配置文件挂载到容器中。如果您存放 EventMesh 配置文件的路径不是/data/eventmesh/conf,请修改宿主机路径为您指定的路径。如果您没有自定义配置文件,请删除此参数。

  • --name eventmesh:自定义的容器名称。此名称是唯一的。

  • -t apache/eventmesh:latest:容器使用的镜像。

执行docker run命令后,将会返回容器的 ID。使用此命令查看所有正在运行的容器的状态:

sudo docker ps

将会打印:

CONTAINER ID   IMAGE                      COMMAND               CREATED          STATUS         PORTS                                                                                                                                                                 NAMES
b7a1546ee96a apache/eventmesh:latest "bash bin/start.sh" 10 seconds ago Up 8 seconds 0.0.0.0:10000->10000/tcp, :::10000->10000/tcp, 0.0.0.0:10105-10106->10105-10106/tcp, :::10105-10106->10105-10106/tcp, 0.0.0.0:10205->10205/tcp, :::10205->10205/tcp eventmesh

如果 EventMesh Runtime 容器不在此命令打印的列表中,则代表容器未能成功启动。您可以使用以下命令查看启动时的日志(将eventmesh替换为您指定的容器名称或 ID):

sudo docker logs eventmesh

5. 查看 EventMesh 日志

成功启动 EventMesh 容器后,您可以通过以下步骤查看 EventMesh Runtime 输出的日志,检查 EventMesh 的运行状态。

进入容器(将eventmesh替换为您指定的容器名称或 ID):

sudo docker exec -it eventmesh /bin/bash

查看日志:

cd logs
tail -n 50 -f eventmesh.out

当日志输出server state:RUNNING,则代表 EventMesh Runtime 启动成功了。

6. 构建 EventMesh Runtime 镜像(可选)

EventMesh 基于 JDK8 开发,二进制发行版和容器镜像基于 JDK8 构建。

要在 JDK8 环境下运行容器,请在 EventMesh 源代码的项目根目录下执行:

sudo docker build -t yourname/eventmesh:yourtag -f docker/Dockerfile_jdk8 .

如果您希望以 JDK11 作为容器的运行环境,则执行:

sudo docker build -t yourname/eventmesh:yourtag -f docker/Dockerfile_jdk11 .