注意：这是kapacitor官方镜像的amd64架构构建的“每个架构”仓库——更多信息，请参见官方镜像文档中的“除amd64之外的架构？”[[]]和官方镜像FAQ中的“Git中的镜像源已更改，现在该怎么办？”[[]]。

快速参考

• 维护者：
  InfluxData

• 获取帮助的地方：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的Dockerfile链接

• 1.7, 1.7.7

• 1.7-alpine, 1.7.7-alpine, alpine

• 1.8, 1.8.2, latest

• 1.8-alpine, 1.8.2-alpine

快速参考（续）

• 问题提交地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm64v8

• 已发布镜像工件详情：
  repo-info仓库的repos/kapacitor/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/kapacitor标签
  official-images仓库的library/kapacitor文件（历史记录）

• 本描述的来源：
  docs仓库的kapacitor/目录（历史记录）

Kapacitor

Kapacitor是一个用Go编写的开源数据处理引擎。它可以处理流数据和批处理数据。

Kapacitor官方文档

!logo

使用本镜像

使用默认配置

使用默认选项启动Kapacitor容器：

$ docker run -p 9092:9092 amd64/kapacitor

启动Kapacitor容器并将数据目录与主机共享：

$ docker run -p 9092:9092 \
      -v $PWD:/var/lib/kapacitor \
      amd64/kapacitor

将$PWD修改为您要存储Kapacitor容器相关数据的目录。

您也可以使用命名卷让Docker控制卷挂载点：

$ docker run -p 9092:9092 \
      -v kapacitor:/var/lib/kapacitor \
      amd64/kapacitor

配置

Kapacitor可以通过配置文件或环境变量进行配置。要挂载配置文件并与服务器一起使用，可以使用以下命令：

生成默认配置文件：

$ docker run --rm amd64/kapacitor kapacitord config > kapacitor.conf

修改默认配置文件（现在可在$PWD下找到），然后启动Kapacitor容器：

$ docker run -p 9092:9092 \
      -v $PWD/kapacitor.conf:/etc/kapacitor/kapacitor.conf:ro \
      amd64/kapacitor

将$PWD修改为您要存储配置文件的目录。

对于环境变量，格式为KAPACITOR_$SECTION_$NAME。所有连字符（-）替换为下划线（_）。如果变量不在某个部分中，则省略该部分。如果配置部分是数组，则使用数字设置配置文件中的第n个值。

示例：

KAPACITOR_HOSTNAME=kapacitor
KAPACITOR_LOGGING_LEVEL=INFO
KAPACITOR_REPORTING_ENABLED=false
KAPACITOR_INFLUXDB_0_URLS_0=[***]

有关配置Kapacitor的更多信息，请参见此处

以root用户运行

从v1.7.4开始，Kapacitor默认不再以root用户运行。如果用户希望恢复此行为，可以将KAPACITOR_AS_ROOT=true设置为环境变量。

暴露的端口

• 9092 TCP — HTTP API端点

订阅

订阅允许InfluxDB将数据推送到Kapacitor以实现更快的告警，而不需要Kapacitor从InfluxDB拉取数据。

这些示例假设您正在使用自定义配置文件，该文件利用Docker的内置服务发现功能。为此，我们首先创建一个新网络：

$ docker network create influxdb

接下来，启动名为influxdb的InfluxDB容器：

$ docker run -d --name=influxdb \
      --net=influxdb \
      influxdb

启动Kapacitor容器，容器主机名与容器名称匹配，以便Kapacitor可以正确自动创建订阅，并将KAPACITOR_INFLUXDB_0_URLS_0值设置为指向InfluxDB。

$ docker run -p 9092:9092 \
    --name=kapacitor \
    -h kapacitor \
    --net=influxdb \
    -e KAPACITOR_INFLUXDB_0_URLS_0=[***] \
    amd64/kapacitor

您也可以启动Kapacitor共享InfluxDB容器的相同网络接口。如果这样做，Docker将表现得好像两个进程都在同一台机器上运行。

$ docker run -p 9092:9092 \
      --name=kapacitor \
      --net=container:influxdb \
      amd64/kapacitor

以这种方式运行时，可以通过localhost与InfluxDB通信。

CLI / SHELL

启动容器：

$ docker run --name=kapacitor -d -p 9092:9092 amd64/kapacitor

运行另一个链接到kapacitor容器的容器以使用客户端。设置环境变量KAPACITOR_URL，以便客户端知道如何连接到Kapacitor。挂载当前目录以访问TICKscript文件。

$ docker run --rm --net=container:kapacitor \
      -v $PWD:/root -w=/root -it \
      amd64/kapacitor bash -l

然后，在容器内，您可以使用kapacitor命令与守护进程交互。

有关Kapacitor的更详细入门指南，请参见此处

镜像变体

amd64/kapacitor镜像有多种版本，每种版本都针对特定用例设计。

amd64/kapacitor:<version>

这是默认镜像。如果您不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器使用（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

amd64/kapacitor:<version>-alpine

此镜像基于流行的Alpine Linux项目，可在alpine官方镜像中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是您的主要关注点时，此变体非常有用。需要注意的主要问题是，它使用musl libc而不是glibc及相关库，因此软件可能会因对libc的需求/假设深度而遇到问题。有关可能出现的问题以及使用Alpine-based镜像的优缺点比较，请参见此Hacker News评论线程。

为了最小化镜像大小，Alpine-based镜像中通常不包含其他相关工具（如git或bash）。以此镜像为基础，可在您自己的Dockerfile中添加所需的工具（如果不熟悉如何安装软件包，请参见alpine镜像描述中的示例）。

许可证

查看此镜像中包含的软件的许可证信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证（如基础发行版中的Bash等，以及包含的主要软件的任何直接或间接依赖项）约束。

一些能够自动检测到的其他许可证信息可能位于repo-info仓库的kapacitor/目录中。

至于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。