minio/m3-nginx pulls statistics

m3 (mkube)

MinIO Kubernetes Cloud

Prerequisites

• Docker • kubectl

A binary release can be downloaded via

• grpc-gateway

Installation

• Install kind

Setup a local kubernetes (m3cluster) using kind

Provision the local kubernetes cluster for test/development

inside /k8s run:

Access Kubernetes dashboard

• Launch kubectl proxy to access kubernetes dashboard • Log in to the dashboard at http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/#!/login • To get the access token

Setup m3

(The following instructions assume that you are in the top-level directory of this repository)

• Build m3 locally • Build m3 local docker image and push it to your local kubernetes • Copy the template located at ./k8s/deployments/m3-deployment.yaml.example into ./k8s/deployments/m3-deployment.yaml • Modify ./k8s/deployments/m3-deployment.yaml

Replace all the with their corresponding values, for example with your personal email. A valid smtp account is needed, if you don't have one we recommend you create a gmail account and enable Less Secure Apps access

• Install the m3 deployment on kubernetes • Install and deploy to k8s your preferred frontend and backend portal • Frontend service name must be called portal and run in port 80 • Start m3 development environment • You should get an email with your activation command, execute it • Finally, perform login to the cluster so you can run all the commands

Using a custom CA for the KMS

Mkube supports the use of custom CA for the kms if need it. Load the custom ca certificate using a configmap

Then set the configmap name and certificate file name on m3-deployment.yaml by uncommenting the following env variables

Apply changes for mkube running kubectl apply -f k8s/deployment/m3-deployment.yaml

Creating a new Storage Cluster

Creating a nodes to store the information

For development add 3 additional nodes

Associate the nodes to a storage cluster

For development assign the remaining 3 nodes

Creating a new Storage Group

Adding a new tenant

If the company name is not url-friendly a short name will be generated, but it can also be specified as shown below.

Adding an Admin User

Making a bucket on a tenant

or

Adding a user to a tenant's database

or

Adding a service account

or

Adding a new permission

To grant write permission to bucketA and bucketB

./m3 tenant permission add acme SAMPLE allow write "bucketA,bucketB"

Accessing the tenant MinIO service via browser UI

The nginx router should be exposed on your local on port 9000 after doing ./m3 dev

Modify your /etc/hosts and add the following record

Then in your browser go to: http://company-short-name.s3.localhost:9000/, you can add more tenants and access them via a subdomain in localhost for now.

Accessing the M3 Portal service via browser UI

• Build and prepare the frontend • Do port-forward to nginx-resolver service that should be able to route to Minio tenants • Do port-forward to portal-proxy service that should be able to route to the Portal UI.

Description from the Docker Hub listing.