设置先决条件

InfluxDB 集群版需要以下先决条件的外部依赖项

• kubectl 命令行工具
• Kubernetes 集群
• kubecfg kubit 操作员
• Kubernetes 入口控制器
• 对象存储：AWS S3 或兼容 S3 的存储（包括 Google Cloud Storage 或 Azure Blob Storage），用于存储 InfluxDB Parquet 文件。
• 兼容 PostgreSQL 的数据库 （AWS Aurora，托管 PostgreSQL 等）：存储 InfluxDB 目录。
• 本地或附加存储：存储 InfluxDB Ingesters 的 Write-Ahead Log（WAL）。

以下将指导您准备这些先决条件。

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

安装 kubectl

Kubernetes 提供了用于与 Kubernetes 集群控制平面通信的 kubectl 命令行工具。 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 容器仓库，或者，如果您在一个隔离环境中运行，一个可以从中复制 InfluxDB 镜像的本地容器仓库。

集群规模推荐

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

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

安装 kubecfg kubit 操作员

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

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

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

设置 Kubernetes 入口控制器

Kubernetes 入口 将 HTTP/S 请求路由到集群内的服务，并需要部署一个 ingress 控制器。您可以使用自己的入口，或者安装 Nginx 入口控制器 来使用 InfluxDB 定义的入口。

设置您的对象存储

InfluxDB 集群支持 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目录需要一个PostgreSQL或兼容PostgreSQL的数据库（AWS Aurora，托管PostgreSQL等）。安装和设置您的兼容PostgreSQL数据库的过程取决于您使用的数据库和数据库提供商。请参阅您的数据库或提供商的文档以设置您的兼容PostgreSQL数据库。

兼容PostgreSQL数据库要求

• PostgreSQL版本13.8–14.6。
• 至少4 GB的内存或等效的提供商特定单位。
• 为了避免冲突并防止与其他应用程序共享使用造成的问题，请确保您的兼容PostgreSQL实例仅用于InfluxDB。

设置本地或附加存储

InfluxDB Ingester（Ingestor）需要本地或附加存储来存储写前日志（WAL）。附加存储的读写速度会影响Ingester的写入性能，因此存储设备越快，您的写入性能越好。推荐的最小本地存储大小为2吉字节（2Gi）。

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