Grafana k6 Operator

Grafana k6 Operator是一个Kubernetes Operator，能够在集群中运行分布式k6负载测试，自动化测试执行和扩展以进行性能验证。

Grafana k6 Operator 概述

商标：本软件列表由Bitnami打包。产品中提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

TL;DR

helm install my-release oci://registry-1.docker.io/bitnamicharts/grafana-k6-operator

想在生产环境中使用Grafana k6 Operator？试试VMware Tanzu Application Catalog，Bitnami目录的商业版。

⚠️ 重要通知：Bitnami目录即将发生的变更

从2025年8月28日开始，Bitnami将改进其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦的镜像。作为此过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本。
• Bitnami将开始在其免费层中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，用于开发目的。
• 从8月28日开始，在两周内，所有现有容器镜像，包括旧版本或带版本的标签（例如2.50.0、10.6），将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），在那里它们将不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，包括强化容器、更小的攻击面、CVE透明度（通过VEX/KEV）、SBOM和企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。有关更多详细信息，请访问Bitnami Secure Images公告。

介绍

此chart使用Helm包管理器在Kubernetes集群上引导Grafana k6 Operator部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+

安装Chart

要使用发布名称“my-release”安装chart：

helm install my-release REGISTRY_NAME/REPOSITORY_NAME/grafana-k6-operator

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm chart仓库和存储库的引用。例如，对于Bitnami，需要使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

该命令使用默认配置在Kubernetes集群上部署Grafana k6 Operator。参数部分列出了可在安装过程中配置的参数。

提示：使用helm list列出所有发布

配置和安装详情

滚动标签 vs 不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果相同标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大变更或严重漏洞，Bitnami将发布新chart来更新其容器。

资源请求和限制

Bitnami chart允许为chart部署内的所有容器设置资源请求和限制。这些在resources值中配置（参见参数表）。为生产工作负载设置请求至关重要，应根据您的具体用例进行调整。

为简化此过程，chart包含resourcesPreset值，可根据不同预设自动设置resources部分。在bitnami/common chart中查看这些预设。然而，在生产工作负载中不建议使用resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参见官方Kubernetes文档。

Prometheus指标

通过将metrics.enabled设置为true，此chart可与Prometheus集成。这将在metrics服务中公开Grafana k6 Operator原生Prometheus端点，可在metrics.service部分下配置。它将具有必要的注解，以便被Prometheus自动抓取。

通过设置authProxy.enabled=true，可以为此端点设置基于RBAC的身份验证，这将部署带有kube-rbac-proxy的边车，只有授权的ServiceAccount能够访问指标。

Prometheus要求

集成工作需要安装Prometheus或Prometheus Operator。安装Bitnami Prometheus helm chart或Bitnami Kube Prometheus helm chart，以便在集群中轻松拥有可用的Prometheus。

与Prometheus Operator集成

该chart可以部署ServiceMonitor对象，用于与Prometheus Operator安装集成。要实现此目的，将值metrics.serviceMonitor.enabled=true。确保集群中安装了Prometheus Operator CustomResourceDefinitions，否则将失败并显示以下错误：

no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装Bitnami Kube Prometheus helm chart以获取必要的CRD和Prometheus Operator。

边车容器

如果在grafana-k6-operator的同一pod中需要额外的容器（例如额外的指标或日志导出器），可以使用sidecars参数定义它们：

sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些边车导出额外的端口，可以使用service.extraPorts参数（如可用）添加额外的端口定义，如下例所示：

service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

如果同一pod中需要额外的初始化容器，可以使用initContainers参数定义它们。例如：

initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于边车容器和初始化容器。

部署额外资源

除了Operator之外，您可能还想部署TestRun对象。为此，chart允许使用extraDeploy参数添加其他对象的完整规范。以下示例创建一个TestRun对象和一个包含测试代码的ConfigMap：

extraDeploy:
- apiVersion: k6.io/v1alpha1
  kind: TestRun
  metadata:
    name: testrun-sample
  spec:
    parallelism: 2
    script:
      configMap:
        name: k6-test
        file: test.js
- apiVersion: v1
  kind: ConfigMap
  metadata:
    name: k6-test
  data:
    test.js: |
      import http from 'k6/http';
      import { Rate } from 'k6/metrics';
      import { check, sleep } from 'k6';

      const failRate = new Rate('failed_requests');

      export let options = {
        stages: [
          { target: 200, duration: '30s' },
          { target: 0, duration: '30s' },
        ],
        thresholds: {
          failed_requests: ['rate<=0'],
          http_req_duration: ['p(95)<500'],
        },
      };

      export default function () {
        const result = http.get('[***]
        check(result, {
          'http response status code is 200': result.status === 200,
        });
        failRate.add(result.status !== 200);
        sleep(1);
      }

查看Grafana k6 Operator官方文档获取可用对象列表。

Pod亲和性

此chart允许使用affinity参数设置自定义亲和性。有关Pod亲和性的更多信息，请参见kubernetes文档。

作为替代方案，使用bitnami/common chart中可用的pod亲和性、pod反亲和性和节点亲和性的预设配置之一。为此，在operator、apiserver和cluster部分中设置podAffinityPreset、podAntiAffinityPreset或nodeAffinityPreset参数。

参数

全局参数

通用参数

注意：此chart的README超出了DockerHub的25000字符限制，因此已被截断。完整README可在[***]