k8s-operator

K8s Operator Docker Image

用于Kubernetes的MinIO Operator,提供对象存储服务的生命周期管理,支持通过自定义资源定义实现声明式部署、自动化扩展、版本升级及维护,简化MinIO集群在K8s环境中的管理。

1 次收藏下载次数: 0状态:社区镜像维护者:MinIO 对象存储仓库类型:镜像最近更新:

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: "docker.xuanyuan.run/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主要配置项

参数路径描述示例值
metadata.nameMinIO集群实例名称minio-cluster
spec.imageMinIO镜像版本minio/minio:RELEASE.2024-05-07T05-11-28Z
spec.credentials.name存储访问密钥的Kubernetes Secret名称minio-creds
spec.pools存储池配置列表(支持多池)-
spec.pools[0].replicas存储池副本数(建议≥4确保高可用)4
spec.pools[0].volumeClaimTemplate.spec.storage单PVC存储容量10Gi
spec.resources资源请求与限制配置requests: {cpu: 1, memory: 2Gi}
spec.metrics.enabled是否启用监控指标暴露true
spec.tls.enabled是否启用TLS加密传输(需配置证书Secret)true

卸载说明

  1. 删除MinIO集群实例:
bash
kubectl delete minioinstances.min.io minio-cluster -n minio
  1. 卸载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),需手动清理数据卷以释放存储资源。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 k8s-operator 镜像标签

docker pull docker.xuanyuan.run/minio/k8s-operator:<标签>

DockerHub 原生拉取命令

docker pull minio/k8s-operator:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告