tutum/influxdb

DEPRECATED

请参见 [***]

tutum-docker-influxdb

![部署到Tutum]([***]

InfluxDB镜像

使用方法

要创建tutum/influxdb镜像，请在tutum-docker-influxdb文件夹中执行以下命令：

docker build -t tutum/influxdb .

现在可以将新镜像推送到仓库：

docker push tutum/influxdb

标签

• tutum/influxdb:latest -> InfluxDB 0.9.6.1
• tutum/influxdb:0.9 -> InfluxDB 0.9.6.1
• tutum/influxdb:0.8.8 -> InfluxDB 0.8.8

运行InfluxDB镜像

启动镜像时，将外部端口8083和8086绑定到容器的所有接口。端口8090和8099仅用于集群，不应暴露到互联网：

docker run -d -p 8083:8083 -p 8086:8086 tutum/influxdb

Docker容器容易被删除。如果删除容器实例且集群离线，InfluxDB存储和配置将丢失。如果需要持久化保留InfluxDB数据，建议为容器的/data文件夹添加卷映射：

docker run -d --volume=/var/influxdb:/data -p 8083:8083 -p 8086:8086 tutum/influxdb

注意：influxdb:0.9与0.8.x不向后兼容。如果需要0.8.x版本，请运行：

docker run -d -p 8083:8083 -p 8086:8086 tutum/influxdb:0.8.8

配置InfluxDB

打开浏览器访问localhost:8083以配置InfluxDB。填写映射到8086的端口。0.9版本不再有默认用户，但可以在config.toml中设置auth-enabled: true。

或者，可以使用RESTful API通过端口8086与InfluxDB交互。例如，如果在0.9.x版本中创建初始数据库时遇到问题，可以使用新的influx命令行工具配置数据库。容器运行时，通过以下命令启动工具：

docker exec -ti influxdb-container-name /usr/bin/influx
Visit https://enterprise.influxdata.com to register for updates, InfluxDB server management, and monitoring.
Connected to http://localhost:8086 version 0.9.6.1
InfluxDB shell 0.9.6.1
>

初始创建数据库

使用-e PRE_CREATE_DB="db1;db2;db3"可在容器首次启动时自动创建名为"db1"、"db2"和"db3"的数据库。数据库名称之间用;分隔。例如：

docker run -d -p 8083:8083 -p 8086:8086 -e ADMIN_USER="root" -e INFLUXDB_INIT_PWD="somepassword" -e PRE_CREATE_DB="db1;db2;db3" tutum/influxdb:latest

或者，使用InfluxDB 0.9 shell创建数据库和用户：

> CREATE DATABASE db1
> SHOW DATABASES
name: databases
---------------
name
db1
> USE db1
> CREATE USER root WITH PASSWORD 'somepassword' WITH ALL PRIVILEGES
> GRANT ALL PRIVILEGES ON db1 TO root
> SHOW USERS
user  admin
root  true

有关InfluxDB 0.9 shell的其他管理方法，请查看InfluxDB网站上的《管理指南》。

初始执行influxql脚本（仅influxdb:0.9可用）

如果希望容器首次启动时自动执行脚本，可使用-v /tmp/init_script.influxql:init_script.influxql:ro。每个influxql命令单独一行。例如：

• Docker运行命令

docker run -d -p 8083:8083 -p 8086:8086 -e ADMIN_USER="root" -e INFLUXDB_INIT_PWD="somepassword" -v /tmp/init_script.influxql:init_script.influxql:ro tutum/influxdb:latest

• influxdb脚本

CREATE DATABASE mydb
CREATE USER writer WITH PASSWORD 'writerpass'
CREATE USER reader WITH PASSWORD 'readerpass'
GRANT WRITE ON mydb TO writer
GRANT READ ON mydb TO reader

SSL支持（仅influxdb:0.8.8可用）

默认情况下，InfluxDB使用端口8086进行HTTP API。如果要使用SSL API，可将环境变量SSL_SUPPORT设置为true。此时，可在端口8086使用HTTP API，在端口8084使用HTTPS API。如果只想允许HTTPS连接，请不要发布端口8086。

如果提供SSL_CERT，系统将使用用户提供的SSL证书。否则，系统将创建自签名证书，这通常会导致未授权证书错误，不推荐使用。

证书文件应包含私钥和公证书。要将其作为环境变量传递，需将换行符转换为\n（两个字符）。可通过运行命令awk 1 ORS='\\n' <your_cert.pem>实现。例如：

docker run -d -p 8083:8083 -p 8084:8084 -e SSL_SUPPORT="True" -e SSL_CERT="`awk 1 ORS='\\n' ~/cert.pem`" tutum/influxdb:latest

Graphite API支持

InfluxDB有插件支持Graphite Carbon API。可通过以下变量自定义：

• GRAPHITE_DB：graphite插件写入指标的数据库名称
• GRAPHITE_BINDING：默认graphite插件监听:2003，可提供任何ip地址:端口
• GRAPHITE_PROTOCOL：'udp'或'tcp'（默认）
• GRAPHITE_TEMPLATE：默认模板设置为instance.profile.measurement*，用于解析指标并从中创建标签

docker run -d -p 8083:8083 -p 8086:8086 -p 2015:2015 -e ADMIN_USER="root" -e INFLUXDB_INIT_PWD="somepassword" -e PRE_CREATE_DB=my_db -e GRAPHITE_DB="my_db" -e GRAPHITE_BINDING=':2015' -e GRAPHITE_PROTOCOL="udp" -e GRAPHITE_template="tag1.tag2.tag3.measurement*" tutum/influxdb

有关InfluxDB graphite插件配置的更多详细信息，请参见：https://github.com/influxdb/influxdb/blob/master/services/graphite/README.md

Collectd支持

InfluxDB有插件支持collectd网络插件。可通过以下变量自定义：

• COLLECTD_DB：collectd插件写入指标的数据库名称
• COLLECTD_BINDING：默认collectd插件监听:25826，可提供任何ip地址:端口
• COLLECTD_RETENTION_POLICY：自定义保留策略
• types.db：提供collectd 5.5.0版本的默认types.db。如需自定义类型，可添加卷映射/usr/share/collectd/types.db

docker run -d -p 8083:8083 -p 8086:8086 -p 25826:25826/udp -e ADMIN_USER="root" -e INFLUXDB_INIT_PWD="somepassword" -e PRE_CREATE_DB=my_db -e COLLECTD_DB="my_db" -e COLLECTD_BINDING=':25826' -e COLLECTD_RETENTION_POLICY="mypolicy" tutum/influxdb

有关InfluxDB collectd插件配置的更多详细信息，请参见：https://github.com/influxdb/influxdb/blob/master/services/collectd/README.md

UDP支持

如果提供UDP_DB，Influx将打开UDP端口（4444或UDP_PORT指定的端口）以接收指定数据库的事件。

docker run -d -p 8083:8083 -p 8086:8086 -p 4444:4444/udp --expose 8090 --expose 8099 --expose 4444 -e UDP_DB="my_db" tutum/influxdb

集群（influxdb:0.9.4.2-1可用）

bash
#（确保防火墙允许端口8088、8089）
docker run -p 8088:8088 -e FORCE_HOSTNAME=192.168.0.1:8088 -t tutum/influxdb
docker run -p 8089:8088 -e FORCE_HOSTNAME=192.168.0.1:8089 -e JOIN=192.168.0.1:8088 -t tutum/influxdb

集群（influxdb:0.8.8可用）

使用：

• -e SEEDS="host1:8090, host2:8090" 向容器传递种子节点
• -e REPLI_FACTOR=x x是集群中分片的复制因子（默认为1）
• -e FORCE_HOSTNAME="auto" 强制将配置文件中的主机名设置为容器的IPv4 eth0地址（在单个docker主机上测试集群时有用）
• -e FORCE_HOSTNAME="<whatever>" 强制将配置文件中的主机名设置为'whatever'

单个docker主机上的示例：

• 启动第一个容器：

docker run -p 8083:8083 -p 8086:8086 --expose 8090 --expose 8099 \
  -e FORCE_HOSTNAME="auto" -e REPLI_FACTOR=2 \
  -d --name masterinflux tutum/influxdb

• 然后启动一个或多个"从节点"：

docker run --link masterinflux:master -p 8083 -p 8086 --expose 8090 --expose 8099 \
  -e SEEDS="master:8090" -e FORCE_HOSTNAME="auto" \
  -d  tutum/influxdb