From b273e83cd2d0bc9198e0f9e67b060f31842ced02 Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Tue, 17 Mar 2026 14:24:06 -0400 Subject: [PATCH 1/7] Add Kubernetes operator promotion page Create a dedicated DocumentDB Kubernetes Operator landing page, add homepage and docs entry points, and align the copy and styling with the rest of the site while highlighting local, hybrid, and multi-cloud workflows. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/kubernetes-operator/page.tsx | 343 +++++++++++++++++++++++++++++++ app/page.tsx | 84 +++++++- app/services/articleService.ts | 6 +- app/services/externalLinks.ts | 5 + articles/content.yml | 4 +- 5 files changed, 437 insertions(+), 5 deletions(-) create mode 100644 app/kubernetes-operator/page.tsx create mode 100644 app/services/externalLinks.ts diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx new file mode 100644 index 0000000..263f8ea --- /dev/null +++ b/app/kubernetes-operator/page.tsx @@ -0,0 +1,343 @@ +import Link from "next/link"; +import { getMetadata } from "../services/metadataService"; +import { + documentdbKubernetesOperatorDocsUrl, + documentdbKubernetesOperatorGitHubUrl, +} from "../services/externalLinks"; + +const operatorBenefits = [ + { + title: "Local to cloud", + description: + "Start on kind or minikube, then move to managed or self-managed Kubernetes with the same operator model.", + }, + { + title: "Hybrid and multi-cloud", + description: + "The docs include concrete AKS, EKS, GKE, and on-prem deployment patterns for teams spanning more than one environment.", + }, + { + title: "Cross-cluster replication", + description: + "Use documented multi-cluster replication and failover patterns when one cluster is not enough.", + }, + { + title: "HA, backup, and TLS", + description: + "Add automatic failover, backup resources, and TLS to operate DocumentDB as a real service.", + }, + { + title: "Day-2 operations", + description: + "Use the kubectl plugin for status, events, and promotion workflows.", + }, +] as const; + +const setupSteps = [ + { + step: "01", + title: "Prepare the cluster", + description: + "Use kind or minikube locally, or a Kubernetes 1.35+ cluster such as AKS, EKS, or GKE.", + }, + { + step: "02", + title: "Install the operator", + description: + "Deploy the operator so it can reconcile DocumentDB resources and manage cluster lifecycle operations.", + }, + { + step: "03", + title: "Create a DocumentDB resource", + description: + "Apply a DocumentDB custom resource to start locally or grow into replicated topologies as your environment expands.", + }, +] as const; + +const operatorHighlights = [ + "kind + minikube quickstart", + "AKS / EKS / GKE", + "Hybrid / on-prem guide", + "Cross-cluster replication", + "Backup + ScheduledBackup resources", + "kubectl plugin for operator workflows", + "TLS-aware deployment model", +] as const; + +const bestFitScenarios = [ + "Teams starting on local clusters and growing toward managed Kubernetes.", + "Platform teams spanning cloud and on-prem Kubernetes environments.", + "Operators that need cross-cluster replication and promotion workflows.", +] as const; + +export const metadata = getMetadata({ + title: "DocumentDB Kubernetes Operator", + description: + "Learn how the DocumentDB Kubernetes Operator takes DocumentDB from local Kubernetes clusters to hybrid and multi-cloud topologies with replication, HA, backups, and TLS.", + extraKeywords: [ + "Kubernetes", + "operator", + "Helm", + "multi-cloud", + "hybrid", + "on-prem", + "cross-cluster replication", + "high availability", + "backup", + "TLS", + ], +}); + +export default function KubernetesOperatorPage() { + return ( +
+
+
+
+
+
+

+ Operator preview +

+

+ DocumentDB Kubernetes Operator +

+

+ Start on kind or minikube. Expand to{" "} + hybrid and multi-cloud Kubernetes. +

+

+ Install with Helm, manage with custom resources, and extend to + documented cross-cluster replication, failover, backups, and + TLS. +

+
+ + Open quick start + + + GitHub repository + + + View local install guides + +
+
+ +
+
+ + Where it fits + +

+ Built for local, hybrid, and multi-cluster paths +

+

+ Use the operator when one cluster is not enough and you want a + consistent Kubernetes operating model. +

+
+ +
    + {bestFitScenarios.map((item) => ( +
  • + + + + + +

    {item}

    +
    • + ))} +
+ +
+

+ Operator highlights +

+
+ {operatorHighlights.map((item) => ( + + {item} + + ))} +
+

+ Preview status +

+

+ The operator is still in preview. Use this page to assess the + fit, then follow the quick start or multi-cluster guides. +

+
+
+
+
+
+ +
+
+
+

+ What the operator adds +

+

+ A better fit for Kubernetes-based DocumentDB environments +

+

+ Choose the operator when one cluster is not enough and you want + the same operating model across local, hybrid, and multi-cloud + environments. +

+
+ +
+ {operatorBenefits.map((item) => ( +
+
+ + + +
+

{item.title}

+

+ {item.description} +

+
+ ))} +
+
+
+ +
+
+
+

+ Setup at a glance +

+

+ The operator flow in three steps +

+

+ Use this page to understand the path. Use the docs for commands, + topology setup, and current support details. +

+
+ +
+ {setupSteps.map((item) => ( +
+ + {item.step} + +

+ {item.title} +

+

+ {item.description} +

+
+ ))} +
+ +
+
+
+

+ What to expect before you start +

+

+ The operator currently targets Kubernetes 1.35+ and depends on + cert-manager and CloudNativePG. Cross-cluster topologies also + require network connectivity between clusters. +

+
+ + Open quick start + +
+
+
+
+ +
+
+

+ Next step +

+

+ Start local, then expand +

+

+ Use the quick start for a local cluster. Then continue with the + hybrid and multi-cloud guides. +

+
+ + Open quick start + + + GitHub repository + + + View local install guides + +
+
+
+
+ ); +} diff --git a/app/page.tsx b/app/page.tsx index b49681c..aba0ef9 100644 --- a/app/page.tsx +++ b/app/page.tsx @@ -1,6 +1,7 @@ import Image from "next/image"; import Link from "next/link"; import CommandSnippet from "./components/CommandSnippet"; +import { documentdbKubernetesOperatorDocsUrl } from "./services/externalLinks"; import { withBasePath } from "./services/sitePath"; type CapabilityIconName = @@ -26,7 +27,26 @@ const quickStartSteps = [ }, { step: "03", - description: "Continue with the docs or prebuilt packages.", + description: "Continue with the docs or Linux packages for the setup you need.", + }, +]; + +const kubernetesOperatorEntryPoints = [ + { + title: "Local clusters", + description: "Start on kind or minikube for local Kubernetes development.", + }, + { + title: "Hybrid and multi-cloud", + description: "Use documented AKS, EKS, GKE, and on-prem deployment guides.", + }, + { + title: "Replication and resilience", + description: "Extend to cross-cluster replication, HA, backups, and TLS.", + }, + { + title: "Day-2 operations", + description: "Use the kubectl plugin for status, events, and promotion.", }, ]; @@ -578,6 +598,68 @@ export default function Home() { +
+
+
+

+ Operator preview +

+

+ DocumentDB Kubernetes Operator +

+

+ Run DocumentDB on Kubernetes—from kind and minikube to{" "} + hybrid and multi-cloud deployments. +

+
+ +
+ {kubernetesOperatorEntryPoints.map((item) => ( +
+

+ {item.title} +

+

+ {item.description} +

+
+ ))} +
+ +
+
+
+

+ Preview with local, hybrid, and multi-cluster paths +

+

+ The operator is still in preview. Start with the overview, then + follow the quick start or multi-cluster guides. +

+
+ +
+ + Read operator overview + + + Open quick start + +
+
+
+
+
+

diff --git a/app/services/articleService.ts b/app/services/articleService.ts index 49991c8..1f79758 100644 --- a/app/services/articleService.ts +++ b/app/services/articleService.ts @@ -109,7 +109,7 @@ function splitPrebuiltNavigation(section: string, links: Link[]): Link[] { const isPrebuiltPackages = (link: Link) => link.link.includes('prebuilt-packages') || /pre-built packages/i.test(link.title); - const dockerAndLinuxLinks: Link[] = [ + const gettingStartedQuickLinks: Link[] = [ { title: 'Docker', link: '/docs/getting-started/docker', @@ -123,11 +123,11 @@ function splitPrebuiltNavigation(section: string, links: Link[]): Link[] { const gettingStartedIndex = filteredLinks.find((link) => link.link === 'index.md'); if (!gettingStartedIndex) { - return [...dockerAndLinuxLinks, ...filteredLinks]; + return [...gettingStartedQuickLinks, ...filteredLinks]; } const remainingLinks = filteredLinks.filter((link) => link !== gettingStartedIndex); - return [gettingStartedIndex, ...dockerAndLinuxLinks, ...remainingLinks]; + return [gettingStartedIndex, ...gettingStartedQuickLinks, ...remainingLinks]; } function updateGettingStartedIndexContent(content: string): string { diff --git a/app/services/externalLinks.ts b/app/services/externalLinks.ts new file mode 100644 index 0000000..eab069c --- /dev/null +++ b/app/services/externalLinks.ts @@ -0,0 +1,5 @@ +export const documentdbKubernetesOperatorDocsUrl = + 'https://documentdb.io/documentdb-kubernetes-operator/preview/'; + +export const documentdbKubernetesOperatorGitHubUrl = + 'https://github.com/documentdb/documentdb-kubernetes-operator'; diff --git a/articles/content.yml b/articles/content.yml index 8514350..c3c5065 100644 --- a/articles/content.yml +++ b/articles/content.yml @@ -4,6 +4,8 @@ landing: links: - title: Getting Started with DocumentDB link: /docs/getting-started + - title: DocumentDB Kubernetes Operator (Preview) + link: /kubernetes-operator - title: API Reference link: /docs/reference - title: Postgres Extension API @@ -11,4 +13,4 @@ landing: - title: DocumentDB Local link: /docs/documentdb-local - title: Architecture under the hood - link: /docs/architecture \ No newline at end of file + link: /docs/architecture From 9c2473740e0fcf79365593074bdf0ddff3425d01 Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Tue, 17 Mar 2026 14:35:11 -0400 Subject: [PATCH 2/7] Remove operator local guides CTA Remove the "View local install guides" buttons from the DocumentDB Kubernetes Operator landing page so the page stays focused on the operator quick start and repository links. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/kubernetes-operator/page.tsx | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx index 263f8ea..a7009bc 100644 --- a/app/kubernetes-operator/page.tsx +++ b/app/kubernetes-operator/page.tsx @@ -1,4 +1,3 @@ -import Link from "next/link"; import { getMetadata } from "../services/metadataService"; import { documentdbKubernetesOperatorDocsUrl, @@ -124,12 +123,6 @@ export default function KubernetesOperatorPage() { > GitHub repository - - View local install guides -

@@ -329,12 +322,6 @@ export default function KubernetesOperatorPage() { > GitHub repository - - View local install guides -
From 1b1a4882b217aa8fb42685525cb1f54c3a814ee2 Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Tue, 17 Mar 2026 14:39:40 -0400 Subject: [PATCH 3/7] Refine operator benefit cards Replace the generic plus icon in the operator benefits section with clearer icons, shorten the card copy, and give the grid more room so the section reads faster. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/kubernetes-operator/page.tsx | 132 ++++++++++++++++++++++++------- 1 file changed, 105 insertions(+), 27 deletions(-) diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx index a7009bc..22d2436 100644 --- a/app/kubernetes-operator/page.tsx +++ b/app/kubernetes-operator/page.tsx @@ -4,34 +4,124 @@ import { documentdbKubernetesOperatorGitHubUrl, } from "../services/externalLinks"; +type OperatorBenefitIcon = "cluster" | "globe" | "replication" | "shield" | "terminal"; + const operatorBenefits = [ { - title: "Local to cloud", - description: - "Start on kind or minikube, then move to managed or self-managed Kubernetes with the same operator model.", + title: "Local first", + description: "Start on kind or minikube, then scale out.", + icon: "cluster" as const, }, { title: "Hybrid and multi-cloud", - description: - "The docs include concrete AKS, EKS, GKE, and on-prem deployment patterns for teams spanning more than one environment.", + description: "Keep one operator model across cloud and on-prem clusters.", + icon: "globe" as const, }, { title: "Cross-cluster replication", - description: - "Use documented multi-cluster replication and failover patterns when one cluster is not enough.", + description: "Replicate across clusters and promote when needed.", + icon: "replication" as const, }, { title: "HA, backup, and TLS", - description: - "Add automatic failover, backup resources, and TLS to operate DocumentDB as a real service.", + description: "Add failover, backups, and secure connectivity.", + icon: "shield" as const, }, { - title: "Day-2 operations", - description: - "Use the kubectl plugin for status, events, and promotion workflows.", + title: "Day-2 tooling", + description: "Use the kubectl plugin for status and promotion tasks.", + icon: "terminal" as const, }, ] as const; +function OperatorBenefitGlyph({ icon }: { icon: OperatorBenefitIcon }) { + switch (icon) { + case "cluster": + return ( + + + + + + + ); + case "globe": + return ( + + + + ); + case "replication": + return ( + + + + ); + case "shield": + return ( + + + + ); + case "terminal": + return ( + + + + ); + } +} + const setupSteps = [ { step: "01", @@ -209,28 +299,16 @@ export default function KubernetesOperatorPage() {

-
+
{operatorBenefits.map((item) => (
- - - +
-

{item.title}

+

{item.title}

{item.description}

From 70029ab83d5da7b57a64382f4114f9d2dde9e74d Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Tue, 17 Mar 2026 15:25:21 -0400 Subject: [PATCH 4/7] Modify words --- app/kubernetes-operator/page.tsx | 55 +++++++++++++++++--------------- 1 file changed, 30 insertions(+), 25 deletions(-) diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx index 22d2436..1e3cde5 100644 --- a/app/kubernetes-operator/page.tsx +++ b/app/kubernetes-operator/page.tsx @@ -8,28 +8,33 @@ type OperatorBenefitIcon = "cluster" | "globe" | "replication" | "shield" | "ter const operatorBenefits = [ { - title: "Local first", - description: "Start on kind or minikube, then scale out.", + title: "Local to cloud", + description: + "Start on kind or minikube, then use the same operator model on managed or self-managed Kubernetes.", icon: "cluster" as const, }, { title: "Hybrid and multi-cloud", - description: "Keep one operator model across cloud and on-prem clusters.", + description: + "Use one operator model across AKS, EKS, GKE, and on-prem clusters.", icon: "globe" as const, }, { title: "Cross-cluster replication", - description: "Replicate across clusters and promote when needed.", + description: + "Replicate across clusters and promote a new primary when you need cross-cluster failover.", icon: "replication" as const, }, { title: "HA, backup, and TLS", - description: "Add failover, backups, and secure connectivity.", + description: + "Add automatic failover, Backup and ScheduledBackup resources, and configurable TLS modes.", icon: "shield" as const, }, { - title: "Day-2 tooling", - description: "Use the kubectl plugin for status and promotion tasks.", + title: "Day-2 operations", + description: + "Use the kubectl plugin for status, events, and promotion workflows.", icon: "terminal" as const, }, ] as const; @@ -133,30 +138,30 @@ const setupSteps = [ step: "02", title: "Install the operator", description: - "Deploy the operator so it can reconcile DocumentDB resources and manage cluster lifecycle operations.", + "Install cert-manager, CloudNativePG, and the DocumentDB operator with Helm.", }, { step: "03", title: "Create a DocumentDB resource", description: - "Apply a DocumentDB custom resource to start locally or grow into replicated topologies as your environment expands.", + "Apply a DocumentDB custom resource to launch a cluster, then expand into replicated topologies as needed.", }, ] as const; const operatorHighlights = [ - "kind + minikube quickstart", + "kind + minikube", "AKS / EKS / GKE", - "Hybrid / on-prem guide", + "Hybrid / on-prem", "Cross-cluster replication", - "Backup + ScheduledBackup resources", - "kubectl plugin for operator workflows", - "TLS-aware deployment model", + "Backup + ScheduledBackup CRDs", + "kubectl plugin workflows", + "Configurable TLS modes", ] as const; const bestFitScenarios = [ - "Teams starting on local clusters and growing toward managed Kubernetes.", - "Platform teams spanning cloud and on-prem Kubernetes environments.", - "Operators that need cross-cluster replication and promotion workflows.", + "Teams moving from local Kubernetes clusters to managed environments.", + "Platform teams standardizing DocumentDB operations across cloud and on-prem clusters.", + "Operators that need replication, promotion, and recovery workflows across clusters.", ] as const; export const metadata = getMetadata({ @@ -196,9 +201,9 @@ export default function KubernetesOperatorPage() { hybrid and multi-cloud Kubernetes.

- Install with Helm, manage with custom resources, and extend to - documented cross-cluster replication, failover, backups, and - TLS. + Install with Helm, manage with custom resources, and run + DocumentDB on Kubernetes with replication, failover, backups, + and TLS.

@@ -293,9 +299,8 @@ export default function KubernetesOperatorPage() { A better fit for Kubernetes-based DocumentDB environments

- Choose the operator when one cluster is not enough and you want - the same operating model across local, hybrid, and multi-cloud - environments. + The operator adds Kubernetes-native lifecycle management, + recovery, and cross-cluster workflows on top of DocumentDB.

From 4fa3a7dc5ce51461f72f14a641aad437fefc7385 Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Wed, 18 Mar 2026 09:55:15 -0400 Subject: [PATCH 5/7] Improve Kubernetes operator page and lint config Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/components/Code.tsx | 2 +- app/components/Index.tsx | 2 +- app/kubernetes-operator/page.tsx | 210 ++++++++++++----- app/services/metadataService.ts | 4 +- dko-page-review.md | 391 +++++++++++++++++++++++++++++++ eslint.config.mjs | 43 +++- tailwind.config.ts | 2 +- 7 files changed, 581 insertions(+), 73 deletions(-) create mode 100644 dko-page-review.md diff --git a/app/components/Code.tsx b/app/components/Code.tsx index 6c56842..ba07d40 100644 --- a/app/components/Code.tsx +++ b/app/components/Code.tsx @@ -21,5 +21,5 @@ export default function Index({ {code} - ) + ); } diff --git a/app/components/Index.tsx b/app/components/Index.tsx index 337b064..2dbba7d 100644 --- a/app/components/Index.tsx +++ b/app/components/Index.tsx @@ -1,4 +1,4 @@ -'use client' +"use client"; import Link from 'next/link'; import { usePathname } from 'next/navigation'; diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx index 1e3cde5..6a22cb6 100644 --- a/app/kubernetes-operator/page.tsx +++ b/app/kubernetes-operator/page.tsx @@ -1,47 +1,72 @@ +import CommandSnippet from "../components/CommandSnippet"; import { getMetadata } from "../services/metadataService"; import { documentdbKubernetesOperatorDocsUrl, documentdbKubernetesOperatorGitHubUrl, } from "../services/externalLinks"; -type OperatorBenefitIcon = "cluster" | "globe" | "replication" | "shield" | "terminal"; +type OperatorBenefitIcon = + | "database" + | "foundation" + | "globe" + | "replication" + | "shield" + | "terminal"; const operatorBenefits = [ { - title: "Local to cloud", + eyebrow: "Compatibility", + title: "MongoDB-compatible", description: - "Start on kind or minikube, then use the same operator model on managed or self-managed Kubernetes.", - icon: "cluster" as const, + "Run DocumentDB with standard MongoDB drivers and tools, then manage it with Kubernetes custom resources.", + highlights: ["PyMongo", "Node.js", "mongosh"], + icon: "database" as const, }, { + eyebrow: "Foundation", + title: "Built on PostgreSQL", + description: + "Use CloudNativePG and PostgreSQL under the hood while keeping a document database workflow on Kubernetes.", + highlights: ["PostgreSQL", "CloudNativePG", "ACID"], + icon: "foundation" as const, + }, + { + eyebrow: "Topology", title: "Hybrid and multi-cloud", description: - "Use one operator model across AKS, EKS, GKE, and on-prem clusters.", + "Use one operator model across kind, minikube, AKS, EKS, GKE, and connected on-prem clusters.", + highlights: ["kind + minikube", "AKS / EKS / GKE", "On-prem"], icon: "globe" as const, }, { - title: "Cross-cluster replication", + eyebrow: "Resilience", + title: "Failover and recovery", description: - "Replicate across clusters and promote a new primary when you need cross-cluster failover.", + "Add automatic failover, cross-cluster replication, and Backup and ScheduledBackup workflows for recovery.", + highlights: ["5-15s failover", "Cross-cluster", "Backup CRDs"], icon: "replication" as const, }, { - title: "HA, backup, and TLS", + eyebrow: "Security", + title: "TLS and access controls", description: - "Add automatic failover, Backup and ScheduledBackup resources, and configurable TLS modes.", + "Choose preview or production TLS modes and integrate with secrets, SCRAM auth, RBAC, and secure cluster networking.", + highlights: ["4 TLS modes", "SCRAM", "RBAC"], icon: "shield" as const, }, { + eyebrow: "Operations", title: "Day-2 operations", description: - "Use the kubectl plugin for status, events, and promotion workflows.", + "Use the kubectl plugin plus events and metrics to inspect status, troubleshoot, and promote a new primary when needed.", + highlights: ["kubectl plugin", "Events", "Metrics"], icon: "terminal" as const, }, ] as const; function OperatorBenefitGlyph({ icon }: { icon: OperatorBenefitIcon }) { switch (icon) { - case "cluster": + case "database": return ( - - - + + + + + ); + case "foundation": + return ( + + + ); @@ -132,52 +194,61 @@ const setupSteps = [ step: "01", title: "Prepare the cluster", description: - "Use kind or minikube locally, or a Kubernetes 1.35+ cluster such as AKS, EKS, or GKE.", + "Use kind or minikube locally, or a Kubernetes 1.35+ cluster such as AKS, EKS, or GKE for the current preview install path.", }, { step: "02", title: "Install the operator", description: - "Install cert-manager, CloudNativePG, and the DocumentDB operator with Helm.", + "Install cert-manager, then add the DocumentDB operator with Helm. CloudNativePG is included as a chart dependency.", }, { step: "03", title: "Create a DocumentDB resource", description: - "Apply a DocumentDB custom resource to launch a cluster, then expand into replicated topologies as needed.", + "Apply a DocumentDB custom resource to launch a MongoDB-compatible database built on PostgreSQL, then expand into replicated topologies as needed.", }, ] as const; const operatorHighlights = [ - "kind + minikube", - "AKS / EKS / GKE", - "Hybrid / on-prem", - "Cross-cluster replication", + "MongoDB-compatible", + "Built on PostgreSQL", + "MIT licensed", + "5-15s failover", "Backup + ScheduledBackup CRDs", + "AKS / EKS / GKE", "kubectl plugin workflows", - "Configurable TLS modes", + "Prometheus-ready", ] as const; const bestFitScenarios = [ - "Teams moving from local Kubernetes clusters to managed environments.", - "Platform teams standardizing DocumentDB operations across cloud and on-prem clusters.", - "Operators that need replication, promotion, and recovery workflows across clusters.", + "Teams moving MongoDB-compatible workloads from local clusters to managed Kubernetes.", + "Platform teams standardizing PostgreSQL-backed DocumentDB operations across cloud and on-prem clusters.", + "Operators that need failover, backup, promotion, and recovery workflows across clusters.", ] as const; +const operatorQuickStartCommand = `helm repo add documentdb https://documentdb.github.io/documentdb-kubernetes-operator +helm install documentdb-operator documentdb/documentdb-operator \\ + --namespace documentdb-operator --create-namespace`; + export const metadata = getMetadata({ title: "DocumentDB Kubernetes Operator", description: - "Learn how the DocumentDB Kubernetes Operator takes DocumentDB from local Kubernetes clusters to hybrid and multi-cloud topologies with replication, HA, backups, and TLS.", + "Run MongoDB-compatible DocumentDB on Kubernetes with a PostgreSQL foundation, replication, HA, backups, TLS, and hybrid or multi-cloud topologies.", extraKeywords: [ "Kubernetes", "operator", "Helm", + "MongoDB compatible", + "PostgreSQL", + "CloudNativePG", "multi-cloud", "hybrid", "on-prem", "cross-cluster replication", "high availability", "backup", + "ScheduledBackup", "TLS", ], }); @@ -197,13 +268,13 @@ export default function KubernetesOperatorPage() { DocumentDB Kubernetes Operator

- Start on kind or minikube. Expand to{" "} - hybrid and multi-cloud Kubernetes. + Run MongoDB-compatible DocumentDB on Kubernetes.{" "} + Built on PostgreSQL for local, hybrid, and multi-cloud paths.

- Install with Helm, manage with custom resources, and run - DocumentDB on Kubernetes with replication, failover, backups, - and TLS. + Install with Helm, manage with custom resources, and add + failover, replication, backups, TLS, and day-2 workflows from a + single operator model.

+
+ {operatorHighlights.map((badge) => ( + + {badge} + + ))} +
@@ -227,12 +308,12 @@ export default function KubernetesOperatorPage() { Where it fits

- Built for local, hybrid, and multi-cluster paths + Built for Kubernetes-native document database operations

- Use the operator when you want Kubernetes-native lifecycle - management for local clusters, HA topologies, or - multi-cluster deployments. + Use the operator when you want MongoDB-compatible DocumentDB + on PostgreSQL with Kubernetes-native lifecycle management for + local clusters, HA topologies, or multi-cluster deployments.

@@ -264,24 +345,12 @@ export default function KubernetesOperatorPage() {

- Operator highlights -

-
- {operatorHighlights.map((item) => ( - - {item} - - ))} -
-

Preview status

- The operator is still in preview. Use this page to assess the - fit, then follow the quick start or multi-cluster guides. + The operator is still in preview. Use this page to assess fit, + then follow the quick start or multi-cluster guides for the + current support envelope.

@@ -313,10 +382,23 @@ export default function KubernetesOperatorPage() {
+

+ {item.eyebrow} +

{item.title}

{item.description}

+
+ {item.highlights.map((highlight) => ( + + {highlight} + + ))} +
))} @@ -338,6 +420,18 @@ export default function KubernetesOperatorPage() {

+
+
+

See the install shape

+

+ Install cert-manager first, then add the operator chart. The + current preview install path brings in CloudNativePG as a + dependency. +

+
+ +
+
{setupSteps.map((item) => (

- The operator currently targets Kubernetes 1.35+ and depends on - cert-manager and CloudNativePG. Cross-cluster topologies also - require network connectivity between clusters. + The current preview install path targets Kubernetes 1.35+, + depends on cert-manager, and uses CloudNativePG under the + hood. Cross-cluster topologies also require network + connectivity between clusters and the documented multi-cluster + setup.

- Start local, then expand + Start with the quick start, then expand

- Use the quick start for a local cluster. Then continue with the - hybrid and multi-cloud guides. + Use the quick start to launch the operator, then continue with + replication, hybrid, and multi-cluster guides.

=> { if (!markdown) return ''; - let processor = remark().use(strip).process(markdown); + const processor = remark().use(strip).process(markdown); - let output: string = String(await processor); + const output: string = String(await processor); return output.trim(); }; diff --git a/dko-page-review.md b/dko-page-review.md new file mode 100644 index 0000000..22e016d --- /dev/null +++ b/dko-page-review.md @@ -0,0 +1,391 @@ +# DocumentDB Kubernetes Operator — Page Review & Analysis + +> **Reviewer:** AI Code Review Agent (Copilot CLI) +> **Date:** 2026-03-17 +> **File Reviewed:** `app/kubernetes-operator/page.tsx` +> **Context:** Deep analysis of the [documentdb](https://github.com/documentdb/documentdb) and [documentdb-kubernetes-operator](https://github.com/documentdb/documentdb-kubernetes-operator) repositories, cross-referenced against the live landing page. + +--- + +## Table of Contents + +1. [Understanding the Product](#1-understanding-the-product) +2. [Understanding the Page](#2-understanding-the-page) +3. [Findings — Critical Content Gaps](#3-findings--critical-content-gaps) +4. [Findings — Missing Technical Information](#4-findings--missing-technical-information) +5. [Findings — Design & Consistency](#5-findings--design--consistency) +6. [Commentary on Current Wording](#6-commentary-on-current-wording) +7. [What the Page Gets Right](#7-what-the-page-gets-right) +8. [Recommendations Summary](#8-recommendations-summary) + +--- + +## 1. Understanding the Product + +Before reviewing the page, I did a full repository audit of both `documentdb` and `documentdb-kubernetes-operator`. Here's what the operator actually is, verified from source code, docs, CRD definitions, controllers, Helm charts, and playground examples. + +### What DocumentDB Is + +DocumentDB is an **open-source, MongoDB-compatible document database built on PostgreSQL**, governed by the Linux Foundation under the MIT license. It consists of: + +- **pg_documentdb_core** — BSON datatype and low-level ops (C PostgreSQL extension) +- **pg_documentdb_api** — CRUD and MongoDB API surface (C extension) +- **pg_documentdb_gw** — MongoDB wire protocol translation (Rust gateway) +- **pg_documentdb_distributed** — Sharding and distributed deployment + +Standard MongoDB drivers (PyMongo, Node.js, Java, Go, C++) work without code changes. The Technical Steering Committee includes representatives from Microsoft, Amazon, AB InBev, Rippling, and YugabyteDB. + +### What the Kubernetes Operator Is + +The operator is a **production-grade Kubernetes operator** (Go, Kubebuilder/controller-runtime, built on CloudNative-PG) that fully automates DocumentDB lifecycle management. Verified capabilities from source code: + +| Capability | Implementation Details | +|---|---| +| **CRDs** | 3 custom resources: DocumentDB (cluster), Backup (VolumeSnapshot), ScheduledBackup (cron) | +| **Controllers** | 6 reconciliation loops: cluster lifecycle, backup, scheduled backup, certificates, physical replication, PV recovery | +| **High Availability** | 1 primary + 2 standby replicas, automatic failover in 5–15 seconds, synchronous replication (quorum ANY 1) | +| **Multi-Cloud Replication** | Physical replication across AKS, EKS, GKE, on-prem via KubeFleet or Istio service mesh | +| **TLS** | 4 modes: Disabled, SelfSigned, CertManager, Provided — with zero-downtime certificate rotation | +| **Backup/Restore** | On-demand + scheduled, VolumeSnapshot-based, 3-level retention hierarchy (backup → schedule → cluster default 30 days), restore from snapshot or retained PV | +| **Upgrades** | Three-phase model (infra → cluster → app), rolling updates via CNPG supervised mode, automatic Helm rollback on failure | +| **kubectl Plugin** | `kubectl documentdb status/health/events/promote` | +| **Sidecar Injector** | CNPG plugin auto-injects DocumentDB Gateway into pods | +| **Observability** | Application Insights (privacy-first, no PII), Prometheus metrics, Grafana dashboards, OpenTelemetry | +| **Multi-Arch** | amd64, arm64, s390x, ppc64le | +| **Network Security** | Network policies for gateway (10260), health checks (8000), replication (5432) | +| **Feature Gates** | ChangeStreams (WAL level=logical for CDC) | +| **Unified Versioning** | Single version controls operator, gateway, PostgreSQL+extension, sidecar injector, CNPG | +| **Playground** | 8 deployment scenarios: single-region AKS/EKS, multi-region fleet, true multi-cloud (AKS+GKE+EKS), TLS, telemetry, upgrades, data sync | +| **Helm** | Single `helm install` deploys operator with CNPG as dependency | + +--- + +## 2. Understanding the Page + +The current page (`app/kubernetes-operator/page.tsx`) is a 413-line React/Next.js component with four sections: + +| Section | Content | +|---|---| +| **Hero** | Title, subtitle ("Start on kind or minikube. Expand to hybrid and multi-cloud"), 2 CTAs, sidebar card with "Where it fits" scenarios and highlight badges | +| **Benefits** | 5 cards: Local to cloud, Hybrid and multi-cloud, Cross-cluster replication, HA/backup/TLS, Day-2 operations | +| **Setup Steps** | 3 numbered steps: Prepare cluster, Install operator, Create DocumentDB resource | +| **Final CTA** | "Start local, then expand" with 2 buttons | + +### Page Data Inventory + +```typescript +operatorBenefits: 5 items (local-to-cloud, hybrid, replication, HA, day-2) +setupSteps: 3 items (prepare, install, create) +operatorHighlights: 7 badge tags +bestFitScenarios: 3 scenarios +``` + +--- + +## 3. Findings — Critical Content Gaps + +### 3.1 MongoDB Compatibility Is Never Mentioned + +**Severity: 🔴 Critical** + +The page never states that DKO runs a MongoDB-compatible database. This is the single most important piece of information for the target audience. + +**Why this matters:** An engineer landing on this page needs to answer "Can I use this with my existing MongoDB application?" within 5 seconds. The answer is yes — standard MongoDB drivers work without code changes — but the page doesn't say so. + +**What's in the actual product:** +- Full MongoDB wire protocol compatibility via DocumentDB Gateway +- Verified driver support: PyMongo, Node.js MongoDB driver, Java, Go, C++ +- Connection via standard `mongodb://` connection strings +- `mongosh` works out of the box + +**My comment:** This is the biggest miss on the page. The operator's entire value proposition rests on "you get MongoDB compatibility on PostgreSQL, deployed and managed automatically on Kubernetes." By omitting MongoDB compatibility, the page removes the hook that would make an engineer stop scrolling and start reading. Every competitor comparison starts with "can it run my MongoDB workloads?" — and this page doesn't answer that question at all. + +### 3.2 PostgreSQL Foundation Is Not Mentioned + +**Severity: 🔴 Critical** + +The main DocumentDB landing page (`app/page.tsx`) prominently features "Powered by PostgreSQL" in the hero subtitle and "Built on PostgreSQL" as trust badge #1. The operator page makes zero reference to PostgreSQL. + +**Why this matters:** PostgreSQL is the credibility anchor. It immediately communicates: +- ACID compliance +- Decades of production stability +- Massive operations ecosystem +- Enterprise compliance readiness +- Familiar to DBAs worldwide + +**My comment:** The main page understood this — PostgreSQL is mentioned 15+ times. The operator page somehow lost this thread. For an engineer evaluating database infrastructure, "built on PostgreSQL" is shorthand for "this is not a toy." Its absence forces the reader to click through to the main page to understand the foundation, which most won't do. + +### 3.3 No Competitive Positioning or "Why This?" + +**Severity: 🔴 Critical** + +The page describes *what* the operator does but never explains *why you'd choose it*. There is no mention of: +- MIT license (vs. MongoDB's SSPL) +- No vendor lock-in +- Cost advantage over MongoDB Atlas +- Open-source governance (Linux Foundation) + +**My comment:** The main page has a full "Why DocumentDB" section with 3 compelling cards. The operator page has nothing equivalent. An engineer evaluating infrastructure needs to justify the choice to their team. "It's a Kubernetes operator" isn't a justification. "It's an MIT-licensed, MongoDB-compatible database on PostgreSQL with automated HA and zero licensing costs" is. + +--- + +## 4. Findings — Missing Technical Information + +### 4.1 Failover Timing Not Quantified + +**Severity: 🟡 Medium** + +The "HA, backup, and TLS" benefit card says "automatic failover" — a generic claim every database makes. The verified failover timing is: +- **Planned switchover:** 2–5 seconds +- **Unplanned primary crash:** 5–15 seconds +- **Node failure:** 20–60 seconds + +**My comment:** Concrete numbers differentiate. "Automatic failover" is table stakes. "5-second failover" is a feature. Engineers compare RTO numbers across products — giving them a number lets DKO win that comparison. The CNPG documentation backs this up, and the operator's controller code confirms the HA topology. + +### 4.2 Observability Stack Not Mentioned + +**Severity: 🟡 Medium** + +No reference to monitoring capabilities anywhere on the page. The actual stack: +- Prometheus metrics (exposed by CNPG) +- Grafana dashboards (pre-built examples in playground) +- OpenTelemetry collector configurations +- Application Insights telemetry (privacy-first, no PII, opt-out available) +- Kubernetes events for all cluster operations + +**My comment:** For production Kubernetes workloads, "how do I monitor this?" is a day-1 question. The absence of observability information signals "this isn't production-ready" to experienced platform engineers — even though the operator has a comprehensive observability story. The playground even includes a complete multi-tenant telemetry setup with Prometheus + Grafana + OTEL. + +### 4.3 Backup/Restore Capabilities Understated + +**Severity: 🟡 Medium** + +Line 29 says "Backup and ScheduledBackup resources" — technically accurate but conveys almost nothing about the capability: +- VolumeSnapshot-based atomic point-in-time backups +- Cron-scheduled backups +- 3-level retention hierarchy (per-backup → per-schedule → cluster-level, default 30 days) +- Restore from VolumeSnapshot or retained PersistentVolume +- Backups survive cluster deletion +- Auto VolumeSnapshotClass creation on AKS + +**My comment:** Backup/restore is one of the most evaluated features for any database. "We have backup CRDs" doesn't tell an engineer whether their RPO/RTO requirements can be met. The three-level retention hierarchy and PV recovery are genuinely sophisticated features that deserve visibility. + +### 4.4 Kubernetes 1.35+ Requirement Needs Clarification + +**Severity: 🟡 Medium** + +Line 367 states the operator targets Kubernetes 1.35+. This is a very recent version requirement (for the ImageVolume GA feature). The docs mention 1.30+ for basic support and 1.35+ for ImageVolume-based extension mounting. + +**My comment:** If 1.35+ is a hard requirement, this is a significant adoption gate that deserves hero-level visibility — many production clusters don't upgrade that quickly. If 1.30+ works with an alternative extension mounting approach, that should be stated to widen the audience. Either way, this detail carries more weight than its current placement (buried in the prerequisites box) suggests. + +### 4.5 Preview Status Visibility + +**Severity: 🟡 Medium** + +The hero eyebrow says "Operator preview" and there's a preview note inside the sidebar card, but the version number (v0.1.3) and practical implications aren't clear. + +**My comment:** Engineers parsing "preview" need to understand: Is this safe for staging? Production? What's the path to GA? The three-phase upgrade model and unified versioning story show that the team has thought about production readiness — but the page doesn't communicate this confidence. A brief "Preview — not yet recommended for production. Targeting stable v1.x" would set appropriate expectations. + +### 4.6 Security Story Beyond TLS + +**Severity: 🟡 Medium** + +TLS is mentioned but the broader security posture is absent: +- SCRAM-SHA-256 authentication +- Kubernetes RBAC (admin/editor/viewer cluster roles auto-created) +- Network policies for ingress restriction +- Disk encryption at rest (default on AKS/GKE) +- PV mount hardening (nodev, nosuid, noexec) +- Secrets management integrations (External Secrets Operator, Azure Key Vault CSI, HashiCorp Vault) + +**My comment:** Security is a checkbox exercise for enterprise adoption. The operator has a genuinely strong security story — 4 TLS modes, RBAC, network policies, encrypted storage, hardened mounts. Reducing this to "configurable TLS modes" leaves significant value on the table. + +### 4.7 Multi-Arch Support Not Mentioned + +**Severity: 🟢 Low** + +The operator builds for amd64, arm64, s390x, and ppc64le. This is relevant for organizations running ARM-based instances (Graviton, Ampere) or mainframe environments (IBM Z). + +**My comment:** A single line or badge tag would suffice. ARM adoption on Kubernetes is accelerating rapidly — mentioning arm64 support signals forward-looking infrastructure awareness. + +--- + +## 5. Findings — Design & Consistency + +### 5.1 Color Scheme Divergence + +**Severity: 🟢 Low** + +The main site uses **blue** accents consistently (blue-300 for eyebrows, blue-400/500 for CTAs, blue borders on hover). The operator page uses **emerald** throughout. + +**Main page pattern:** +``` +Eyebrows: text-blue-300 +Primary CTA: bg-blue-500 hover:bg-blue-400 +Secondary CTA: border-blue-400/30 bg-blue-500/10 +Card hover: border-blue-400/30 +``` + +**Operator page pattern:** +``` +Eyebrows: text-emerald-300 +Primary CTA: bg-emerald-500 hover:bg-emerald-400 +Secondary CTA: border-emerald-400/30 bg-emerald-500/10 +Card hover: border-emerald-400/30 +``` + +**My comment:** This could be intentional — emerald as a "Kubernetes/infrastructure" sub-brand within the DocumentDB identity. If so, it works aesthetically. But if it's unintentional, it creates visual fragmentation. The main page actually already uses emerald for the Kubernetes Operator section (lines 605+), so there is precedent for emerald = K8s operator. This is consistent within the main page's own section differentiation. **Verdict: This is fine as-is.** + +### 5.2 Information Density Gap + +**Severity: 🟡 Medium** + +**Main page sections:** +- Hero with 3-tier CTAs + command snippet +- 4 capability cards with eyebrows + 2–4 highlight badges each +- "Why DocumentDB" with 3 value cards +- Community stats (3.2k+ stars, 11 TSC members, 5 contributor orgs) +- Press section (4 outlets) +- Kubernetes Operator teaser section +- Final CTA + +**Operator page sections:** +- Hero with 2 CTAs + sidebar card +- 5 simple benefit cards (title + single-line description) +- 3 setup steps +- Final CTA + +**My comment:** The main page is a rich, multi-layered landing page. The operator page feels like a brochure in comparison. For a product with 17+ production features, 6 controllers, 3 CRDs, 8 deployment scenarios, and multi-cloud support, the page communicates about 20% of the value. The gap is most noticeable in the benefit cards — the main page's capability cards have eyebrow categories and 2–4 highlight badges; the operator cards have just a title and one sentence. + +### 5.3 No Code Snippet or Command Example + +**Severity: 🟡 Medium** + +The main page features a `CommandSnippet` component with a Docker one-liner. The operator page has no equivalent — no `helm install` command, no sample YAML, no `kubectl apply` example. + +**My comment:** A Helm install command or a minimal DocumentDB YAML manifest would dramatically increase engagement. Engineers want to see the "shape" of the product before committing to read docs. Something like: + +```bash +helm install documentdb-operator documentdb/documentdb-operator \ + --namespace documentdb-operator --create-namespace +``` + +or a minimal cluster YAML: + +```yaml +apiVersion: documentdb.io/preview +kind: DocumentDB +metadata: + name: my-cluster +spec: + instancesPerNode: 3 + resource: + storage: + pvcSize: 10Gi +``` + +This is standard practice for Kubernetes operator landing pages. + +--- + +## 6. Commentary on Current Wording + +### Benefit Cards — Line by Line + +| Current Title | Current Description | My Assessment | +|---|---|---| +| **"Local to cloud"** | "Start on kind or minikube, then use the same operator model on managed or self-managed Kubernetes." | ⚠️ Undersells. This makes DKO sound like a migration helper. The value is production-grade lifecycle automation. Suggest: **"Production-ready on Kubernetes"** — "Deploy with HA, automatic failover, and zero-downtime upgrades on any Kubernetes 1.35+ cluster." | +| **"Hybrid and multi-cloud"** | "Use one operator model across AKS, EKS, GKE, and on-prem clusters." | ✅ Accurate but could be stronger. Doesn't mention the orchestration layer (KubeFleet, Istio) or that cross-cloud replication is physical replication. Suggest adding: "with cross-cloud physical replication via KubeFleet or Istio." | +| **"Cross-cluster replication"** | "Replicate across clusters and promote a new primary when you need cross-cluster failover." | ✅ Accurate. Could quantify: "Replicate across clusters with physical streaming replication. Promote a new primary with a single kubectl command." | +| **"HA, backup, and TLS"** | "Add automatic failover, Backup and ScheduledBackup resources, and configurable TLS modes." | ⚠️ Too many concepts compressed. These are three separate enterprise features — each deserving its own card. At minimum, quantify failover time and TLS mode count. | +| **"Day-2 operations"** | "Use the kubectl plugin for status, events, and promotion workflows." | ✅ Good. Could mention what the plugin actually provides: `kubectl documentdb status` shows cluster health, connection strings, and replication lag. | + +### Hero Section Wording + +**Current subtitle:** "Start on kind or minikube. Expand to hybrid and multi-cloud Kubernetes." + +**My comment:** This frames DKO as a "scale up when you're ready" story. But DKO's strongest pitch is to organizations already running production Kubernetes who need an automated, enterprise-grade document database operator. The "start local" angle is valid for developer adoption but shouldn't be the hero message. + +**Suggested alternative:** "Deploy MongoDB-compatible DocumentDB on any Kubernetes cluster — with automated HA, multi-cloud replication, and enterprise security." + +### Hero Description + +**Current:** "Install with Helm, manage with custom resources, and run DocumentDB on Kubernetes with replication, failover, backups, and TLS." + +**My comment:** Solid, accurate, but reads like a feature list. Doesn't communicate value. Compare with the main page's hero: "Built for document workloads. Powered by PostgreSQL." — which communicates positioning in one line. Suggest: "A single Helm install gives you a MongoDB-compatible database with automatic failover, scheduled backups, multi-cloud replication, and four TLS modes — all managed through Kubernetes custom resources." + +### "Where it fits" Sidebar + +**Current scenarios:** +1. Teams moving from local Kubernetes clusters to managed environments. +2. Platform teams standardizing DocumentDB operations across cloud and on-prem clusters. +3. Operators that need replication, promotion, and recovery workflows across clusters. + +**My comment:** These are reasonable but generic. They describe Kubernetes workflows, not DocumentDB-specific value. Missing scenarios that would resonate more: +- "Teams migrating from MongoDB Atlas who need self-hosted, MongoDB-compatible databases on their own infrastructure." +- "Organizations requiring MongoDB compatibility with zero licensing costs (MIT license)." +- "Platform teams needing a document database with automated HA and sub-15-second failover." + +### Setup Steps + +**Current step 2:** "Install cert-manager, CloudNativePG, and the DocumentDB operator with Helm." + +**My comment:** Listing three things to install makes the setup feel heavy. The Helm chart actually bundles CNPG as a dependency, so it's really just cert-manager + the operator chart. Suggest: "Install cert-manager, then add the DocumentDB operator via Helm (CloudNativePG is included as a dependency)." + +--- + +## 7. What the Page Gets Right + +Not everything needs fixing. The page does several things well: + +1. **Section structure follows good HCI patterns** — eyebrow → title → description → content is consistent and scannable. + +2. **Progressive disclosure** — Hero establishes concept, benefits explain features, setup shows path, CTA converts. The flow is logical. + +3. **Preview status is present** — Both the eyebrow and the sidebar card mention preview status. Could be more prominent but it's there. + +4. **Custom SVG icons are well-designed** — The 5 glyph icons (cluster, globe, replication, shield, terminal) are clean, consistent, and semantically appropriate. + +5. **Responsive design is solid** — Mobile-first with proper breakpoints (sm, lg, xl), full-width buttons on mobile, grid layouts on desktop. + +6. **CTA placement is good** — Two opportunities to click through (hero + footer), both with primary + secondary options. + +7. **The highlight badges** — "kind + minikube", "AKS / EKS / GKE", "Cross-cluster replication", etc. — provide quick scanning for engineers checking compatibility. + +8. **Metadata/SEO is well-configured** — Good title, description, and relevant keywords for search discoverability. + +--- + +## 8. Recommendations Summary + +### Must-Fix (Content Gaps That Hurt Adoption) + +| # | Issue | Recommendation | +|---|---|---| +| 1 | **MongoDB compatibility not mentioned** | Add to hero description and/or a dedicated benefit card. This is the #1 hook. | +| 2 | **PostgreSQL foundation not mentioned** | Add "Built on PostgreSQL" — mirror the main page's positioning. | +| 3 | **No competitive positioning** | Add MIT license, no vendor lock-in, cost advantage vs. Atlas. Consider a "Why DKO?" section. | +| 4 | **No code snippet** | Add a `helm install` command or minimal YAML manifest using `CommandSnippet` component. | + +### Should-Fix (Missing Information) + +| # | Issue | Recommendation | +|---|---|---| +| 5 | **Failover timing** | Quantify: "5–15 second automatic failover" | +| 6 | **Observability absent** | Add benefit card or highlight badges for Prometheus, Grafana, OTEL | +| 7 | **Backup details thin** | Expand to mention VolumeSnapshots, retention policies, PV recovery | +| 8 | **Security beyond TLS** | Mention RBAC, network policies, disk encryption, SCRAM auth | +| 9 | **K8s version requirement** | Clarify 1.30+ vs. 1.35+ distinction if applicable | + +### Nice-to-Have (Polish) + +| # | Issue | Recommendation | +|---|---|---| +| 10 | **Information density** | Add more capability cards or a stats section (e.g., "5–15s failover", "4 TLS modes", "3 CRDs") | +| 11 | **"HA, backup, and TLS" overloaded** | Consider splitting into separate cards — each is a major enterprise feature | +| 12 | **Hero subtitle** | Reframe from "start local, expand" to leading with production value | +| 13 | **Multi-arch support** | Add arm64/s390x/ppc64le as highlight badge | +| 14 | **Best-fit scenarios** | Add MongoDB migration and cost savings scenarios | + +--- + +*This review is based on a complete audit of the `documentdb` and `documentdb-kubernetes-operator` repositories (source code, CRD definitions, controllers, Helm charts, docs, and playground examples) cross-referenced against the live landing page. All capability claims are verified from source.* diff --git a/eslint.config.mjs b/eslint.config.mjs index 65fd485..355a810 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -1,15 +1,36 @@ import { defineConfig } from "eslint/config"; -import nextPlugin from '@next/eslint-plugin-next' +import nextPlugin from "@next/eslint-plugin-next"; +import tsParser from "@typescript-eslint/parser"; export default defineConfig([ - { - plugins: { - '@next/next': nextPlugin, - }, - rules: { - semi: "error", - "prefer-const": "error", - ...nextPlugin.configs.recommended.rules - }, - }, + { + ignores: [ + ".next/**", + "out/**", + "coverage/**", + "build/**", + "node_modules/**", + ], + }, + { + files: ["**/*.{js,mjs,cjs,ts,tsx}"], + languageOptions: { + parser: tsParser, + parserOptions: { + ecmaVersion: "latest", + sourceType: "module", + ecmaFeatures: { + jsx: true, + }, + }, + }, + plugins: { + "@next/next": nextPlugin, + }, + rules: { + ...nextPlugin.configs["core-web-vitals"].rules, + semi: "error", + "prefer-const": "error", + }, + }, ]); diff --git a/tailwind.config.ts b/tailwind.config.ts index 8459a8f..db68cff 100644 --- a/tailwind.config.ts +++ b/tailwind.config.ts @@ -15,4 +15,4 @@ module.exports = { }, }, plugins: [], -} \ No newline at end of file +}; From f43bdfb973285692b60f8b241b965e535bb34a53 Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Thu, 19 Mar 2026 09:10:22 -0400 Subject: [PATCH 6/7] Reorder operator entry points Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/components/Navbar.tsx | 6 ++ app/page.tsx | 124 +++++++++++++++++++------------------- 2 files changed, 68 insertions(+), 62 deletions(-) diff --git a/app/components/Navbar.tsx b/app/components/Navbar.tsx index 048c031..d1b04f8 100644 --- a/app/components/Navbar.tsx +++ b/app/components/Navbar.tsx @@ -75,6 +75,12 @@ export default function Navbar() { > Download + + K8s Operator + +
+
+
+

+ Operator preview +

+

+ DocumentDB Kubernetes Operator +

+

+ Run DocumentDB on Kubernetes—from kind and minikube to{" "} + hybrid and multi-cloud deployments. +

+
+ +
+ {kubernetesOperatorEntryPoints.map((item) => ( +
+

+ {item.title} +

+

+ {item.description} +

+
+ ))} +
+ + +
+
+
@@ -598,68 +660,6 @@ export default function Home() {
-
-
-
-

- Operator preview -

-

- DocumentDB Kubernetes Operator -

-

- Run DocumentDB on Kubernetes—from kind and minikube to{" "} - hybrid and multi-cloud deployments. -

-
- -
- {kubernetesOperatorEntryPoints.map((item) => ( -
-

- {item.title} -

-

- {item.description} -

-
- ))} -
- -
-
-
-

- Preview with local, hybrid, and multi-cluster paths -

-

- The operator is still in preview. Start with the overview, then - follow the quick start or multi-cluster guides. -

-
- -
- - Read operator overview - - - Open quick start - -
-
-
-
-
-

From 4f46e060d976b5476695d01d70b60238547a9855 Mon Sep 17 00:00:00 2001 From: Guanzhou Song Date: Thu, 19 Mar 2026 09:49:26 -0400 Subject: [PATCH 7/7] Refine operator page wording Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- app/kubernetes-operator/page.tsx | 43 ++++++++++++++++---------------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx index 6a22cb6..9fc9c4b 100644 --- a/app/kubernetes-operator/page.tsx +++ b/app/kubernetes-operator/page.tsx @@ -15,11 +15,11 @@ type OperatorBenefitIcon = const operatorBenefits = [ { - eyebrow: "Compatibility", - title: "MongoDB-compatible", + eyebrow: "Workloads", + title: "Document workloads", description: - "Run DocumentDB with standard MongoDB drivers and tools, then manage it with Kubernetes custom resources.", - highlights: ["PyMongo", "Node.js", "mongosh"], + "Run DocumentDB with client drivers and tools, then manage it with Kubernetes custom resources.", + highlights: ["Client drivers", "Tools", "CRDs"], icon: "database" as const, }, { @@ -43,14 +43,14 @@ const operatorBenefits = [ title: "Failover and recovery", description: "Add automatic failover, cross-cluster replication, and Backup and ScheduledBackup workflows for recovery.", - highlights: ["5-15s failover", "Cross-cluster", "Backup CRDs"], + highlights: ["Automatic failover", "Cross-cluster", "Backup CRDs"], icon: "replication" as const, }, { eyebrow: "Security", title: "TLS and access controls", description: - "Choose preview or production TLS modes and integrate with secrets, SCRAM auth, RBAC, and secure cluster networking.", + "Choose from four TLS modes and integrate with secrets, SCRAM auth, RBAC, and secure cluster networking.", highlights: ["4 TLS modes", "SCRAM", "RBAC"], icon: "shield" as const, }, @@ -194,7 +194,7 @@ const setupSteps = [ step: "01", title: "Prepare the cluster", description: - "Use kind or minikube locally, or a Kubernetes 1.35+ cluster such as AKS, EKS, or GKE for the current preview install path.", + "Use kind or minikube locally, or a Kubernetes 1.35+ cluster such as AKS, EKS, or GKE to run the operator preview.", }, { step: "02", @@ -206,15 +206,15 @@ const setupSteps = [ step: "03", title: "Create a DocumentDB resource", description: - "Apply a DocumentDB custom resource to launch a MongoDB-compatible database built on PostgreSQL, then expand into replicated topologies as needed.", + "Apply a DocumentDB custom resource to launch a document database built on PostgreSQL, then expand into replicated topologies as needed.", }, ] as const; const operatorHighlights = [ - "MongoDB-compatible", + "Document workloads", "Built on PostgreSQL", "MIT licensed", - "5-15s failover", + "Automatic failover", "Backup + ScheduledBackup CRDs", "AKS / EKS / GKE", "kubectl plugin workflows", @@ -222,7 +222,7 @@ const operatorHighlights = [ ] as const; const bestFitScenarios = [ - "Teams moving MongoDB-compatible workloads from local clusters to managed Kubernetes.", + "Teams moving document workloads from local clusters to managed Kubernetes.", "Platform teams standardizing PostgreSQL-backed DocumentDB operations across cloud and on-prem clusters.", "Operators that need failover, backup, promotion, and recovery workflows across clusters.", ] as const; @@ -234,12 +234,12 @@ helm install documentdb-operator documentdb/documentdb-operator \\ export const metadata = getMetadata({ title: "DocumentDB Kubernetes Operator", description: - "Run MongoDB-compatible DocumentDB on Kubernetes with a PostgreSQL foundation, replication, HA, backups, TLS, and hybrid or multi-cloud topologies.", + "Run DocumentDB on Kubernetes with a PostgreSQL foundation, replication, HA, backups, TLS, and hybrid or multi-cloud topologies.", extraKeywords: [ "Kubernetes", "operator", "Helm", - "MongoDB compatible", + "document database", "PostgreSQL", "CloudNativePG", "multi-cloud", @@ -268,7 +268,7 @@ export default function KubernetesOperatorPage() { DocumentDB Kubernetes Operator

- Run MongoDB-compatible DocumentDB on Kubernetes.{" "} + Run DocumentDB on Kubernetes.{" "} Built on PostgreSQL for local, hybrid, and multi-cloud paths.

@@ -311,9 +311,9 @@ export default function KubernetesOperatorPage() { Built for Kubernetes-native document database operations

- Use the operator when you want MongoDB-compatible DocumentDB - on PostgreSQL with Kubernetes-native lifecycle management for - local clusters, HA topologies, or multi-cluster deployments. + Use the operator when you want DocumentDB on PostgreSQL with + Kubernetes-native lifecycle management for local clusters, HA + topologies, or multi-cluster deployments.

@@ -425,8 +425,7 @@ export default function KubernetesOperatorPage() {

See the install shape

Install cert-manager first, then add the operator chart. The - current preview install path brings in CloudNativePG as a - dependency. + chart includes CloudNativePG as a dependency.

@@ -458,9 +457,9 @@ export default function KubernetesOperatorPage() { What to expect before you start

- The current preview install path targets Kubernetes 1.35+, - depends on cert-manager, and uses CloudNativePG under the - hood. Cross-cluster topologies also require network + The operator preview targets Kubernetes 1.35+, requires + cert-manager to be installed first, and uses CloudNativePG + under the hood. Cross-cluster topologies also require network connectivity between clusters and the documented multi-cluster setup.