设置InfluxDB集群

在开始本教程时，请执行以下操作以确保一切准备就绪。

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

安装和配置您的InfluxDB集群

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

下载、安装和配置influxctl CLI

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

1. 下载并安装 influxctl CLI.

2. 创建一个连接配置文件并提供您的InfluxDB集群连接凭证.

   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集群凭证

• 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 替换为您的 数据库令牌 字符串。