使用 Helm 配置您的 InfluxDB 集群

使用 Kubernetes 管理您的 InfluxDB Clustered 部署，并使用 YAML 配置文件应用配置设置。InfluxDB Clustered Helm chart 提供了一种使用 Helm 部署 InfluxDB 集群的替代方法。它充当 InfluxDB AppInstance 资源的包装器。当使用 Helm 时，在本地机器上的 values.yaml 中应用配置选项。

InfluxData 提供以下项目

• influxdb-docker-config.json：经过身份验证的 Docker 配置文件。InfluxDB Clustered 软件位于安全的容器注册表中。此文件授予访问安装 InfluxDB Clustered 所需的容器镜像集合的权限。

配置数据

当准备配置您的 InfluxDB 集群时，请准备好以下信息

• InfluxDB 集群主机名：Kubernetes 用于公开 InfluxDB API 端点的主机名
• PostgreSQL 风格的数据源名称 (DSN)：用于访问存储 InfluxDB Catalog 的 PostgreSQL 兼容数据库。
• 对象存储凭证 （AWS S3 或 S3 兼容）
  • 端点 URL
  • 访问密钥
  • 存储桶名称
  • 区域（S3 必需，其他对象存储可能不需要）
• 本地存储信息 （用于 ingester pod）
  • 存储类
  • 存储大小

InfluxDB 部署到 Kubernetes 命名空间，在以下安装过程中，该命名空间被称为目标命名空间。为了简单起见，我们假设此命名空间为 influxdb，但是您可以使用任何您喜欢的名称。

AppInstance 资源

InfluxDB 的安装、更新和升级过程由编辑和应用名为 AppInstance 的 Kubernetes 自定义资源 (CRD) 驱动。AppInstance CRD 包含在 InfluxDB Clustered Helm chart 中，并且可以通过在 chart 中包含的 values.yaml 中应用自定义设置进行配置。

AppInstance 资源包含关键信息，例如

• 目标命名空间的名称
• InfluxDB 包的版本
• 对 InfluxDB 容器注册表拉取密钥的引用
• InfluxDB API 公开的主机名
• 连接到 外部先决条件 的参数

kubecfg kubit operator

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

skipOperator: true

配置您的集群

1. 安装 Helm
2. 创建 values.yaml 文件
3. 配置对 InfluxDB 容器注册表的访问
4. 修改配置文件以指向先决条件

安装 Helm

如果您尚未这样做，请在您的本地机器上 安装 Helm。

创建 values.yaml 文件

从 GitHub 下载或复制 InfluxDB Clustered Helm chart 的基本 values.yaml，并将其存储在本地。例如 - 如果使用 cURL

curl -O https://raw.githubusercontent.com/influxdata/helm-charts/master/charts/influxdb3-clustered/values.yaml

或者您可以从 GitHub 复制默认的 values.yaml

在 GitHub 上查看 values.yaml

配置对 InfluxDB 容器注册表的访问

提供的 influxdb-docker-config.json 授予对运行 InfluxDB Clustered 所需的容器镜像集合的访问权限。您的 Kubernetes 集群需要访问容器注册表才能拉取并安装 InfluxDB。

当拉取镜像时，主要有两种情况

• 您有一个 Kubernetes 集群，可以从 InfluxData 容器注册表拉取镜像。
• 您在没有网络接口（“气隙”）的环境中运行，并且您只能访问私有容器注册表。

在这两种情况下，您都需要一个有效的容器注册表密钥文件。使用 crane 创建容器注册表密钥文件。

1. 安装 crane
2. 使用以下命令创建容器注册表密钥文件并检索必要的密钥

mkdir /tmp/influxdbsecret
cp influxdb-docker-config.json /tmp/influxdbsecret/config.json
DOCKER_CONFIG=/tmp/influxdbsecret \
  crane manifest \
  us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:
PACKAGE_VERSION

将 PACKAGE_VERSION 替换为您的 InfluxDB Clustered 包版本。

如果您的 Docker 配置有效，并且您能够连接到容器注册表，则命令成功，并且输出是 Docker 镜像的 JSON 清单，类似于以下内容

{
  "schemaVersion": 2,
  "config": {
    "mediaType": "application/vnd.kubecfg.bundle.config.v1+json",
    "digest": "sha256:6900d2f248e678176c68f3768e7e48958bb96a59232070ff31b3b018cf299aa7",
    "size": 8598
  },
  "layers": [
    {
      "mediaType": "application/vnd.kubecfg.bundle.tar+gzip",
      "digest": "sha256:7c1d62e76287035a9b22b2c155f328fae9beff2c6aa7a09a2dd2697539f41d98",
      "size": 404059
    }
  ],
  "annotations": {
    "org.opencontainers.image.created": "1970-01-01T00:00:00Z",
    "org.opencontainers.image.revision": "unknown",
    "org.opencontainers.image.source": "kubecfg pack"
  }
}

如果 Docker 配置存在问题，crane 将无法检索清单，并且输出类似于以下错误

Error: fetching manifest us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:<package-version>: GET https://us-docker.pkg.dev/v2/token?scope=repository%3Ainfluxdb2-artifacts%2Fclustered%2Finfluxdb%3Apull&service=: DENIED: Permission "artifactregistry.repositories.downloadArtifacts" denied on resource "projects/influxdb2-artifacts/locations/us/repositories/clustered" (or it may not exist)

kubectl create secret docker-registry gar-docker-secret \
  --from-file=.dockerconfigjson=influxdb-docker-config.json \
  --namespace influxdb

secret/gar-docker-secret created

DOCKER_CONFIG=/tmp/influxdbsecret \
crane config \
  us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:
PACKAGE_VERSION
 \
  | jq -r '.metadata["oci.image.list"].images[]' \
  > /tmp/images.txt

us-docker.pkg.dev/influxdb2-artifacts/idpe/idpe-cd-ioxauth@sha256:5f015a7f28a816df706b66d59cb9d6f087d24614f485610619f0e3a808a73864
us-docker.pkg.dev/influxdb2-artifacts/iox/iox@sha256:b59d80add235f29b806badf7410239a3176bc77cf2dc335a1b07ab68615b870c
...

</tmp/images.txt xargs -I% crane cp % 
REGISTRY_HOSTNAME
/%

myregistry.mydomain.io

images:
  registryOverride: 
REGISTRY_HOSTNAME

修改配置文件以指向先决条件

使用连接集群到先决条件所需的凭证更新您的 values.yaml 文件。

• 配置 Ingress
• 配置对象存储
• 配置 Catalog 数据库
• 为 ingester 配置本地存储

配置 Ingress

要配置 Ingress，请在您的 values.yaml 中为以下字段提供值

• ingress.hosts：集群主机名

  提供 Kubernetes 应该用于公开 InfluxDB API 端点的主机名 - 例如：cluster-host.com。

  您可以提供多个主机名。Ingress 层接受所有列出的主机名的传入请求。如果您想为您的内部和外部流量设置不同的路径，这可能很有用。

  您负责配置和管理 DNS。选项包括

  • 手动管理 DNS 记录
  • 使用 external-dns 将公开的 Kubernetes 服务和 Ingress 与 DNS 提供商同步。

• ingress.tlsSecretName：TLS 证书 secret 名称

  （可选）：提供包含您的 TLS 证书和密钥的 secret 的名称。本指南中的示例使用名称 ingress-tls。

  tlsSecretName 字段是可选的。如果您已经有 DNS 名称的 TLS 证书，您可能想要使用它。

  写入和查询 InfluxDB 中的数据不需要 TLS。为了简单起见，您可以等到进入生产环境后再启用 TLS。有关更多信息，请参阅 InfluxDB Clustered 安装过程的阶段 4，保护您的集群安全。

ingress:
  hosts:
    - cluster-host.com
  tlsSecretName: ingress-tls

配置对象存储

要将您的 InfluxDB 集群连接到您的对象存储，请在您的 values.yaml 中提供所需的凭证。所需的凭证取决于您的对象存储提供商。

objectStore:
    # Bucket that the Parquet files will be stored in
  bucket: 
S3_BUCKET_NAME
  
  s3: 
    # URL for S3 Compatible object store
    endpoint: 
S3_URL

    # Set to true to allow communication over HTTP (instead of HTTPS)
    allowHttp: 'true'

    # S3 Access Key
    # This can also be provided as a valueFrom: secretKeyRef:
    accessKey:
      value: 
S3_ACCESS_KEY

    # S3 Secret Key
    # This can also be provided as a valueFrom: secretKeyRef:
    secretKey:
      value: 
S3_SECRET_KEY

    # This value is required for AWS S3, it may or may not be required for other providers.
    region: 
S3_REGION

objectStore:
    # Bucket that the Parquet files will be stored in
  bucket: 
AZURE_BUCKET_NAME
  
  azure:
    # Azure Blob Storage Access Key
    # This can also be provided as a valueFrom:
    accessKey:
      value: 
AZURE_ACCESS_KEY

    # Azure Blob Storage Account
    # This can also be provided as a valueFrom: secretKeyRef:
    account:
      value: 
AZURE_STORAGE_ACCOUNT

objectStore:
    # Bucket that the Parquet files will be stored in
  bucket: 
GOOGLE_BUCKET_NAME
  
  google:
    # This section is not needed if you are using GKE Workload Identity.
    # It is only required to use explicit service account secrets (JSON files)
    serviceAccountSecret:
      # Kubernetes Secret name containing the credentials for a Google IAM
      # Service Account.
      name: 
GOOGLE_IAM_SECRET
      # The key within the Secret containing the credentials.
      key: 
GOOGLE_CREDENTIALS_KEY

配置 Catalog 数据库

InfluxDB Catalog 是一个 PostgreSQL 兼容的关系数据库，它存储关于您的时间序列数据的元数据。要将您的 InfluxDB 集群连接到您的 PostgreSQL 兼容数据库，请在您的 values.yaml 中为以下字段提供值

• catalog.dsn
  • SecretName：Secret 名称
  • SecretKey：secret 中包含 DSN 的密钥

catalog:
  # Secret name and key within the secret containing the dsn string to connect
  # to the catalog
  dsn:
    # Kubernetes Secret name containing the dsn for the catalog.
    SecretName: 
SECRET_NAME
    # The key within the Secret containing the dsn.
    SecretKey: 
SECRET_KEY

替换以下内容

• SECRET_NAME：包含您的 PostgreSQL 兼容 DSN 的 secret 的名称
• SECRET_KEY：secret 中引用您的 PostgreSQL 兼容 DSN 的密钥

Catalog DSN error: A catalog error occurred: unhandled external error: error with configuration: invalid port number

postgresql://postgres:meow#meow@my-fancy.cloud-database.party:5432/postgres

postgresql://postgres:meow%23meow@my-fancy.cloud-database.party:5432/postgres

postgres://username:passw0rd@mydomain:5432/influxdb?sslmode=disable

为 ingester 配置本地存储

InfluxDB ingester 需要本地存储来存储传入数据的预写日志 (WAL)。要将您的 InfluxDB 集群连接到本地存储，请在您的 values.yaml 中为以下字段提供值

• ingesterStorage
  • storageClassName：Kubernetes 存储类。这取决于 Kubernetes 环境和所需的存储特性。
  • storage：存储大小。我们建议至少 2 gibibytes (2Gi)。

ingesterStorage:
  # (Optional) Set the storage class. This will differ based on the K8s
  # environment and desired storage characteristics.
  # If not set, the default storage class will be used.
  storageClassName: 
STORAGE_CLASS
  # Set the storage size (minimum 2Gi recommended)
  storage: 
STORAGE_SIZE

替换以下内容

• STORAGE_CLASS：Kubernetes 存储类
• STORAGE_SIZE：存储大小 (示例：2Gi)