Alloy Operator

Alloy Operator 是一个 Kubernetes Operator，用于管理 Grafana Alloy 实例的生命周期。它基于 Operator SDK 构建，并以 https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy 作为基础。

当前版本

用法

使用 Alloy Operator 需遵循以下两个步骤：

1. 部署 Alloy Operator。
2. 部署 Alloy 实例。

部署 Alloy Operator

$ helm install alloy-operator grafana/alloy-operator

部署 Alloy 实例

创建 Alloy 实例配置文件：

---
apiVersion: collectors.grafana.com/v1alpha1
kind: Alloy
metadata:
  name: alloy-test
spec:
  alloy:
    configMap:
      content: |-
        prometheus.exporter.self "default" {}

        prometheus.scrape "default" {
          targets = prometheus.exporter.self.default.targets
          forward_to = [prometheus.remote_write.local_prom.receiver]
        }

        prometheus.remote_write "local_prom" {
          endpoint {
            url = "http://prometheus-server.prometheus.svc:9090/api/v1/write"
          }
        }

spec 部分支持 https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy 的 values 文件中的所有字段。

有关示例，请参见本仓库中的测试用例：

• 基础 Alloy 实例
• 带 HostPath 卷挂载的 DaemonSet
• 带 WAL 的 StatefulSet
• 远程配置

[!NOTE] Alloy 实例不会部署 PodLogs CRD，也不支持 spec 中的 crds 字段。

贡献

我们欢迎对 Grafana Alloy Operator 的贡献！有关更多信息，请参见我们的 贡献指南。

更新 Alloy 版本

Alloy Operator 默认嵌入特定版本的 Alloy。Alloy Operator Helm chart 的 appVersion 与 Alloy Helm chart 的版本匹配。具体版本信息请参见 当前版本。要更新嵌入的 Alloy 版本，请运行脚本：./scripts/update-alloy.sh。确保更新 Alloy Operator 版本并执行 make clean build test。

发布 Alloy Operator

1. 设置新的 Alloy Operator chart 版本
2. 运行 make clean build test 重新生成文件
3. 确保所有变更都已记录在 CHANGELOG.md 中
4. 提交变更、创建 PR 并合并到 main 分支
5. 运行 "Release Alloy Operator Helm chart" GitHub 动作