MAS DevOps Ansible Collection Ansible CLI
Home Roles: Dependency Mgmt minio Features Role Variables Example Playbook Run Role Playbook License

minio¤

Deploy a MinIO object storage instance in OpenShift for development and testing with IBM Maximo Application Suite.

MinIO provides S3-compatible object storage and is deployed with persistent volume for data storage. The role creates a namespace, persistent volume claim, deployment, service, and route to make MinIO accessible within the cluster. The MinIO container image (quay.io/ibmmas/minio) and its digest are selected based on the MAS catalog.

Development and Testing Only

This MinIO deployment is intended for development and testing purposes only. For production environments, use enterprise-grade object storage solutions such as IBM Cloud Object Storage, AWS S3, or Azure Blob Storage.

Features¤

  • S3-Compatible API: Full compatibility with Amazon S3 API
  • Persistent Storage: Data stored on persistent volumes
  • Web Console: Built-in web interface for management, exposed via an edge-terminated route
  • OpenShift Integration: Deployed as native OpenShift resources

Role Variables¤

Variable Required Default
minio_namespace No minio
minio_instance_name No minio
minio_root_user No minio
minio_root_password No None
primary_storage_class No Cluster default RWX storage class
ocp_enable_ipv6 No false

MinIO Deployment¤

minio_namespace¤

OpenShift namespace where MinIO is deployed — a valid Kubernetes namespace name; the namespace is created if it does not exist.

  • Optional
  • Environment Variable: MINIO_NAMESPACE
  • Default: minio

All MinIO resources (namespace, PVC, deployment, service, and route) are created in this namespace. Use different namespaces when deploying multiple MinIO instances.

minio_instance_name¤

Name for the MinIO deployment and associated resources — a valid Kubernetes resource name (lowercase alphanumeric with hyphens).

  • Optional
  • Environment Variable: MINIO_INSTANCE_NAME
  • Default: minio

Used in the deployment name and the service selector. Use descriptive names for multiple instances (e.g. minio-dev, minio-test).

minio_root_user¤

Root username for MinIO console and S3 API access — an alphanumeric string (minimum 3 characters).

  • Optional
  • Environment Variable: MINIO_ROOT_USER
  • Default: minio

The root user has full administrative access to MinIO. The default is acceptable for development and testing only.

minio_root_password¤

Root password for MinIO console and S3 API access — MinIO requires a password of at least 8 characters.

  • Optional
  • Environment Variable: MINIO_ROOT_PASSWORD
  • Default: None

The role does not generate a password — set it explicitly and store it securely for future access.

Storage¤

primary_storage_class¤

Storage class for the MinIO persistent volume claim — a valid storage class name available in the cluster.

  • Optional
  • Environment Variable: MINIO_STORAGE_CLASS
  • Default: Cluster's default RWX storage class (auto-detected). The role fails if the value is not set and no default can be detected.

The PVC (minio-pvc) requests 40Gi with ReadWriteOnce access mode using this storage class. Verify available storage classes with oc get storageclass; consider the performance characteristics of the storage class when selecting it.

Networking¤

ocp_enable_ipv6¤

Configure MinIO to use IPv6 addressing — true or false.

  • Optional
  • Environment Variable: OCP_ENABLE_IPV6
  • Default: false

When true, the service is configured as SingleStack IPv6 and the MinIO server binds to IPv6 addresses for both the API (port 9000) and console (port 9090).

Example Playbook¤

After installing the Ansible Collection you can include this role in your own custom playbooks.

- hosts: localhost
  vars:
    minio_namespace: minio
    minio_instance_name: minio-dev
    minio_root_user: admin
    minio_root_password: mySecurePassword123
  roles:
    - ibm.mas_devops.minio

Run Role Playbook¤

After installing the Ansible Collection you can easily run the role standalone using the run_role playbook provided.

export MINIO_NAMESPACE=minio
export MINIO_INSTANCE_NAME=minio-dev
export MINIO_ROOT_USER=admin
export MINIO_ROOT_PASSWORD=mySecurePassword123
ROLE_NAME=minio ansible-playbook ibm.mas_devops.run_role

License¤

EPL-2.0