设置先决条件

InfluxDB Clustered 需要以下先决条件的外部依赖项

• kubectl 命令行工具
• Kubernetes 集群
• kubecfg kubit operator
• Kubernetes Ingress 控制器
• 对象存储：AWS S3 或 S3 兼容存储（包括 Google Cloud Storage 或 Azure Blob Storage），用于存储 InfluxDB Parquet 文件。
• PostgreSQL 兼容数据库（AWS Aurora，托管 PostgreSQL 等）：存储 InfluxDB Catalog。
• 本地或附加存储：存储 InfluxDB Ingesters 的预写日志 (WAL)。

以下步骤将引导您完成准备这些先决条件的过程。

• 安装 kubectl
• 设置您的 Kubernetes 集群
• 安装 kubecfg kubit operator
• 设置 Kubernetes Ingress 控制器
• 设置您的对象存储
• 设置您的 PostgreSQL 兼容数据库
• 设置本地或附加存储

安装 kubectl

Kubernetes 提供了 kubectl 命令行工具，用于与 Kubernetes 集群的控制平面进行通信。kubectl 用于管理您的 InfluxDB 集群。

按照说明在本地计算机上安装 kubectl

• 在 Linux 上安装 kubectl
• 在 macOS 上安装 kubectl
• 在 Windows 上安装 kubectl

设置您的 Kubernetes 集群

1. 部署 Kubernetes 集群。部署过程取决于您的 Kubernetes 环境或 Kubernetes 云提供商。请参阅 Kubernetes 文档或您的云提供商的文档，以获取有关部署 Kubernetes 集群的信息。

2. 确保 kubectl 可以连接到您的 Kubernetes 集群。您的管理 kubeconfig 文件定义了集群连接凭据。

3. 创建两个命名空间 – influxdb 和 kubit。使用 kubectl create namespace 创建命名空间

   kubectl create namespace influxdb && \
   kubectl create namespace kubit
   

4. 在集群中安装 Ingress 控制器 和获取有效 TLS 证书的机制（例如：cert-manager）或手动带外提供证书 PEM。要使用 InfluxDB 特定的 Ingress 控制器，请安装 Ingress NGINX。

5. 确保您的 Kubernetes 集群可以访问 InfluxDB 容器注册表，或者，如果在 air-gapped 环境中运行，则可以访问您可以在其中复制 InfluxDB 镜像的本地容器注册表。

集群规模建议

作为生产工作负载的起点，InfluxData 建议 InfluxDB Clustered 组件采用以下规模

您的规模可能需要根据您的环境、云提供商和工作负载而有所不同，但这对于您的初始测试来说是一个合理的起始规模。

安装 kubecfg kubit operator

kubecfg kubit operator（由 InfluxData 维护）简化了 InfluxDB Clustered 包的安装和管理。它管理用于安装、管理和更新 InfluxDB 集群的 jsonnet 模板的应用。

使用 kubectl 安装 kubecfg kubit operator v0.0.18 或更高版本。

kubectl apply -k 'https://github.com/kubecfg/kubit//kustomize/global?ref=v0.0.19'

设置 Kubernetes Ingress 控制器

Kubernetes ingress 将 HTTP/S 请求路由到集群内的服务，并且需要部署 ingress controller。您可以提供自己的 ingress，也可以安装 Nginx Ingress Controller 以使用 InfluxDB 定义的 ingress。

设置您的对象存储

InfluxDB Clustered 支持 AWS S3 或 S3 兼容存储（包括 Google Cloud Storage、Azure Blob Storage 和 MinIO），用于存储 InfluxDB Parquet 文件。请参阅您的对象存储提供商的文档，以获取有关设置对象存储的信息

• 创建 AWS S3 存储桶
• 创建 Google Cloud Storage 存储桶
• 创建 Azure Blob Storage 容器
• 创建 MinIO 存储桶

配置对象存储权限

确保您用于连接到 S3 兼容对象存储的身份具有正确的权限，以允许 InfluxDB 执行所需的所有操作。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "s3:PutObjectAcl",
                "s3:PutObject",
                "s3:ListMultipartUploadParts",
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:DeleteObject",
                "s3:AbortMultipartUpload"
            ],
            "Resource": "arn:aws:s3:::
S3_BUCKET_NAME
/*",
        },
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource": "arn:aws:s3:::
S3_BUCKET_NAME
",
        },
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "*",
        }
    ]
}

gcloud storage buckets add-iam-policy-binding \
    gs://
GCP_BUCKET
 \
    --member="serviceAccount:
GCP_SERVICE_ACCOUNT
" \
    --role="roles/storage.objectUser"

az role assignment create \
    --role "Storage Blob Data Contributor" \
    --assignee 
PRINCIPAL
 \
    --scope "/subscriptions/
AZURE_SUBSCRIPTION
/resourceGroups/
AZURE_RESOURCE_GROUP
/providers/Microsoft.Storage/storageAccounts/
AZURE_STORAGE_ACCOUNT
/blobServices/default/containers/
AZURE_STORAGE_CONTAINER
"

设置您的 PostgreSQL 兼容数据库

InfluxDB Catalog 存储与您的时间序列数据相关的元数据，需要 PostgreSQL 或 PostgreSQL 兼容数据库（AWS Aurora，托管 PostgreSQL 等）。安装和设置 PostgreSQL 兼容数据库的过程取决于您使用的数据库和数据库提供商。请参阅您的数据库或提供商的文档，以了解如何设置 PostgreSQL 兼容数据库。

PostgreSQL 兼容数据库要求

• PostgreSQL 版本13 或 14。
• 至少 4 GB 内存或等效的提供商特定单元。
• 为避免冲突并防止与其他应用程序共享使用导致的问题，请确保您的 PostgreSQL 兼容实例专用于 InfluxDB。

设置本地或附加存储

InfluxDB Ingester 需要本地或附加存储来存储预写日志 (WAL)。附加存储的读取和写入速度会影响 Ingester 的写入性能，因此存储设备速度越快，您的写入性能就越好。建议的本地存储最小大小为 2 gibibytes (2Gi)。

本地或附加存储的安装和设置取决于您的底层硬件或云提供商。请参阅您的提供商的文档，以获取有关安装和配置本地存储的信息。