library/kapacitor

快速参考

• 维护者：
  https://github.com/influxdata/influxdata-docker

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

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

• https://github.com/influxdata/influxdata-docker/blob/add887456e0d1657ae822e422bc5cbb2b9b723bc/kapacitor/1.7/Dockerfile

• https://github.com/influxdata/influxdata-docker/blob/add887456e0d1657ae822e422bc5cbb2b9b723bc/kapacitor/1.7/alpine/Dockerfile

• https://github.com/influxdata/influxdata-docker/blob/add887456e0d1657ae822e422bc5cbb2b9b723bc/kapacitor/1.8/Dockerfile

• https://github.com/influxdata/influxdata-docker/blob/add887456e0d1657ae822e422bc5cbb2b9b723bc/kapacitor/1.8/alpine/Dockerfile

快速参考（续）

• 提交 issue 的位置：
  https://github.com/influxdata/influxdata-docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/kapacitor/%E3%80%81https://hub.docker.com/r/arm64v8/kapacitor/

• 已发布镜像制品详情：
  https://github.com/docker-library/repo-info/blob/master/repos/kapacitor%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/kapacitor%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fkapacitor
  https://github.com/docker-library/official-images/blob/master/library/kapacitor%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/kapacitor%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/kapacitor%EF%BC%88https://github.com/docker-library/docs/commits/master/kapacitor%EF%BC%89

Kapacitor

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

Kapacitor 官方文档

!https://raw.githubusercontent.com/docker-library/docs/43d87118415bb75d7bb***e79cd6d69186f67/kapacitor/logo.png

使用此镜像

使用默认配置

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

console
$ docker run -p 9092:9092 kapacitor

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

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

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

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

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

配置

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

生成默认配置文件：

console
$ docker run --rm kapacitor kapacitord config > kapacitor.conf

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

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

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

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

示例：

console
KAPACITOR_HOSTNAME=kapacitor
KAPACITOR_LOGGING_LEVEL=INFO
KAPACITOR_REPORTING_ENABLED=false
KAPACITOR_INFLUXDB_0_URLS_0=http://influxdb:8086

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

以 root 用户运行

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

暴露端口

• 9092 TCP — HTTP API 端点

订阅

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

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

console
$ docker network create influxdb

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

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

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

console
$ docker run -p 9092:9092 \
    --name=kapacitor \
    -h kapacitor \
    --net=influxdb \
    -e KAPACITOR_INFLUXDB_0_URLS_0=http://influxdb:8086 \
    kapacitor

您也可以启动 Kapacitor 使其共享 InfluxDB 容器的网络接口。这样做时，Docker 会将两个进程视为在同一台机器上运行：

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

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

CLI / SHELL

启动容器：

console
$ docker run --name=kapacitor -d -p 9092:9092 kapacitor

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

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

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

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

镜像变体

kapacitor 镜像有多种版本，每种版本设计用于特定用例。

kapacitor:<version>

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

kapacitor:<version>-alpine

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

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

为了最小化镜像大小，基于 Alpine 的镜像中通常不包含其他相关工具（如 git 或 bash）。以此镜像为基础，可在您自己的 Dockerfile 中添加所需内容（如果不熟悉如何安装软件包，请参见 https://hub.docker.com/_/alpine/ 中的示例）。

许可证

查看此镜像中包含的软件的https://github.com/influxdata/kapacitor/blob/master/LICENSE%E3%80%82

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

一些能够自动检测到的其他许可证信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/kapacitor%E4%B8%AD%E3%80%82

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