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

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

可选语言: 英文版本中文版本

前提

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

获取 EventMesh 镜像

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

  1. sudo docker pull eventmesh/eventmesh:v1.4.0

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

  1. sudo docker images

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

  1. REPOSITORY TAG IMAGE ID CREATED SIZE
  2. eventmesh/eventmesh v1.4.0 6e2964599c78 3 months ago 936.73 MB

创建配置文件

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

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

  1. sudo mkdir -p /data/eventmesh/rocketmq/conf
  2. cd /data/eventmesh/rocketmq/conf
  3. sudo touch eventmesh.properties
  4. sudo touch rocketmq-client.properties

配置 eventMesh.properties

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

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

  1. sudo vim eventmesh.properties

你可以直接将 GitHub 仓库中的对应配置文件中的内容复制过来,链接为:https://github.com/apache/incubator-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

配置 rocketmq-client.properties

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

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

  1. sudo vim rocketmq-client.properties

你可以直接将 GitHub 仓库中的对应配置文件中的内容复制过来,链接为:https://github.com/apache/incubator-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

运行 EventMesh

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

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

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

综合一下,对应的启动命令为:

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

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

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

  1. sudo docker ps

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

  1. CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
  2. d1e1a335d4a9 eventmesh/eventmesh:v1.4.0 "/bin/sh -c 'sh star…" About a minute ago Up About a minute 0.0.0.0:10000->10000/tcp, :::10000->10000/tcp, 0.0.0.0:10105->10105/tcp, :::10105->10105/tcp focused_bartik

从这个信息中可以看出,container idd1e1a335d4a9namefocused_bartik,它们都可以用来唯一标识这个容器。注意:在你的电脑中,它们的值可能跟这里的不同。

管理 EventMesh 容器

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

进入容器 命令示例:

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

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

  1. cd ../logs
  2. tail -f eventmesh.out

删除容器 命令示例:

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

探索更多

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

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