Influxdb2.0文档翻译——InfluxDB安装

Posted 2021-10-13 wzy0623

目录

一、安装InfluxDB

1. macOS

（1）安装InfluxDB v2.0

（2）启动InfluxDB

（3）启用shell补全（可选）

2. Linux

（1）下载并安装InfluxDB v2.0

（2）启动InfluxDB

（3）启用shell补全（可选）

3. Windows

（1）下载并安装InfluxDB v2.0

（2）启动InfluxDB

4. Docker

（1）下载并运行InfluxDB v2.0

（2）在InfluxDB容器外部持久化数据

（3）使用Docker配置InfluxDB

（4）将控制台插入InfluxDB容器中

5. Kubernetes

（1）在Kubernetes群集中安装InfluxDB。

6. Raspberry Pi

（1）Raspberry Pi上的InfluxDB。

二、设置InfluxDB

1. 通过UI设置InfluxDB

2. 通过influx命令行设置InfluxDB

---

原文链接：Install InfluxDB | InfluxDB OSS 2.0 Documentation

        InfluxDB 2.0时间序列平台专门用于收集、存储、处理和可视化度量与事件。下载、安装并设置InfluxDB OSS。

一、安装InfluxDB

1. macOS

（1）安装InfluxDB v2.0

• 使用Homebrew

        我们推荐使用 Homebrew 在macOS上安装InfluxDB v2.0：

brew update
brew install influxdb

• 手工下载并安装

        你也可以直接下载适用于macOS的InfluxDB v2.0二进制文件：InfluxDB v2.0 (macOS)

（可选）验证下载的二进制文件的真实性
        为了增加安全性，请使用 gpg 验证下载的签名。（大多数操作系统默认包含 gpg 命令。如果 gpg 不可用，参阅 GnuPG主页 以获取安装说明。）

1. 下载并导入InfluxData的公钥：

curl -s https://repos.influxdata.com/influxdb2.key | gpg --import -

2. 通过将 .asc 添加到下载URL下载发行版的签名文件。例如：

wget https://dl.influxdata.com/influxdb/releases/influxdb2-2.0.8-darwin-amd64.tar.gz.asc

3. 使用 gpg --verify 验证签名：

gpg --verify influxdb2-2.0.8-darwin-amd64.tar.gz.asc influxdb2-2.0.8-darwin-amd64.tar.gz

        此命令的输出应包括以下内容：

gpg: Good signature from "InfluxData <[e-mail]>" [unknown]

解包InfluxDB二进制文件
        要解压缩下载的归档文件，双击Finder中的归档文件，或在macOS命令提示符应用程序（如Terminal或 iTerm2 ）中运行以下命令：

# Unpackage contents to the current working directory
tar zxvf ~/Downloads/influxdb2-2.0.8-darwin-amd64.tar.gz

（可选）将二进制文件放在$PATH中
        如果你愿意，可以将 influx 和 influxd 放在 $PATH 中，也可以在可执行文件前面加上 ./ 然后就地运行。

# (Optional) Copy the influx and influxd binary to your $PATH
sudo cp influxdb2-2.0.8-darwin-amd64/{influx,influxd} /usr/local/bin/

InfluxDB 1.x和2.x都包括 influx 和 influxd 二进制文件。如果InfluxDB 1.x二进制文件已经在 $PATH 中，请在将其放入 $PATH 之前，就地运行2.0二进制文件或重命名它们。如果重命名二进制文件，则本文档中对 influx 和 influxd 的所有引用都将引用重命名的二进制文件。

网络端口
        默认情况下，InfluxDB使用8086 TCP端口通过 InfluxDB HTTP API 进行客户端-服务器通信。

（2）启动InfluxDB

        通过运行 influxd 守护程序启动InfluxDB：

influxd

在macOS Catalina上运行InfluxDB
macOS Catalina要求下载的二进制文件必须由注册的苹果开发者签名。目前，当你首次尝试运行 influxd 或 influx 时，macOS将阻止其运行。要手动授权InfluxDB二进制文件，执行以下操作：
1. 尝试运行 influx 或 influxd 命令。
2. 打开System Preferences，然后单击Security & Privacy。
3. 在 General 选项卡下，有一条关于 influxd 或 influx 被阻止的消息。点击Open Anyway。
4. 对两个二进制文件重复此过程。

我们正在更新构建过程，以确保发布的二进制文件由InfluxData签名。

“too many open files” 错误
运行 influxd 后，你可能会在日志输出中看到如下错误：

too many open files

要解决此问题，按照 推荐步骤 增加你的操作系统版本的文件和进程限制数，然后重启 influxd 。
有关可用标志和选项的信息，参阅 influxd文档。

（3）启用shell补全（可选）

        安装 influx shell补全脚本，参阅 influx completion 。

InfluxDB “phone home”
默认情况下，InfluxDB将遥测数据发送回InfluxData。InfluxData telemetry 页面提供有关收集哪些数据以及如何使用这些数据的信息。

要选择不将遥测数据发送回InfluxData，在启动 influxd 时包含 --reporting disabled 标志。

influxd --reporting-disabled

2. Linux

（1）下载并安装InfluxDB v2.0

        下载用于Linux的InfluxDB v2.0。InfluxDB v2.0 (amd64) InfluxDB v2.0 (arm)
 

（可选）验证下载的二进制文件的真实性
        为了增加安全性，使用 gpg 验证下载的签名。（大多数操作系统默认包含 gpg 命令。如果 gpg 不可用，参阅 GnuPG主页 以获取安装说明。）

1. 下载并导入InfluxData的公钥：

curl -s https://repos.influxdata.com/influxdb2.key | gpg --import -

2. 通过将 .asc 添加到下载URL下载发行版的签名文件。例如：

wget https://dl.influxdata.com/influxdb/releases/influxdb2-2.0.8-linux-amd64.tar.gz.asc

3. 使用 gpg --verify 验证签名：

gpg --verify influxdb2-2.0.8-linux-amd64.tar.gz.asc influxdb2-2.0.8-linux-amd64.tar.gz

        此命令的输出应包括以下内容：

gpg: Good signature from "InfluxData <[e-mail]>" [unknown]

将可执行文件放在$PATH中
        解压缩下载的归档文件，并将 influx 和 influxd 可执行文件放在系统 $PATH 中。注意：以下命令是示例。根据自己的需要调整文件名、路径和应用程序。

# Unpackage contents to the current working directory
tar xvzf path/to/influxdb2-2.0.8-linux-amd64.tar.gz

# Copy the influx and influxd binary to your $PATH
sudo cp influxdb2-2.0.8-linux-amd64/{influx,influxd} /usr/local/bin/

InfluxDB 1.x和2.x都包括 influx 和 influxd 二进制文件。如果InfluxDB 1.x二进制文件已经在 $PATH 中，请在将其放入 $PATH 之前，就地运行2.0二进制文件或重命名它们。如果重命名二进制文件，则本文档中对 influx 和 influxd 的所有引用都将引用重命名的二进制文件。将InfluxDB作为服务安装到systemd中
1. 使用以下命令，从 InfluxData下载页面 中的URL下载并安装相应的 .deb 或 .rpm 文件：

# Ubuntu/Debian
wget https://dl.influxdata.com/influxdb/releases/influxdb2-2.x.x-xxx.deb
sudo dpkg -i influxdb2_2.x.x_xxx.deb

# Red Hat/CentOS/Fedora
wget https://dl.influxdata.com/influxdb/releases/influxdb2-2.x.x-xxx.rpm
sudo yum localinstall influxdb2_2.x.x_xxx.deb.rpm

使用 .rpm 下载包的确切文件名（例如， influxdb2-2.0.3-amd64.rpm ）。

2. 启动InfluxDB服务

sudo service influxdb start

        安装InfluxDB包将在 /lib/systemd/services/InfluxDB.service 目录下创建一个服务文件，以便在启动时将InfluxDB作为后台服务启动。

3. 重新启动系统并验证服务是否正常运行：

$  sudo service influxdb status
● influxdb.service - InfluxDB is an open-source, distributed, time series database
  Loaded: loaded (/lib/systemd/system/influxdb.service; enabled; vendor preset: enable>
  Active: active (running)

        作为服务安装时，InfluxDB将数据存储在以下位置：

• 时间序列数据： /var/lib/xdb/engine/ 
• 键值数据： /var/lib/influxdb/influxd.bolt 。
• influx命令行配置： ~/.influxdbv2/configs （更多信息参阅 influx config ）。

        要自定义InfluxDB配置，使用 命令行标志（参数）、环境变量或InfluxDB配置文件。更多信息参阅InfluxDB configuration options 。

向systemd传递参数
1. 在 /etc/default/influxdb2 文件中添加如下所示的一行或多行，其中包含 influxd 的参数：

ARG1="--http-bind-address :8087"
ARG2="<another argument here>"

2. 编辑 /lib/systemd/system/influxdb.service 文件如下：

ExecStart=/usr/bin/influxd $ARG1 $ARG2

网络端口
        默认情况下，InfluxDB使用TCP端口 8086 通过 InfluxDB HTTP API 进行客户端-服务器通信。

（2）启动InfluxDB

        通过运行 influxd 守护程序启动InfluxDB：

influxd

        有关可用标志和选项的信息，参阅  influxd 文档 。

（3）启用shell补全（可选）

        安装 influx shell补全脚本，参阅 influx completion 。

InfluxDB “phone home”
默认情况下，InfluxDB将遥测数据发送回InfluxData。 InfluxData telemetry  页面提供有关收集哪些数据以及如何使用这些数据的信息。

要选择不将遥测数据发送回InfluxData，在启动 influxd 时包含 --reporting disabled 标志。

influxd --reporting-disabled

3. Windows

系统要求

• Windows 10
• 64位AMD架构
•  Powershell 或用于Linux的 Windows子系统（WSL）

命令行示例
使用 Powershell 或 WSL 执行 influx 和 influxd 命令。本文档中的命令行示例使用 influx 和 influxd ，就像安装在系统 PATH 上一样。如果 PATH 上未安装这些二进制文件，将所供示例中的 influx 和 influxd 分别替换为 ./influx 和 ./influxd 。
 

（1）下载并安装InfluxDB v2.0

        下载用于Windows的InfluxDB v2.0。 InfluxDB v2.0 (Windows) 

        将下载的归档文件解压到 C:\\Program Files\\InfluxData\\ 中，并根据需要重命名它。

> Expand-Archive .\\influxdb2-2.0.8-windows-amd64.zip -DestinationPath 'C:\\Program Files\\InfluxData\\'
> mv 'C:\\Program Files\\InfluxData\\influxdb2-2.0.8-windows-amd64' 'C:\\Program Files\\InfluxData\\influxdb'

网络端口
        默认情况下，InfluxDB使用TCP端口8086通过 InfluxDB HTTP API 进行客户端-服务器通信。

（2）启动InfluxDB

        在 Powershell 中，定位到 C:\\Program Files\\InfluxData\\influxdb 并通过运行 influxd 守护程序启动influxdb：

> cd -Path 'C:\\Program Files\\InfluxData\\influxdb'
> ./influxd

        有关可用标志和选项的信息，请参阅 influxd 文档 。

授予网络访问权
首次启动InfluxDB时，Windows Defender 将显示以下消息：
Windows Defender Firewall has blocked some features of this app.

1. 选择 Private networks ，例如我的家庭或工作网络。
2. 单击 Allow access。

InfluxDB “phone home”
默认情况下，InfluxDB将遥测数据发送回InfluxData。 InfluxData telemetry 页面提供有关收集哪些数据以及如何使用这些数据的信息。

要选择不将遥测数据发送回InfluxData，在启动 influxd 时包含 --reporting disabled 标志。

./influxd --reporting-disabled

4. Docker

（1）下载并运行InfluxDB v2.0

        使用 docker run 下载并运行InfluxDB v2.0 docker映像。暴露端口 8086 ，InfluxDB使用该端口通过 InfluxDB HTTP API 进行客户端-服务器通信。

docker run --name influxdb -p 8086:8086 influxdb:2.0.8

        要在 分离模式 下运行InfluxDB，请在 docker run 命令中包含 -d 标志。

（2）在InfluxDB容器外部持久化数据

1. 创建一个新目录以存储数据并进到该目录。

mkdir path/to/influxdb-docker-data-volume && cd $_

2. 在新目录中，运行带有 --volume 标志的InfluxDB Docker容器，将容器中 /var/lib/influxdb2 的数据持久化到主机文件系统中的当前工作目录。

docker run \\
    --name influxdb \\
    -p 8086:8086 \\
    --volume $PWD:/var/lib/influxdb2 \\
    influxdb:2.0.8

（3）使用Docker配置InfluxDB

        要装载InfluxDB配置文件并从Docker中使用它，执行以下操作：
1. 在InfluxDB容器外部持久化数据
2. 使用以下命令在主机文件系统上生成默认配置文件：

docker run \\
  --rm influxdb:2.0.8 \\
  influxd print-config > config.yml

3. 修改默认配置，该配置现在在 $PWD 下可用。
4. 启动InfluxDB容器：

docker run -p 8086:8086 \\
  -v $PWD/config.yml:/etc/influxdb2/config.yml \\
  influxdb:2.0.8

（在 此处 查找有关配置InfluxDB的更多信息。）

（4）将控制台插入InfluxDB容器中

        要使用 influx 命令行界面，请将控制台插入 influxdb  Docker容器：

docker exec -it influxdb /bin/bash

InfluxDB “phone home”
默认情况下，InfluxDB将遥测数据发送回InfluxData。 InfluxData telemetry 页面提供有关收集哪些数据以及如何使用这些数据的信息。

要选择不将遥测数据发送回InfluxData，在启动influxd容器时包含 --reporting disabled 标志。

docker run -p 8086:8086 influxdb:2.0.8 --reporting-disabled

5. Kubernetes

（1）在Kubernetes群集中安装InfluxDB。

        下面的说明使用 minikube 或 kind ，但在任何Kubernetes集群中的步骤都应该类似。InfluxData还提供 Helm charts 。1. 安装 minikube 或 kind 。
2. 启动本地群集：

# with minikube
minikube start

# with kind
kind create cluster

3. 通过运行以下命令应用 InfluxDB配置示例 ：

kubectl apply -f https://raw.githubusercontent.com/influxdata/docs-v2/master/static/downloads/influxdb-k8-minikube.yaml

在运行 kubectl apply -f <url> 之前，请务必检查YAML manifests！

        这将创建“influxdb”命名空间、服务和状态集。还创建了一个PersistentVolumeClaim来存储写入InfluxDB的数据。

1. 确保Pod正在运行：

kubectl get pods -n influxdb

2. 确保服务可用：

kubectl describe service -n influxdb influxdb

应该在命令输出中的端点后看到IP地址。

3. 将端口8086从群集转发到本地主机：

kubectl port-forward -n influxdb service/influxdb 8086:8086

6. Raspberry Pi

（1）Raspberry Pi上的InfluxDB。

要求
        在Raspberry Pi上运行InfluxDB，需要：

• Raspberry Pi 4+或400
• 64位操作系统。我们建议安装 64位版本的Ubuntu 桌面或与64位Raspberry Pi兼容的Ubuntu服务器。

安装
        按照 Linux安装说明 在Raspberry Pi上安装InfluxDB。
        使用 Raspberry Pi模板 可以轻松配置Raspberry Pi的收集和可视化系统度量。

支持32位系统
        如果有32位Raspberry Pi， 使用Telegraf 收集数据并发送至：

• 在64位系统上运行的 InfluxDB OSS
• 使用 免费级 帐户的InfluxDB云
• 在InfluxDB云中 使用基于 付费的帐户，并放宽资源限制。

二、设置InfluxDB

        InfluxDB的初始设置过程包括创建默认组织、用户、桶和操作员API令牌。设置过程在InfluxDB用户界面（UI）和 influx 命令行界面（CLI）中都可用。

操作员令牌权限

在InfluxDB设置过程中创建的操作员令牌具有对数据库中所有组织的完全读写访问权限。为了防止跨组织的意外交互，我们建议为每个组织 创建一个All访问令牌 ，并使用这些令牌来管理InfluxDB。

1. 通过UI设置InfluxDB

1. 在InfluxDB运行时，访问localhost:8086。
2. 单击“Get Started”

设置你的初始用户
1. 输入初始用户的用户名。
2. 输入并确认用户密码。
3. 输入初始组织名。
4. 输入初始桶名。
5. 点击Continue。

        InfluxDB现在使用主用户、组织和桶进行初始化。你已准备好 写入或收集数据 。

（可选）设置并使用influx命令行
        如果通过UI设置InfluxDB并希望使用 influx  命令行 ，建议设置配置文件。这样可以避免在每个 influx 命令中传递InfluxDB API令牌 。完成以下步骤以设置存储凭据的配置文件。

1. 在终端中运行以下命令：

# Set up a configuration profile
influx config create -n default \\
  -u http://localhost:8086 \\
  -o example-org \\
  -t mySuP3rS3cr3tT0keN \\
  -a

        这将配置一个名为 default 的新配置文件，并使该配置文件处于活动状态，以便针在该实例中运行 influx  CLI命令。有关更多详细信息，请参见 influx config 。

2. 学习 influx  CLI命令。查看所有可用的 influx 命令，键入 influx -h 或查看 influx - InfluxDB command line interface 。

2. 通过influx命令行设置InfluxDB

        通过 influx 命令行运行以下命令，开始InfluxDB设置过程：

influx setup

1. 输入主用户名。
2. 输入用户密码。
3. 再次输入以确认密码。
4. 输入主组织名。
5. 输入主桶名。
6. 输入主桶的保留期，有效单位为纳秒（ns）、微秒（us或µs）、毫秒（ms）、秒（s）、分钟（m）、小时（h）、天（d）和周（w）。无限保留期则不输入任何内容。
7. 确认主用户、组织和桶的详细信息。

        InfluxDB现在使用主用户、组织、桶和API令牌初始化。InfluxDB还为你创建一个配置概要文件，这样就不必为每个命令添加组织和令牌。要查看该配置文件，使用 influx config list 命令。

        要继续通过命令行使用InfluxDB，需要在安装过程中创建API令牌。要查看令牌，使用上面创建的凭据登录到UI。（有关说明参阅 View tokens in the InfluxDB UI 。）

        你已准备好 写入或收集数据 。

要自动化安装过程，请使用 标志 提供的所需信息。

安装InfluxDB后，就可以 开始使用InfluxDB中的数据 了。