Skip to content

Documentation: Clarify region and zone annotations #349

@Arceoavs

Description

@Arceoavs

Bug Report

The installation description in installation.md is excellent as a first start, and it was helpful for me until the pods did not start correctly. The reason, as it turns out, is that the annotations for regions and zones per node are mandatory.

Description

Please take a look at the problem above. Adding the annotations made the pods start without any issues. Since this is a straightforward issue and solution, but took some looking around in the repository to solve, the documentation would benefit from adding a hint to this configuration.

The main Readme.md is more explicit on this:

"Important: The topology.kubernetes.io/region and topology.kubernetes.io/zone labels must be set. Region is the Proxmox cluster name, and zone is the Proxmox node name. Cluster name can be human-readable and should be the same as in Cloud config."

Logs

proxmox-csi-plugin-node-: RegisterPlugin error -- plugin registration failed with err: rpc error: code = Unknown desc = failed to get region for node talos-<xxx>

Environment

  • Plugin version: v0.11.0
  • Kubernetes version: [v1.32.3]
  • OS version: Talos Linux 1.9.5

Community Note

  • Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
  • Please do not leave "+1" or other comments that do not add relevant new information or questions; they generate extra noise for issue followers and do not help prioritize the request

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions