设置 InfluxDB Clustered

当您开始学习本教程时，请执行以下操作以确保一切就绪。

• 安装并配置您的 InfluxDB 集群
• 下载、安装和配置 influxctl CLI
• 创建数据库
• 创建数据库令牌
• 配置身份验证凭据

安装并配置您的 InfluxDB 集群

按照 安装 InfluxDB Clustered 指南安装先决条件并设置您的集群。

下载、安装和配置 influxctl CLI

influxctl CLI 允许您从命令行管理您的 InfluxDB 集群，并执行管理任务，例如管理数据库和令牌。

1. 下载并安装 influxctl CLI.

2. 创建一个连接配置文件并提供您的 InfluxDB Clustered 连接凭据.

   influxctl CLI 使用 连接配置文件 连接到您的 InfluxDB 集群并进行身份验证。

   根据您的操作系统，在以下位置创建一个名为 config.toml 的文件。

   操作系统	默认配置文件路径
   Linux	~/.config/influxctl/config.toml
   macOS	~/Library/Application Support/influxctl/config.toml
   Windows	%APPDATA%\influxctl\config.toml

   如果存储在非默认位置，请在每个 influxctl 命令中包含 --config 标志，并提供指向您的配置文件路径。

3. 复制并粘贴示例配置配置文件代码 到您的 config.toml 中

[[profile]]
  name = "default"
  product = "clustered"
  host = "cluster-host.com"
  port = "
PORT
"

[profile.auth.oauth2]
  client_id = "
OAUTH_CLIENT_ID
"
  scopes = [""]
  token_url = "
OAUTH_TOKEN_URL
"
  device_url = "
OAUTH_DEVICE_URL
"

将以下内容替换为您的 InfluxDB Clustered 凭据

• PORT：用于访问您的 InfluxDB 集群的端口
• OAUTH_CLIENT_ID：您的 OAuth2 提供商的客户端 URL（例如：https://identityprovider/oauth2/v2/token）
• OAUTH_DEVICE_ID：您的 OAuth2 提供商的设备 URL（例如：https://identityprovider/oauth2/v2/auth/device）

有关 influxctl 配置文件的详细信息，请参阅 配置连接配置文件.

创建数据库

使用 influxctl database create 命令 创建一个数据库。您可以使用现有数据库，也可以专门为此入门教程创建一个新数据库。本入门教程中的示例假设数据库名为 get-started。

提供以下信息

• 数据库名称。
• 可选： 数据库 保留期 作为持续时间值。如果未指定保留期，则默认值为无限。

influxctl database create --retention-period 
1y
 
get-started

创建数据库令牌

使用 influxctl token create 命令 为您的数据库创建一个具有读取和写入权限的数据库令牌。

提供以下信息

• 权限授予
  • --read-database：授予对数据库的读取权限
  • --write-database 授予对数据库的写入权限
• 令牌描述

influxctl token create \
  --read-database 
get-started
 \
  --write-database 
get-started
 \
  "Read/write token for 
get-started
 database"

该命令返回令牌 ID 和令牌字符串。将令牌字符串存储在安全的地方。您稍后会需要它。这是令牌字符串以纯文本形式提供的唯一一次。

配置身份验证凭据

后续章节中的代码示例假设您已将令牌字符串分配给 INFLUX_TOKEN 环境变量——例如

export INFLUX_TOKEN=
DATABASE_TOKEN

$env:INFLUX_TOKEN = "
DATABASE_TOKEN
"

set INFLUX_TOKEN=
DATABASE_TOKEN
 
# Make sure to include a space character at the end of this command.

将 DATABASE_TOKEN 替换为您的 数据库令牌 字符串。