Skip to content

docs(kubernetes): describe the Proxmox VE substrate for tenant clusters - #761

Open
Marian Koreniuk (themoriarti) wants to merge 1 commit into
cozystack:mainfrom
themoriarti:docs/proxmox-substrate
Open

Marian Koreniuk (themoriarti) wants to merge 1 commit into
cozystack:mainfrom
themoriarti:docs/proxmox-substrate

Conversation

@themoriarti

Copy link
Copy Markdown
Contributor

What this PR does

Adds docs/next/kubernetes/proxmox-substrate.md: an operator page for substrate: proxmox on the kubernetes / kubernetes-nodes applications (cozystack/cozystack#4087, #4088, #4089, #4742), which ships opt-in in v1.7.0-rc.1.

The page covers:

  • what runs where (capmox, in-cluster IPAM, Proxmox CCM and CSI controller in the management cluster; only the CSI node plugin in the tenant), and that the hypervisor token never enters the tenant;
  • a support matrix (Cozystack v1.7 / main, Proxmox VE 9.2.x verified, capmox v0.7.7);
  • enabling cozystack.capi-provider-infra-proxmox and the capmox-config Secret, with the three mistakes the chart comments call out (PROXMOX_URL without /api2/json, full token id, rotation needs a restart);
  • Proxmox user, tokens, resource pool and the per-tenant ACL table from the kubernetes chart README;
  • building the Talos template with hack/proxmox-talos-template.sh and why not from the bare-metal nocloud image;
  • Kubernetes and KubernetesNodes examples with the proxmox.* values as documented in values.yaml;
  • verification commands, the isolation model, the v1.7 limitations, and a troubleshooting table built from the failure modes described in the three PRs.

It is placed under Managed Kubernetes because substrate is a property of a tenant cluster; the provider guides under Install are about hosting Cozystack itself.

What it does not do

Checks

  • Values and keys verified against packages/apps/kubernetes{,-nodes}/values.yaml and the kubernetes chart README on main (aed7fa896).
  • capmox privileges and env vars match the provider's docs/Usage.md; the CCM/CSI region meaning matches proxmox-cloud-controller-manager docs/config.md.
  • All hostnames, pools and address ranges in the examples are placeholders.
  • Not built locally (no Hugo here); relying on the Netlify deploy preview.

Related: cozystack/cozystack#3481, cozystack/community#98, #741.

Add a page under Managed Kubernetes for substrate: proxmox, the opt-in
option that runs the workers of a tenant cluster on an external Proxmox VE
cluster through capmox: what runs where, the support matrix, enabling the
packages, Proxmox user/token/pool setup with the privileges the charts
document, the Talos template script, Kubernetes and KubernetesNodes values,
verification, the isolation model, limitations and troubleshooting.

Assisted-by: LLM
Signed-off-by: Marian Koreniuk <moriarti@cp.if.ua>
@netlify

netlify Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit 78e5af5
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/6ad733ea40841a381a2ec001
😎 Deploy Preview https://deploy-preview-761--cozystack.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: c9c5e608-c342-4553-accc-a4731eb91bae
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant