Skip to content

DOCS-3167: Recommend --network-policy none on AKS - #3213

Draft
ctauchen wants to merge 2 commits into
tigera:mainfrom
ctauchen:aks-network-policy-none
Draft

ctauchen wants to merge 2 commits into
tigera:mainfrom
ctauchen:aks-network-policy-none

Conversation

@ctauchen

@ctauchen ctauchen commented Nov 13, 2026 •

Copy link
Copy Markdown
Collaborator

The Calico Cloud system requirements page now recommends --network-policy none on AKS. It also warns about clusters made with --network-policy calico.

Jira: https://tigera.atlassian.net/browse/DOCS-3167
Preview: https://deploy-preview-3213--calico-docs-preview-next.netlify.app/calico-cloud/get-started/system-requirements#azure-kubernetes-service

Flags:

  • Is --network-policy calico still supported for new installs? This PR marks it "not recommended".
  • After --network-policy none, does az aks show report null or "none"? The page says null.

Copilot AI lite review requested due to automatic review settings November 13, 2026 12:15
@netlify

netlify Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

👷 Deploy request for calico-docs-preview-next pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit b2adafd

@netlify

netlify Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit b2adafd
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6af6ff726035ef234eda1607
😎 Deploy Preview https://deploy-preview-3213--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 95 (🔴 down 2 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The documentation contains an unresolved inconsistency about whether --network-policy none yields networkPolicy: null or "none", leaving the supported value and verification guidance unclear in both affected files.

2 open issues
What changed in this PR

Updates Calico Cloud AKS system requirements to recommend disabling AKS-managed network policy and warn about the operational risks of using Azure-managed Calico.

Changes:

  • Recommends creating AKS clusters with --network-policy none.
  • Marks networkPolicy: "calico" as supported but not recommended.
  • Adds warnings about AKS-managed Calico resources, migration downtime, and temporary loss of policy enforcement.
File Description
calico-cloud/​get-started/​system-requirements.mdx Updates the current Calico Cloud AKS requirements with network-policy recommendations and migration warnings.
calico-cloud_versioned_docs/​version-24-1/​get-started/​system-requirements.mdx Applies the same AKS network-policy guidance and migration warnings to the version 24.1 documentation.

Review effort: Lite

Comment on lines +147 to +148
We recommend that `networkPolicy` is `null`.
To get this, create your cluster with `--network-policy none`.
Comment on lines +147 to +148
We recommend that `networkPolicy` is `null`.
To get this, create your cluster with `--network-policy none`.
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.

2 participants