MinIO Operator brings native support for MinIO, Graphical Console, and Encryption to Kubernetes. This document explains how to get started with MinIO Operator using kubectl minio plugin.
- Kubernetes >= v1.17.0.
- Create PVs. We recommend direct CSI driver for PV creation.
- Install
kubectl minioplugin.
MinIO Operator offers MinIO Tenant creation, management, upgrade, zone addition and more. Operator is meant to control and manage multiple MinIO Tenants.
To get started, create the MinIO Operator deployment. This is a one time process.
kubectl minio operator createOnce the MinIO Operator is created, proceed with Tenant creation.
A Tenant is a MinIO cluster created and managed by the Operator.
Before creating a Tenant, please create the namespace where this Tenant will reside.
For logical isolation, Operator allows a single Tenant per Kubernetes Namespace.
kubectl create ns tenant1-nsNext, create the Kubernetes secret that encapsulates root credentials for MinIO Tenant. Please ensure to create secret object with literals accesskey and secretkey.
Remember to change YOUR-ACCESS-KEY and YOUR-SECRET-KEY to actual values.
kubectl create secret generic tenant1-secret --from-literal=accesskey=YOUR-ACCESS-KEY --from-literal=secretkey=YOUR-SECRET-KEY --namespace tenant1-nsNote that the access key and secret key provided here is authorized to perform all operations on the Tenant.
We can create the Tenant now. Before that, please ensure you have requisite nodes and drives in place and relevant PVs are created. In below example, we ask MinIO Operator to create a Tenant with 4 nodes, 16 volumes, and 16 Ti total raw capacity (4 volumes of 1 Ti per node). This means you need to have 4 PVCs of 1 Ti each, per node, and total of 4 nodes, before attempting to create the MinIO Tenant.
We recommend direct CSI driver to create PVs.
kubectl minio tenant create --name tenant1 --secret tenant1-secret --servers 4 --volumes 16 --capacity 16Ti --namespace tenant1-ns --storage-class direct.csi.min.ioYou can add capacity to the tenant using kubectl minio plugin, like this
kubectl minio tenant volume add --name tenant1 --servers 8 --volumes 32 --capacity 32Ti --namespace tenant1-ns
This will add 32 drives spread uniformly over 8 servers to the tenant tenant1, with additional capacity of 32Ti. Read more about tenant expansion here.
Use of MinIO Operator is governed by the GNU AGPLv3 or later, found in the LICENSE file.