Add details to why the minio tenant headless service must be used over the normal clusterIP service

[AntonOfTheWoods]

"The console service is for managing the tenant, while the hl service exposes the S3 compatible API. "

the <tenant>-hl service is a headless service. There is also a minio "normal" (clusterIP) service created. Why can't we used the "normal" service? Does the plugin have to connect to all of the pods behind the service? I have been testing with a single pod and it works with the normal service (not the headless version) but that may just be because there is a single pod. Can you update the docs to say why it can't use the normal service, if indeed that is the case? Thanks!

EDIT: Furthermore, how does https://cloudnative-pg.io/plugin-barman-cloud/docs/retention/ ("The Barman Cloud Plugin supports automated cleanup of obsolete backups via retention policies, configured in the .spec.retentionPolicy field of the ObjectStore resource.") square with https://cloudnative-pg.io/plugin-barman-cloud/docs/object_stores/#s3-lifecycle-policy ("Barman Cloud uploads backup files to S3 but does not modify or delete them afterward. ") ?

[dosubot]

The headless (<tenant>-hl) service is required for MinIO in multi-pod (distributed) setups because it exposes DNS records for each pod, allowing clients (like the plugin) to communicate directly with all MinIO pods. This is essential for distributed MinIO, where the S3 API expects to reach each storage node individually for correct operation. The normal ClusterIP service only provides a single load-balanced endpoint, which hides the individual pods and can break distributed mode functionality. In single-pod setups, the normal service may appear to work since there's only one pod, but this does not generalize to multi-pod deployments. For reliable operation, especially in HA or scalable environments, always use the headless service as your endpointURL in the plugin configuration reference.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[AntonOfTheWoods]

But does barman actually need to contact all the individual pods?