ghcr.io/grafana/alloy-operator:1.9.0

Alloy Operator

Alloy Operator 是一个 Kubernetes Operator，用于管理 https://grafana.com/docs/alloy/latest/ 实例的生命周期。它基于 https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy%EF%BC%8C%E4%BD%BF%E7%94%A8 https://sdk.operatorframework.io/ 构建。

当前版本

用法

使用 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 操作。