Zeebe Docs翻译：1. 2 安装

该页面指导您完成出于开发目的的Zeebe代理的初始安装。如果您正在寻找有关如何设置和操作Zeebe的更多详细信息，请确保还查阅《操作指南》。

有多种安装Zeebe的方法：

• 下载发行版
  
• 使用Docker（推荐）

使用Docker

尝试Zeebe的最简单方法是使用Docker。使用Docker可为您提供一致的环境，我们建议将其用于开发。

先决条件

• 操作系统：
  • 的Linux
  • Windows / MacOS（仅开发版本，不支持生产）
• 码头工人

用于docker-compose的Docker配置

尝试Zeebe的最简单方法是使用官方的docker-compose存储库。这使您可以使用单个命令启动复杂的配置，并在准备深入到该级别时了解如何配置它们的详细信息。

zeebe-docker-composit存储库docker-compose中提供了使用，可选地通过Operate和Simple Monitor 启动单个Zeebe代理的Docker配置。有关使用这些配置的更多说明，请参见该存储库中的README.md。

在没有docker-compose的情况下使用Docker

您可以在Docker上运行Zeebe：

docker run --name zeebe -p 26500:26500 camunda/zeebe:latest

裸露端口

• 26500：Gateway API
• 26501：Command API（gateway-to-broker）
• 26502：Internal API（broker-to-broker）

卷

默认数据卷为/usr/local/zeebe/data。它包含所有应保留的数据。

组态

Zeebe配置位于/usr/local/zeebe/conf/zeebe.cfg.toml。日志记录配置位于/usr/local/zeebe/conf/log4j2.xml。

泊坞窗映像的配置也可以通过使用环境变量进行更改。

可用的环境变量：

• ZEEBE_LOG_LEVEL：设置Zeebe Logger的日志级别（默认值：）info。
• ZEEBE_HOST：设置要绑定的主机地址，而不是容器的IP。
• BOOTSTRAP：设置internal-system分区的复制因子。
• ZEEBE_CONTACT_POINTS：设置集群设置中其他代理的联系点。
• DEPLOY_ON_KUBERNETES：如果设置为true，它将应用一些配置更改，以便在Kubernetes环境中运行Zeebe。

Mac和Windows用户

注意：在使用VM运行Docker容器（如Mac和Windows）的系统上，VM至少需要4GB内存，否则Zeebe可能无法启动，并显示类似以下错误：

Exception in thread "actor-runner-service-container" java.lang.OutOfMemoryError: Direct buffer memory
        at java.nio.Bits.reserveMemory(Bits.java:694)
        at java.nio.DirectByteBuffer.<init>(DirectByteBuffer.java:123)
        at java.nio.ByteBuffer.allocateDirect(ByteBuffer.java:311)
        at io.zeebe.util.allocation.DirectBufferAllocator.allocate(DirectBufferAllocator.java:28)
        at io.zeebe.util.allocation.BufferAllocators.allocateDirect(BufferAllocators.java:26)
        at io.zeebe.dispatcher.DispatcherBuilder.initAllocatedBuffer(DispatcherBuilder.java:266)
        at io.zeebe.dispatcher.DispatcherBuilder.build(DispatcherBuilder.java:198)
        at io.zeebe.broker.services.DispatcherService.start(DispatcherService.java:61)
        at io.zeebe.servicecontainer.impl.ServiceController$InvokeStartState.doWork(ServiceController.java:269)
        at io.zeebe.servicecontainer.impl.ServiceController.doWork(ServiceController.java:138)
        at io.zeebe.servicecontainer.impl.ServiceContainerImpl.doWork(ServiceContainerImpl.java:110)
        at io.zeebe.util.actor.ActorRunner.tryRunActor(ActorRunner.java:165)
        at io.zeebe.util.actor.ActorRunner.runActor(ActorRunner.java:145)
        at io.zeebe.util.actor.ActorRunner.doWork(ActorRunner.java:114)
        at io.zeebe.util.actor.ActorRunner.run(ActorRunner.java:71)
        at java.lang.Thread.run(Thread.java:748)

如果将Docker与默认Moby VM配合使用，则可以通过Docker首选项调整VM可用的内存量。右键单击系统任务栏中的Docker图标以访问首选项。

如果您将Docker设置与一起使用，docker-machine并且您的defaultVM没有4GB内存，则可以使用以下命令创建一个新的内存：

docker-machine create --driver virtualbox --virtualbox-memory 4000 zeebe

验证Docker Machine是否正常运行：

docker-machine ls

NAME        ACTIVE   DRIVER       STATE     URL                         SWARM   DOCKER        ERRORS
zeebe     *        virtualbox   Running   tcp://192.168.99.100:2376           v17.03.1-ce

配置您的终端：

eval $(docker-machine env zeebe)

然后运行Zeebe：

docker run --rm -p 26500:26500 camunda/zeebe:latest

要获取Zeebe的IP：

docker-machine ip zeebe

192.168.99.100

验证您可以连接到Zeebe：

telnet 192.168.99.100 26500

下载发行版

您始终可以从Github发布页面下载最新的Zeebe版本。

先决条件

• 操作系统：
  • 的Linux
  • Windows / MacOS（仅开发版本，不支持生产）
• Java虚拟机：
  • Oracle Hotspot v1.8
  • 开启JDK v1.8

下载发行版后，将其解压缩到您选择的文件夹中。要提取Zeebe发行版并启动代理，Linux用户可以输入：

tar -xzf zeebe-distribution-X.Y.Z.tar.gz -C zeebe/
./bin/broker

Windows用户可以下载.zip软件包并使用他们喜欢的解压缩工具将其解压缩。然后，他们可以打开提取的文件夹，导航到该bin文件夹，然后通过双击该broker.bat文件来启动代理。

Zeebe经纪人启动后，将产生以下输出：

23:39:13.167 [] [main] INFO  io.zeebe.util.config - Reading configuration for class class io.zeebe.broker.system.configuration.BrokerCfg from file conf/zeebe.cfg.toml
23:39:13.246 [] [main] INFO  io.zeebe.broker.system - Scheduler configuration: Threads{cpu-bound: 2, io-bound: 2}.
23:39:13.270 [] [main] INFO  io.zeebe.broker.system - Version: X.Y.Z
23:39:13.273 [] [main] INFO  io.zeebe.broker.system - Starting broker with configuration {