How do I specify Ceph monitor addresses in ceph-csi-operator Helm values?

[Tarasmon]

I’m migrating from the old ceph-csi-rbd Helm chart to the ceph-csi-operator Helm chart.

In values.yaml, the cephConnections.monitors section is defined as a map:

cephConnections:
  monitors: {}
  

• Are the keys arbitrary?
• Should the values be IP:port?
• Can I use hostnames or IPv6 addresses?

What’s the correct way to specify monitors for the operator?

[codeninja115]

In the ceph-csi-operator Helm chart:

• The keys in monitors are arbitrary — you can name them anything.
• The values must be host:port, typically the monitor IPs or hostnames with the v1 port (6789).
• IPv6 addresses should be quoted, e.g., "[1:2:3::4]:6789".
• Hostnames are supported, not just raw IPs.

Example:

cephConnections:
  monitors:
    mon1: "10.0.0.1:6789"
    mon2: "10.0.0.2:6789"
    mon3: "[fd00::1]:6789"

Notes:

• v1 (port 6789) is safest and widely compatible.
• v2 (port 3300) works on newer Ceph/CSI versions, but mixed v1/v2 in Helm values is not fully documented.
• Even though monitors is defined as a map, it is effectively treated like a list by the operator.

This configuration ensures the operator can connect to all Ceph monitors properly.

[Tarasmon]

@codeninja115 Thank you for answer! How should I list Ceph monitors in the ceph-csi-operator Helm values.yaml?

[codeninja115]

In the ceph-csi-operator Helm values.yaml:

• Keys in monitors are arbitrary labels.
• Values must be host:port (IP or hostname).
• Quote IPv6 addresses: "[fd00::1]:6789".

Example:

cephConnections:
  monitors:
    mon1: "10.0.0.1:6789"
    mon2: "10.0.0.2:6789"
    mon3: "[fd00::1]:6789"
Use v1 (6789) for compatibility; v2 (3300) works on newer Ceph/CSI versions.