Docs upcoming v26.0.0

bin/bump-version

@@ -69,6 +69,10 @@ rm -f src/{clusterd,environmentd,materialized,persist-client,testdrive,catalog-d
 
 cargo update --workspace
 
+crd_descriptions_json=doc/user/data/self_managed/materialize_crd_descriptions.json
+cargo run -p mz-cloud-resources --bin crd-writer > "${crd_descriptions_json}"
+git add "${crd_descriptions_json}"
+
 bin/helm-chart-version-bump --bump-orchestratord-version "v$version"
 
 helm_docs_version=1.14.2
@@ -83,7 +87,11 @@ if [ "$(helm-docs --version)" != "helm-docs version $helm_docs_version" ]; then
     echo "Install helm-docs $helm_docs_version from https://github.com/norwoodj/helm-docs/releases/tag/v$helm_docs_version"
     exit 1
 fi
+# update README.md
 helm-docs misc/helm-charts
+# update values yaml descriptions
+helm-docs misc/helm-charts -t misc/helm-charts/operator/value_descriptions.yml.gotmpl -o value_descriptions.yml
+mv misc/helm-charts/operator/value_descriptions.yml doc/user/data/self_managed/materialize_operator_chart_parameter.yml
 
 if $sbom; then
     if ! inspector-sbomgen --version > /dev/null; then

ci/deploy/pipeline.template.yml

@@ -47,14 +47,3 @@ steps:
       queue: linux-x86_64-small
     concurrency: 1
     concurrency_group: deploy/npm
-
-  - id: deploy-helm-chart
-    label: ":rocket: :helm:"
-    command: bin/ci-builder run stable misc/helm-charts/publish.sh
-    depends_on: "deploy-docker"
-    branches: "v*.*"
-    timeout_in_minutes: 30
-    agents:
-      queue: linux-aarch64-small
-    concurrency: 1
-    concurrency_group: deploy/helm_chart

ci/publish-helm-charts/pipeline.template.yml

@@ -0,0 +1,128 @@
+# Copyright Materialize, Inc. and contributors. All rights reserved.
+#
+# Use of this software is governed by the Business Source License
+# included in the LICENSE file at the root of this repository.
+#
+# As of the Change Date specified in that file, in accordance with
+# the Business Source License, use of this software will be governed
+# by the Apache License, Version 2.0.
+# This file is processed by mkpipeline.py to trim unnecessary steps in PR
+# builds. The inputs for steps using the `mzcompose` plugin are computed
+# automatically. Inputs for other steps need to be manually listed in the
+# `inputs` key.
+dag: true
+steps:
+  - group: "Orchestratord tests"
+    key: orchestratord-test
+    steps:
+      - id: orchestratord-defaults
+        label: "Orchestratord test (defaults from documentation)"
+        timeout_in_minutes: 120
+        plugins:
+          - ./ci/plugins/mzcompose:
+              composition: orchestratord
+              run: defaults
+              args: ["--tag=$CI_MZ_VERSION"]
+              ci-builder: stable
+        env:
+          # Old versions are not on GHCR yet
+          MZ_GHCR: 0
+        agents:
+          queue: hetzner-aarch64-16cpu-32gb
+
+      - id: orchestratord-default-properties
+        label: "Orchestratord test (defaults for properties)"
+        timeout_in_minutes: 120
+        plugins:
+          - ./ci/plugins/mzcompose:
+              composition: orchestratord
+              args: ["--tag=$CI_MZ_VERSION", --action=noop, --properties=defaults, --recreate-cluster, --no-orchestratord-override]
+              ci-builder: stable
+        env:
+          # Old versions are not on GHCR yet
+          MZ_GHCR: 0
+        agents:
+          queue: hetzner-aarch64-16cpu-32gb
+
+      - id: orchestratord-individual
+        label: "Orchestratord test (individual properties)"
+        timeout_in_minutes: 120
+        plugins:
+          - ./ci/plugins/mzcompose:
+              composition: orchestratord
+              args: ["--tag=$CI_MZ_VERSION", --action=noop, --properties=individual, --recreate-cluster, --no-orchestratord-override]
+              ci-builder: stable
+        env:
+          # Old versions are not on GHCR yet
+          MZ_GHCR: 0
+        agents:
+          queue: hetzner-aarch64-16cpu-32gb
+
+      - id: orchestratord-combine
+        label: "Orchestratord test (combine properties)"
+        timeout_in_minutes: 120
+        plugins:
+          - ./ci/plugins/mzcompose:
+              composition: orchestratord
+              args: ["--tag=$CI_MZ_VERSION", --action=noop, --properties=combine, --runtime=3600, --recreate-cluster, --no-orchestratord-override]
+              ci-builder: stable
+        env:
+          # Old versions are not on GHCR yet
+          MZ_GHCR: 0
+        agents:
+          queue: hetzner-aarch64-16cpu-32gb
+
+  - id: terraform-aws-tag
+    label: "Terraform + Helm Chart E2E on AWS (tagged)"
+    artifact_paths: [test/terraform/aws-temporary/terraform.tfstate, "mz-debug/**/*"]
+    timeout_in_minutes: 120
+    concurrency: 1
+    concurrency_group: 'terraform-aws'
+    agents:
+      queue: linux-aarch64-small
+    plugins:
+      - ./ci/plugins/scratch-aws-access: ~
+      - ./ci/plugins/mzcompose:
+          composition: terraform
+          run: aws-temporary
+          args: ["--tag=$CI_MZ_VERSION", --no-run-testdrive-files, --no-orchestratord-override]
+          ci-builder: stable
+
+  - id: terraform-gcp-tag
+    label: "Terraform + Helm Chart E2E on GCP (tagged)"
+    artifact_paths: [test/terraform/gcp-temporary/terraform.tfstate, "mz-debug/**/*"]
+    timeout_in_minutes: 120
+    concurrency: 1
+    concurrency_group: 'terraform-gcp'
+    agents:
+      queue: linux-aarch64-small
+    plugins:
+      - ./ci/plugins/mzcompose:
+          composition: terraform
+          run: gcp-temporary
+          args: ["--tag=$CI_MZ_VERSION", --no-run-testdrive-files, --no-orchestratord-override]
+          ci-builder: stable
+
+  - id: terraform-azure-tag
+    label: "Terraform + Helm Chart E2E on Azure (tagged)"
+    artifact_paths: [test/terraform/azure-temporary/terraform.tfstate, "mz-debug/**/*"]
+    timeout_in_minutes: 120
+    concurrency: 1
+    concurrency_group: 'terraform-azure'
+    agents:
+      queue: linux-aarch64-small
+    plugins:
+      - ./ci/plugins/mzcompose:
+          composition: terraform
+          run: azure-temporary
+          args: ["--tag=$CI_MZ_VERSION", --no-run-testdrive-files, --no-orchestratord-override]
+          ci-builder: stable
+
+  - wait: ~
+
+  - id: helm-charts-publish
+    label: Publish Helm Charts
+    command: bin/ci-builder run stable misc/helm-charts/publish.sh
+    timeout_in_minutes: 30
+    agents:
+      queue: linux-aarch64-small

doc/user/assets/sass/_base.scss

@@ -34,7 +34,7 @@ $rem-scale: 0.585;
     --milli: #{rem(2)};
     --xx-small: #{rem(2.5)};
     --x-small: #{rem(3)};
-    --small: #{rem(4)};
+    --small: #{rem(4.5)};
     --medium: #{rem(5)};
     --large: #{rem(6)};
 

doc/user/assets/sass/_layout.scss

@@ -10,10 +10,10 @@
 .content-wrapper {
     display: flex;
     justify-content: center;
-    padding-top: var(--nav-height);
+    padding-top: calc(var(--nav-height) + var(--small));
 
     @media(max-width: 800px) {
-        padding-top: calc(var(--nav-height) + var(--xx-small));
+        padding-top: calc(var(--nav-height) + var(--small));
     }
 
     @media(max-width: 380px) {
@@ -139,7 +139,7 @@ table.inline-headings {
         z-index: 100;
         top: var(--nav-height);
         left: 0;
-        height: calc(100vh - var(--nav-height));
+        height: calc(120vh - var(--nav-height));
         border-right: 1px solid var(--divider-light);
         transform: translateX(-100%);
         transition: all .2s ease-out;
@@ -193,6 +193,7 @@ table.inline-headings {
     @media(max-width: 850px) {
         padding-bottom: var(--large);
         height: calc(100vh - var(--nav-height));
+        margin-top: 80px;
     }
 
     a {

doc/user/assets/sass/_nav.scss

@@ -149,7 +149,7 @@
 
 button.show-topics {
     display: none;
-    margin: 0 0 var(--small) !important;
+    margin: var(--small) 0 var(--small) !important;
     text-align: left;
     font-weight: 300;
     font-size: var(--base);
@@ -171,6 +171,7 @@ button.close-topics {
     position: absolute;
     justify-content: center;
     align-items: center;
+    margin-top: 80px;
     top: 0;
     right: 0;
     transform: translateX(50%) translateY(50%);

doc/user/config.toml

@@ -7,7 +7,7 @@ disableKinds = ['taxonomy']
 
 [params]
 repo = "//github.com/MaterializeInc/materialize"
-bannerMessage = ""
+bannerMessage = "**New: Self-Managed v26.0!** New features include license keys, SCRAM-SHA support, and more! For details on v26.0 features, see [Release Notes](/releases/).<br>**Note**: To upgrade from v25.2 to v26.0, you must [upgrade first to v25.2.15](https://materialize.com/docs/self-managed/v25.2/release-notes/#v25215)."
 bannerLink = ""
 
 [frontmatter]

doc/user/content/ingest-data/postgres/_index.md

@@ -38,15 +38,11 @@ Materialize gives you the following benefits:
 The PostgreSQL source requires **PostgreSQL 11+** and is compatible with most
 common PostgreSQL hosted services.
 
-| Integration guides                          |
-| ------------------------------------------- |
-| {{% ingest-data/postgres-native-support %}} |
-
-If there is a hosted service or PostgreSQL distribution that is not listed above
-but you would like to use with Materialize, please submit a [feature
-request](https://github.com/MaterializeInc/materialize/discussions/new?category=feature-requests&labels=A-integration)
-or reach out in the Materialize [Community
-Slack](https://materialize.com/s/chat).
+## Integration guides
+
+The following integration guides are available:
+
+{{% include-md file="shared-content/postgresql-ingest-data-guides.md" %}}
 
 ## Considerations