MinIO Kubernetes Plugin

Overview

The kubectl minio plugin brings native support for deploying MinIO tenants to Kubernetes clusters using the kubectl CLI. Use kubectl minio to deploy a MinIO tenant with little to no interaction with YAML configuration files.

Installing kubectl minio implies installing the MinIO Kubernetes Operator.

Installation

The MinIO Kubernetes Plugin requires Kubernetes 1.19.0 or later.

The following code downloads the latest stable version 5.0.4 of the MinIO Kubernetes Plugin and installs it to the system $PATH.

kubectl krew update
kubectl krew install minio

wget https://github.com/minio/operator/releases/download/v5.0.4/kubectl-minio_5.0.4_linux_amd64 -O kubectl-minio
chmod +x kubectl-minio
mv kubectl-minio /usr/local/bin/

You can access the plugin using the kubectl minio command. Run the following command to verify installation of the plugin:

kubectl minio version

Subcommands

kubectl minio has the following subcommands:

• init

• proxy

• tenant

• delete

• version

Environment Variables

The MinIO Operator uses the following environment variables during startup to set configuration settings. Configure these variables on the machine running the kubectl plugin.

MINIO_OPERATOR_CERTIFICATES_VERSION

Specifies the certificate API version to use.

Valid values are v1 or v1beta1.

When not specified, the default is the API Kubernetes provides.

MINIO_OPERATOR_RUNTIME

Specify the type of runtime to use.

Valid values are EKS, Rancher, or OpenShift. Leave blank if none of the options apply.

When set as EKS, the MINIO_OPERATOR_CSR_SIGNER_NAME must be beta.eks.amazonaws.com/app-serving.

MINIO_OPERATOR_CSR_SIGNER_NAME

Override the default signer for certificate signing requests (CSRs).

When not specified, the default value is kubernetes.io/kubelet-serving.

OPERATOR_CERT_PASSWD

Optional

The password Operator should use to decrypt the private key in the TLS certificate for Operator.

MINIO_OPERATOR_DEPLOYMENT_NAME

Specifies the namespace to create and use for Operator

When not specified, the default value is minio-operator.

OPERATOR_STS_ENABLED

Toggle STS Service on or off.

When not specified, the default value is off.

MINIO_CONSOLE_DEPLOYMENT_NAME

The name to use for the Operator Console.

When not specified, the default value is operator.

OPERATOR_CONSOLE_TLS_ENABLE

Toggle Console TLS service on or off.

When not specified, the default value is off.

WATCHED_NAMESPACE

A comma-separated list of the namespace(s) Operator should watch for tenants.

When not specified, the default value is "" to watch all namespaces.