Skip to content

docs(networking): explain FQDN policy limitations with CNI chaining - #766

Open
Fedor Batonogov (batonogov) wants to merge 1 commit into
cozystack:mainfrom
batonogov:docs/fqdn-chaining-limitations
Open

Fedor Batonogov (batonogov) wants to merge 1 commit into
cozystack:mainfrom
batonogov:docs/fqdn-chaining-limitations

Conversation

@batonogov

Copy link
Copy Markdown

The default Kube-OVN + Cilium stack uses generic-veth chaining, whose L7 limitations are not explained on the network architecture page. Users who need both VM networking and FQDN egress policies have no documented placement option.

Document the limitation in v1.6 and next, explain the L3/L4 alternatives, and describe placing affected workloads in a managed Kubernetes cluster with Cilium as the primary CNI while retaining the management cluster's networking. Clarify policy scope, DNS-derived IP enforcement, and the need to test allowed and denied traffic.

Related to cozystack/cozystack#3820. The SecurityGroup API question remains outside this documentation change.

Validation: independent technical, security/anonymization, and documentation reviews; git diff --check; i18n key parity and translation freshness checks; Hugo 0.164.0 preview build and inspection of both generated pages. No deployment-specific identifiers or configuration are included. This PR changes documentation only; it does not validate a live dataplane.

@netlify

netlify Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit 79b37f9
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/6ad8c5d3fcb6618f93463dad
😎 Deploy Preview https://deploy-preview-766--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 21, 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: f4be6eed-8a02-4afd-9f89-18f2b540799a
  • 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.

myasnikovdaniil added a commit that referenced this pull request Oct 30, 2026
On the Kube-OVN + Cilium stack Cilium runs chained in generic-veth mode,
where its Layer 7 policy, toFQDNs included, is not reliable, and a
CiliumNetworkPolicy the API accepts can still do nothing on the
dataplane. #766 warns about it and points to a managed Kubernetes
cluster with Cilium as its primary CNI, but only in next/ and v1.6/.

Both hold for v1.7.0: the kubeovn variant of the cilium package still
sets chainingMode: generic-veth, and a tenant Kubernetes cluster always
installs Cilium as its CNI.

The change is #766's next/ diff with the rewrite release_next.sh
applies. next/ and v1.6/ stay with #766.

Assisted-By: LLM
Signed-off-by: Myasnikov Daniil <[email protected]>
myasnikovdaniil added a commit that referenced this pull request Oct 30, 2026
On the Kube-OVN + Cilium stack Cilium runs chained in generic-veth mode,
where its Layer 7 policy, toFQDNs included, is not reliable, and a
CiliumNetworkPolicy the API accepts can still do nothing on the
dataplane. #766 warns about it and points to a managed Kubernetes
cluster with Cilium as its primary CNI, but only in next/ and v1.6/.

Both hold for v1.7.0: the kubeovn variant of the cilium package still
sets chainingMode: generic-veth, and a tenant Kubernetes cluster always
installs Cilium as its CNI.

The change is #766's next/ diff with the rewrite release_next.sh
applies. next/ and v1.6/ stay with #766.

Assisted-By: LLM
Signed-off-by: Myasnikov Daniil <[email protected]>
myasnikovdaniil added a commit that referenced this pull request Oct 30, 2026
)

The v1.7 docs were cut from `next/` in
#780 while several docs PRs
about v1.7.0 behaviour were still open against `next/` only, so
`/docs/v1.7/` and the stable `/docs/` copy miss them. This adds their
content to `content/en/docs/v1.7/`, checked against the v1.7.0 tag.
Every page is the source PR's `next/` file with the same `/docs/next/`
rewrite that `hack/release_next.sh` does, except where noted.

- #763
- #747, hand-merged after
`networking.kubeovn.MASTER_NODES` because main got the
`networking.encryption.enabled` row after its base
- #761, with four corrections
below
- #762
- #766
- #764, the HTTPCache section
of the upgrade guide, in both `next/` and `v1.7/` on top of the fixes
from #781. I'm not carrying 764
further, this PR takes over its content.

Four lines of the Proxmox page are wrong for v1.7.0 and are fixed in the
v1.7 copy only. `replicas: 2` in the KubernetesNodes example is now
`minReplicas: 2` and `maxReplicas: 2`, there is no `replicas` field. The
CCM and CSI controller Deployments are `kubernetes-<cluster>-pccm` and
`kubernetes-<cluster>-pcsi-controller`. `bundles.enabledPackages` is set
on the `cozystack.cozystack-platform` Package, no ConfigMap feeds it.
The CSI release depends only on the tenant Cilium release, not on the
CCM, so I cut that clause. The `next/` copy in 761 needs the same fixes.

The `next/` side of 763, 747, 761, 762 and 766 and the `v1.6/` side of
763, 762 and 766 stay in their own PRs, so they still merge without
conflicts with this one. Nothing generated is committed, the stable
`/docs/` copies are built from `v1.7/` at build time.

Hugo production and preview builds, `hack/check-i18n.sh` and a link and
anchor check of every changed page pass locally, with the same Hugo
warnings as main.

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