minio/k8s-operator

MinIO Operator 镜像文档

镜像概述和主要用途

MinIO Operator是一个遵循Kubernetes Operator模式的管理工具，用于在Kubernetes集群中部署、管理和维护MinIO对象存储实例。它通过自定义资源定义（CRD）提供声明式API，将MinIO集群的生命周期管理（如部署、扩展、升级、备份、恢复）抽象为Kubernetes原生资源操作，降低云原生环境下对象存储的管理复杂度，适用于企业级对象存储需求的自动化运维。

核心功能和特性

声明式部署与管理

• 通过MinIOInstance自定义资源（CR）声明MinIO集群配置，Kubernetes控制器自动协调实际状态与期望状态。
• 支持通过YAML文件定义存储容量、副本数、节点亲和性等参数，实现配置即代码（IaC）。

自动化生命周期管理

• 弹性扩展：支持通过调整CR中spec.pools.replicas参数实现计算资源扩展，通过volumeClaimTemplate调整存储容量扩展。
• 版本升级：支持配置自动或手动升级MinIO集群版本，升级过程中保障数据可用性。
• 故障自愈：检测到节点或存储故障时，自动调度新实例替换故障节点，维持集群可用性。

数据安全与合规

• 集成Kubernetes Secrets管理访问密钥（Access Key/Secret Key），支持加密存储。
• 支持配置TLS加密传输，通过spec.tls参数启用证书管理。
• 支持数据备份策略配置，通过spec.backups定义定时备份或手动触发备份。

监控与可观测性

• 原生集成Prometheus监控指标，暴露集群健康状态、性能指标（如吞吐量、延迟）和资源使用率。
• 支持通过spec.metrics配置监控规则，结合Grafana实现可视化 dashboards。

使用场景和适用范围

适用场景

• 企业级对象存储：需高可用、可扩展的对象存储服务，用于存储文档、图片、视频等非结构化数据。
• 云原生应用存储：为Kubernetes集群内微服务提供共享对象存储，支持S3兼容API。
• 大数据与AI存储：作为大数据处理（如Spark、Hadoop）或AI训练的底层存储，提供高吞吐量和水平扩展能力。
• DevOps与CI/CD：存储构建产物、日志数据，支持版本控制和访问权限管理。

适用范围

• Kubernetes集群版本：1.21+（需支持CRD v1和Operator模式）。
• 存储需求：需持久化存储（依赖Kubernetes PV/PVC，支持本地存储、云存储等）。
• 资源要求：单节点至少2 CPU核心、4GB内存（生产环境建议更高配置）。

使用方法和配置说明

前提条件

• Kubernetes集群（1.21+），已配置kubectl命令行工具。
• 集群内已部署CSI存储驱动（支持动态PV供应）。
• 具备集群管理员权限（用于安装CRD和Operator）。

1. 安装MinIO Operator

步骤1：安装CRD和Operator

通过MinIO官方提供的YAML文件安装CRD和Operator部署资源：

bash
kubectl apply -k https://github.com/minio/operator.git/helm/operator/crds?ref=v5.0.0
kubectl apply -k https://github.com/minio/operator.git/helm/operator?ref=v5.0.0

步骤2：验证Operator部署

检查Operator Pod状态：

bash
kubectl get pods -n minio-operator
# 预期输出示例：
# NAME                       READY   STATUS    RESTARTS   AGE
# minio-operator-xxxxxxxxx   1/1     Running   0          5m

2. 部署MinIO集群实例

步骤1：创建MinIOInstance自定义资源

创建minio-instance.yaml文件，定义MinIO集群配置：

yaml
apiVersion: minio.min.io/v2
kind: MinIOInstance
metadata:
  name: minio-cluster
  namespace: minio
spec:
  # 集群名称
  clusterName: "minio-cluster"
  # MinIO镜像版本
  image: "minio/minio:RELEASE.2024-05-07T05-11-28Z"
  # 访问密钥（通过Kubernetes Secret管理）
  credentials:
    name: minio-creds
  # 存储池配置（支持多池）
  pools:
    - name: pool-0
      replicas: 4  # 4副本（生产建议至少4副本确保高可用）
      volumeClaimTemplate:
        metadata:
          name: minio-data
        spec:
          accessModes: ["ReadWriteOnce"]
          resources:
            requests:
              storage: 10Gi  # 单PVC容量
          storageClassName: "standard"  # 存储类名称
  # 资源限制
  resources:
    requests:
      cpu: 1
      memory: 2Gi
    limits:
      cpu: 2
      memory: 4Gi
  # 启用监控
  metrics:
    enabled: true

步骤2：创建访问密钥Secret

bash
kubectl create secret generic minio-creds -n minio \
  --from-literal=accesskey=AKIAEXAMPLE \
  --from-literal=secretkey=secretkeyexample123

步骤3：部署MinIO集群

bash
kubectl apply -f minio-instance.yaml -n minio

步骤4：验证集群状态

bash
kubectl get minioinstances.min.io -n minio
# 预期输出示例：
# NAME            STATE         AGE
# minio-cluster   Running       10m

配置参数说明

MinIOInstance CR主要配置项

卸载说明

1. 删除MinIO集群实例：

bash
kubectl delete minioinstances.min.io minio-cluster -n minio

2. 卸载MinIO Operator及CRD：

bash
kubectl delete -k https://github.com/minio/operator.git/helm/operator?ref=v5.0.0
kubectl delete crd minioinstances.min.io

注意：删除MinIO集群实例不会自动删除存储卷（PV），需手动清理数据卷以释放存储资源。