Skip to main content
版本：v1.2.0

使用 Docker 快速入门 EventMesh（暂时只支持到1.4.0版本）

本篇快速入门将详细介绍使用 docker 部署 EventMesh，以 RocketMQ 作为对接的中间件。

1. 前提​

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

2. 获取 EventMesh 镜像​

首先，你可以打开一个命令行，并且使用下面的 pull 命令从 Docker Hub 中下载最新发布的 EventMesh 。

sudo docker pull eventmesh/eventmesh:v1.4.0

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

sudo docker images

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

$ sudo docker images
REPOSITORY            TAG       IMAGE ID       CREATED         SIZE
eventmesh/eventmesh   v1.4.0    6e2964599c78   16 months ago   937MB

3. 创建配置文件​

在根据 EventMesh 镜像运行对应容器之前，你需要创建两个配置文件，分别是：eventMesh.properties 和 rocketmq-client.properties。

首先，你需要使用下面的命令创建这两个文件。

sudo mkdir -p /data/eventmesh/rocketmq/conf
cd /data/eventmesh/rocketmq/conf
sudo touch eventmesh.properties
sudo touch rocketmq-client.properties

4. 配置 eventMesh.properties​

这个配置文件中包含 EventMesh 运行时环境和集成进来的其他插件所需的参数。

使用下面的 vim 命令编辑 eventmesh.properties。

sudo vim eventmesh.properties

你可以直接将 GitHub 仓库中的对应配置文件中的内容复制过来，链接为：https://github.com/apache/eventmesh/blob/1.3.0/eventmesh-runtime/conf/eventmesh.properties 。

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

属性默认值备注
eventMesh.server.http.port10105EventMesh http server port
eventMesh.server.tcp.port10000EventMesh tcp server port
eventMesh.server.grpc.port10205EventMesh grpc server port

5. 配置 rocketmq-client.properties​

这个配置文件中包含 RocketMQ nameserver 的信息。

使用下面的 vim 命令编辑 rocketmq-client.properties。

sudo vim rocketmq-client.properties

你可以直接将 GitHub 仓库中的对应配置文件中的内容复制过来，链接为：https://github.com/apache/eventmesh/blob/1.3.0/eventmesh-runtime/conf/rocketmq-client.properties 。请注意，如果您正在运行的 namesetver 地址不是配置文件中的默认值，请将其修改为实际正在运行的nameserver地址。

请检查配置文件里的默认namesrvAddr是否已被占用，如果被占用请修改成未被占用的地址：

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

6. 运行 EventMesh​

现在你就可以开始根据下载好的 EventMesh 镜像运行容器了。

使用到的命令是 docker run，有以下两点内容需要格外注意。

  1. 绑定容器端口和宿主机端口：使用 docker run 的 -p 选项。
  2. 将宿主机中的两份配置文件挂在到容器中：使用 docker run 的 -v 选项。

综合一下，对应的启动命令为：

sudo docker run -d \
    -p 10000:10000 -p 10105:10105 \
    -v /data/eventmesh/rocketmq/conf/eventMesh.properties:/data/app/eventmesh/conf/eventMesh.properties \
    -v /data/eventmesh/rocketmq/conf/rocketmq-client.properties:/data/app/eventmesh/conf/rocketmq-client.properties \
    eventmesh/eventmesh:v1.4.0

如果运行命令之后看到新输出一行字符串，那么运行 EventMesh 镜像的容器就启动成功了。

接下来，你可以使用下面的命令查看容器的状态。

sudo docker ps

如果成功的话，你会看到终端打印出了如下所示容器的信息，其中就有运行 EventMesh 镜像的容器。

CONTAINER ID   IMAGE                        COMMAND                  CREATED         STATUS         PORTS                                                                                          NAMES
5bb6b6092672   eventmesh/eventmesh:v1.4.0   "/bin/sh -c 'sh star…"   5 seconds ago   Up 3 seconds   0.0.0.0:10000->10000/tcp, :::10000->10000/tcp, 0.0.0.0:10105->10105/tcp, :::10105->10105/tcp   eager_driscoll

从这个信息中可以看出，container id 是 5bb6b6092672，name 是 eager_driscoll，它们都可以用来唯一标识这个容器。注意：在你的电脑中，它们的值可能跟这里的不同。

7. 管理 EventMesh 容器​

在成功的运行了 EventMesh 容器后，你可以通过进入容器、查看日志、删除容器等方式管理容器。

进入容器 命令示例：

sudo docker exec -it [your container id or name] /bin/bash

在容器中 查看日志 命令示例：

cd ../logs
tail -f eventmesh.out

删除容器 命令示例:

sudo docker rm -f [your container id or name]

8. 探索更多​

现在 EventMesh 已经通过容器运行了，你可以参考 eventmesh-examples 模块 编写并测试自己的代码了。

希望你享受这个过程并获得更多收获！