Custom Hostname Discovery [](https://slack.min.io)

March 11, 2023 ยท View on GitHub

This document explains how to control the names used for host discovery. This allows us to discover hosts using external name services, which is useful for serving with trusted certificates.

Getting Started

If MinIO Tenant is named tenant1, then the four servers will be called myminio-pool-0-0, myminio-pool-0-1, myminio-pool-0-2, and myminio-pool-0-3. If all of your hosts are available at the domain example.com then you can use the --hosts-template flag in MinIO Operator Deployment yaml to update discovery. This will generate the discovery string myminio-pool-0-{0...3}.example.com.

  containers:
    - command:
        - /operator
        - --hosts-template
        - '{{.StatefulSet}}-{{.Ellipsis}}.example.com'

The following fields can be configured:

FieldDescription
StatefulSetThe name of the tenant StatefulSet (e.g. minio).
CIServiceThe name of the service provided in spec.serviceName.
HLServiceThe name of the headless service that is generated (e.g. minio-hl-service)
Ellipsis{0...N-1} the per-pool host numbers.
DomainThe cluster domain, either cluster.local or the contents of the CLUSTER_DOMAIN environment variable.