From 0cfad8636187660ef95ea00ceccab15c6f068933 Mon Sep 17 00:00:00 2001 From: Serge Logvinov Date: Mon, 8 Sep 2025 19:10:56 +0700 Subject: [PATCH] docs: proxmox ha-groups Update documentation about using Proxmox HA group as a zone label. Signed-off-by: Serge Logvinov --- CODE_OF_CONDUCT.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++ README.md | 6 ++++ docs/config.md | 5 ++- 3 files changed, 86 insertions(+), 1 deletion(-) create mode 100644 CODE_OF_CONDUCT.md diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..96df771 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,76 @@ +## Code of Conduct + +### Our Pledge + +In the interest of fostering an open and welcoming environment, we as +contributors and maintainers pledge to making participation in our project and +our community a harassment-free experience for everyone, regardless of age, body +size, disability, ethnicity, sex characteristics, gender identity and expression, +level of experience, education, socio-economic status, nationality, personal +appearance, race, religion, or sexual identity and orientation. + +### Our Standards + +Examples of behavior that contributes to creating a positive environment +include: + +* Using welcoming and inclusive language +* Being respectful of differing viewpoints and experiences +* Gracefully accepting constructive criticism +* Focusing on what is best for the community +* Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery and unwelcome sexual attention or + advances +* Trolling, insulting/derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or electronic + address, without explicit permission +* Other conduct which could reasonably be considered inappropriate in a + professional setting + +### Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable +behavior and are expected to take appropriate and fair corrective action in +response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or +reject comments, commits, code, wiki edits, issues, and other contributions +that are not aligned to this Code of Conduct, or to ban temporarily or +permanently any contributor for other behaviors that they deem inappropriate, +threatening, offensive, or harmful. + +### Scope + +This Code of Conduct applies both within project spaces and in public spaces +when an individual is representing the project or its community. Examples of +representing a project or community include using an official project e-mail +address, posting via an official social media account, or acting as an appointed +representative at an online or offline event. Representation of a project may be +further defined and clarified by project maintainers. + +### Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported by contacting the project team at [INSERT EMAIL ADDRESS]. All +complaints will be reviewed and investigated and will result in a response that +is deemed necessary and appropriate to the circumstances. The project team is +obligated to maintain confidentiality with regard to the reporter of an incident. +Further details of specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good +faith may face temporary or permanent repercussions as determined by other +members of the project's leadership. + +### Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, +available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html + +[homepage]: https://www.contributor-covenant.org + +For answers to common questions about this code of conduct, see +https://www.contributor-covenant.org/faq diff --git a/README.md b/README.md index c9896d3..feb7980 100644 --- a/README.md +++ b/README.md @@ -50,6 +50,12 @@ metadata: topology.kubernetes.io/region: cluster-1 # Proxmox hypervisor host machine name topology.kubernetes.io/zone: pve-node-1 + + # Proxmox specific labels + topology.proxmox.sinextra.dev/region: cluster-1 + topology.proxmox.sinextra.dev/node: pve-node-1 + topology.proxmox.sinextra.dev/ha-group: default + name: worker-1 spec: ... diff --git a/docs/config.md b/docs/config.md index 3217f0d..bbcd5af 100644 --- a/docs/config.md +++ b/docs/config.md @@ -17,6 +17,8 @@ features: # The IPs that do not match the CIDRs will be kept in the order they # were detected. ip_sort_order: '192.168.0.0/16,2001:db8:85a3::8a2e:370:7334/112' + # Enable use of Proxmox HA group as a zone label + ha_group: true|false clusters: # List of Proxmox clusters @@ -56,6 +58,7 @@ You can define multiple clusters in the `clusters` section. * `network` - Defines how the network addresses are handled by the CCM. The default value is `default`, which uses the kubelet argument `--node-ips` to assign IPs to the node resource. The `qemu` mode uses the QEMU agent API to retrieve network addresses from the virtual machine, while auto attempts to detect the best mode automatically. * `ipv6_support_disabled` - Set to `true` to ignore any IPv6 addresses. The default is `false`. * `external_ip_cidrs` - A comma-separated list of external IP address CIDRs. You can use `!` to exclude a CIDR from the list. This is useful for defining which IPs should be considered external and not included in the node addresses. - +* `ip_sort_order` - A comma-separated list defining the order in which IP addresses should be sorted. The IPs that do not match the CIDRs will be kept in the order they were detected. +* `ha_group` - Set to `true` to enable the use of Proxmox HA group as a zone label. The default is `false`. For more information about the network modes, see the [Networking documentation](networking.md).