用于Kubernetes的MinIO Operator,提供对象存储服务的生命周期管理,支持通过自定义资源定义实现声明式部署、自动化扩展、版本升级及维护,简化MinIO集群在K8s环境中的管理。
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部署资源:
bashkubectl 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状态:
bashkubectl 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集群配置:
yamlapiVersion: 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
bashkubectl create secret generic minio-creds -n minio \ --from-literal=accesskey=AKIAEXAMPLE \ --from-literal=secretkey=secretkeyexample123
步骤3:部署MinIO集群
bashkubectl apply -f minio-instance.yaml -n minio
步骤4:验证集群状态
bashkubectl get minioinstances.min.io -n minio # 预期输出示例: # NAME STATE AGE # minio-cluster Running 10m
配置参数说明
MinIOInstance CR主要配置项
| 参数路径 | 描述 | 示例值 |
|---|---|---|
metadata.name | MinIO集群实例名称 | minio-cluster |
spec.image | MinIO镜像版本 | 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 |
卸载说明
- 删除MinIO集群实例:
bashkubectl delete minioinstances.min.io minio-cluster -n minio
- 卸载MinIO Operator及CRD:
bashkubectl 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:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务