Skip to content

[DE-4343] Add VKS install page under Install on clusters#2809

Open
sabags wants to merge 4 commits into
tigera:mainfrom
sabags:add-vks-ce-install-docs
Open

[DE-4343] Add VKS install page under Install on clusters#2809
sabags wants to merge 4 commits into
tigera:mainfrom
sabags:add-vks-ce-install-docs

Conversation

@sabags

@sabags sabags commented Jun 30, 2026

Copy link
Copy Markdown
Collaborator

What

Adds a new VMware Kubernetes Service (VKS) install page under Getting started → Install on clusters (Calico Enterprise), wired into the sidebar after TKG.

The page covers installing Calico Enterprise on VKS:

  • Part 1 — Supervisor Service setup (Carvel package build/publish)
  • Part 2 — guest-cluster deployment, with optional Windows node support
  • Parts 3–4 — air-gapped bundle/image relocation

Source

Ported from tigera/vks CE-install.md (auto-pull-with-tigera-io).

Porting notes

  • Converted the > ℹ️ / ❗ / 💡 / 🛑 blockquote callouts to Docusaurus :::note / :::info / :::tip / :::caution.
  • Removed an internal vSphere lab URL.
  • Made the private-registry cross-link site-relative.
  • Used $[prodname] in body prose (frontmatter description kept literal, per convention).
  • Excluded the author's internal "New changes" packaging notes from the source file — they describe tigera/vks repo changes, not user-facing install steps.

Add a "VMware Kubernetes Service (VKS)" page to the Calico Enterprise
install-on-clusters section and wire it into the sidebar after TKG.

Covers installing Calico Enterprise on VKS: Part 1 Supervisor Service setup
(Carvel package build/publish), Part 2 guest-cluster deployment with optional
Windows node support, and Parts 3-4 air-gapped bundle/image relocation.

Ported from tigera/vks CE-install.md: blockquote callouts converted to
Docusaurus admonitions, an internal vSphere lab URL removed, the private-
registry cross-link made site-relative, and $[prodname] used in body prose.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@sabags sabags requested a review from a team as a code owner June 30, 2026 00:14
Copilot AI review requested due to automatic review settings June 30, 2026 00:14
@netlify

netlify Bot commented Jun 30, 2026

Copy link
Copy Markdown

Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 2a1e5cf
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6a43156a616db6000850a581
😎 Deploy Preview https://deploy-preview-2809--calico-docs-preview-next.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.

@netlify

netlify Bot commented Jun 30, 2026

Copy link
Copy Markdown

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 2a1e5cf
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6a43156ae0d67800081c40d7
😎 Deploy Preview https://deploy-preview-2809--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: 71 (🔴 down 17 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (🟢 up 9 from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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.

Pull request overview

Adds a new Calico Enterprise “Install on clusters” guide for VMware Kubernetes Service (VKS) and wires it into the Calico Enterprise sidebar under “Getting started → Install on clusters” (placed after TKG).

Changes:

  • Added a new vks.mdx installation guide covering Supervisor Service packaging/publish, guest-cluster deployment (incl. optional Windows), and air-gapped relocation steps.
  • Updated the Calico Enterprise sidebar to include the new VKS page.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
sidebars-calico-enterprise.js Adds the VKS install page to the “Install on clusters” navigation after TKG.
calico-enterprise/getting-started/install-on-clusters/vks.mdx New end-to-end VKS install guide (Supervisor Service + guest clusters + optional Windows + air-gapped relocation).

Comment thread calico-enterprise/getting-started/install-on-clusters/vks.mdx Outdated
Comment thread calico-enterprise/getting-started/install-on-clusters/vks.mdx Outdated
Comment thread calico-enterprise/getting-started/install-on-clusters/vks.mdx Outdated
Comment thread calico-enterprise/getting-started/install-on-clusters/vks.mdx Outdated
sabags and others added 3 commits June 29, 2026 17:26
Copy the VKS install page into calico-enterprise_versioned_docs/version-3.23-2
and add it to that version's sidebar after TKG. Also switch the private-registry
cross-link from an absolute /latest path to a relative .mdx link so it resolves
to the correct version on both the latest and versioned pages.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Fix "Configmap" -> "ConfigMap" (correct Kubernetes kind casing) in the Step 6 heading.
- Use kubectl apply -f for the Tigera license (idempotent on re-runs) instead of create -f.
- Use grep -E 'tigera|calico' in the verification step (portable; BRE \| isn't on BSD/macOS grep).

Copilot's /latest-link comment was already resolved by the prior relative-.mdx-link change.
Applied to both the latest and 3.23-2 versioned copies.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Reorganize into Big picture / Before you begin / How to / Next steps to match
the other "Install on clusters" pages (tkg, openshift, etc.); the Parts 1-4
procedure now lives under How to as ### subsections. Drop the body --- rules
(headings already delimit sections), rename per-part "Prerequisites" headings
to avoid duplicate slugs, update in-page anchor links to the new slugs, and add
a Next steps section. Applied to both the latest and 3.23-2 versioned copies.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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