Skip to main content
版本：v1.0.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 模块 编写并测试自己的代码了。

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