From 3ec2f949e0139cd9c5929da3192caf2d06c623e8 Mon Sep 17 00:00:00 2001 From: Cam Date: Mon, 8 Sep 2025 16:21:43 +0000 Subject: [PATCH 01/11] New top nav, Build landing page --- content/docs/build/_index.md | 122 +++++++++++++++++++++++++++++ layouts/partials/docs/top-nav.html | 48 ++++++------ 2 files changed, 148 insertions(+), 22 deletions(-) create mode 100644 content/docs/build/_index.md diff --git a/content/docs/build/_index.md b/content/docs/build/_index.md new file mode 100644 index 000000000000..fd59c9bf1f31 --- /dev/null +++ b/content/docs/build/_index.md @@ -0,0 +1,122 @@ +--- +title: Build +linktitle: Build +capability: build +docs_home: true +notitle: true +menu: + build: + identifier: build-home + weight: 1 +meta_desc: Build and deploy cloud infrastructure with Pulumi. Manage stacks, environments, resources, and services for your daily engineering work. +meta_image: /images/docs/meta-images/docs-meta.png +h1: Build with Pulumi +description:

Everything you need for daily engineering work - creating stacks, managing environments, deploying resources, and building cloud services.

+link_buttons: + primary: + label: Get Started + link: /docs/iac/get-started/ + secondary: + label: Create Environment + link: /docs/esc/get-started/ + +sections: +- type: full-width-cards + heading: Core Building Blocks + cards: + - icon: stack-blue-21-21 + heading: Stacks + description: Create and manage isolated deployments of your infrastructure across environments. + link: /docs/iac/concepts/stack/ + - icon: gear-blue-21-21 + heading: Environments + description: Configure secrets, settings, and variables across your infrastructure and applications. + link: /docs/esc/environments/ + - icon: cube-blue-21-21 + heading: Resources + description: Provision and manage cloud resources with infrastructure as code. + link: /docs/iac/concepts/resources/ + - icon: layers-blue-21-21 + heading: Components + description: Build reusable infrastructure components for consistent deployments. + link: /docs/iac/concepts/resources/components/ +- type: cards-logo-label-link + heading: Get Started Building + description: Jump into creating infrastructure on your preferred cloud platform. + cards: + - label: AWS Quick Start + icon: aws-40 + link: /docs/iac/get-started/aws/ + - label: Azure Quick Start + icon: azure-40 + link: /docs/iac/get-started/azure/ + - label: Google Cloud Quick Start + icon: google-cloud-40 + link: /docs/iac/get-started/gcp/ + - label: Kubernetes Quick Start + icon: kubernetes-40 + link: /docs/iac/get-started/kubernetes/ +- type: full-width-cards + heading: Essential Build Tasks + cards: + - icon: terminal-blue-21-21 + heading: Deploy Your First Stack + description: Learn the fundamentals of creating and deploying infrastructure stacks. + link: /docs/iac/get-started/ + - icon: key-blue-21-21 + heading: Manage Secrets & Config + description: Securely handle configuration and secrets across environments. + link: /docs/esc/get-started/ + - icon: cloud-blue-21-21 + heading: Connect to Cloud Services + description: Build applications that integrate with cloud databases, storage, and APIs. + link: /docs/iac/concepts/ + - icon: layers-blue-21-21 + heading: Organize Stacks + description: Structure your infrastructure across development, staging, and production. + link: /docs/pulumi-cloud/stacks/ +- type: button-cards + heading: Popular Build Workflows + description: Common patterns for building and deploying cloud infrastructure. + cards: + - heading: Serverless Applications + description: "Deploy functions, APIs, and event-driven architectures on AWS Lambda, Azure Functions, and Google Cloud Functions." + link: /docs/iac/clouds/aws/guides/lambda/ + primary_button_label: View Examples + primary_button_link: /docs/iac/clouds/aws/guides/lambda/ + - heading: Container Workloads + description: "Deploy containerized applications on Kubernetes, AWS ECS, Azure Container Apps, and Google Cloud Run." + link: /docs/iac/clouds/kubernetes/ + primary_button_label: Get Started + primary_button_link: /docs/iac/clouds/kubernetes/get-started/ + - heading: Static Websites + description: "Build and deploy static sites with CDNs, SSL certificates, and custom domains." + link: /docs/iac/clouds/aws/guides/static-website/ + primary_button_label: Deploy Now + primary_button_link: /docs/iac/clouds/aws/guides/static-website/ +- type: cards-logo-label-link + heading: Build in Your Language + description: Use familiar programming languages for infrastructure as code. + cards: + - label: TypeScript/JavaScript + icon: icon-32-32 node-color-32-32 + link: /docs/iac/languages-sdks/javascript/ + - label: Python + icon: icon-32-32 python-color-32-32 + link: /docs/iac/languages-sdks/python/ + - label: Go + icon: icon-32-32 go-color-32-32 + link: /docs/iac/languages-sdks/go/ + - label: .NET + icon: icon-32-32 dotnet-color-32-32 + link: /docs/iac/languages-sdks/dotnet/ + - label: Java + icon: icon-32-32 java-color-32-32 + link: /docs/iac/languages-sdks/java/ + - label: YAML + icon: icon-32-32 yaml-color-32-32 + link: /docs/iac/languages-sdks/yaml/ +- type: flat + heading: Ready to build? + description:

Start with our Get Started guide, explore tutorials, or jump into environment configuration. Need help? Join us on Slack or contact support.

+--- \ No newline at end of file diff --git a/layouts/partials/docs/top-nav.html b/layouts/partials/docs/top-nav.html index aeee124ed672..dade7ba2705d 100644 --- a/layouts/partials/docs/top-nav.html +++ b/layouts/partials/docs/top-nav.html @@ -1,19 +1,29 @@ {{ $selection := "home" }} -{{ if hasPrefix .Path "/docs/iac" }} - {{ $selection = "iac" }} +{{ if .Params.capability }} + {{ $selection = .Params.capability }} +{{ else if hasPrefix .Path "/docs/build" }} + {{ $selection = "build" }} +{{ else if hasPrefix .Path "/docs/platform" }} + {{ $selection = "platform" }} +{{ else if hasPrefix .Path "/docs/management" }} + {{ $selection = "management" }} +{{ else if hasPrefix .Path "/docs/developer-tools" }} + {{ $selection = "developer-tools" }} +{{ else if hasPrefix .Path "/docs/iac" }} + {{ $selection = "build" }} {{ else if hasPrefix .Path "/docs/esc" }} - {{ $selection = "esc" }} -{{ else if hasPrefix .Path "/docs/idp" }} - {{ $selection = "idp" }} + {{ $selection = "build" }} {{ else if hasPrefix .Path "/docs/pulumi-cloud" }} - {{ $selection = "cloud" }} + {{ $selection = "build" }} {{ else if hasPrefix .Path "/docs/insights" }} - {{ $selection = "insights" }} + {{ $selection = "management" }} +{{ else if hasPrefix .Path "/docs/idp" }} + {{ $selection = "platform" }} {{ else if hasPrefix .Path "/docs" }} {{ $selection = "home" }} {{ else if hasPrefix .Path "/registry" }} - {{ $selection = "packages" }} + {{ $selection = "platform" }} {{ else if hasPrefix .Path "/tutorials" }} {{ $selection = "tutorials" }} {{ end }} @@ -23,23 +33,17 @@ Docs Home - - Pulumi IaC - - - Pulumi ESC - - - Pulumi Insights + + Build - - Pulumi IDP + + Platform - - Pulumi Cloud + + Management - - Packages + + Developer Tools Tutorials From 730582ad8dcdf53d00b1094bbff3ae5b1586f251 Mon Sep 17 00:00:00 2001 From: Cam Date: Mon, 8 Sep 2025 16:52:17 +0000 Subject: [PATCH 02/11] Enhance documentation structure and content for Build, Environments, Resources, and Stacks sections; update menu integration and improve HTML rendering for better clarity and accessibility. --- content/docs/build/_index.md | 18 +++++++++++------- content/docs/esc/environments/_index.md | 5 +++++ content/docs/iac/concepts/resources/_index.md | 5 +++++ content/docs/iac/concepts/stacks.md | 5 +++++ content/docs/iac/get-started/_index.md | 5 +++++ .../docs/pulumi-cloud/projects-and-stacks.md | 5 +++++ layouts/partials/docs/menu.html | 2 +- .../partials/docs/special-pages/docs-home.html | 5 +++-- 8 files changed, 40 insertions(+), 10 deletions(-) diff --git a/content/docs/build/_index.md b/content/docs/build/_index.md index fd59c9bf1f31..3115c176d3ab 100644 --- a/content/docs/build/_index.md +++ b/content/docs/build/_index.md @@ -8,9 +8,13 @@ menu: build: identifier: build-home weight: 1 +expanded_menu_ids: + - build-get-started + - build-stacks-projects + - build-environments meta_desc: Build and deploy cloud infrastructure with Pulumi. Manage stacks, environments, resources, and services for your daily engineering work. meta_image: /images/docs/meta-images/docs-meta.png -h1: Build with Pulumi +h1: Build with Pulumi description:

Everything you need for daily engineering work - creating stacks, managing environments, deploying resources, and building cloud services.

link_buttons: primary: @@ -27,7 +31,7 @@ sections: - icon: stack-blue-21-21 heading: Stacks description: Create and manage isolated deployments of your infrastructure across environments. - link: /docs/iac/concepts/stack/ + link: /docs/iac/concepts/stacks/ - icon: gear-blue-21-21 heading: Environments description: Configure secrets, settings, and variables across your infrastructure and applications. @@ -74,7 +78,7 @@ sections: - icon: layers-blue-21-21 heading: Organize Stacks description: Structure your infrastructure across development, staging, and production. - link: /docs/pulumi-cloud/stacks/ + link: /docs/pulumi-cloud/projects-and-stacks/ - type: button-cards heading: Popular Build Workflows description: Common patterns for building and deploying cloud infrastructure. @@ -88,12 +92,12 @@ sections: description: "Deploy containerized applications on Kubernetes, AWS ECS, Azure Container Apps, and Google Cloud Run." link: /docs/iac/clouds/kubernetes/ primary_button_label: Get Started - primary_button_link: /docs/iac/clouds/kubernetes/get-started/ + primary_button_link: /docs/iac/get-started/kubernetes/ - heading: Static Websites description: "Build and deploy static sites with CDNs, SSL certificates, and custom domains." - link: /docs/iac/clouds/aws/guides/static-website/ - primary_button_label: Deploy Now - primary_button_link: /docs/iac/clouds/aws/guides/static-website/ + link: /tutorials/ + primary_button_label: View Tutorials + primary_button_link: /tutorials/ - type: cards-logo-label-link heading: Build in Your Language description: Use familiar programming languages for infrastructure as code. diff --git a/content/docs/esc/environments/_index.md b/content/docs/esc/environments/_index.md index 2546b7810fd2..ae0bbee23ef6 100644 --- a/content/docs/esc/environments/_index.md +++ b/content/docs/esc/environments/_index.md @@ -8,6 +8,11 @@ menu: parent: esc-home identifier: esc-environments weight: 4 + build: + name: Environments + identifier: build-environments + parent: build-home + weight: 30 --- Pulumi ESC (Environments, Secrets, and Configuration) lets you define collections of configuration settings and secrets called _environments_ and use them in any application or service. Environments are YAML documents composed of static key-value pairs, programmatic expressions, dynamically retrieved values from supported providers including all major clouds through OpenID Connect (OIDC), and other Pulumi ESC environments. diff --git a/content/docs/iac/concepts/resources/_index.md b/content/docs/iac/concepts/resources/_index.md index 0fc03d508a02..c89480bc9f12 100644 --- a/content/docs/iac/concepts/resources/_index.md +++ b/content/docs/iac/concepts/resources/_index.md @@ -10,6 +10,11 @@ menu: parent: iac-concepts weight: 40 identifier: iac-concepts-resources + build: + name: Resources + identifier: build-resources + parent: build-home + weight: 40 concepts: identifier: resources weight: 3 diff --git a/content/docs/iac/concepts/stacks.md b/content/docs/iac/concepts/stacks.md index 2d28f8690309..c0a1cfd6bc7f 100644 --- a/content/docs/iac/concepts/stacks.md +++ b/content/docs/iac/concepts/stacks.md @@ -9,6 +9,11 @@ menu: name: Stacks parent: iac-concepts weight: 30 + build: + name: Stacks + identifier: build-stacks + parent: build-stacks-projects + weight: 1 concepts: weight: 2 aliases: diff --git a/content/docs/iac/get-started/_index.md b/content/docs/iac/get-started/_index.md index 1d1cd6cb792c..ff0aa2ebb873 100644 --- a/content/docs/iac/get-started/_index.md +++ b/content/docs/iac/get-started/_index.md @@ -11,6 +11,11 @@ menu: identifier: iac-get-started parent: iac-home weight: 10 + build: + name: Get Started + identifier: build-get-started + parent: build-home + weight: 10 getstarted: name: Overview weight: 2 diff --git a/content/docs/pulumi-cloud/projects-and-stacks.md b/content/docs/pulumi-cloud/projects-and-stacks.md index 5c7a1ca1bd76..f6b9811b004c 100644 --- a/content/docs/pulumi-cloud/projects-and-stacks.md +++ b/content/docs/pulumi-cloud/projects-and-stacks.md @@ -10,6 +10,11 @@ menu: parent: cloud-home weight: 2 identifier: pulumi-cloud-projects-and-stacks + build: + name: Projects & Stacks + identifier: build-stacks-projects + parent: build-home + weight: 20 aliases: - /docs/intro/console/project-and-stack-management/ - /docs/reference/service/roles-and-access-controls/ diff --git a/layouts/partials/docs/menu.html b/layouts/partials/docs/menu.html index 3462e88cd0b0..1309715e0a3b 100644 --- a/layouts/partials/docs/menu.html +++ b/layouts/partials/docs/menu.html @@ -5,7 +5,7 @@ one from the current path. If that doesn't work, don't show a menu. (TODO: Would it be helpful to be able to set the menu somehow in the frontmatter?) */}} -{{ $validMenus := slice "iac" "esc" "idp" "cloud" "insights"}} +{{ $validMenus := slice "iac" "esc" "idp" "cloud" "insights" "build" "platform" "management" "developer-tools"}} {{ if not (in $validMenus $menuID) }} {{ $menuID = "" }} diff --git a/layouts/partials/docs/special-pages/docs-home.html b/layouts/partials/docs/special-pages/docs-home.html index b59337a499c4..4cb89afa7143 100644 --- a/layouts/partials/docs/special-pages/docs-home.html +++ b/layouts/partials/docs/special-pages/docs-home.html @@ -4,14 +4,15 @@
From 603c0307bc29c0f6b799fe6ae096a4b0ba01d5d0 Mon Sep 17 00:00:00 2001 From: Cam Date: Mon, 8 Sep 2025 17:18:40 +0000 Subject: [PATCH 03/11] Add capability metadata and enhance menu structure for various documentation sections --- content/docs/developer-tools/_index.md | 128 ++++++++++++++++++ content/docs/esc/cli/_index.md | 6 + content/docs/esc/environments/_index.md | 1 + content/docs/iac/cli/_index.md | 6 + .../docs/iac/concepts/components/_index.md | 6 + content/docs/iac/concepts/resources/_index.md | 1 + content/docs/iac/concepts/stacks.md | 1 + content/docs/iac/crossguard/_index.md | 6 + content/docs/iac/get-started/_index.md | 1 + content/docs/iac/languages-sdks/_index.md | 6 + content/docs/idp/_index.md | 6 + content/docs/insights/_index.md | 6 + content/docs/management/_index.md | 122 +++++++++++++++++ content/docs/platform/_index.md | 125 +++++++++++++++++ .../docs/pulumi-cloud/deployments/_index.md | 6 + .../docs/pulumi-cloud/projects-and-stacks.md | 1 + layouts/partials/docs/menu.html | 28 ++-- 17 files changed, 447 insertions(+), 9 deletions(-) create mode 100644 content/docs/developer-tools/_index.md create mode 100644 content/docs/management/_index.md create mode 100644 content/docs/platform/_index.md diff --git a/content/docs/developer-tools/_index.md b/content/docs/developer-tools/_index.md new file mode 100644 index 000000000000..c45392c0d915 --- /dev/null +++ b/content/docs/developer-tools/_index.md @@ -0,0 +1,128 @@ +--- +title: Developer Tools +linktitle: Developer Tools +capability: developer-tools +docs_home: true +notitle: true +menu: + developer-tools: + identifier: developer-tools-home + weight: 1 +expanded_menu_ids: + - developer-tools-cli + - developer-tools-sdks +meta_desc: Technical interfaces and tools for developers. CLIs, SDKs, APIs, and AI-powered development assistance for infrastructure as code. +meta_image: /images/docs/meta-images/docs-meta.png +h1: Developer tools and interfaces +description:

Technical tools and interfaces for developers - command-line tools, programming language SDKs, REST APIs, and AI-powered development assistance.

+link_buttons: + primary: + label: Install CLI + link: /docs/iac/download-install/ + secondary: + label: Try Pulumi AI + link: /ai/ + +sections: +- type: full-width-cards + heading: Core Developer Tools + cards: + - icon: terminal-blue-21-21 + heading: Command Line Interface + description: Powerful CLI for managing infrastructure deployments, configurations, and cloud resources. + link: /docs/iac/cli/ + - icon: code-blue-21-21 + heading: Language SDKs + description: Native SDKs for TypeScript, Python, Go, .NET, Java, and YAML with full IDE support. + link: /docs/iac/languages-sdks/ + - icon: api-blue-21-21 + heading: REST APIs + description: Programmatic access to Pulumi Cloud services for custom integrations and automation. + link: /docs/pulumi-cloud/cloud-rest-api/ + - icon: ai-blue-21-21 + heading: Pulumi AI + description: AI-powered infrastructure generation, optimization, and intelligent assistance. + link: /ai/ +- type: cards-logo-label-link + heading: Programming Languages + description: Build infrastructure using your favorite programming language. + cards: + - label: TypeScript + icon: icon-32-32 node-color-32-32 + link: /docs/iac/languages-sdks/javascript/ + - label: Python + icon: icon-32-32 python-color-32-32 + link: /docs/iac/languages-sdks/python/ + - label: Go + icon: icon-32-32 go-color-32-32 + link: /docs/iac/languages-sdks/go/ + - label: .NET + icon: icon-32-32 dotnet-color-32-32 + link: /docs/iac/languages-sdks/dotnet/ + - label: Java + icon: icon-32-32 java-color-32-32 + link: /docs/iac/languages-sdks/java/ + - label: YAML + icon: icon-32-32 yaml-color-32-32 + link: /docs/iac/languages-sdks/yaml/ +- type: button-cards + heading: Development Environment + description: Tools and integrations for your development workflow. + cards: + - heading: IDE Extensions + description: "Rich IDE support with IntelliSense, syntax highlighting, and debugging for VS Code, IntelliJ, and more." + link: /docs/iac/languages-sdks/ + primary_button_label: Get Extensions + primary_button_link: /docs/iac/languages-sdks/ + - heading: Automation API + description: "Embed Pulumi directly in your applications with programmatic infrastructure deployment and management." + link: /docs/iac/automation-api/ + primary_button_label: Learn More + primary_button_link: /docs/iac/automation-api/ + - heading: Testing Framework + description: "Unit test and integration test your infrastructure code with familiar testing tools and patterns." + link: /docs/iac/using-pulumi/testing/ + primary_button_label: Start Testing + primary_button_link: /docs/iac/using-pulumi/testing/ +- type: full-width-cards + heading: Command Line Tools + cards: + - icon: pulumi-blue-21-21 + heading: Pulumi CLI + description: Deploy, manage, and operate cloud infrastructure with the main Pulumi command-line tool. + link: /docs/iac/cli/ + - icon: esc-blue-21-21 + heading: ESC CLI + description: Manage environments, secrets, and configuration with the dedicated ESC command-line tool. + link: /docs/esc/cli/ + - icon: convert-blue-21-21 + heading: Conversion Tools + description: Migrate from Terraform, CloudFormation, Kubernetes YAML, and other formats to Pulumi. + link: /docs/iac/adopting-pulumi/migrating-to-pulumi/ + - icon: ai-blue-21-21 + heading: AI-Powered Generation + description: Generate infrastructure code from natural language descriptions using Pulumi AI. + link: /ai/ +- type: full-width-cards + heading: Integration & Automation + cards: + - icon: webhook-blue-21-21 + heading: Webhooks + description: Integrate with external systems through webhooks for deployment notifications and triggers. + link: /docs/pulumi-cloud/webhooks/ + - icon: workflow-blue-21-21 + heading: CI/CD Integration + description: Seamless integration with GitHub Actions, GitLab CI, Azure DevOps, and other CI/CD systems. + link: /docs/iac/using-pulumi/continuous-delivery/ + - icon: script-blue-21-21 + heading: Scripting & Automation + description: Automate infrastructure operations with scripts, policies, and custom workflows. + link: /docs/iac/automation-api/ + - icon: debug-blue-21-21 + heading: Debugging & Troubleshooting + description: Tools and techniques for debugging infrastructure deployments and resolving issues. + link: /docs/iac/support/troubleshooting/ +- type: flat + heading: Ready to start developing? + description:

Install the CLI, explore the SDKs, or try Pulumi AI. Check out our getting started guide and join us on Slack for support.

+--- \ No newline at end of file diff --git a/content/docs/esc/cli/_index.md b/content/docs/esc/cli/_index.md index bab161b5c0dc..6dbaa5e4fcad 100644 --- a/content/docs/esc/cli/_index.md +++ b/content/docs/esc/cli/_index.md @@ -4,11 +4,17 @@ title_tag: Pulumi ESC CLI Overview meta_desc: An overview of the Pulumi ESC (Environments, Secrets, and Configuration) CLI. h1: Pulumi ESC CLI overview no_on_this_page: true +capability: developer-tools menu: esc: parent: esc-home identifier: esc-cli-overview weight: 7 + developer-tools: + name: ESC CLI + identifier: developer-tools-esc-cli + parent: developer-tools-home + weight: 15 aliases: - /docs/esc-cli/ --- diff --git a/content/docs/esc/environments/_index.md b/content/docs/esc/environments/_index.md index ae0bbee23ef6..cadcbfbcb623 100644 --- a/content/docs/esc/environments/_index.md +++ b/content/docs/esc/environments/_index.md @@ -3,6 +3,7 @@ title: Environments title_tag: Pulumi ESC Environments h1: Environments meta_desc: Pulumi ESC allows you to compose and manage hierarchical collections of configuration and secrets called environments and consume them in various ways. +capability: build menu: esc: parent: esc-home diff --git a/content/docs/iac/cli/_index.md b/content/docs/iac/cli/_index.md index 307ec28c93ce..bac41878e16c 100644 --- a/content/docs/iac/cli/_index.md +++ b/content/docs/iac/cli/_index.md @@ -5,12 +5,18 @@ title: Pulumi CLI h1: Pulumi CLI overview no_on_this_page: true meta_image: /images/docs/meta-images/docs-meta.png +capability: developer-tools menu: iac: name: Pulumi CLI weight: 45 identifier: iac-cli parent: iac-home + developer-tools: + name: Pulumi CLI + identifier: developer-tools-cli + parent: developer-tools-home + weight: 10 aliases: - /docs/reference/commands/ - /docs/tour/basics-deploying/ diff --git a/content/docs/iac/concepts/components/_index.md b/content/docs/iac/concepts/components/_index.md index 35bab12b0004..8e28882b755d 100644 --- a/content/docs/iac/concepts/components/_index.md +++ b/content/docs/iac/concepts/components/_index.md @@ -4,12 +4,18 @@ meta_desc: A component resource is a logical grouping of resources. Learn how to title: Components h1: Component resources meta_image: /images/docs/meta-images/docs-meta.png +capability: platform menu: iac: name: Components parent: iac-concepts weight: 70 identifier: iac-concepts-components + platform: + name: Components + identifier: platform-components + parent: platform-home + weight: 20 aliases: - /docs/intro/concepts/resources/components/ - /docs/concepts/resources/components/ diff --git a/content/docs/iac/concepts/resources/_index.md b/content/docs/iac/concepts/resources/_index.md index c89480bc9f12..7b297eb4334a 100644 --- a/content/docs/iac/concepts/resources/_index.md +++ b/content/docs/iac/concepts/resources/_index.md @@ -4,6 +4,7 @@ meta_desc: Resources represent the fundamental units that make up your cloud inf title: Resources h1: Resources meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Resources diff --git a/content/docs/iac/concepts/stacks.md b/content/docs/iac/concepts/stacks.md index c0a1cfd6bc7f..b2cb530e05e3 100644 --- a/content/docs/iac/concepts/stacks.md +++ b/content/docs/iac/concepts/stacks.md @@ -4,6 +4,7 @@ meta_desc: Every Pulumi program is deployed to a stack and a project can have as title: Stacks h1: Stacks meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Stacks diff --git a/content/docs/iac/crossguard/_index.md b/content/docs/iac/crossguard/_index.md index 4f111f8d757f..9943fda9f892 100644 --- a/content/docs/iac/crossguard/_index.md +++ b/content/docs/iac/crossguard/_index.md @@ -5,12 +5,18 @@ meta_desc: Pulumi's Policy as Code offering, CrossGuard, allows you to set guard title: Policy as code h1: Pulumi policy as code meta_image: /images/docs/meta-images/docs-meta.png +capability: platform menu: iac: name: Policy as code parent: iac-home weight: 55 identifier: iac-policy + platform: + name: Policy as Code + identifier: platform-policy + parent: platform-home + weight: 30 aliases: - /docs/guides/crossguard/ - /policy-as-code/ diff --git a/content/docs/iac/get-started/_index.md b/content/docs/iac/get-started/_index.md index ff0aa2ebb873..c643f9eb0b31 100644 --- a/content/docs/iac/get-started/_index.md +++ b/content/docs/iac/get-started/_index.md @@ -5,6 +5,7 @@ title: Get started h1: Get started with Pulumi no_on_this_page: true meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Get started diff --git a/content/docs/iac/languages-sdks/_index.md b/content/docs/iac/languages-sdks/_index.md index a55decc5d2a6..a16e90970087 100644 --- a/content/docs/iac/languages-sdks/_index.md +++ b/content/docs/iac/languages-sdks/_index.md @@ -4,11 +4,17 @@ meta_desc: An overview of how to use Node.js, Python, Go, .NET, Java, and YAML w title: Languages & SDKs h1: Pulumi languages & SDKs meta_image: /images/docs/meta-images/docs-meta.png +capability: developer-tools menu: iac: name: Languages & SDKs parent: iac-home weight: 35 + developer-tools: + name: Language SDKs + identifier: developer-tools-sdks + parent: developer-tools-home + weight: 20 identifier: iac-languages languages: name: Overview diff --git a/content/docs/idp/_index.md b/content/docs/idp/_index.md index b7fb9c86a92b..74e366ed7801 100644 --- a/content/docs/idp/_index.md +++ b/content/docs/idp/_index.md @@ -7,6 +7,11 @@ menu: idp: identifier: idp-home weight: 1 + platform: + name: Templates & IDP + identifier: platform-idp + parent: platform-home + weight: 10 expanded_menu_ids: - idp-get-started @@ -14,6 +19,7 @@ expanded_menu_ids: meta_desc: Pulumi IDP enables you to build secure, scalable, and flexible developer workflows. meta_image: /images/docs/meta-images/docs-meta.png +capability: platform h1: Pulumi IDP Docs description:

Pulumi IDP enables you to build secure, scalable, and flexible developer workflows.

diff --git a/content/docs/insights/_index.md b/content/docs/insights/_index.md index 470dcc2ecb19..75595c8da662 100644 --- a/content/docs/insights/_index.md +++ b/content/docs/insights/_index.md @@ -7,11 +7,17 @@ menu: insights: identifier: insights-home weight: 1 + management: + name: Insights & Analytics + identifier: management-insights + parent: management-home + weight: 20 expanded_menu_ids: - insights-get-started - insights-concepts meta_desc: Pulumi Insights is an intelligent infrastructure management service to discover, understand, manage, and improve any cloud infrastructure. meta_image: /images/docs/meta-images/insights-meta.png +capability: management h1: Pulumi Insights Documentation description: | Pulumi Insights offers an intelligent platform for discovering, understanding, and managing cloud infrastructure with AI-powered asset and compliance management. diff --git a/content/docs/management/_index.md b/content/docs/management/_index.md new file mode 100644 index 000000000000..40bc54a55d09 --- /dev/null +++ b/content/docs/management/_index.md @@ -0,0 +1,122 @@ +--- +title: Management +linktitle: Management +capability: management +docs_home: true +notitle: true +menu: + management: + identifier: management-home + weight: 1 +expanded_menu_ids: + - management-deployments + - management-governance +meta_desc: Operational oversight and governance for infrastructure. Manage deployments, policies, access controls, compliance, and audit across your organization. +meta_image: /images/docs/meta-images/docs-meta.png +h1: Infrastructure management and governance +description:

Operational oversight and governance tools for managing deployments, enforcing policies, controlling access, and maintaining compliance across your cloud infrastructure.

+link_buttons: + primary: + label: Cloud Console + link: /docs/pulumi-cloud/ + secondary: + label: View Insights + link: /docs/insights/ + +sections: +- type: full-width-cards + heading: Core Management Capabilities + cards: + - icon: deploy-blue-21-21 + heading: Deployments + description: Monitor and manage infrastructure deployments across environments with automated workflows. + link: /docs/pulumi-cloud/deployments/ + - icon: shield-blue-21-21 + heading: Policy & Governance + description: Enforce organizational standards, compliance rules, and security policies through code. + link: /docs/iac/crossguard/ + - icon: users-blue-21-21 + heading: Access Management + description: Control who can access and modify infrastructure with role-based permissions and teams. + link: /docs/pulumi-cloud/access-management/ + - icon: audit-blue-21-21 + heading: Compliance & Audit + description: Track changes, monitor compliance, and generate audit reports for regulatory requirements. + link: /docs/insights/ +- type: button-cards + heading: Management Services + description: Enterprise-grade tools for infrastructure governance and operational control. + cards: + - heading: Pulumi Cloud Deployments + description: "Centralized deployment management with approval workflows, drift detection, and automated remediation." + link: /docs/pulumi-cloud/deployments/ + primary_button_label: Get Started + primary_button_link: /docs/pulumi-cloud/deployments/get-started/ + - heading: Pulumi Insights + description: "Asset discovery, compliance monitoring, and AI-powered insights across your cloud infrastructure." + link: /docs/insights/ + primary_button_label: Explore Insights + primary_button_link: /docs/insights/get-started/ + - heading: Policy as Code (CrossGuard) + description: "Define and enforce infrastructure policies using familiar programming languages with automated validation." + link: /docs/iac/crossguard/ + primary_button_label: Learn CrossGuard + primary_button_link: /docs/iac/crossguard/get-started/ +- type: full-width-cards + heading: Governance & Control + cards: + - icon: approval-blue-21-21 + heading: Approval Workflows + description: Require approvals for infrastructure changes with customizable review processes. + link: /docs/pulumi-cloud/deployments/ + - icon: drift-blue-21-21 + heading: Drift Detection + description: Automatically detect and remediate infrastructure drift from your desired state. + link: /docs/pulumi-cloud/deployments/drift/ + - icon: cost-blue-21-21 + heading: Cost Management + description: Track and optimize cloud spending with cost insights and budget alerts. + link: /docs/insights/ + - icon: security-blue-21-21 + heading: Security Scanning + description: Continuously scan infrastructure for security vulnerabilities and misconfigurations. + link: /docs/insights/ +- type: cards-logo-label-link + heading: Enterprise Features + description: Advanced management capabilities for large organizations and regulated industries. + cards: + - label: SAML/SSO + icon: saml-40 + link: /docs/pulumi-cloud/access-management/saml-sso/ + - label: SCIM Provisioning + icon: scim-40 + link: /docs/pulumi-cloud/access-management/scim/ + - label: Audit Logs + icon: audit-40 + link: /docs/pulumi-cloud/audit-logs/ + - label: Private Hosting + icon: private-40 + link: /docs/pulumi-cloud/self-hosted/ +- type: full-width-cards + heading: Operational Excellence + cards: + - icon: monitor-blue-21-21 + heading: Observability + description: Monitor infrastructure health, performance, and availability across all environments. + link: /docs/insights/ + - icon: alert-blue-21-21 + heading: Alerting & Notifications + description: Get notified about deployment failures, policy violations, and infrastructure issues. + link: /docs/pulumi-cloud/webhooks/ + - icon: backup-blue-21-21 + heading: Backup & Recovery + description: Protect against configuration loss with automated backups and point-in-time recovery. + link: /docs/pulumi-cloud/deployments/ + - icon: scale-blue-21-21 + heading: Multi-Environment Management + description: Consistently manage infrastructure across development, staging, and production environments. + link: /docs/pulumi-cloud/ +- type: flat + heading: Ready to govern at scale? + description:

Start with Deployments, explore Insights, or set up Policy as Code. Enterprise customers can learn about access management and audit logging.

+--- \ No newline at end of file diff --git a/content/docs/platform/_index.md b/content/docs/platform/_index.md new file mode 100644 index 000000000000..66b5a32c9ddc --- /dev/null +++ b/content/docs/platform/_index.md @@ -0,0 +1,125 @@ +--- +title: Platform +linktitle: Platform +capability: platform +docs_home: true +notitle: true +menu: + platform: + identifier: platform-home + weight: 1 +expanded_menu_ids: + - platform-packages + - platform-templates +meta_desc: Discover and create reusable infrastructure assets. Find packages, templates, components, and patterns to accelerate your cloud development. +meta_image: /images/docs/meta-images/docs-meta.png +h1: Platform ecosystem and assets +description:

Discover and create reusable infrastructure components, packages, templates, and patterns to accelerate development and ensure consistency across teams.

+link_buttons: + primary: + label: Browse Registry + link: /registry/ + secondary: + label: IDP Templates + link: /docs/idp/ + +sections: +- type: full-width-cards + heading: Platform Assets + cards: + - icon: package-blue-21-21 + heading: Packages & Providers + description: Ready-to-use infrastructure components for AWS, Azure, Google Cloud, and 120+ providers. + link: /registry/ + - icon: template-blue-21-21 + heading: Templates + description: Kickstart projects with pre-built templates and scaffolding for common architectures. + link: /docs/idp/ + - icon: layers-blue-21-21 + heading: Components + description: Higher-level abstractions that encapsulate best practices and simplify complex deployments. + link: /docs/iac/concepts/resources/components/ + - icon: blueprint-blue-21-21 + heading: Architecture Patterns + description: Reference architectures and proven patterns for scalable cloud solutions. + link: /docs/iac/using-pulumi/ +- type: cards-logo-label-link + heading: Popular Providers + description: Most-used cloud and service providers in the Pulumi ecosystem. + cards: + - label: AWS + icon: aws-40 + link: /registry/packages/aws/ + - label: Azure + icon: azure-40 + link: /registry/packages/azure/ + - label: Google Cloud + icon: google-cloud-40 + link: /registry/packages/gcp/ + - label: Kubernetes + icon: kubernetes-40 + link: /registry/packages/kubernetes/ + - label: Docker + icon: docker-40 + link: /registry/packages/docker/ + - label: Terraform + icon: terraform-40 + link: /registry/packages/terraform/ +- type: button-cards + heading: Platform Capabilities + description: Tools and services to create, share, and manage reusable infrastructure assets. + cards: + - heading: Pulumi Registry + description: "Discover over 120 cloud and service providers, plus thousands of community packages and components." + link: /registry/ + primary_button_label: Browse Registry + primary_button_link: /registry/ + - heading: Internal Developer Platform + description: "Create templates and self-service infrastructure for your engineering teams with governance guardrails." + link: /docs/idp/ + primary_button_label: Get Started + primary_button_link: /docs/idp/get-started/ + - heading: Component Authoring + description: "Build reusable infrastructure components that encapsulate your organization's best practices." + link: /docs/iac/concepts/resources/components/ + primary_button_label: Learn More + primary_button_link: /docs/iac/concepts/resources/components/ +- type: full-width-cards + heading: Platform Engineering + cards: + - icon: users-blue-21-21 + heading: Team Collaboration + description: Share packages, templates, and components across engineering teams. + link: /docs/pulumi-cloud/ + - icon: shield-blue-21-21 + heading: Governance & Policy + description: Enforce organizational standards and compliance through code and templates. + link: /docs/iac/crossguard/ + - icon: workflow-blue-21-21 + heading: Automation & CI/CD + description: Integrate reusable assets into your deployment pipelines and workflows. + link: /docs/iac/using-pulumi/continuous-delivery/ + - icon: chart-blue-21-21 + heading: Usage & Analytics + description: Track adoption and usage of your platform assets across the organization. + link: /docs/insights/ +- type: cards-logo-label-link + heading: Popular Templates + description: Get started quickly with proven infrastructure patterns and architectures. + cards: + - label: Static Website + icon: web-40 + link: /templates/static-website/ + - label: Serverless + icon: lambda-40 + link: /templates/serverless/ + - label: Container Service + icon: container-40 + link: /templates/container-service/ + - label: Kubernetes App + icon: kubernetes-40 + link: /templates/kubernetes-application/ +- type: flat + heading: Ready to build your platform? + description:

Start by exploring the Registry, create your first IDP template, or learn about component authoring. Need help? Join us on Slack or contact support.

+--- \ No newline at end of file diff --git a/content/docs/pulumi-cloud/deployments/_index.md b/content/docs/pulumi-cloud/deployments/_index.md index f033b5d002c7..bb965fe78e9a 100644 --- a/content/docs/pulumi-cloud/deployments/_index.md +++ b/content/docs/pulumi-cloud/deployments/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi Deployments is the fast way for individuals, teams, enterprise title: "Deployments" h1: "Pulumi Deployments" meta_image: /images/docs/meta-images/docs-meta.png +capability: management menu: cloud: name: Deployments parent: cloud-home identifier: pulumi-cloud-deployments weight: 3 + management: + name: Deployments + identifier: management-deployments + parent: management-home + weight: 10 aliases: - /docs/intro/pulumi-service/deployments/ - /docs/intro/deployments/ diff --git a/content/docs/pulumi-cloud/projects-and-stacks.md b/content/docs/pulumi-cloud/projects-and-stacks.md index f6b9811b004c..19e504413b8b 100644 --- a/content/docs/pulumi-cloud/projects-and-stacks.md +++ b/content/docs/pulumi-cloud/projects-and-stacks.md @@ -4,6 +4,7 @@ meta_desc: Learn how to manage projects and stacks in the Pulumi Cloud, includin title: "Projects & stacks" h1: "Projects & stacks" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: cloud: name: "Projects & stacks" diff --git a/layouts/partials/docs/menu.html b/layouts/partials/docs/menu.html index 1309715e0a3b..0cc002e27812 100644 --- a/layouts/partials/docs/menu.html +++ b/layouts/partials/docs/menu.html @@ -12,18 +12,28 @@ {{ end }} {{ if eq $menuID "" }} - {{ $segments := split $page.Path "/"}} + {{/* Check for capability frontmatter first */}} + {{ if $page.Params.capability }} + {{ if in $validMenus $page.Params.capability }} + {{ $menuID = $page.Params.capability }} + {{ end }} + {{ end }} + + {{/* If no capability set, derive from path */}} + {{ if eq $menuID "" }} + {{ $segments := split $page.Path "/"}} - {{ if eq (index $segments 1) "docs" }} - {{ $section := index $segments 2 }} + {{ if eq (index $segments 1) "docs" }} + {{ $section := index $segments 2 }} - {{/* Little hack to handle prevent colliding with the existing `pulumi-cloud` menu. */}} - {{ if eq $section "pulumi-cloud" }} - {{ $section = "cloud" }} - {{ end }} + {{/* Little hack to handle prevent colliding with the existing `pulumi-cloud` menu. */}} + {{ if eq $section "pulumi-cloud" }} + {{ $section = "cloud" }} + {{ end }} - {{ if in $validMenus $section }} - {{ $menuID = $section }} + {{ if in $validMenus $section }} + {{ $menuID = $section }} + {{ end }} {{ end }} {{ end }} {{ end }} From 6119a4ccb7de6617be28d0d47c882fca7158f638 Mon Sep 17 00:00:00 2001 From: Cam Date: Mon, 8 Sep 2025 18:18:24 +0000 Subject: [PATCH 04/11] Implement capability-aware breadcrumb navigation for improved documentation structure --- layouts/partials/docs/breadcrumb.html | 55 +++++++++++++++++++++++---- 1 file changed, 48 insertions(+), 7 deletions(-) diff --git a/layouts/partials/docs/breadcrumb.html b/layouts/partials/docs/breadcrumb.html index 4c514342e673..c1c8c73a4fca 100644 --- a/layouts/partials/docs/breadcrumb.html +++ b/layouts/partials/docs/breadcrumb.html @@ -1,15 +1,56 @@ - +
    - {{ template "breadcrumbnav" (dict "p1" . "p2" .) }} -
+ +
  • + + Docs + +
    • + + {{ $capability := .Params.capability }} + {{ if $capability }} + + {{ $capabilityTitle := "" }} + {{ $capabilityUrl := "" }} + + {{ if eq $capability "build" }} + {{ $capabilityTitle = "Build" }} + {{ $capabilityUrl = "/docs/build/" }} + {{ else if eq $capability "platform" }} + {{ $capabilityTitle = "Platform" }} + {{ $capabilityUrl = "/docs/platform/" }} + {{ else if eq $capability "management" }} + {{ $capabilityTitle = "Management" }} + {{ $capabilityUrl = "/docs/management/" }} + {{ else if eq $capability "developer-tools" }} + {{ $capabilityTitle = "Developer Tools" }} + {{ $capabilityUrl = "/docs/developer-tools/" }} + {{ end }} + + +
  • + + {{ $capabilityTitle }} + +
    • -{{/* TODO: Can we modify this to use the existing menus temporarily instead? */}} + +
  • + {{ .Title }} +
    • + + {{ else }} + + {{ template "pathbreadcrumb" (dict "p1" . "p2" .) }} + {{ end }} + -{{ define "breadcrumbnav" }} + +{{ define "pathbreadcrumb" }} {{ if and .p1.Parent (ne .p1.Parent .p1.Site.Home) }} - {{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2) }} + {{ template "pathbreadcrumb" (dict "p1" .p1.Parent "p2" .p2) }} {{ end }} {{ if not (isset .p1.Params "redirect_to") }}
  • @@ -18,4 +59,4 @@
    • {{ end }} -{{ end }} +{{ end }} \ No newline at end of file From ad54dfa5c7c042d29d6dcc85f464759089e9157a Mon Sep 17 00:00:00 2001 From: Cam Date: Mon, 8 Sep 2025 19:44:34 +0000 Subject: [PATCH 05/11] lint fix --- content/docs/iac/languages-sdks/_index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/docs/iac/languages-sdks/_index.md b/content/docs/iac/languages-sdks/_index.md index a16e90970087..71bdd066eb58 100644 --- a/content/docs/iac/languages-sdks/_index.md +++ b/content/docs/iac/languages-sdks/_index.md @@ -15,7 +15,6 @@ menu: identifier: developer-tools-sdks parent: developer-tools-home weight: 20 - identifier: iac-languages languages: name: Overview weight: 7 From f40ff53f55ed3ed2da415ad43c07b14662f73531 Mon Sep 17 00:00:00 2001 From: Cam Date: Mon, 8 Sep 2025 21:04:14 +0000 Subject: [PATCH 06/11] Enhance documentation layout and styling with emoji icons, improve breadcrumb functionality, and update section headings for better clarity and accessibility. --- assets/css/bundle.css | 12 +++++ content/docs/_index.md | 47 ++++++++----------- content/docs/build/_index.md | 18 +++---- content/docs/developer-tools/_index.md | 10 ++-- content/docs/management/_index.md | 10 ++-- content/docs/platform/_index.md | 18 +++---- layouts/docs/home.html | 8 +++- layouts/partials/docs/breadcrumb.html | 28 ++++++----- .../docs/special-pages/docs-home.html | 8 +++- theme/src/scss/docs/_docs-home.scss | 12 +++++ 10 files changed, 103 insertions(+), 68 deletions(-) diff --git a/assets/css/bundle.css b/assets/css/bundle.css index c06abb1e2b00..4a87ee09851c 100644 --- a/assets/css/bundle.css +++ b/assets/css/bundle.css @@ -4911,6 +4911,18 @@ section.docs-home a.full-width-card div.icon-heading div.icon{ top:-1px } +section.docs-home a.full-width-card div.icon-heading div.icon.emoji-icon{ + font-size:21px; + line-height:21px; + width:21px; + height:21px; + display:flex; + align-items:center; + justify-content:center; + background:transparent; + text-indent:0 !important +} + section.docs-home a.full-width-card:hover{ background:#f9f9f9; border:1px solid #bebfc9 diff --git a/content/docs/_index.md b/content/docs/_index.md index ee83cc7e800c..7be2d2dcc7c3 100644 --- a/content/docs/_index.md +++ b/content/docs/_index.md @@ -11,7 +11,7 @@ docs_home: true noleftnav: true norightnav: true nobreadcrumb: true -h1: Pulumi Docs +h1: Pulumi Docs description:

    Pulumi is an open source platform for automating, securing, and managing cloud resources, configuration, and secrets, using your favorite programming languages.

    link_buttons: primary: @@ -19,43 +19,36 @@ link_buttons: link: /docs/get-started/ sections: - type: button-cards - heading: Featured Products + heading: Start with Your Workflow cards: - - heading: Pulumi IaC - description: "Infrastructure as code for engineers in Node.js, Python, Go, .NET, Java, and YAML" - link: /docs/iac/ + - heading: Build + description: "Create and deploy cloud infrastructure using your favorite programming languages" + link: /docs/build/ primary_button_label: Get Started primary_button_link: /docs/iac/get-started/ secondary_button_label: Install secondary_button_link: /docs/iac/download-install/ - - heading: Pulumi ESC - description: "Environments, Secrets and Configuration Management" - link: /docs/esc/ - primary_button_label: Get Started - primary_button_link: /docs/esc/get-started/ - secondary_button_label: Install - secondary_button_link: /docs/esc/download-install/ - - heading: Pulumi IDP - description: "Secure, compliant, and customizable developer workflows at scale" - link: /docs/idp/ - primary_button_label: Get Started - primary_button_link: /docs/idp/get-started/ + - heading: Platform + description: "Enable teams with enterprise automation, collaboration, and internal developer platforms" + link: /docs/platform/ + primary_button_label: Learn More + primary_button_link: /docs/platform/ secondary_button_label: Create an account secondary_button_link: https://app.pulumi.com/signup - - heading: Pulumi Insights - description: "Asset management, compliance remediation and AI insights over the cloud" - link: /docs/insights/ + - heading: Management + description: "Discover, govern, and optimize cloud infrastructure with AI-powered insights and compliance" + link: /docs/management/ primary_button_label: Get Started primary_button_link: /docs/insights/get-started/ secondary_button_label: Create an account secondary_button_link: https://app.pulumi.com/signup - - heading: Pulumi Cloud - description: "Managed service for using Pulumi open source at scale. Use SaaS or self-host" - link: /docs/pulumi-cloud/ - primary_button_label: Get Started - primary_button_link: /docs/pulumi-cloud/get-started/ - secondary_button_label: Create an account - secondary_button_link: https://app.pulumi.com/signup + - heading: Developer Tools + description: "CLIs, SDKs, APIs, and AI-powered development tools for infrastructure as code" + link: /docs/developer-tools/ + primary_button_label: Explore Tools + primary_button_link: /docs/developer-tools/ + secondary_button_label: Install CLI + secondary_button_link: /docs/iac/download-install/ - type: cards-logo-label-link heading: Clouds description:

    Pulumi IaC supports AWS, Azure, Google Cloud, Kubernetes, and 120+ packages.

    diff --git a/content/docs/build/_index.md b/content/docs/build/_index.md index 3115c176d3ab..193d884ccfb8 100644 --- a/content/docs/build/_index.md +++ b/content/docs/build/_index.md @@ -14,7 +14,7 @@ expanded_menu_ids: - build-environments meta_desc: Build and deploy cloud infrastructure with Pulumi. Manage stacks, environments, resources, and services for your daily engineering work. meta_image: /images/docs/meta-images/docs-meta.png -h1: Build with Pulumi +h1: Build with Pulumi description:

    Everything you need for daily engineering work - creating stacks, managing environments, deploying resources, and building cloud services.

    link_buttons: primary: @@ -28,19 +28,19 @@ sections: - type: full-width-cards heading: Core Building Blocks cards: - - icon: stack-blue-21-21 + - icon: πŸ“š heading: Stacks description: Create and manage isolated deployments of your infrastructure across environments. link: /docs/iac/concepts/stacks/ - - icon: gear-blue-21-21 + - icon: βš™οΈ heading: Environments description: Configure secrets, settings, and variables across your infrastructure and applications. link: /docs/esc/environments/ - - icon: cube-blue-21-21 + - icon: 🧱 heading: Resources description: Provision and manage cloud resources with infrastructure as code. link: /docs/iac/concepts/resources/ - - icon: layers-blue-21-21 + - icon: 🧩 heading: Components description: Build reusable infrastructure components for consistent deployments. link: /docs/iac/concepts/resources/components/ @@ -63,19 +63,19 @@ sections: - type: full-width-cards heading: Essential Build Tasks cards: - - icon: terminal-blue-21-21 + - icon: πŸš€ heading: Deploy Your First Stack description: Learn the fundamentals of creating and deploying infrastructure stacks. link: /docs/iac/get-started/ - - icon: key-blue-21-21 + - icon: πŸ” heading: Manage Secrets & Config description: Securely handle configuration and secrets across environments. link: /docs/esc/get-started/ - - icon: cloud-blue-21-21 + - icon: ☁️ heading: Connect to Cloud Services description: Build applications that integrate with cloud databases, storage, and APIs. link: /docs/iac/concepts/ - - icon: layers-blue-21-21 + - icon: πŸ“‹ heading: Organize Stacks description: Structure your infrastructure across development, staging, and production. link: /docs/pulumi-cloud/projects-and-stacks/ diff --git a/content/docs/developer-tools/_index.md b/content/docs/developer-tools/_index.md index c45392c0d915..f305bbe88fba 100644 --- a/content/docs/developer-tools/_index.md +++ b/content/docs/developer-tools/_index.md @@ -13,7 +13,7 @@ expanded_menu_ids: - developer-tools-sdks meta_desc: Technical interfaces and tools for developers. CLIs, SDKs, APIs, and AI-powered development assistance for infrastructure as code. meta_image: /images/docs/meta-images/docs-meta.png -h1: Developer tools and interfaces +h1: Developer Tools and Interfaces description:

    Technical tools and interfaces for developers - command-line tools, programming language SDKs, REST APIs, and AI-powered development assistance.

    link_buttons: primary: @@ -27,19 +27,19 @@ sections: - type: full-width-cards heading: Core Developer Tools cards: - - icon: terminal-blue-21-21 + - icon: πŸ’» heading: Command Line Interface description: Powerful CLI for managing infrastructure deployments, configurations, and cloud resources. link: /docs/iac/cli/ - - icon: code-blue-21-21 + - icon: πŸ”§ heading: Language SDKs description: Native SDKs for TypeScript, Python, Go, .NET, Java, and YAML with full IDE support. link: /docs/iac/languages-sdks/ - - icon: api-blue-21-21 + - icon: πŸ”Œ heading: REST APIs description: Programmatic access to Pulumi Cloud services for custom integrations and automation. link: /docs/pulumi-cloud/cloud-rest-api/ - - icon: ai-blue-21-21 + - icon: πŸ€– heading: Pulumi AI description: AI-powered infrastructure generation, optimization, and intelligent assistance. link: /ai/ diff --git a/content/docs/management/_index.md b/content/docs/management/_index.md index 40bc54a55d09..77497047cc2c 100644 --- a/content/docs/management/_index.md +++ b/content/docs/management/_index.md @@ -13,7 +13,7 @@ expanded_menu_ids: - management-governance meta_desc: Operational oversight and governance for infrastructure. Manage deployments, policies, access controls, compliance, and audit across your organization. meta_image: /images/docs/meta-images/docs-meta.png -h1: Infrastructure management and governance +h1: Infrastructure Management and Governance description:

    Operational oversight and governance tools for managing deployments, enforcing policies, controlling access, and maintaining compliance across your cloud infrastructure.

    link_buttons: primary: @@ -27,19 +27,19 @@ sections: - type: full-width-cards heading: Core Management Capabilities cards: - - icon: deploy-blue-21-21 + - icon: πŸš€ heading: Deployments description: Monitor and manage infrastructure deployments across environments with automated workflows. link: /docs/pulumi-cloud/deployments/ - - icon: shield-blue-21-21 + - icon: πŸ›‘οΈ heading: Policy & Governance description: Enforce organizational standards, compliance rules, and security policies through code. link: /docs/iac/crossguard/ - - icon: users-blue-21-21 + - icon: πŸ‘₯ heading: Access Management description: Control who can access and modify infrastructure with role-based permissions and teams. link: /docs/pulumi-cloud/access-management/ - - icon: audit-blue-21-21 + - icon: πŸ“‹ heading: Compliance & Audit description: Track changes, monitor compliance, and generate audit reports for regulatory requirements. link: /docs/insights/ diff --git a/content/docs/platform/_index.md b/content/docs/platform/_index.md index 66b5a32c9ddc..23c9c32832ee 100644 --- a/content/docs/platform/_index.md +++ b/content/docs/platform/_index.md @@ -13,7 +13,7 @@ expanded_menu_ids: - platform-templates meta_desc: Discover and create reusable infrastructure assets. Find packages, templates, components, and patterns to accelerate your cloud development. meta_image: /images/docs/meta-images/docs-meta.png -h1: Platform ecosystem and assets +h1: Platform Ecosystem and Assets description:

    Discover and create reusable infrastructure components, packages, templates, and patterns to accelerate development and ensure consistency across teams.

    link_buttons: primary: @@ -27,19 +27,19 @@ sections: - type: full-width-cards heading: Platform Assets cards: - - icon: package-blue-21-21 + - icon: πŸ“¦ heading: Packages & Providers description: Ready-to-use infrastructure components for AWS, Azure, Google Cloud, and 120+ providers. link: /registry/ - - icon: template-blue-21-21 + - icon: πŸ“„ heading: Templates description: Kickstart projects with pre-built templates and scaffolding for common architectures. link: /docs/idp/ - - icon: layers-blue-21-21 + - icon: 🧩 heading: Components description: Higher-level abstractions that encapsulate best practices and simplify complex deployments. link: /docs/iac/concepts/resources/components/ - - icon: blueprint-blue-21-21 + - icon: πŸ—οΈ heading: Architecture Patterns description: Reference architectures and proven patterns for scalable cloud solutions. link: /docs/iac/using-pulumi/ @@ -87,19 +87,19 @@ sections: - type: full-width-cards heading: Platform Engineering cards: - - icon: users-blue-21-21 + - icon: πŸ‘₯ heading: Team Collaboration description: Share packages, templates, and components across engineering teams. link: /docs/pulumi-cloud/ - - icon: shield-blue-21-21 + - icon: πŸ›‘οΈ heading: Governance & Policy description: Enforce organizational standards and compliance through code and templates. link: /docs/iac/crossguard/ - - icon: workflow-blue-21-21 + - icon: ⚑ heading: Automation & CI/CD description: Integrate reusable assets into your deployment pipelines and workflows. link: /docs/iac/using-pulumi/continuous-delivery/ - - icon: chart-blue-21-21 + - icon: πŸ“Š heading: Usage & Analytics description: Track adoption and usage of your platform assets across the organization. link: /docs/insights/ diff --git a/layouts/docs/home.html b/layouts/docs/home.html index 9ee5b1e51fbb..85cdb2f7ee2f 100644 --- a/layouts/docs/home.html +++ b/layouts/docs/home.html @@ -56,7 +56,13 @@

    {{ .heading }}

    {{ range .cards }}
    -
    + {{ if .icon }} + {{ if not (strings.Contains .icon "-") }} +
    {{ .icon }}
    + {{ else }} +
    + {{ end }} + {{ end }}

    {{ .heading }}

    {{ .description }}

    diff --git a/layouts/partials/docs/breadcrumb.html b/layouts/partials/docs/breadcrumb.html index c1c8c73a4fca..2dab25371253 100644 --- a/layouts/partials/docs/breadcrumb.html +++ b/layouts/partials/docs/breadcrumb.html @@ -13,6 +13,7 @@ {{ $capabilityTitle := "" }} {{ $capabilityUrl := "" }} + {{ $isCapabilityHomePage := .Params.docs_home }} {{ if eq $capability "build" }} {{ $capabilityTitle = "Build" }} @@ -28,17 +29,22 @@ {{ $capabilityUrl = "/docs/developer-tools/" }} {{ end }} - -
  • - - {{ $capabilityTitle }} - -
    • - - -
  • - {{ .Title }} -
    • + {{ if $isCapabilityHomePage }} + +
  • + {{ $capabilityTitle }} +
    • + {{ else }} + +
  • + + {{ $capabilityTitle }} + +
    • +
  • + {{ .Title }} +
    • + {{ end }} {{ else }} diff --git a/layouts/partials/docs/special-pages/docs-home.html b/layouts/partials/docs/special-pages/docs-home.html index 4cb89afa7143..93a2ccb360e2 100644 --- a/layouts/partials/docs/special-pages/docs-home.html +++ b/layouts/partials/docs/special-pages/docs-home.html @@ -42,7 +42,13 @@

    {{ .heading }}

    {{ range .cards }}
    -
    + {{ if .icon }} + {{ if not (strings.Contains .icon "-") }} +
    {{ .icon }}
    + {{ else }} +
    + {{ end }} + {{ end }}

    {{ .heading }}

    {{ .description }}

    diff --git a/theme/src/scss/docs/_docs-home.scss b/theme/src/scss/docs/_docs-home.scss index befd54070955..07137ce3f881 100644 --- a/theme/src/scss/docs/_docs-home.scss +++ b/theme/src/scss/docs/_docs-home.scss @@ -139,6 +139,18 @@ section.docs-home { div.icon { top: -1px; + + &.emoji-icon { + font-size: 21px; + line-height: 21px; + width: 21px; + height: 21px; + display: flex; + align-items: center; + justify-content: center; + background: transparent; + text-indent: 0 !important; + } } } From 4a857fe2c280c2bd9797202a841ee721b44ae2aa Mon Sep 17 00:00:00 2001 From: Cam Date: Tue, 9 Sep 2025 00:12:36 +0000 Subject: [PATCH 07/11] Build landing page done-ish (WIP) --- content/docs/build/_index.md | 11 ++- content/docs/build/advanced-concepts.md | 33 +++++++ content/docs/build/cloud-platforms.md | 67 ++++++++++++++ content/docs/build/cloud-quickstarts.md | 72 +++++++++++++++ content/docs/build/configure-secure.md | 52 +++++++++++ content/docs/build/core-concepts.md | 65 ++++++++++++++ content/docs/build/getting-help.md | 87 +++++++++++++++++++ content/docs/build/getting-started.md | 59 +++++++++++++ content/docs/build/understand-context.md | 73 ++++++++++++++++ content/docs/esc/_index.md | 1 + content/docs/esc/environments/_index.md | 8 +- content/docs/esc/environments/imports.md | 6 ++ .../environments/working-with-environments.md | 6 ++ content/docs/esc/faq.md | 6 ++ content/docs/esc/get-started/_index.md | 6 ++ content/docs/esc/get-started/begin.md | 6 ++ .../esc/get-started/create-environment.md | 6 ++ .../esc/get-started/import-environments.md | 6 ++ .../get-started/integrate-with-pulumi-iac.md | 6 ++ .../get-started/retrieve-external-secrets.md | 6 ++ .../get-started/store-and-retrieve-secrets.md | 6 ++ .../get-started/use-short-term-credentials.md | 6 ++ .../integrations/dynamic-secrets/_index.md | 6 ++ .../esc/integrations/infrastructure/_index.md | 6 ++ .../infrastructure/pulumi-iac/_index.md | 5 ++ content/docs/iac/_index.md | 1 + content/docs/iac/adopting-pulumi/_index.md | 6 ++ content/docs/iac/clouds/_index.md | 6 ++ content/docs/iac/clouds/aws/_index.md | 6 ++ content/docs/iac/clouds/azure/_index.md | 6 ++ content/docs/iac/clouds/gcp/_index.md | 6 ++ content/docs/iac/clouds/kubernetes/_index.md | 6 ++ content/docs/iac/concepts/_index.md | 6 ++ .../docs/iac/concepts/components/_index.md | 7 +- content/docs/iac/concepts/config.md | 10 ++- content/docs/iac/concepts/functions/_index.md | 13 ++- .../iac/concepts/inputs-outputs/_index.md | 6 ++ .../docs/iac/concepts/inputs-outputs/all.md | 5 ++ .../docs/iac/concepts/inputs-outputs/apply.md | 5 ++ content/docs/iac/concepts/options/_index.md | 6 ++ .../options/additionalsecretoutputs.md | 5 ++ content/docs/iac/concepts/options/aliases.md | 5 ++ .../iac/concepts/options/customtimeouts.md | 5 ++ .../concepts/options/deletebeforereplace.md | 5 ++ .../docs/iac/concepts/options/deletedwith.md | 5 ++ .../docs/iac/concepts/options/dependson.md | 5 ++ content/docs/iac/concepts/options/hooks.md | 5 ++ .../iac/concepts/options/ignorechanges.md | 5 ++ content/docs/iac/concepts/options/import.md | 5 ++ content/docs/iac/concepts/options/parent.md | 5 ++ content/docs/iac/concepts/options/protect.md | 5 ++ content/docs/iac/concepts/options/provider.md | 5 ++ .../docs/iac/concepts/options/providers.md | 5 ++ .../iac/concepts/options/replaceonchanges.md | 5 ++ .../iac/concepts/options/retainOnDelete.md | 5 ++ .../iac/concepts/options/transformations.md | 5 ++ .../docs/iac/concepts/options/transforms.md | 5 ++ content/docs/iac/concepts/options/version.md | 5 ++ content/docs/iac/concepts/projects/_index.md | 6 ++ .../iac/concepts/projects/project-file.md | 5 ++ .../concepts/projects/stack-settings-file.md | 5 ++ content/docs/iac/concepts/resources/_index.md | 4 +- .../concepts/resources/dynamic-providers.md | 6 ++ content/docs/iac/concepts/resources/names.md | 6 ++ .../docs/iac/concepts/resources/providers.md | 5 ++ content/docs/iac/concepts/secrets.md | 10 +-- content/docs/iac/concepts/stacks.md | 2 +- .../docs/iac/concepts/state-and-backends.md | 10 +-- .../aws-cdk/_index.md | 6 ++ .../cloud-templates/cloudformation/_index.md | 6 ++ .../docs/iac/concepts/vs/terraform/_index.md | 6 ++ content/docs/iac/download-install/_index.md | 6 ++ .../iac/download-install/migrating-3.0.md | 7 ++ content/docs/iac/download-install/versions.md | 6 ++ content/docs/iac/get-started/_index.md | 8 +- content/docs/iac/get-started/aws/_index.md | 6 ++ content/docs/iac/get-started/aws/begin.md | 5 ++ content/docs/iac/get-started/aws/configure.md | 5 ++ .../iac/get-started/aws/create-component.md | 5 ++ .../iac/get-started/aws/create-project.md | 5 ++ .../docs/iac/get-started/aws/deploy-stack.md | 5 ++ .../docs/iac/get-started/aws/destroy-stack.md | 5 ++ .../iac/get-started/aws/modify-program.md | 5 ++ .../docs/iac/get-started/aws/next-steps.md | 5 ++ content/docs/iac/get-started/azure/_index.md | 6 ++ content/docs/iac/get-started/azure/begin.md | 6 ++ .../iac/get-started/azure/create-project.md | 6 ++ .../iac/get-started/azure/deploy-changes.md | 6 ++ .../iac/get-started/azure/deploy-stack.md | 6 ++ .../iac/get-started/azure/destroy-stack.md | 6 ++ .../iac/get-started/azure/modify-program.md | 6 ++ .../docs/iac/get-started/azure/next-steps.md | 6 ++ .../iac/get-started/azure/review-project.md | 6 ++ content/docs/iac/get-started/gcp/_index.md | 6 ++ content/docs/iac/get-started/gcp/begin.md | 6 ++ .../iac/get-started/gcp/create-project.md | 6 ++ .../iac/get-started/gcp/deploy-changes.md | 6 ++ .../docs/iac/get-started/gcp/deploy-stack.md | 6 ++ .../docs/iac/get-started/gcp/destroy-stack.md | 6 ++ .../iac/get-started/gcp/modify-program.md | 6 ++ .../docs/iac/get-started/gcp/next-steps.md | 6 ++ .../iac/get-started/gcp/review-project.md | 6 ++ .../docs/iac/get-started/kubernetes/_index.md | 6 ++ .../docs/iac/get-started/kubernetes/begin.md | 6 ++ .../get-started/kubernetes/create-project.md | 6 ++ .../get-started/kubernetes/deploy-changes.md | 6 ++ .../get-started/kubernetes/deploy-stack.md | 6 ++ .../get-started/kubernetes/destroy-stack.md | 6 ++ .../get-started/kubernetes/modify-program.md | 6 ++ .../iac/get-started/kubernetes/next-steps.md | 6 ++ .../get-started/kubernetes/review-project.md | 6 ++ content/docs/iac/languages-sdks/_index.md | 7 +- .../docs/iac/languages-sdks/dotnet/_index.md | 11 +++ content/docs/iac/languages-sdks/go/_index.md | 11 +++ .../docs/iac/languages-sdks/java/_index.md | 11 +++ .../iac/languages-sdks/javascript/_index.md | 11 +++ .../docs/iac/languages-sdks/python/_index.md | 11 +++ .../docs/iac/languages-sdks/yaml/_index.md | 11 +++ .../docs/pulumi-cloud/projects-and-stacks.md | 4 +- 119 files changed, 1146 insertions(+), 39 deletions(-) create mode 100644 content/docs/build/advanced-concepts.md create mode 100644 content/docs/build/cloud-platforms.md create mode 100644 content/docs/build/cloud-quickstarts.md create mode 100644 content/docs/build/configure-secure.md create mode 100644 content/docs/build/core-concepts.md create mode 100644 content/docs/build/getting-help.md create mode 100644 content/docs/build/getting-started.md create mode 100644 content/docs/build/understand-context.md diff --git a/content/docs/build/_index.md b/content/docs/build/_index.md index 193d884ccfb8..c4c8574a19c8 100644 --- a/content/docs/build/_index.md +++ b/content/docs/build/_index.md @@ -10,8 +10,11 @@ menu: weight: 1 expanded_menu_ids: - build-get-started - - build-stacks-projects - - build-environments + - build-cloud-quickstarts + - build-core-concepts + - build-configure-secure + - build-languages + - build-cloud-platforms meta_desc: Build and deploy cloud infrastructure with Pulumi. Manage stacks, environments, resources, and services for your daily engineering work. meta_image: /images/docs/meta-images/docs-meta.png h1: Build with Pulumi @@ -33,9 +36,9 @@ sections: description: Create and manage isolated deployments of your infrastructure across environments. link: /docs/iac/concepts/stacks/ - icon: βš™οΈ - heading: Environments + heading: Configuration & Secrets description: Configure secrets, settings, and variables across your infrastructure and applications. - link: /docs/esc/environments/ + link: /docs/build/configure-secure/ - icon: 🧱 heading: Resources description: Provision and manage cloud resources with infrastructure as code. diff --git a/content/docs/build/advanced-concepts.md b/content/docs/build/advanced-concepts.md new file mode 100644 index 000000000000..c36bf085aae5 --- /dev/null +++ b/content/docs/build/advanced-concepts.md @@ -0,0 +1,33 @@ +--- +title: Advanced Concepts +h1: Advanced Concepts +capability: build +menu: + build: + name: Advanced Concepts + identifier: build-advanced-concepts + parent: build-core-concepts + weight: 50 +meta_desc: Advanced concepts for building infrastructure with Pulumi - functions, dynamic providers, and resource naming. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Advanced concepts for taking your infrastructure further with Pulumi. + +## Functions + +Invoke cloud provider functions and utilities: + +- **[Functions](/docs/iac/concepts/functions/)** - Invoke cloud provider functions to get data and resources + +## Dynamic Providers + +Create custom resource providers: + +- **[Dynamic Providers](/docs/iac/concepts/resources/dynamic-providers/)** - Create custom resource providers for unique use cases + +## Resource Management + +Advanced resource management concepts: + +- **[Resource Names](/docs/iac/concepts/resources/names/)** - Understanding how Pulumi names resources diff --git a/content/docs/build/cloud-platforms.md b/content/docs/build/cloud-platforms.md new file mode 100644 index 000000000000..59428b971ddd --- /dev/null +++ b/content/docs/build/cloud-platforms.md @@ -0,0 +1,67 @@ +--- +title: Cloud Platforms +h1: Cloud Platforms +capability: build +menu: + build: + name: Cloud Platforms + identifier: build-cloud-platforms + parent: build-home + weight: 40 +meta_desc: Build infrastructure on any cloud platform - AWS, Azure, Google Cloud, Kubernetes, and 100+ providers. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Build infrastructure on any cloud platform. Pulumi supports AWS, Azure, Google Cloud, Kubernetes, and over 100 cloud providers and services. + +## Cloud Platform Overview + +Choose your platform and get building: + +- **[Clouds Overview](/docs/iac/clouds/)** - Explore all supported cloud platforms +- **Multi-cloud by design** - Use the same tools across all platforms +- **Consistent experience** - Same languages, workflows, and tools everywhere + +## Major Cloud Platforms + +Get started building on the major cloud providers: + +- **[Amazon Web Services (AWS)](/docs/iac/clouds/aws/)** - Build on the world's most comprehensive cloud platform +- **[Microsoft Azure](/docs/iac/clouds/azure/)** - Enterprise cloud services and integration +- **[Google Cloud Platform (GCP)](/docs/iac/clouds/gcp/)** - Google's suite of cloud computing services +- **[Kubernetes](/docs/iac/clouds/kubernetes/)** - Container orchestration and cloud-native apps + +## Getting Started by Platform + +Jump right into building with platform-specific guides: + +- **[AWS Quickstart](/docs/iac/get-started/aws/)** - Deploy your first AWS resources +- **[Azure Quickstart](/docs/iac/get-started/azure/)** - Get started on Microsoft Azure +- **[GCP Quickstart](/docs/iac/get-started/gcp/)** - Build on Google Cloud Platform +- **[Kubernetes Quickstart](/docs/iac/get-started/kubernetes/)** - Deploy to Kubernetes clusters + +## Integration Patterns + +Connect your cloud infrastructure with configuration and secrets: + +- **[Infrastructure Integration](/docs/esc/integrations/infrastructure/)** - Connect ESC with cloud resources +- **[Pulumi IaC Integration](/docs/esc/integrations/infrastructure/pulumi-iac/)** - Use ESC with your infrastructure code +- **[Kubernetes Integration](/docs/esc/integrations/kubernetes/)** - Manage Kubernetes secrets and config + +## Multi-Cloud Advantages + +Build infrastructure that spans multiple clouds: + +- **Avoid vendor lock-in** - Use the same tools across all platforms +- **Best of breed** - Choose the best services from each cloud +- **Disaster recovery** - Build resilient multi-cloud architectures +- **Cost optimization** - Optimize costs across different providers + +## Next Steps + +Ready to build on your preferred platform? + +1. **Choose your cloud** - Pick AWS, Azure, GCP, or Kubernetes +2. **Follow the quickstart** - Complete your first deployment +3. **Explore advanced patterns** - Learn platform-specific best practices +4. **Connect configuration** - Set up [Configure & Secure](/docs/build/configure-secure/) workflows diff --git a/content/docs/build/cloud-quickstarts.md b/content/docs/build/cloud-quickstarts.md new file mode 100644 index 000000000000..2190a5d399c7 --- /dev/null +++ b/content/docs/build/cloud-quickstarts.md @@ -0,0 +1,72 @@ +--- +title: Cloud Quickstarts +h1: Cloud Quickstarts +capability: build +menu: + build: + name: Cloud Quickstarts (AWS, Azure, GCP, K8s) + identifier: build-cloud-quickstarts + parent: build-get-started + weight: 30 +meta_desc: Get started building infrastructure on your preferred cloud platform - AWS, Azure, Google Cloud, or Kubernetes quickstart guides. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Jump into building infrastructure on your preferred cloud platform. Choose from AWS, Azure, Google Cloud, or Kubernetes quickstart guides. + +## Choose Your Cloud Platform + +Select your preferred platform and follow the step-by-step guide: + +### [AWS Quickstart](/docs/iac/get-started/aws/) + +Deploy your first infrastructure on Amazon Web Services: + +- Set up AWS credentials +- Create an S3 bucket +- Deploy serverless functions +- Manage EC2 instances + +### [Azure Quickstart](/docs/iac/get-started/azure/) + +Get started building on Microsoft Azure: + +- Configure Azure authentication +- Create resource groups +- Deploy web applications +- Manage storage accounts + +### [Google Cloud Quickstart](/docs/iac/get-started/gcp/) + +Build infrastructure on Google Cloud Platform: + +- Set up GCP credentials +- Create cloud storage buckets +- Deploy cloud functions +- Manage compute engines + +### [Kubernetes Quickstart](/docs/iac/get-started/kubernetes/) + +Deploy applications to Kubernetes clusters: + +- Configure cluster access +- Deploy applications and services +- Manage deployments and pods +- Set up ingress and networking + +## Multi-Cloud Deployments + +Ready for more advanced scenarios? + +- **Multi-cloud architectures** - Deploy across multiple providers +- **Hybrid deployments** - Combine on-premises and cloud resources +- **Cloud migration** - Move workloads between providers + +## Next Steps + +After completing a quickstart: + +1. **Explore [Core Concepts](/docs/build/core-concepts/)** - Understand projects, stacks, and resources +2. **Choose [Your Language](/docs/build/choose-language/)** - Language-specific guides and examples +3. **Set up [Configure & Secure](/docs/build/configure-secure/)** - Production configuration and secrets +4. **Learn [Cloud Platforms](/docs/build/cloud-platforms/)** - Advanced platform-specific patterns diff --git a/content/docs/build/configure-secure.md b/content/docs/build/configure-secure.md new file mode 100644 index 000000000000..cdddc6b67715 --- /dev/null +++ b/content/docs/build/configure-secure.md @@ -0,0 +1,52 @@ +--- +title: Configure & Secure +h1: Configure & Secure +capability: build +menu: + build: + name: Configure & Secure + identifier: build-configure-secure + parent: build-core-concepts + weight: 50 +meta_desc: Configure applications and manage secrets during individual development with Pulumi ESC and IaC configuration. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Configure applications and manage secrets during individual development. Learn how to handle configuration, environments, secrets, and infrastructure integration for your daily engineering work. + +## Basic Configuration + +Manage configuration settings for your infrastructure and applications: + +- [Configuration fundamentals](/docs/iac/concepts/config/) - Core configuration concepts +- [Project configuration](/docs/iac/concepts/projects/) - Configure projects and stacks + +## Environment Management + +Use Pulumi ESC for environment configuration: + +- [Environment fundamentals](/docs/esc/environments/) - ESC environment basics +- [Working with environments](/docs/esc/environments/working-with-environments/) - Environment workflows +- [Environment composition](/docs/esc/environments/imports/) - Environment imports and composition + +## Development Secrets & Login + +Securely handle secrets and dynamic credentials during development: + +- [Dynamic secrets](/docs/esc/integrations/dynamic-secrets/) - Dynamic secrets providers +- [AWS login credentials](/docs/esc/integrations/dynamic-login-credentials/aws-login/) - AWS OIDC login +- [Azure login credentials](/docs/esc/integrations/dynamic-login-credentials/azure-login/) - Azure OIDC login +- [GCP login credentials](/docs/esc/integrations/dynamic-login-credentials/gcp-login/) - GCP OIDC login + +## Infrastructure Integration + +Connect ESC with your infrastructure: + +- [Infrastructure integrations](/docs/esc/integrations/infrastructure/) - ESC infrastructure integration overview +- [Pulumi IaC integration](/docs/esc/integrations/infrastructure/pulumi-iac/) - Using ESC with Pulumi IaC +- [Kubernetes integration](/docs/esc/integrations/kubernetes/) - ESC with Kubernetes + +## Getting Started + +- [Get started with ESC](/docs/esc/get-started/) - Create your first environment +- [Configuration best practices](/docs/iac/concepts/config/) - Configuration patterns and security diff --git a/content/docs/build/core-concepts.md b/content/docs/build/core-concepts.md new file mode 100644 index 000000000000..3ba51c0d7a84 --- /dev/null +++ b/content/docs/build/core-concepts.md @@ -0,0 +1,65 @@ +--- +title: Core Concepts +h1: Core Concepts +capability: build +menu: + build: + name: Core Concepts + identifier: build-core-concepts + parent: build-home + weight: 20 +meta_desc: Master the fundamental concepts for building infrastructure with Pulumi - projects, stacks, resources, components, and configuration. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Master the fundamental concepts for building cloud infrastructure with Pulumi. Understand projects, stacks, resources, and how they work together. + +## Projects & Stacks + +Organize your infrastructure code and deployments: + +- **[Projects](/docs/iac/concepts/projects/)** - Project structure and configuration +- **[Stacks](/docs/iac/concepts/stacks/)** - Isolated deployments of your infrastructure +- **[Project Files](/docs/iac/concepts/projects/project-file/)** - Configure your Pulumi project +- **[Stack Settings](/docs/iac/concepts/projects/stack-settings-file/)** - Stack-specific configuration + +## Resources & Components + +Build with cloud resources and reusable components: + +- **[Resources](/docs/iac/concepts/resources/)** - Provision and manage cloud resources +- **[Components](/docs/iac/concepts/components/)** - Use reusable infrastructure components +- **[Resource Options](/docs/iac/concepts/options/)** - Control resource behavior and lifecycle + +## Configuration & Environments + +Configure your infrastructure for different environments: + +- **[Basic Configuration](/docs/iac/concepts/config/)** - Configuration fundamentals +- **[Secrets](/docs/iac/concepts/secrets/)** - Secure handling of sensitive information +- **[Environments](/docs/esc/environments/)** - ESC environment management +- **[State & Backends](/docs/iac/concepts/state-and-backends/)** - Understanding infrastructure state + +## Inputs, Outputs & Dependencies + +Understand data flow and resource relationships: + +- **[Inputs & Outputs](/docs/iac/concepts/inputs-outputs/)** - Resource data flow +- **[Apply Functions](/docs/iac/concepts/inputs-outputs/apply/)** - Transform output values +- **[All Function](/docs/iac/concepts/inputs-outputs/all/)** - Work with lists of outputs + +## Advanced Concepts + +Take your infrastructure further: + +- **[Functions](/docs/iac/concepts/functions/)** - Invoke cloud provider functions +- **[Dynamic Providers](/docs/iac/concepts/resources/dynamic-providers/)** - Create custom resource providers +- **[Resource Names](/docs/iac/concepts/resources/names/)** - Understanding resource naming + +## Getting Started + +New to these concepts? Start here: + +1. **[Your First Stack](/docs/iac/get-started/)** - Hands-on introduction to projects and stacks +2. **[Choose Your Language](/docs/iac/languages-sdks/)** - Language-specific examples +3. **[Cloud Quickstarts](/docs/iac/get-started/)** - Platform-specific tutorials diff --git a/content/docs/build/getting-help.md b/content/docs/build/getting-help.md new file mode 100644 index 000000000000..a084b143ac40 --- /dev/null +++ b/content/docs/build/getting-help.md @@ -0,0 +1,87 @@ +--- +title: Getting Help +h1: Getting Help +capability: build +menu: + build: + name: Getting Help + identifier: build-getting-help + parent: build-home + weight: 80 +meta_desc: Get help with building infrastructure using Pulumi - troubleshooting, FAQ, community support, and technical assistance. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Get help with building infrastructure using Pulumi. Find answers to common questions, troubleshoot issues, and connect with the community. + +## ESC FAQ + +Frequently asked questions about Pulumi ESC (Environments, Secrets, Config): + +- **[ESC FAQ](/docs/esc/faq/)** - Common questions about environments, secrets, and configuration management + +## Basic Troubleshooting + +Get help with common build and deployment issues: + +- **[Installation Issues](/docs/iac/download-install/)** - Troubleshoot Pulumi CLI installation +- **[Getting Started Problems](/docs/iac/get-started/)** - Common first-time setup issues +- **[Configuration Errors](/docs/iac/concepts/config/)** - Fix configuration-related problems + +For advanced troubleshooting and debugging tools, see [Developer Tools](/docs/developer-tools/). + +## Community & Support + +Connect with the Pulumi community and get expert help: + +### Community Resources + +- **[Community Slack](https://slack.pulumi.com)** - Join thousands of developers building with Pulumi +- **[GitHub Discussions](https://github.com/pulumi/pulumi/discussions)** - Ask questions and share ideas +- **[Stack Overflow](https://stackoverflow.com/questions/tagged/pulumi)** - Search existing questions or ask new ones + +### Getting Help + +- **[Community Support](/support/)** - Free community support options +- **[Professional Support](/support/)** - Enterprise support and services +- **[Training & Consulting](/support/)** - Expert guidance and training + +### Documentation & Learning + +- **[Tutorials](/tutorials/)** - Step-by-step guides for common scenarios +- **[Examples](/docs/reference/pkg/)** - Browse code examples in your preferred language +- **[Blog](https://pulumi.com/blog/)** - Latest updates, tutorials, and best practices + +## Quick Help Resources + +### Before You Ask + +1. **Check the logs**: Most errors include detailed information in the output +2. **Review the documentation**: Make sure you're following current best practices +3. **Search existing issues**: Your question might already be answered + +### How to Get Better Help + +When asking for help, please include: + +- **Pulumi version**: Run `pulumi version` +- **Operating system**: Windows, macOS, Linux +- **Programming language**: TypeScript, Python, Go, etc. +- **Cloud provider**: AWS, Azure, Google Cloud, etc. +- **Error messages**: Copy the full error output +- **Minimal reproducible example**: Share the smallest code that demonstrates the issue + +### Building-Specific Help Topics + +- **Stack management**: Creating, updating, and destroying stacks +- **Resource provisioning**: Working with cloud resources and providers +- **Configuration**: Managing settings and environment variables +- **Secrets**: Securely handling sensitive information +- **Environment setup**: Configuring development environments + +## Next Steps + +- **Ready to build?** Start with [Getting Started](/docs/iac/get-started/) +- **Need advanced tools?** Explore [Developer Tools](/docs/developer-tools/) +- **Building with a team?** Check out [Platform capabilities](/docs/platform/) +- **Need compliance?** See [Management capabilities](/docs/management/) diff --git a/content/docs/build/getting-started.md b/content/docs/build/getting-started.md new file mode 100644 index 000000000000..68cbe3e38f48 --- /dev/null +++ b/content/docs/build/getting-started.md @@ -0,0 +1,59 @@ +--- +title: Getting Started +h1: Getting Started +capability: build +menu: + build: + name: Getting Started + identifier: build-get-started + parent: build-home + weight: 10 +meta_desc: Get started building infrastructure with Pulumi - installation, first stack, cloud quickstarts, and environment setup. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Get started building cloud infrastructure with Pulumi. From installation through your first deployments and environment setup. + +## Install & Setup + +Get Pulumi installed and ready for development: + +- **[Install & Setup](/docs/iac/download-install/)** - Download and install the Pulumi CLI +- **[Version Management](/docs/iac/download-install/versions/)** - Available Pulumi versions +- **[Migrating to 3.0](/docs/iac/download-install/migrating-3.0/)** - Upgrade guide for Pulumi 3.0 + +## Your First Stack + +Create and deploy your first piece of infrastructure: + +- **[Your First Stack](/docs/iac/get-started/)** - Complete getting started guide +- Choose your cloud platform and follow step-by-step tutorials + +## Cloud Quickstarts + +Jump start building on your preferred cloud platform: + +- **[AWS Quickstart](/docs/iac/get-started/aws/)** - Get started on Amazon Web Services +- **[Azure Quickstart](/docs/iac/get-started/azure/)** - Get started on Microsoft Azure +- **[Google Cloud Quickstart](/docs/iac/get-started/gcp/)** - Get started on Google Cloud Platform +- **[Kubernetes Quickstart](/docs/iac/get-started/kubernetes/)** - Get started with Kubernetes + +## ESC Environment Setup + +Set up configuration and secrets management: + +- **[ESC Environment Setup](/docs/esc/get-started/)** - Create your first environment for configuration and secrets +- **[ESC Installation](/docs/esc/download-install/)** - Install the ESC CLI + +## Next Steps + +Once you've completed your first deployment: + +1. **Learn Core Concepts** - Understand [Projects & Stacks](/docs/iac/concepts/stacks/), [Resources](/docs/iac/concepts/resources/), and [Configuration](/docs/iac/concepts/config/) +2. **Choose Your Language** - Explore language-specific guides for [TypeScript](/docs/iac/languages-sdks/javascript/), [Python](/docs/iac/languages-sdks/python/), [Go](/docs/iac/languages-sdks/go/), and more +3. **Advanced Topics** - Set up [Configure & Secure](/docs/build/configure-secure/) workflows for production use + +## Getting Help + +- **[Community Slack](https://slack.pulumi.com)** - Get help from the community +- **[Getting Help](/docs/build/getting-help/)** - All support options and resources diff --git a/content/docs/build/understand-context.md b/content/docs/build/understand-context.md new file mode 100644 index 000000000000..17b10bc1ef6a --- /dev/null +++ b/content/docs/build/understand-context.md @@ -0,0 +1,73 @@ +--- +title: Understand Pulumi Context +h1: Understand Pulumi Context +capability: build +menu: + build: + name: Understand Pulumi Context + identifier: build-understand-context + parent: build-core-concepts + weight: 70 +meta_desc: Understand Pulumi in context of other tools like Terraform, CloudFormation, and AWS CDK. Learn migration strategies and when to use Pulumi. +meta_image: /images/docs/meta-images/docs-meta.png +--- + +Understand how Pulumi compares to other infrastructure tools and when to use Pulumi for your infrastructure needs. Learn about migration strategies and tool comparisons. + +## vs. Terraform & OpenTofu + +Compare Pulumi with Terraform and understand the key differences: + +- [Pulumi vs. Terraform](/docs/iac/concepts/vs/terraform/) - Comprehensive comparison +- [Pulumi vs. OpenTofu](/docs/iac/concepts/vs/terraform/opentofu/) - OpenTofu-specific differences +- [Terraform terminology in Pulumi](/docs/iac/concepts/vs/terraform/terminology/) - Mapping concepts + +## vs. CloudFormation & ARM Templates + +Understand how Pulumi differs from cloud-native template languages: + +- [Pulumi vs. CloudFormation](/docs/iac/concepts/vs/cloud-templates/cloudformation/) - AWS comparison +- [Cloud templates overview](/docs/iac/concepts/vs/cloud-templates/) - General cloud templates comparison + +## vs. AWS CDK + +Compare Pulumi with AWS CDK and other cloud development kits: + +- [Pulumi vs. AWS CDK](/docs/iac/concepts/vs/cloud-template-transpilers/aws-cdk/) - CDK-specific comparison +- [Cloud template transpilers](/docs/iac/concepts/vs/cloud-template-transpilers/) - CDK and similar tools + +## Migration Strategy + +Learn when and how to adopt Pulumi from other tools: + +- [Adopting Pulumi](/docs/iac/adopting-pulumi/) - Migration strategy overview +- [Import existing resources](/docs/iac/adopting-pulumi/import/) - When and why to import existing infrastructure +- [Migration tools](/docs/developer-tools/) - Technical migration utilities and tools + +## Key Pulumi Advantages + +Understanding why developers choose Pulumi: + +- **Use familiar languages**: TypeScript, Python, Go, C#, Java, YAML +- **Full programming language features**: Loops, conditionals, functions, classes +- **Rich ecosystem**: Package managers, IDEs, testing frameworks +- **Multi-cloud by default**: Same tools and languages across all clouds +- **Infrastructure as software**: Not just configuration, but real software engineering practices + +## When to Choose Pulumi + +Pulumi is particularly well-suited for: + +- **Complex infrastructure**: When you need loops, conditionals, or advanced logic +- **Multi-cloud deployments**: Managing infrastructure across multiple cloud providers +- **Developer-focused teams**: When infrastructure teams want to use familiar programming languages +- **Component reuse**: Building and sharing reusable infrastructure components +- **Integration with application code**: When infrastructure and application development are tightly coupled + +## Getting Started + +Ready to try Pulumi? Start here: + +- [Install Pulumi](/docs/iac/download-install/) - Get up and running +- [Your first stack](/docs/iac/get-started/) - Deploy your first infrastructure +- [Choose your language](/docs/iac/languages-sdks/) - Pick your preferred programming language diff --git a/content/docs/esc/_index.md b/content/docs/esc/_index.md index 21e88ea2423a..a9fa338f5422 100644 --- a/content/docs/esc/_index.md +++ b/content/docs/esc/_index.md @@ -3,6 +3,7 @@ title: Pulumi ESC linktitle: Pulumi ESC docs_home: true notitle: true +capability: build menu: esc: identifier: esc-home diff --git a/content/docs/esc/environments/_index.md b/content/docs/esc/environments/_index.md index cadcbfbcb623..9ebc66b09b44 100644 --- a/content/docs/esc/environments/_index.md +++ b/content/docs/esc/environments/_index.md @@ -10,10 +10,10 @@ menu: identifier: esc-environments weight: 4 build: - name: Environments - identifier: build-environments - parent: build-home - weight: 30 + name: Environment Management + identifier: build-environment-management + parent: build-configure-secure + weight: 20 --- Pulumi ESC (Environments, Secrets, and Configuration) lets you define collections of configuration settings and secrets called _environments_ and use them in any application or service. Environments are YAML documents composed of static key-value pairs, programmatic expressions, dynamically retrieved values from supported providers including all major clouds through OpenID Connect (OIDC), and other Pulumi ESC environments. diff --git a/content/docs/esc/environments/imports.md b/content/docs/esc/environments/imports.md index 3cb0af49f1eb..fce7f05b4468 100644 --- a/content/docs/esc/environments/imports.md +++ b/content/docs/esc/environments/imports.md @@ -3,12 +3,18 @@ title: Importing other environments title_tag: Importing other environments | Pulumi ESC h1: Importing other environments meta_desc: Pulumi ESC allows you to import and compose configurations from multiple environments, reducing duplication and ensuring consistency. +capability: build menu: esc: name: Importing environments identifier: esc-importing-environments parent: esc-environments weight: 2 + build: + name: Importing environments + identifier: build-importing-environments + parent: build-config-environments + weight: 30 --- Environments can be composed from other environments. diff --git a/content/docs/esc/environments/working-with-environments.md b/content/docs/esc/environments/working-with-environments.md index 71d098f8404f..76bc7d5caeac 100644 --- a/content/docs/esc/environments/working-with-environments.md +++ b/content/docs/esc/environments/working-with-environments.md @@ -3,11 +3,17 @@ title: Working with environments title_tag: Pulumi ESC environments h1: Working with environments meta_desc: Pulumi ESC allows you to compose and manage hierarchical collections of configuration and secrets and consume them in various ways. +capability: build menu: esc: identifier: working-with-environments parent: esc-environments weight: 1 + build: + name: Working with environments + identifier: build-working-environments + parent: build-config-environments + weight: 20 search: boost: true keywords: diff --git a/content/docs/esc/faq.md b/content/docs/esc/faq.md index b46987f9cc07..c3ea69d9d389 100644 --- a/content/docs/esc/faq.md +++ b/content/docs/esc/faq.md @@ -4,11 +4,17 @@ meta_desc: Frequently asked questions about Pulumi ESC, pricing and roadmap. title: FAQ h1: Pulumi ESC FAQs meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: esc: parent: esc-home weight: 12 identifier: faq + build: + name: ESC FAQ + identifier: build-esc-faq + parent: build-getting-help + weight: 10 aliases: - /docs/pulumi-cloud/esc/faq --- diff --git a/content/docs/esc/get-started/_index.md b/content/docs/esc/get-started/_index.md index 76687df4bbd4..7cb74942196b 100644 --- a/content/docs/esc/get-started/_index.md +++ b/content/docs/esc/get-started/_index.md @@ -3,11 +3,17 @@ title: Get started title_tag: Get Started with Pulumi ESC (Environments, Secrets, and Configuration) h1: Get Started with Pulumi ESC (Environments, Secrets, and Configuration) meta_desc: Learn how to manage secrets and hierarchical configuration with Pulumi ESC. +capability: build menu: esc: parent: esc-home identifier: esc-get-started weight: 2 + build: + name: Configuration & Secrets Environment Setup + identifier: build-esc-get-started + parent: build-configure-secure + weight: 70 aliases: - /docs/pulumi-cloud/esc/get-started/ --- diff --git a/content/docs/esc/get-started/begin.md b/content/docs/esc/get-started/begin.md index 75d1132f3b64..d36186f98fd6 100644 --- a/content/docs/esc/get-started/begin.md +++ b/content/docs/esc/get-started/begin.md @@ -3,11 +3,17 @@ title_tag: Before You Begin | Pulumi ESC title: Before you begin h1: "Pulumi ESC: Before you begin" meta_desc: This page provides an overview on how to get started with Pulumi ESC. +capability: build weight: 2 menu: esc: parent: esc-get-started identifier: esc-get-started-begin + build: + name: Before you begin + identifier: build-esc-get-started-begin + parent: build-esc-get-started + weight: 2 --- Before you get started using Pulumi ESC, let's run through a few quick steps to ensure your environment is set up correctly. diff --git a/content/docs/esc/get-started/create-environment.md b/content/docs/esc/get-started/create-environment.md index cff290812f45..ab6a9196558b 100644 --- a/content/docs/esc/get-started/create-environment.md +++ b/content/docs/esc/get-started/create-environment.md @@ -3,11 +3,17 @@ title_tag: Create a New Environment | Pulumi ESC title: Create environment h1: "Pulumi ESC: Create A New Environment" meta_desc: This page provides an overview on how to create a new Pulumi ESC environment. +capability: build weight: 3 menu: esc: parent: esc-get-started identifier: esc-get-started-create-environment + build: + name: Create environment + identifier: build-esc-get-started-create-environment + parent: build-esc-get-started + weight: 3 --- diff --git a/content/docs/esc/get-started/import-environments.md b/content/docs/esc/get-started/import-environments.md index 7c88325f4ff0..b19e82833c52 100644 --- a/content/docs/esc/get-started/import-environments.md +++ b/content/docs/esc/get-started/import-environments.md @@ -3,11 +3,17 @@ title_tag: Import Environments | Pulumi ESC title: Import environments h1: "Pulumi ESC: Import Environments" meta_desc: This page provides an overview on how to import environments in Pulumi ESC. +capability: build weight: 5 menu: esc: parent: esc-get-started identifier: esc-get-started-import-environments + build: + name: Import environments + identifier: build-esc-get-started-import-environments + parent: build-esc-get-started + weight: 5 --- ## Overview diff --git a/content/docs/esc/get-started/integrate-with-pulumi-iac.md b/content/docs/esc/get-started/integrate-with-pulumi-iac.md index da24afa6f7f2..9fd37738df1f 100644 --- a/content/docs/esc/get-started/integrate-with-pulumi-iac.md +++ b/content/docs/esc/get-started/integrate-with-pulumi-iac.md @@ -3,11 +3,17 @@ title_tag: Integrate with Pulumi IaC | Pulumi ESC title: Integrate with Pulumi IaC h1: "Pulumi ESC: Integrate with Pulumi IaC" meta_desc: This page provides an overview on how to use Pulumi ESC with Pulumi IaC. +capability: build weight: 8 menu: esc: parent: esc-get-started identifier: esc-get-started-integrate-with-pulumi-iac + build: + name: Integrate with Pulumi IaC + identifier: build-esc-get-started-integrate-with-pulumi-iac + parent: build-esc-get-started + weight: 8 --- ## Overview diff --git a/content/docs/esc/get-started/retrieve-external-secrets.md b/content/docs/esc/get-started/retrieve-external-secrets.md index fe502b315192..ea0c0c69266b 100644 --- a/content/docs/esc/get-started/retrieve-external-secrets.md +++ b/content/docs/esc/get-started/retrieve-external-secrets.md @@ -3,11 +3,17 @@ title_tag: Retrieve External Secrets | Pulumi ESC title: Retrieve secrets from external sources h1: "Pulumi ESC: Retrieve Secrets from External Sources" meta_desc: This page provides an overview on how to retrieve secrets from external sources. +capability: build weight: 7 menu: esc: parent: esc-get-started identifier: esc-get-started-retrieve-external-secrets + build: + name: Retrieve secrets from external sources + identifier: build-esc-get-started-retrieve-external-secrets + parent: build-esc-get-started + weight: 7 --- ## Overview diff --git a/content/docs/esc/get-started/store-and-retrieve-secrets.md b/content/docs/esc/get-started/store-and-retrieve-secrets.md index 8ae36420d945..2ef240b98048 100644 --- a/content/docs/esc/get-started/store-and-retrieve-secrets.md +++ b/content/docs/esc/get-started/store-and-retrieve-secrets.md @@ -3,11 +3,17 @@ title_tag: Store and Retrieve Secrets | Pulumi ESC title: Store and retrieve secrets h1: "Pulumi ESC: Store and Retrieve Secrets" meta_desc: This page provides an overview on how to store and retrieve secrets in Pulumi ESC. +capability: build weight: 4 menu: esc: parent: esc-get-started identifier: esc-get-started-store-retrieve-secrets + build: + name: Store and retrieve secrets + identifier: build-esc-get-started-store-retrieve-secrets + parent: build-esc-get-started + weight: 4 --- diff --git a/content/docs/esc/get-started/use-short-term-credentials.md b/content/docs/esc/get-started/use-short-term-credentials.md index 7a7d68983468..85c7d3103d5d 100644 --- a/content/docs/esc/get-started/use-short-term-credentials.md +++ b/content/docs/esc/get-started/use-short-term-credentials.md @@ -3,10 +3,16 @@ title_tag: Use Short Term Cloud Credentials | Pulumi ESC title: Use short term cloud credentials h1: "Use Short Term Cloud Credentials to Run Commands Without Local Secrets" meta_desc: This page provides an overview on how to get short term cloud credentials and run commands without using local secrets using the "esc run" command. +capability: build weight: 6 menu: esc: parent: esc-get-started + build: + name: Use short term cloud credentials + identifier: build-esc-get-started-use-short-term-credentials + parent: build-esc-get-started + weight: 6 --- Managing cloud credentials presents significant challenges for organizations of all sizes. Static, long-lived credentials, especially those stored in local environments introduce security risks and operational issues. Pulumi ESC’s built-in support for [dynamic login providers](/docs/esc/integrations/dynamic-login-credentials/), allows you to generate short-term, scoped credentials via OIDC. These credentials can then be used in your CLI workflows, CI/CD, Pulumi IaC, and more! diff --git a/content/docs/esc/integrations/dynamic-secrets/_index.md b/content/docs/esc/integrations/dynamic-secrets/_index.md index 2d4558939b34..048475c06afc 100644 --- a/content/docs/esc/integrations/dynamic-secrets/_index.md +++ b/content/docs/esc/integrations/dynamic-secrets/_index.md @@ -3,12 +3,18 @@ title: Dynamic secrets title_tag: Integrate Pulumi ESC with Dynamic Secrets providers | Pulumi ESC h1: Import and use secrets from providers meta_desc: Pulumi ESC enables integration with secrets providers like 1Password, AWS, Azure, Google Cloud, and Vault, to securely manage secrets in your environments. +capability: build menu: esc: name: Dynamic secrets identifier: esc-dynamic-secrets parent: esc-integrations weight: 2 + build: + name: Development Secrets & Login + identifier: build-dev-secrets + parent: build-configure-secure + weight: 30 --- Pulumi ESC providers enable you to dynamically import secrets and configuration from the provider into your environment. diff --git a/content/docs/esc/integrations/infrastructure/_index.md b/content/docs/esc/integrations/infrastructure/_index.md index 764b94d8e9e0..3b4266ccf9f2 100644 --- a/content/docs/esc/integrations/infrastructure/_index.md +++ b/content/docs/esc/integrations/infrastructure/_index.md @@ -3,11 +3,17 @@ title: Infrastructure title_tag: Infrastructure tools integrations | Pulumi ESC h1: ESC infrastructure tools integrations meta_desc: Pulumi ESC integrates with infrastructure tools like Pulumi IaC, Cloudflare, and Terraform for management of environment variables, secrets, and configurations. +capability: build menu: esc: identifier: esc-inf-tools-integrations parent: esc-integrations weight: 5 + build: + name: Infrastructure Integration + identifier: build-infrastructure-integrations + parent: build-configure-secure + weight: 40 aliases: - /docs/esc/other-integrations --- diff --git a/content/docs/esc/integrations/infrastructure/pulumi-iac/_index.md b/content/docs/esc/integrations/infrastructure/pulumi-iac/_index.md index c277181f4807..96fc5476809d 100644 --- a/content/docs/esc/integrations/infrastructure/pulumi-iac/_index.md +++ b/content/docs/esc/integrations/infrastructure/pulumi-iac/_index.md @@ -3,11 +3,16 @@ title: Pulumi IaC title_tag: Pulumi ESC and IaC integration h1: ESC Pulumi IaC Integration meta_desc: Pulumi ESC integrates with Pulumi IaC to expose environment settings and secrets to Pulumi stacks, simplifying configuration management. +capability: build menu: esc: identifier: esc-pulumi-iac-integrations parent: esc-inf-tools-integrations weight: 1 + build: + name: Pulumi IaC integration + parent: build-infrastructure-integrations + weight: 1 --- With support for Pulumi ESC built into the Pulumi CLI, you can expose an environment's settings and secrets to any or all of your Pulumi stacks, bypassing the need to define and maintain individual configuration settings or secrets "locally" in Pulumi config files. The optional `pulumiConfig` key enables this. diff --git a/content/docs/iac/_index.md b/content/docs/iac/_index.md index e8b78f301e2b..71daadc53b18 100644 --- a/content/docs/iac/_index.md +++ b/content/docs/iac/_index.md @@ -3,6 +3,7 @@ title: Pulumi IaC linktitle: Pulumi IaC docs_home: true notitle: true +capability: build menu: iac: identifier: iac-home diff --git a/content/docs/iac/adopting-pulumi/_index.md b/content/docs/iac/adopting-pulumi/_index.md index bafbd52f887a..c1feae9c3a5c 100644 --- a/content/docs/iac/adopting-pulumi/_index.md +++ b/content/docs/iac/adopting-pulumi/_index.md @@ -4,12 +4,18 @@ meta_desc: Learn how Pulumi compares to other solutions, how to migrate to Pulum title: Adopting Pulumi h1: Adopting Pulumi meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Adopting Pulumi parent: iac-home weight: 25 identifier: iac-adopting + build: + name: Migration Strategy + identifier: build-migration-strategy + parent: build-understand-context + weight: 40 usingpulumi: identifier: adopting-pulumi weight: 1 diff --git a/content/docs/iac/clouds/_index.md b/content/docs/iac/clouds/_index.md index a2cb3d5d3a95..81351b016245 100644 --- a/content/docs/iac/clouds/_index.md +++ b/content/docs/iac/clouds/_index.md @@ -4,7 +4,13 @@ meta_desc: Pulumi supports AWS, Azure, Google Cloud, Kubernetes, and over 100 ot title: "Clouds" no_on_this_page: true meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-cloud-platforms + name: Cloud Platform Overview + weight: 10 + identifier: build-cloud-platform-overview iac: parent: iac-home name: Clouds diff --git a/content/docs/iac/clouds/aws/_index.md b/content/docs/iac/clouds/aws/_index.md index 057f312dc7e6..05702aea8fc8 100644 --- a/content/docs/iac/clouds/aws/_index.md +++ b/content/docs/iac/clouds/aws/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi offers full support for AWS, with two providers, 10+ component title: "AWS" meta_image: /images/docs/meta-images/docs-clouds-aws-meta-image.png h1: AWS & Pulumi +capability: build menu: iac: name: AWS identifier: aws-clouds parent: iac-clouds weight: 1 + build: + name: Amazon Web Services + identifier: build-aws + parent: build-cloud-platforms + weight: 20 cloud_overview: true description: Build infrastructure on AWS using TypeScript, Python, Go, C#, Java or YAML. Pulumi supports all AWS services and stays up-to-date with all AWS features. get_started_guide: diff --git a/content/docs/iac/clouds/azure/_index.md b/content/docs/iac/clouds/azure/_index.md index 602b47357cdc..e3da804acd87 100644 --- a/content/docs/iac/clouds/azure/_index.md +++ b/content/docs/iac/clouds/azure/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi offers full support for Azure, with two providers, 4+ componen title: "Azure" meta_image: /images/docs/meta-images/docs-clouds-azure-meta-image.png h1: Azure & Pulumi +capability: build menu: iac: name: Azure identifier: azure-clouds parent: iac-clouds weight: 1 + build: + name: Microsoft Azure + identifier: build-azure + parent: build-cloud-platforms + weight: 30 cloud_overview: true description: Build infrastructure on Azure using TypeScript, Python, Go, C#, Java or YAML. The Azure Native provider is always up-to-date and covers 100% of the resources in Azure Resource Manager (ARM). get_started_guide: diff --git a/content/docs/iac/clouds/gcp/_index.md b/content/docs/iac/clouds/gcp/_index.md index 32f1c91c7ad4..da4d8a1c51ac 100644 --- a/content/docs/iac/clouds/gcp/_index.md +++ b/content/docs/iac/clouds/gcp/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi offers full support for Google Cloud, with two providers, 2 co title: "Google Cloud" meta_image: /images/docs/meta-images/docs-clouds-google-cloud-meta-image.png h1: Google Cloud & Pulumi +capability: build menu: iac: name: Google Cloud identifier: google-clouds parent: iac-clouds weight: 1 + build: + name: Google Cloud Platform + identifier: build-gcp + parent: build-cloud-platforms + weight: 40 cloud_overview: true description: Build infrastructure on Google Cloud using TypeScript, Python, Go, C#, Java or YAML. Pulumi supports all Google Cloud APIs and stays up-to-date with all Google Cloud features. get_started_guide: diff --git a/content/docs/iac/clouds/kubernetes/_index.md b/content/docs/iac/clouds/kubernetes/_index.md index 1145d2b42470..6199fc3ad764 100644 --- a/content/docs/iac/clouds/kubernetes/_index.md +++ b/content/docs/iac/clouds/kubernetes/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi offers full support for Kubernetes, with a provider, an operat title: "Kubernetes" meta_image: /images/docs/meta-images/docs-clouds-kubernetes-meta-image.png h1: Kubernetes & Pulumi +capability: build menu: iac: name: Kubernetes identifier: kubernetes-clouds parent: iac-clouds weight: 1 + build: + name: Kubernetes + identifier: build-kubernetes + parent: build-cloud-platforms + weight: 50 cloud_overview: true description: Streamline Kubernetes cluster configuration, management, and application workload deployments using TypeScript, Python, Go, C#, Java or YAML. Use the Pulumi Kubernetes Operator to manage both Kubernetes and cloud resources. get_started_guide: diff --git a/content/docs/iac/concepts/_index.md b/content/docs/iac/concepts/_index.md index 3dc124424d90..d55e11c3756d 100644 --- a/content/docs/iac/concepts/_index.md +++ b/content/docs/iac/concepts/_index.md @@ -4,12 +4,18 @@ meta_desc: Learn about what Pulumi is, how it works, and how its components work title: Concepts h1: What is Pulumi? meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Concepts weight: 15 parent: iac-home identifier: iac-concepts + build: + name: Core Concepts + identifier: build-core-concepts + parent: build-home + weight: 20 concepts: name: Overview weight: 4 diff --git a/content/docs/iac/concepts/components/_index.md b/content/docs/iac/concepts/components/_index.md index 8e28882b755d..40ec9d27c540 100644 --- a/content/docs/iac/concepts/components/_index.md +++ b/content/docs/iac/concepts/components/_index.md @@ -4,13 +4,18 @@ meta_desc: A component resource is a logical grouping of resources. Learn how to title: Components h1: Component resources meta_image: /images/docs/meta-images/docs-meta.png -capability: platform +capability: build menu: iac: name: Components parent: iac-concepts weight: 70 identifier: iac-concepts-components + build: + name: Components + identifier: build-components + parent: build-core-concepts + weight: 30 platform: name: Components identifier: platform-components diff --git a/content/docs/iac/concepts/config.md b/content/docs/iac/concepts/config.md index 09d349544502..6a6fbb08e7dc 100644 --- a/content/docs/iac/concepts/config.md +++ b/content/docs/iac/concepts/config.md @@ -4,13 +4,19 @@ meta_desc: This page provides an overview of how Pulumi manages cloud applicatio title: Configuration h1: Configuration meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Configuration parent: iac-concepts weight: 65 - concepts: - weight: 6 + build: + name: Configuration & Environments + identifier: build-config-environments + parent: build-configure-secure + weight: 30 +concepts: + weight: 6 aliases: - /docs/reference/config/ - /docs/tour/programs-configuration/ diff --git a/content/docs/iac/concepts/functions/_index.md b/content/docs/iac/concepts/functions/_index.md index 970241494323..b6d5e549012e 100644 --- a/content/docs/iac/concepts/functions/_index.md +++ b/content/docs/iac/concepts/functions/_index.md @@ -4,16 +4,13 @@ meta_desc: Learn about the three types of functions available in Pulumi programs title: Functions h1: Functions meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: - iac: + build: name: Functions - parent: iac-concepts - weight: 60 - identifier: iac-concepts-functions - concepts: - name: Functions - parent: Overview - weight: 6 + identifier: build-functions + parent: build-advanced-concepts + weight: 10 --- Pulumi provides three types of functions that you can use in your programs to interact with cloud resources and retrieve data from cloud providers. Understanding these different function types and when to use them is essential for writing effective Pulumi programs. diff --git a/content/docs/iac/concepts/inputs-outputs/_index.md b/content/docs/iac/concepts/inputs-outputs/_index.md index c881ad846513..3526174bfdc7 100644 --- a/content/docs/iac/concepts/inputs-outputs/_index.md +++ b/content/docs/iac/concepts/inputs-outputs/_index.md @@ -4,12 +4,18 @@ meta_desc: Resource properties are treated specially in Pulumi, both for purpose title: "Inputs & outputs" h1: "Inputs & outputs" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Inputs & outputs parent: iac-concepts weight: 60 identifier: iac-concepts-inputs-outputs + build: + name: Inputs, Outputs & Dependencies + identifier: build-inputs-outputs + parent: build-core-concepts + weight: 40 concepts: identifier: inputs-outputs weight: 5 diff --git a/content/docs/iac/concepts/inputs-outputs/all.md b/content/docs/iac/concepts/inputs-outputs/all.md index e38853f2b744..7acdb198688d 100644 --- a/content/docs/iac/concepts/inputs-outputs/all.md +++ b/content/docs/iac/concepts/inputs-outputs/all.md @@ -4,10 +4,15 @@ meta_desc: "Learn how to access multiple output values using the All method in P title: Accessing multiple outputs with All h1: Accessing multiple outputs with All meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: All parent: iac-concepts-inputs-outputs + build: + name: All + parent: build-inputs-outputs + weight: 2 concepts: weight: 2 parent: inputs-outputs diff --git a/content/docs/iac/concepts/inputs-outputs/apply.md b/content/docs/iac/concepts/inputs-outputs/apply.md index cd64eec2e754..cba05d681b9b 100644 --- a/content/docs/iac/concepts/inputs-outputs/apply.md +++ b/content/docs/iac/concepts/inputs-outputs/apply.md @@ -4,11 +4,16 @@ meta_desc: "Learn how to access a single output value using the apply method in title: Accessing single outputs with Apply h1: Accessing single outputs with Apply meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Apply parent: iac-concepts-inputs-outputs weight: 1 + build: + name: Apply + parent: build-inputs-outputs + weight: 1 concepts: weight: 2 parent: inputs-outputs diff --git a/content/docs/iac/concepts/options/_index.md b/content/docs/iac/concepts/options/_index.md index 4d3f9327cc07..30b9e5752909 100644 --- a/content/docs/iac/concepts/options/_index.md +++ b/content/docs/iac/concepts/options/_index.md @@ -4,11 +4,17 @@ meta_desc: Resource options can be used to configure how all Pulumi resources ar title: Resource options h1: Resource options meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: parent: iac-concepts identifier: options-concepts weight: 50 + build: + name: Resource Options + identifier: build-options + parent: build-resources + weight: 10 aliases: - /docs/intro/concepts/resources/options/ - /docs/concepts/options/ diff --git a/content/docs/iac/concepts/options/additionalsecretoutputs.md b/content/docs/iac/concepts/options/additionalsecretoutputs.md index 33f4f018b9c5..01d3e78d3d92 100644 --- a/content/docs/iac/concepts/options/additionalsecretoutputs.md +++ b/content/docs/iac/concepts/options/additionalsecretoutputs.md @@ -4,11 +4,16 @@ meta_desc: The additionalSecretOutputs resource option specifies a list of named title: "additionalSecretOutputs" h1: "Resource option: additionalSecretOutputs" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: additionalSecretOutputs parent: options-concepts weight: 1 + build: + name: additionalSecretOutputs + parent: build-options + weight: 1 aliases: - /docs/intro/concepts/resources/options/additionalsecretoutputs/ - /docs/concepts/options/additionalsecretoutputs/ diff --git a/content/docs/iac/concepts/options/aliases.md b/content/docs/iac/concepts/options/aliases.md index fb41528b2113..dc59fd10f743 100644 --- a/content/docs/iac/concepts/options/aliases.md +++ b/content/docs/iac/concepts/options/aliases.md @@ -4,11 +4,16 @@ meta_desc: The aliases resource option is commonly used when refactoring Pulumi title: "aliases" h1: "Resource option: aliases" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: aliases parent: options-concepts weight: 2 + build: + name: aliases + parent: build-options + weight: 2 aliases: - /docs/intro/concepts/resources/#aliases - /docs/intro/concepts/resources/options/aliases/ diff --git a/content/docs/iac/concepts/options/customtimeouts.md b/content/docs/iac/concepts/options/customtimeouts.md index 53963ec8e47e..8b5d967ba349 100644 --- a/content/docs/iac/concepts/options/customtimeouts.md +++ b/content/docs/iac/concepts/options/customtimeouts.md @@ -4,11 +4,16 @@ meta_desc: The customTimeouts resource option specifies the default retry/timeou title: "customTimeouts" h1: "Resource option: customTimeouts" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: customTimeouts parent: options-concepts weight: 3 + build: + name: customTimeouts + parent: build-options + weight: 3 aliases: - /docs/intro/concepts/resources/options/customtimeouts/ - /docs/concepts/options/customtimeouts/ diff --git a/content/docs/iac/concepts/options/deletebeforereplace.md b/content/docs/iac/concepts/options/deletebeforereplace.md index a7fd3a1c5151..630340d2d8df 100644 --- a/content/docs/iac/concepts/options/deletebeforereplace.md +++ b/content/docs/iac/concepts/options/deletebeforereplace.md @@ -4,11 +4,16 @@ meta_desc: Setting the deleteBeforeReplace option to true means that Pulumi will title: "deleteBeforeReplace" h1: "Resource option: deleteBeforeReplace" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: deleteBeforeReplace parent: options-concepts weight: 4 + build: + name: deleteBeforeReplace + parent: build-options + weight: 4 aliases: - /docs/intro/concepts/resources/options/deletebeforereplace/ - /docs/concepts/options/deletebeforereplace/ diff --git a/content/docs/iac/concepts/options/deletedwith.md b/content/docs/iac/concepts/options/deletedwith.md index c0b96fcb7a80..29c6dfb4d018 100644 --- a/content/docs/iac/concepts/options/deletedwith.md +++ b/content/docs/iac/concepts/options/deletedwith.md @@ -4,11 +4,16 @@ meta_desc: The deletedWith resource option allows you to skip running resource d title: "deletedWith" h1: "Resource option: deletedWith" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: deletedWith parent: options-concepts weight: 5 + build: + name: deletedWith + parent: build-options + weight: 5 aliases: - /docs/intro/concepts/resources/options/deletedwith/ - /docs/concepts/options/deletedwith/ diff --git a/content/docs/iac/concepts/options/dependson.md b/content/docs/iac/concepts/options/dependson.md index 041172d5b598..914e66a94ae3 100644 --- a/content/docs/iac/concepts/options/dependson.md +++ b/content/docs/iac/concepts/options/dependson.md @@ -4,11 +4,16 @@ meta_desc: The dependsOn resource option specifies additional resource dependenc title: "dependsOn" h1: "Resource option: dependsOn" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: dependsOn parent: options-concepts weight: 6 + build: + name: dependsOn + parent: build-options + weight: 6 aliases: - /docs/intro/concepts/resources/options/dependson/ - /docs/concepts/options/dependson/ diff --git a/content/docs/iac/concepts/options/hooks.md b/content/docs/iac/concepts/options/hooks.md index 22018512aba2..dbd27983c6c3 100644 --- a/content/docs/iac/concepts/options/hooks.md +++ b/content/docs/iac/concepts/options/hooks.md @@ -4,11 +4,16 @@ meta_desc: The hooks resource option provides a set of resource hooks linked to title: "hooks" h1: "Resource option: hooks" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: hooks parent: options-concepts weight: 7 + build: + name: Hooks + parent: build-options + weight: 7 aliases: - /docs/intro/concepts/resources/options/hooks/ - /docs/concepts/options/hooks/ diff --git a/content/docs/iac/concepts/options/ignorechanges.md b/content/docs/iac/concepts/options/ignorechanges.md index 8814fa04351c..a93eca14f405 100644 --- a/content/docs/iac/concepts/options/ignorechanges.md +++ b/content/docs/iac/concepts/options/ignorechanges.md @@ -4,11 +4,16 @@ meta_desc: The ignoreChanges resource option declares that changes to certain pr title: "ignoreChanges" h1: "Resource option: ignoreChanges" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: ignoreChanges parent: options-concepts weight: 8 + build: + name: ignoreChanges + parent: build-options + weight: 8 aliases: - /docs/intro/concepts/resources/options/ignorechanges/ - /docs/concepts/options/ignorechanges/ diff --git a/content/docs/iac/concepts/options/import.md b/content/docs/iac/concepts/options/import.md index 430a01d63e90..918a38ab5a29 100644 --- a/content/docs/iac/concepts/options/import.md +++ b/content/docs/iac/concepts/options/import.md @@ -4,11 +4,16 @@ meta_desc: The import resource option brings an existing cloud resource into Pul title: "import" h1: "Resource option: import" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: import parent: options-concepts weight: 9 + build: + name: Import + parent: build-options + weight: 9 aliases: - /docs/intro/concepts/resources/options/import/ - /docs/concepts/options/import/ diff --git a/content/docs/iac/concepts/options/parent.md b/content/docs/iac/concepts/options/parent.md index 1ff309dc9f3f..4e2a888b2e73 100644 --- a/content/docs/iac/concepts/options/parent.md +++ b/content/docs/iac/concepts/options/parent.md @@ -4,11 +4,16 @@ meta_desc: The parent resource option establishes an explicit parent/child relat title: "parent" h1: "Resource option: parent" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: parent parent: options-concepts weight: 10 + build: + name: Parent + parent: build-options + weight: 10 aliases: - /docs/intro/concepts/resources/options/parent/ - /docs/concepts/options/parent/ diff --git a/content/docs/iac/concepts/options/protect.md b/content/docs/iac/concepts/options/protect.md index 813fc471c0dc..597b9ecd5745 100644 --- a/content/docs/iac/concepts/options/protect.md +++ b/content/docs/iac/concepts/options/protect.md @@ -4,11 +4,16 @@ meta_desc: The protect resource option prevents accidental deletion of a resourc title: "protect" h1: "Resource option: protect" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: protect parent: options-concepts weight: 11 + build: + name: Protect + parent: build-options + weight: 11 aliases: - /docs/intro/concepts/resources/options/protect/ - /docs/concepts/options/protect/ diff --git a/content/docs/iac/concepts/options/provider.md b/content/docs/iac/concepts/options/provider.md index 777d2f4988fb..a6c2cadb4296 100644 --- a/content/docs/iac/concepts/options/provider.md +++ b/content/docs/iac/concepts/options/provider.md @@ -4,11 +4,16 @@ meta_desc: The provider resource option passes an explicitly configured provider title: "provider" h1: "Resource option: provider" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: provider parent: options-concepts weight: 12 + build: + name: Provider + parent: build-options + weight: 12 aliases: - /docs/concepts/resources/options/provider/ - /docs/concepts/options/provider/ diff --git a/content/docs/iac/concepts/options/providers.md b/content/docs/iac/concepts/options/providers.md index f2167c4e9634..212cfd1a01ab 100644 --- a/content/docs/iac/concepts/options/providers.md +++ b/content/docs/iac/concepts/options/providers.md @@ -4,11 +4,16 @@ meta_desc: The providers resource option specifies a set of explicitly configure title: "providers" h1: "Resource option: providers" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: providers parent: options-concepts weight: 13 + build: + name: Providers + parent: build-options + weight: 13 aliases: - /docs/concepts/resources/options/providers/ - /docs/concepts/options/providers/ diff --git a/content/docs/iac/concepts/options/replaceonchanges.md b/content/docs/iac/concepts/options/replaceonchanges.md index 90cc1c2a8b2a..e6e515da5207 100644 --- a/content/docs/iac/concepts/options/replaceonchanges.md +++ b/content/docs/iac/concepts/options/replaceonchanges.md @@ -4,11 +4,16 @@ meta_desc: The replaceOnChanges resource option indicates that changes to proper title: "replaceOnChanges" h1: "Resource option: replaceOnChanges" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: replaceOnChanges parent: options-concepts weight: 14 + build: + name: replaceOnChanges + parent: build-options + weight: 14 aliases: - /docs/intro/concepts/resources/options/replaceonchanges/ - /docs/concepts/options/replaceonchanges/ diff --git a/content/docs/iac/concepts/options/retainOnDelete.md b/content/docs/iac/concepts/options/retainOnDelete.md index f26a1806fef1..90e23b8b1a40 100644 --- a/content/docs/iac/concepts/options/retainOnDelete.md +++ b/content/docs/iac/concepts/options/retainOnDelete.md @@ -4,11 +4,16 @@ meta_desc: The `retainOnDelete` resource option marks a resource to be retained title: "retainOnDelete" h1: "Resource option: retainOnDelete" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: retainOnDelete parent: options-concepts weight: 15 + build: + name: retainOnDelete + parent: build-options + weight: 15 aliases: - /docs/intro/concepts/resources/options/retainondelete/ - /docs/concepts/options/retainondelete/ diff --git a/content/docs/iac/concepts/options/transformations.md b/content/docs/iac/concepts/options/transformations.md index 03b56420fbaa..dcf32ae7c9ff 100644 --- a/content/docs/iac/concepts/options/transformations.md +++ b/content/docs/iac/concepts/options/transformations.md @@ -4,11 +4,16 @@ meta_desc: The transformations resource option provides a list of transformation title: "transformations" h1: "Resource option: transformations" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: transformations parent: options-concepts weight: 16 + build: + name: Transformations + parent: build-options + weight: 16 aliases: - /docs/intro/concepts/resources/options/transformations/ - /docs/concepts/options/transformations/ diff --git a/content/docs/iac/concepts/options/transforms.md b/content/docs/iac/concepts/options/transforms.md index 838337af55d7..07bab9c0bdf6 100644 --- a/content/docs/iac/concepts/options/transforms.md +++ b/content/docs/iac/concepts/options/transforms.md @@ -4,11 +4,16 @@ meta_desc: The transforms resource option provides a list of transforms to apply title: "transforms" h1: "Resource option: transforms" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: transforms parent: options-concepts weight: 16 + build: + name: Transforms + parent: build-options + weight: 16 aliases: - /docs/intro/concepts/resources/options/transforms/ - /docs/concepts/options/transforms/ diff --git a/content/docs/iac/concepts/options/version.md b/content/docs/iac/concepts/options/version.md index dc1ebc2baf12..c8fde31ac638 100644 --- a/content/docs/iac/concepts/options/version.md +++ b/content/docs/iac/concepts/options/version.md @@ -4,11 +4,16 @@ meta_desc: The version resource option specifies a provider version to use when title: "version" h1: "Resource option: version" meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: identifier: version parent: options-concepts weight: 17 + build: + name: Version + parent: build-options + weight: 17 aliases: - /docs/intro/concepts/resources/options/version/ - /docs/concepts/options/version/ diff --git a/content/docs/iac/concepts/projects/_index.md b/content/docs/iac/concepts/projects/_index.md index 902f6769d219..c3c88f8a4912 100644 --- a/content/docs/iac/concepts/projects/_index.md +++ b/content/docs/iac/concepts/projects/_index.md @@ -4,12 +4,18 @@ meta_desc: A Pulumi project is any folder which contains a Pulumi.yaml file. Lea title: Projects h1: Projects meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Projects parent: iac-concepts weight: 20 identifier: iac-concepts-projects + build: + name: Projects + identifier: build-projects + parent: build-stacks-projects + weight: 10 concepts: identifier: projects weight: 1 diff --git a/content/docs/iac/concepts/projects/project-file.md b/content/docs/iac/concepts/projects/project-file.md index dcebc0fa58d9..4fb24e9c2995 100644 --- a/content/docs/iac/concepts/projects/project-file.md +++ b/content/docs/iac/concepts/projects/project-file.md @@ -4,11 +4,16 @@ meta_desc: Documentation of the settings that are valid for the Pulumi project f title: Project file reference h1: Pulumi project file reference meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Project file reference parent: iac-concepts-projects weight: 1 + build: + name: Project file reference + parent: build-projects + weight: 1 concepts: parent: projects weight: 1 diff --git a/content/docs/iac/concepts/projects/stack-settings-file.md b/content/docs/iac/concepts/projects/stack-settings-file.md index 3f66f59137a2..d0c5a529a768 100644 --- a/content/docs/iac/concepts/projects/stack-settings-file.md +++ b/content/docs/iac/concepts/projects/stack-settings-file.md @@ -4,11 +4,16 @@ meta_desc: Documentation of the settings that are valid for Pulumi stack configu title: Stack settings file reference h1: Pulumi stack settings file reference meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Stack settings file reference parent: iac-concepts-projects weight: 2 + build: + name: Stack settings file reference + parent: build-projects + weight: 2 concepts: parent: projects weight: 2 diff --git a/content/docs/iac/concepts/resources/_index.md b/content/docs/iac/concepts/resources/_index.md index 7b297eb4334a..e0902671669a 100644 --- a/content/docs/iac/concepts/resources/_index.md +++ b/content/docs/iac/concepts/resources/_index.md @@ -14,8 +14,8 @@ menu: build: name: Resources identifier: build-resources - parent: build-home - weight: 40 + parent: build-core-concepts + weight: 25 concepts: identifier: resources weight: 3 diff --git a/content/docs/iac/concepts/resources/dynamic-providers.md b/content/docs/iac/concepts/resources/dynamic-providers.md index a533bad3e22b..e6dd4dc873cd 100644 --- a/content/docs/iac/concepts/resources/dynamic-providers.md +++ b/content/docs/iac/concepts/resources/dynamic-providers.md @@ -4,11 +4,17 @@ meta_desc: Dynamic resource providers are providers that can be written inside y title: Dynamic providers h1: Dynamic resource providers meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Dynamic providers parent: iac-concepts-resources weight: 6 + build: + name: Dynamic providers + identifier: build-dynamic-providers + parent: build-advanced-concepts + weight: 20 concepts: parent: resources weight: 6 diff --git a/content/docs/iac/concepts/resources/names.md b/content/docs/iac/concepts/resources/names.md index 6e97c4d3a683..76f3f6e79e80 100644 --- a/content/docs/iac/concepts/resources/names.md +++ b/content/docs/iac/concepts/resources/names.md @@ -4,11 +4,17 @@ meta_desc: A resource in Pulumi has a logical name (in Pulumi) and a physical na title: Names h1: Resource names meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Names parent: iac-concepts-resources weight: 1 + build: + name: Resource Names + identifier: build-resource-names + parent: build-advanced-concepts + weight: 30 concepts: parent: resources weight: 1 diff --git a/content/docs/iac/concepts/resources/providers.md b/content/docs/iac/concepts/resources/providers.md index 5f0c6fdc6053..9a41ddbee71a 100644 --- a/content/docs/iac/concepts/resources/providers.md +++ b/content/docs/iac/concepts/resources/providers.md @@ -4,11 +4,16 @@ meta_desc: A resource provider handles communications with a cloud service to cr title: Providers h1: Resource providers meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Providers parent: iac-concepts-resources weight: 4 + build: + name: Providers + parent: build-resources + weight: 4 concepts: parent: resources weight: 4 diff --git a/content/docs/iac/concepts/secrets.md b/content/docs/iac/concepts/secrets.md index ecebfcc5b633..f732816f0ece 100644 --- a/content/docs/iac/concepts/secrets.md +++ b/content/docs/iac/concepts/secrets.md @@ -4,13 +4,13 @@ meta_desc: This page provides an overview of how Pulumi manages sensitive config title: Secrets h1: Secrets meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: - iac: + build: name: Secrets - parent: iac-concepts - weight: 90 - concepts: - weight: 7 + identifier: build-secrets + parent: build-config-environments + weight: 10 aliases: - /docs/intro/concepts/secrets/ - /docs/concepts/secrets/ diff --git a/content/docs/iac/concepts/stacks.md b/content/docs/iac/concepts/stacks.md index b2cb530e05e3..07e9dd8789e6 100644 --- a/content/docs/iac/concepts/stacks.md +++ b/content/docs/iac/concepts/stacks.md @@ -14,7 +14,7 @@ menu: name: Stacks identifier: build-stacks parent: build-stacks-projects - weight: 1 + weight: 20 concepts: weight: 2 aliases: diff --git a/content/docs/iac/concepts/state-and-backends.md b/content/docs/iac/concepts/state-and-backends.md index ab25201c5cc3..0647d755bc55 100644 --- a/content/docs/iac/concepts/state-and-backends.md +++ b/content/docs/iac/concepts/state-and-backends.md @@ -8,13 +8,13 @@ keywords: - infrastructure state - state backend meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: - iac: + build: name: State & backends - parent: iac-concepts - weight: 100 - concepts: - weight: 9 + identifier: build-state-backends + parent: build-config-environments + weight: 40 aliases: - /docs/reference/state/ diff --git a/content/docs/iac/concepts/vs/cloud-template-transpilers/aws-cdk/_index.md b/content/docs/iac/concepts/vs/cloud-template-transpilers/aws-cdk/_index.md index 2c33db0fb914..dc76c43f1a79 100644 --- a/content/docs/iac/concepts/vs/cloud-template-transpilers/aws-cdk/_index.md +++ b/content/docs/iac/concepts/vs/cloud-template-transpilers/aws-cdk/_index.md @@ -4,11 +4,17 @@ meta_desc: Pulumi and AWS Cloud Development Kit (CDK) share some similarities, b title: Pulumi vs AWS Cloud Development Kit (CDK) h1: Pulumi vs AWS Cloud Development Kit (CDK) meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Pulumi vs AWS Cloud Development Kit (CDK) parent: cloud-template-transpilers weight: 3 + build: + name: vs. AWS CDK + identifier: build-vs-aws-cdk + parent: build-understand-context + weight: 30 concepts: parent: vs weight: 3 diff --git a/content/docs/iac/concepts/vs/cloud-templates/cloudformation/_index.md b/content/docs/iac/concepts/vs/cloud-templates/cloudformation/_index.md index 1dc932014af6..4e9989daa5d5 100644 --- a/content/docs/iac/concepts/vs/cloud-templates/cloudformation/_index.md +++ b/content/docs/iac/concepts/vs/cloud-templates/cloudformation/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi and AWS CloudFormation share some similarities, but there are title: AWS CloudFormation h1: Pulumi vs AWS CloudFormation meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: AWS CloudFormation parent: iac-concepts-compare weight: 2 identifier: iac-concepts-compare-cloudformation + build: + name: vs. CloudFormation & ARM + identifier: build-vs-cloudformation + parent: build-understand-context + weight: 20 concepts: parent: vs weight: 2 diff --git a/content/docs/iac/concepts/vs/terraform/_index.md b/content/docs/iac/concepts/vs/terraform/_index.md index 56b4b213a04c..4acd72dd4a1a 100644 --- a/content/docs/iac/concepts/vs/terraform/_index.md +++ b/content/docs/iac/concepts/vs/terraform/_index.md @@ -4,12 +4,18 @@ meta_desc: Pulumi IaC and Terraform have many similarities, and yet they differ title: Terraform h1: Terraform vs. Pulumi IaC meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: name: Terraform parent: iac-concepts-compare weight: 1 identifier: iac-concepts-compare-terraform + build: + name: vs. Terraform & OpenTofu + identifier: build-vs-terraform + parent: build-understand-context + weight: 10 concepts: identifier: vs-terraform parent: vs diff --git a/content/docs/iac/download-install/_index.md b/content/docs/iac/download-install/_index.md index dd9895115dfa..5a0e803f322f 100644 --- a/content/docs/iac/download-install/_index.md +++ b/content/docs/iac/download-install/_index.md @@ -4,11 +4,17 @@ meta_desc: This page contains detailed instructions for downloading and installi title: "Download & install" h1: Download & install Pulumi meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: iac: parent: iac-home weight: 5 identifier: iac-install + build: + name: Install & Setup + identifier: build-install + parent: build-get-started + weight: 10 install: name: Overview weight: 1 diff --git a/content/docs/iac/download-install/migrating-3.0.md b/content/docs/iac/download-install/migrating-3.0.md index c62f068dd292..7344c1a7398d 100644 --- a/content/docs/iac/download-install/migrating-3.0.md +++ b/content/docs/iac/download-install/migrating-3.0.md @@ -4,6 +4,13 @@ meta_desc: This page provides instructions for upgrading to Pulumi 3.0 title: Upgrading to Pulumi 3.0 no_on_this_page: true meta_image: /images/docs/meta-images/docs-meta.png +capability: build +menu: + build: + name: Version Management & Migration + identifier: build-version-management + parent: build-core-concepts + weight: 50 aliases: - /docs/get-started/install/migrating-3.0/ diff --git a/content/docs/iac/download-install/versions.md b/content/docs/iac/download-install/versions.md index 0b3a2ab826ae..b74d11fe3f27 100644 --- a/content/docs/iac/download-install/versions.md +++ b/content/docs/iac/download-install/versions.md @@ -1,9 +1,15 @@ --- title: Pulumi CLI versions meta_desc: This page provides an list of available versions of the Pulumi CLI. +capability: build menu: install: weight: 1 + build: + name: Available Versions + identifier: build-available-versions + parent: build-core-concepts + weight: 60 aliases: - /docs/reference/changelog/ diff --git a/content/docs/iac/get-started/_index.md b/content/docs/iac/get-started/_index.md index c643f9eb0b31..45c9ae1b79be 100644 --- a/content/docs/iac/get-started/_index.md +++ b/content/docs/iac/get-started/_index.md @@ -13,10 +13,10 @@ menu: parent: iac-home weight: 10 build: - name: Get Started - identifier: build-get-started - parent: build-home - weight: 10 + name: Your First Stack + identifier: build-your-first-stack + parent: build-get-started + weight: 20 getstarted: name: Overview weight: 2 diff --git a/content/docs/iac/get-started/aws/_index.md b/content/docs/iac/get-started/aws/_index.md index 3e9013224643..476f854bb86d 100644 --- a/content/docs/iac/get-started/aws/_index.md +++ b/content/docs/iac/get-started/aws/_index.md @@ -3,12 +3,18 @@ title: AWS title_tag: Get started with Pulumi and AWS h1: Get started with Pulumi and AWS meta_desc: This page provides an overview and guide on how to get started with AWS. +capability: build menu: iac: name: AWS parent: iac-get-started weight: 2 identifier: aws-b-get-started + build: + name: AWS + identifier: build-get-started-aws + parent: build-cloud-quickstarts + weight: 10 aliases: - /docs/iac/get-started/aws/b/ diff --git a/content/docs/iac/get-started/aws/begin.md b/content/docs/iac/get-started/aws/begin.md index 6e1c78a185a3..962a919c8e0b 100644 --- a/content/docs/iac/get-started/aws/begin.md +++ b/content/docs/iac/get-started/aws/begin.md @@ -5,7 +5,12 @@ h1: "Get started with Pulumi and AWS" stepper_link: "I'm ready to begin" meta_desc: This page provides an overview on how to get started with Pulumi when starting an AWS project. weight: 2 +capability: build menu: + build: + name: Install Pulumi + parent: build-get-started-aws + weight: 2 iac: name: Install Pulumi parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/configure.md b/content/docs/iac/get-started/aws/configure.md index 50f655ca834e..f8c13fb7e8bd 100644 --- a/content/docs/iac/get-started/aws/configure.md +++ b/content/docs/iac/get-started/aws/configure.md @@ -4,7 +4,12 @@ title: Configure access h1: "Get started with Pulumi and AWS" meta_desc: This page provides an overview on how to get started with Pulumi when starting an AWS project. weight: 3 +capability: build menu: + build: + name: Configure access + parent: build-get-started-aws + weight: 3 iac: name: Configure access parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/create-component.md b/content/docs/iac/get-started/aws/create-component.md index dfb78dbcce62..07a196ca7be0 100644 --- a/content/docs/iac/get-started/aws/create-component.md +++ b/content/docs/iac/get-started/aws/create-component.md @@ -4,7 +4,12 @@ title: Create a component h1: "Get started with Pulumi and AWS" meta_desc: This page provides an overview on how to create infrastructure abstractions with Pulumi. weight: 7 +capability: build menu: + build: + name: Create a component + parent: build-get-started-aws + weight: 7 iac: name: Create a component parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/create-project.md b/content/docs/iac/get-started/aws/create-project.md index 4482819033d3..ae3e75e1b75c 100644 --- a/content/docs/iac/get-started/aws/create-project.md +++ b/content/docs/iac/get-started/aws/create-project.md @@ -4,7 +4,12 @@ title: Create project h1: "Get started with Pulumi and AWS" meta_desc: This page provides an overview of how to create a new AWS + Pulumi project. weight: 4 +capability: build menu: + build: + name: Create project + parent: build-get-started-aws + weight: 4 iac: name: Create project parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/deploy-stack.md b/content/docs/iac/get-started/aws/deploy-stack.md index 0ec8c9a57d86..cfff48695886 100644 --- a/content/docs/iac/get-started/aws/deploy-stack.md +++ b/content/docs/iac/get-started/aws/deploy-stack.md @@ -4,7 +4,12 @@ title: Deploy to AWS h1: "Get started with Pulumi and AWS" meta_desc: Learn how to deploy your stack to an AWS project in this guide. weight: 5 +capability: build menu: + build: + name: Deploy + parent: build-get-started-aws + weight: 5 iac: name: Deploy parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/destroy-stack.md b/content/docs/iac/get-started/aws/destroy-stack.md index a260efd99692..b7f29424a42f 100644 --- a/content/docs/iac/get-started/aws/destroy-stack.md +++ b/content/docs/iac/get-started/aws/destroy-stack.md @@ -4,7 +4,12 @@ title: Destroy stack h1: "Get started with Pulumi and AWS" meta_desc: This page provides an overview of how to destroy a Pulumi stack of an AWS project. weight: 8 +capability: build menu: + build: + name: Cleanup & destroy + parent: build-get-started-aws + weight: 8 iac: name: Cleanup & destroy parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/modify-program.md b/content/docs/iac/get-started/aws/modify-program.md index 509f2fbd513e..d31d8ba12823 100644 --- a/content/docs/iac/get-started/aws/modify-program.md +++ b/content/docs/iac/get-started/aws/modify-program.md @@ -4,7 +4,12 @@ title: Make an update h1: "Get started with Pulumi and AWS" meta_desc: This page provides an overview on how to update an AWS project from a Pulumi program. weight: 6 +capability: build menu: + build: + name: Make an update + parent: build-get-started-aws + weight: 6 iac: name: Make an update parent: aws-b-get-started diff --git a/content/docs/iac/get-started/aws/next-steps.md b/content/docs/iac/get-started/aws/next-steps.md index e6234952188b..d94d8887b97e 100644 --- a/content/docs/iac/get-started/aws/next-steps.md +++ b/content/docs/iac/get-started/aws/next-steps.md @@ -6,7 +6,12 @@ stepper_link: "Congratulations!" meta_desc: This page provides a list of tutorials that take a deeper dive into AWS cloud resources. weight: 9 +capability: build menu: + build: + name: Next steps + parent: build-get-started-aws + weight: 9 iac: name: Next steps parent: aws-b-get-started diff --git a/content/docs/iac/get-started/azure/_index.md b/content/docs/iac/get-started/azure/_index.md index ac525fa78bbb..859f24293681 100644 --- a/content/docs/iac/get-started/azure/_index.md +++ b/content/docs/iac/get-started/azure/_index.md @@ -3,6 +3,7 @@ title_tag: Get Started with Azure meta_desc: This page provides an overview and guide on how to get started with Azure. title: Azure h1: Get started with Pulumi & Azure +capability: build menu: iac: name: Azure @@ -13,6 +14,11 @@ menu: parent: azure identifier: azure-get-started weight: 2 + build: + name: Azure + identifier: build-get-started-azure + parent: build-cloud-quickstarts + weight: 30 aliases: - /docs/quickstart/azure/ - /docs/get-started/azure/ diff --git a/content/docs/iac/get-started/azure/begin.md b/content/docs/iac/get-started/azure/begin.md index 96add9efaba1..4ed02cee4cee 100644 --- a/content/docs/iac/get-started/azure/begin.md +++ b/content/docs/iac/get-started/azure/begin.md @@ -4,7 +4,13 @@ meta_desc: This page provides an overview on how to get started with Pulumi when title: Before you begin h1: "Pulumi & Azure: Before you begin" weight: 2 +capability: build menu: + build: + name: Install Pulumi + identifier: build-get-started-azure-begin + parent: build-get-started-azure + weight: 2 iac: name: Install Pulumi identifier: azure-get-started.begin diff --git a/content/docs/iac/get-started/azure/create-project.md b/content/docs/iac/get-started/azure/create-project.md index ba393a8528c3..fed0f24a36eb 100644 --- a/content/docs/iac/get-started/azure/create-project.md +++ b/content/docs/iac/get-started/azure/create-project.md @@ -4,7 +4,13 @@ meta_desc: This page provides an overview of how to create a new Azure + Pulumi title: Create project h1: "Pulumi & Azure: Create project" weight: 3 +capability: build menu: + build: + name: Create project + identifier: build-get-started-azure-create-project + parent: build-get-started-azure + weight: 3 iac: name: Create project identifier: azure-get-started.create-project diff --git a/content/docs/iac/get-started/azure/deploy-changes.md b/content/docs/iac/get-started/azure/deploy-changes.md index 03a4d9d9bc28..c74c70c6c3a5 100644 --- a/content/docs/iac/get-started/azure/deploy-changes.md +++ b/content/docs/iac/get-started/azure/deploy-changes.md @@ -4,7 +4,13 @@ meta_desc: Learn how to deploy changes to an Azure project in this guide. title: Deploy changes h1: "Pulumi & Azure: Deploy changes" weight: 7 +capability: build menu: + build: + name: Deploy changes + identifier: build-get-started-azure-deploy-changes + parent: build-get-started-azure + weight: 7 iac: name: Deploy changes identifier: azure-get-started.deploy-changes diff --git a/content/docs/iac/get-started/azure/deploy-stack.md b/content/docs/iac/get-started/azure/deploy-stack.md index b505fc186e0e..7b5d25a86da9 100644 --- a/content/docs/iac/get-started/azure/deploy-stack.md +++ b/content/docs/iac/get-started/azure/deploy-stack.md @@ -4,7 +4,13 @@ meta_desc: Learn how to deploy your stack to an Azure project in this guide. title: Deploy stack h1: "Pulumi & Azure: Deploy stack" weight: 5 +capability: build menu: + build: + name: Deploy stack + identifier: build-get-started-azure-deploy-stack + parent: build-get-started-azure + weight: 5 iac: name: Deploy stack identifier: azure-get-started.deploy-stack diff --git a/content/docs/iac/get-started/azure/destroy-stack.md b/content/docs/iac/get-started/azure/destroy-stack.md index 3b6b8bc4490b..130f296ae24e 100644 --- a/content/docs/iac/get-started/azure/destroy-stack.md +++ b/content/docs/iac/get-started/azure/destroy-stack.md @@ -4,7 +4,13 @@ meta_desc: This page provides an overview of how to destroy a Pulumi stack of an title: Destroy stack h1: "Pulumi & Azure: Destroy stack" weight: 8 +capability: build menu: + build: + name: Destroy stack + identifier: build-get-started-azure-destroy-stack + parent: build-get-started-azure + weight: 8 iac: name: Destroy stack identifier: azure-get-started.destroy-stack diff --git a/content/docs/iac/get-started/azure/modify-program.md b/content/docs/iac/get-started/azure/modify-program.md index 2bc23b5a1d2c..29bdf65caff7 100644 --- a/content/docs/iac/get-started/azure/modify-program.md +++ b/content/docs/iac/get-started/azure/modify-program.md @@ -4,7 +4,13 @@ meta_desc: This page provides an overview on how to update an Azure project from title: Modify program h1: "Pulumi & Azure: Modify program" weight: 6 +capability: build menu: + build: + name: Modify program + identifier: build-get-started-azure-modify-program + parent: build-get-started-azure + weight: 6 iac: name: Modify program identifier: azure-get-started.modify-program diff --git a/content/docs/iac/get-started/azure/next-steps.md b/content/docs/iac/get-started/azure/next-steps.md index 9a15dbcbc416..54fa97792530 100644 --- a/content/docs/iac/get-started/azure/next-steps.md +++ b/content/docs/iac/get-started/azure/next-steps.md @@ -5,7 +5,13 @@ meta_desc: This page provides a list of tutorials that take a deeper dive into title: Next steps h1: "Pulumi & Azure: Next steps" weight: 9 +capability: build menu: + build: + name: Next steps + identifier: build-get-started-azure-next-steps + parent: build-get-started-azure + weight: 9 iac: name: Next steps identifier: azure-get-started.next-steps diff --git a/content/docs/iac/get-started/azure/review-project.md b/content/docs/iac/get-started/azure/review-project.md index 9328f58e0105..fffc0394e04d 100644 --- a/content/docs/iac/get-started/azure/review-project.md +++ b/content/docs/iac/get-started/azure/review-project.md @@ -4,7 +4,13 @@ meta_desc: This page provides an overview on how to a review a new Azure project title: Review project h1: "Pulumi & Azure: Review project" weight: 4 +capability: build menu: + build: + name: Review project + identifier: build-get-started-azure-review-project + parent: build-get-started-azure + weight: 4 iac: name: Review project identifier: azure-get-started.review-project diff --git a/content/docs/iac/get-started/gcp/_index.md b/content/docs/iac/get-started/gcp/_index.md index 6a24361db45d..04d8cfbec89b 100644 --- a/content/docs/iac/get-started/gcp/_index.md +++ b/content/docs/iac/get-started/gcp/_index.md @@ -3,6 +3,7 @@ title_tag: Get Started with Google Cloud meta_desc: This page provides an overview and guide on how to get started with Google Cloud. title: Google Cloud h1: Get started with Pulumi & Google Cloud +capability: build menu: iac: name: Google Cloud @@ -13,6 +14,11 @@ menu: parent: google-cloud identifier: google-cloud-get-started weight: 3 + build: + name: Google Cloud + identifier: build-get-started-gcp + parent: build-cloud-quickstarts + weight: 40 aliases: - /docs/quickstart/gcp/ - /docs/get-started/gcp/ diff --git a/content/docs/iac/get-started/gcp/begin.md b/content/docs/iac/get-started/gcp/begin.md index abe1a766a8dd..fb3189f449c5 100644 --- a/content/docs/iac/get-started/gcp/begin.md +++ b/content/docs/iac/get-started/gcp/begin.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview on how to get started with Pulumi and title: Before you begin h1: "Pulumi & Google Cloud: Before you begin" weight: 2 +capability: build menu: iac: name: Install Pulumi identifier: gcp-get-started.begin parent: gcp-get-started weight: 2 + build: + name: Install Pulumi + identifier: build-gcp-begin + parent: build-get-started-gcp + weight: 10 aliases: - /docs/quickstart/gcp/begin/ - /docs/quickstart/gcp/install-pulumi/ diff --git a/content/docs/iac/get-started/gcp/create-project.md b/content/docs/iac/get-started/gcp/create-project.md index af070ef411b9..2b9977278421 100644 --- a/content/docs/iac/get-started/gcp/create-project.md +++ b/content/docs/iac/get-started/gcp/create-project.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how to create a new Google Cloud + title: Create project h1: "Pulumi & Google Cloud: Create project" weight: 3 +capability: build menu: iac: name: Create project identifier: gcp-get-started.create-project parent: gcp-get-started weight: 3 + build: + name: Create project + identifier: build-gcp-create-project + parent: build-get-started-gcp + weight: 20 aliases: - /docs/quickstart/gcp/create-project/ - /docs/get-started/gcp/create-project/ diff --git a/content/docs/iac/get-started/gcp/deploy-changes.md b/content/docs/iac/get-started/gcp/deploy-changes.md index e20f793a002c..5c9d76bded2c 100644 --- a/content/docs/iac/get-started/gcp/deploy-changes.md +++ b/content/docs/iac/get-started/gcp/deploy-changes.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how deploy changes to a Google Clou title: Deploy changes h1: "Pulumi & Google Cloud: Deploy changes" weight: 7 +capability: build menu: iac: name: Deploy changes identifier: gcp-get-started.deploy-changes parent: gcp-get-started weight: 7 + build: + name: Deploy changes + identifier: build-gcp-deploy-changes + parent: build-get-started-gcp + weight: 50 clouds: parent: google-cloud-get-started identifier: gcp-deploy-changes diff --git a/content/docs/iac/get-started/gcp/deploy-stack.md b/content/docs/iac/get-started/gcp/deploy-stack.md index 2a237e6466be..d76f5dd54117 100644 --- a/content/docs/iac/get-started/gcp/deploy-stack.md +++ b/content/docs/iac/get-started/gcp/deploy-stack.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how to deploy changes to a Google C title: Deploy stack h1: "Pulumi & Google Cloud: Deploy stack" weight: 5 +capability: build menu: iac: name: Deploy stack identifier: gcp-get-started.deploy-stack parent: gcp-get-started weight: 5 + build: + name: Deploy stack + identifier: build-gcp-deploy-stack + parent: build-get-started-gcp + weight: 30 clouds: parent: google-cloud-get-started identifier: gcp-deploy-stack diff --git a/content/docs/iac/get-started/gcp/destroy-stack.md b/content/docs/iac/get-started/gcp/destroy-stack.md index a58274549df2..1e39c26540d5 100644 --- a/content/docs/iac/get-started/gcp/destroy-stack.md +++ b/content/docs/iac/get-started/gcp/destroy-stack.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how to destroy a Pulumi stack of a title: Destroy stack h1: "Pulumi & Google Cloud: Destroy stack" weight: 8 +capability: build menu: iac: name: Destroy stack identifier: gcp-get-started.destroy-stack parent: gcp-get-started weight: 8 + build: + name: Destroy stack + identifier: build-gcp-destroy-stack + parent: build-get-started-gcp + weight: 60 clouds: parent: google-cloud-get-started identifier: gcp-destroy-stack diff --git a/content/docs/iac/get-started/gcp/modify-program.md b/content/docs/iac/get-started/gcp/modify-program.md index 616cb2511065..41c6540b20c8 100644 --- a/content/docs/iac/get-started/gcp/modify-program.md +++ b/content/docs/iac/get-started/gcp/modify-program.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview on how to update Google Cloud (GCP) pr title: Modify program h1: "Pulumi & Google Cloud: Modify program" weight: 6 +capability: build menu: iac: name: Modify program identifier: gcp-get-started.modify-program parent: gcp-get-started weight: 6 + build: + name: Modify program + identifier: build-gcp-modify-program + parent: build-get-started-gcp + weight: 40 clouds: parent: google-cloud-get-started identifier: gcp-modify-program diff --git a/content/docs/iac/get-started/gcp/next-steps.md b/content/docs/iac/get-started/gcp/next-steps.md index 105f71ce7037..dcec24901008 100644 --- a/content/docs/iac/get-started/gcp/next-steps.md +++ b/content/docs/iac/get-started/gcp/next-steps.md @@ -5,12 +5,18 @@ meta_desc: This page provides a list of tutorials that take a deeper dive into title: Next steps h1: "Pulumi & Google Cloud: Next steps" weight: 9 +capability: build menu: iac: name: Next steps identifier: gcp-get-started.next-steps parent: gcp-get-started weight: 9 + build: + name: Next steps + identifier: build-gcp-next-steps + parent: build-get-started-gcp + weight: 70 clouds: parent: google-cloud-get-started identifier: gcp-next-steps diff --git a/content/docs/iac/get-started/gcp/review-project.md b/content/docs/iac/get-started/gcp/review-project.md index 72f0f5fdf894..97adcd0e7bd5 100644 --- a/content/docs/iac/get-started/gcp/review-project.md +++ b/content/docs/iac/get-started/gcp/review-project.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview on how to a review a new Google Cloud title: Review project h1: "Pulumi & Google Cloud: Review project" weight: 4 +capability: build menu: iac: name: Review project identifier: gcp-get-started.review-project parent: gcp-get-started weight: 4 + build: + name: Review project + identifier: build-gcp-review-project + parent: build-get-started-gcp + weight: 25 clouds: parent: google-cloud-get-started identifier: gcp-review-project diff --git a/content/docs/iac/get-started/kubernetes/_index.md b/content/docs/iac/get-started/kubernetes/_index.md index 803cddd2abca..145ee2ec645c 100644 --- a/content/docs/iac/get-started/kubernetes/_index.md +++ b/content/docs/iac/get-started/kubernetes/_index.md @@ -3,6 +3,7 @@ title_tag: Get Started with Kubernetes meta_desc: This page provides an overview and guide on how to get started with Kubernetes. title: Kubernetes h1: Get Started with Kubernetes +capability: build menu: iac: name: Kubernetes @@ -13,6 +14,11 @@ menu: identifier: kubernetes-get-started parent: kube weight: 4 + build: + name: Kubernetes + identifier: build-get-started-kubernetes + parent: build-cloud-quickstarts + weight: 40 aliases: - /docs/quickstart/kubernetes/ - /docs/get-started/kubernetes/ diff --git a/content/docs/iac/get-started/kubernetes/begin.md b/content/docs/iac/get-started/kubernetes/begin.md index 35704f9e4765..ee380e8ae784 100644 --- a/content/docs/iac/get-started/kubernetes/begin.md +++ b/content/docs/iac/get-started/kubernetes/begin.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview on how to get started with Pulumi when title: Before you begin h1: "Pulumi & Kubernetes: Before you begin" weight: 2 +capability: build menu: iac: name: Install Pulumi identifier: kubernetes-get-started.begin parent: kubernetes-get-started weight: 2 + build: + name: Install Pulumi + identifier: build-kubernetes-begin + parent: build-get-started-kubernetes + weight: 10 clouds: parent: kubernetes-get-started identifier: kubernetes-begin diff --git a/content/docs/iac/get-started/kubernetes/create-project.md b/content/docs/iac/get-started/kubernetes/create-project.md index 52de60cba5c8..93a3ad36c530 100644 --- a/content/docs/iac/get-started/kubernetes/create-project.md +++ b/content/docs/iac/get-started/kubernetes/create-project.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how to create a new Kubernetes + Pu title: Create project h1: "Pulumi & Kubernetes: Create project" weight: 3 +capability: build menu: iac: name: Create project identifier: kubernetes-get-started.create-project parent: kubernetes-get-started weight: 3 + build: + name: Create project + identifier: build-kubernetes-create-project + parent: build-get-started-kubernetes + weight: 20 clouds: parent: kubernetes-get-started identifier: kubernetes-get-started-create-project diff --git a/content/docs/iac/get-started/kubernetes/deploy-changes.md b/content/docs/iac/get-started/kubernetes/deploy-changes.md index 60394fa693ed..72017c97a9a2 100644 --- a/content/docs/iac/get-started/kubernetes/deploy-changes.md +++ b/content/docs/iac/get-started/kubernetes/deploy-changes.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how deploy changes to a Kubernetes title: Deploy changes h1: "Pulumi & Kubernetes: Deploy changes" weight: 7 +capability: build menu: iac: name: Deploy changes identifier: kubernetes-get-started.deploy-changes parent: kubernetes-get-started weight: 7 + build: + name: Deploy changes + identifier: build-kubernetes-deploy-changes + parent: build-get-started-kubernetes + weight: 50 clouds: parent: kubernetes-get-started identifier: kubernetes-deploy-changes diff --git a/content/docs/iac/get-started/kubernetes/deploy-stack.md b/content/docs/iac/get-started/kubernetes/deploy-stack.md index a7b8552f8ca2..f4806327d053 100644 --- a/content/docs/iac/get-started/kubernetes/deploy-stack.md +++ b/content/docs/iac/get-started/kubernetes/deploy-stack.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how to deploy a Kubernetes project title: Deploy stack h1: "Pulumi & Kubernetes: Deploy stack" weight: 5 +capability: build menu: iac: name: Deploy stack identifier: kubernetes-get-started.deploy-stack parent: kubernetes-get-started weight: 5 + build: + name: Deploy stack + identifier: build-kubernetes-deploy-stack + parent: build-get-started-kubernetes + weight: 30 clouds: parent: kubernetes-get-started identifier: kubernetes-deploy-stack diff --git a/content/docs/iac/get-started/kubernetes/destroy-stack.md b/content/docs/iac/get-started/kubernetes/destroy-stack.md index dca925c4af19..099802e8fa2b 100644 --- a/content/docs/iac/get-started/kubernetes/destroy-stack.md +++ b/content/docs/iac/get-started/kubernetes/destroy-stack.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview of how to destroy a Pulumi stack of a title: Destroy stack h1: "Pulumi & Kubernetes: Destroy stack" weight: 8 +capability: build menu: iac: name: Destroy stack identifier: kubernetes-get-started.destroy-stack parent: kubernetes-get-started weight: 8 + build: + name: Destroy stack + identifier: build-kubernetes-destroy-stack + parent: build-get-started-kubernetes + weight: 60 clouds: parent: kubernetes-get-started identifier: kubernetes-destroy-stack diff --git a/content/docs/iac/get-started/kubernetes/modify-program.md b/content/docs/iac/get-started/kubernetes/modify-program.md index 72731b576529..c55bc3bcdb5c 100644 --- a/content/docs/iac/get-started/kubernetes/modify-program.md +++ b/content/docs/iac/get-started/kubernetes/modify-program.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview on how to update Kubernetes project fr title: Modify program h1: "Pulumi & Kubernetes: Modify program" weight: 6 +capability: build menu: iac: name: Modify program identifier: kubernetes-get-started.modify-program parent: kubernetes-get-started weight: 6 + build: + name: Modify program + identifier: build-kubernetes-modify-program + parent: build-get-started-kubernetes + weight: 40 clouds: parent: kubernetes-get-started identifier: kubernetes-modify-program diff --git a/content/docs/iac/get-started/kubernetes/next-steps.md b/content/docs/iac/get-started/kubernetes/next-steps.md index 4eda1952b8e3..9e191840a511 100644 --- a/content/docs/iac/get-started/kubernetes/next-steps.md +++ b/content/docs/iac/get-started/kubernetes/next-steps.md @@ -5,12 +5,18 @@ meta_desc: This page provides a list of tutorials that take a deeper dive into K title: Next steps h1: "Pulumi & Kubernetes: Next steps" weight: 9 +capability: build menu: iac: name: Next steps identifier: kubernetes-get-started.next-steps parent: kubernetes-get-started weight: 9 + build: + name: Next steps + identifier: build-kubernetes-next-steps + parent: build-get-started-kubernetes + weight: 70 clouds: parent: kubernetes-get-started identifier: kubernetes-next-steps diff --git a/content/docs/iac/get-started/kubernetes/review-project.md b/content/docs/iac/get-started/kubernetes/review-project.md index ad3709d87ee6..fdaa4fb02108 100644 --- a/content/docs/iac/get-started/kubernetes/review-project.md +++ b/content/docs/iac/get-started/kubernetes/review-project.md @@ -4,12 +4,18 @@ meta_desc: This page provides an overview on how to review a new Kubernetes proj title: Review project h1: "Pulumi & Kubernetes: Review project" weight: 4 +capability: build menu: iac: name: Review project identifier: kubernetes-get-started.review-project parent: kubernetes-get-started weight: 4 + build: + name: Review project + identifier: build-kubernetes-review-project + parent: build-get-started-kubernetes + weight: 25 clouds: parent: kubernetes-get-started identifier: kubernetes-review-project-get-started diff --git a/content/docs/iac/languages-sdks/_index.md b/content/docs/iac/languages-sdks/_index.md index 71bdd066eb58..4c8f562d611b 100644 --- a/content/docs/iac/languages-sdks/_index.md +++ b/content/docs/iac/languages-sdks/_index.md @@ -4,12 +4,17 @@ meta_desc: An overview of how to use Node.js, Python, Go, .NET, Java, and YAML w title: Languages & SDKs h1: Pulumi languages & SDKs meta_image: /images/docs/meta-images/docs-meta.png -capability: developer-tools +capability: build menu: iac: name: Languages & SDKs parent: iac-home weight: 35 + build: + name: Languages + identifier: build-languages + parent: build-home + weight: 30 developer-tools: name: Language SDKs identifier: developer-tools-sdks diff --git a/content/docs/iac/languages-sdks/dotnet/_index.md b/content/docs/iac/languages-sdks/dotnet/_index.md index 4fc87beb505d..5801340e0afb 100644 --- a/content/docs/iac/languages-sdks/dotnet/_index.md +++ b/content/docs/iac/languages-sdks/dotnet/_index.md @@ -4,7 +4,18 @@ meta_desc: An overview of how to use .NET languages like C# and F# with Pulumi f title: C#, VB, F# (.NET) h1: Pulumi & C#, VB, F# (.NET) meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-languages + name: C#/F#/.NET + weight: 50 + identifier: build-languages-dotnet + developer-tools: + parent: dev-languages + name: C#/F#/.NET + weight: 3 + identifier: dev-languages-dotnet iac: name: C#, F#, VB (.NET) parent: iac-languages diff --git a/content/docs/iac/languages-sdks/go/_index.md b/content/docs/iac/languages-sdks/go/_index.md index 37497aac904b..b513146a0e86 100644 --- a/content/docs/iac/languages-sdks/go/_index.md +++ b/content/docs/iac/languages-sdks/go/_index.md @@ -4,7 +4,18 @@ meta_desc: An overview of how to use the Go language with Pulumi for infrastruct title: Go h1: Pulumi & Go meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-languages + name: Go + weight: 40 + identifier: build-languages-go + developer-tools: + parent: dev-languages + name: Go + weight: 4 + identifier: dev-languages-go iac: name: Go parent: iac-languages diff --git a/content/docs/iac/languages-sdks/java/_index.md b/content/docs/iac/languages-sdks/java/_index.md index be5fc9d908e4..fffd999d5ae1 100644 --- a/content/docs/iac/languages-sdks/java/_index.md +++ b/content/docs/iac/languages-sdks/java/_index.md @@ -4,7 +4,18 @@ meta_desc: An overview of how to use the Java language with Pulumi for infrastru title: Java h1: Pulumi & Java meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-languages + name: Java + weight: 60 + identifier: build-languages-java + developer-tools: + parent: dev-languages + name: Java + weight: 5 + identifier: dev-languages-java iac: name: Java parent: iac-languages diff --git a/content/docs/iac/languages-sdks/javascript/_index.md b/content/docs/iac/languages-sdks/javascript/_index.md index e0f36cd5187e..256c22b224ab 100644 --- a/content/docs/iac/languages-sdks/javascript/_index.md +++ b/content/docs/iac/languages-sdks/javascript/_index.md @@ -4,7 +4,18 @@ meta_desc: Learn to use Node.js languages like JavaScript and TypeScript with Pu title: TypeScript (Node.js) h1: Pulumi & TypeScript & JavaScript (Node.js) meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-languages + name: TypeScript/JavaScript + weight: 20 + identifier: build-languages-javascript + developer-tools: + parent: dev-languages + name: TypeScript/JavaScript + weight: 1 + identifier: dev-languages-javascript iac: name: TypeScript (Node.js) parent: iac-languages diff --git a/content/docs/iac/languages-sdks/python/_index.md b/content/docs/iac/languages-sdks/python/_index.md index f84cf0027c5c..da120cdb1941 100644 --- a/content/docs/iac/languages-sdks/python/_index.md +++ b/content/docs/iac/languages-sdks/python/_index.md @@ -4,7 +4,18 @@ meta_desc: An overview of how to use Python with Pulumi for infrastructure as co title: Python h1: Pulumi & Python meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-languages + name: Python + weight: 30 + identifier: build-languages-python + developer-tools: + parent: dev-languages + name: Python + weight: 2 + identifier: dev-languages-python iac: name: Python parent: iac-languages diff --git a/content/docs/iac/languages-sdks/yaml/_index.md b/content/docs/iac/languages-sdks/yaml/_index.md index ecf645b15726..d89b0971f694 100644 --- a/content/docs/iac/languages-sdks/yaml/_index.md +++ b/content/docs/iac/languages-sdks/yaml/_index.md @@ -4,7 +4,18 @@ meta_desc: An overview of how to use Pulumi YAML for infrastructure as code on a title: YAML h1: Pulumi & YAML meta_image: /images/docs/meta-images/docs-meta.png +capability: build menu: + build: + parent: build-languages + name: YAML + weight: 70 + identifier: build-languages-yaml + developer-tools: + parent: dev-languages + name: YAML + weight: 6 + identifier: dev-languages-yaml iac: name: YAML parent: iac-languages diff --git a/content/docs/pulumi-cloud/projects-and-stacks.md b/content/docs/pulumi-cloud/projects-and-stacks.md index 19e504413b8b..6d97bf2fd29b 100644 --- a/content/docs/pulumi-cloud/projects-and-stacks.md +++ b/content/docs/pulumi-cloud/projects-and-stacks.md @@ -14,8 +14,8 @@ menu: build: name: Projects & Stacks identifier: build-stacks-projects - parent: build-home - weight: 20 + parent: build-core-concepts + weight: 10 aliases: - /docs/intro/console/project-and-stack-management/ - /docs/reference/service/roles-and-access-controls/ From e5beee8faa364243cf333cd60e246c0d36a85877 Mon Sep 17 00:00:00 2001 From: Cam Date: Wed, 10 Sep 2025 01:57:21 +0000 Subject: [PATCH 08/11] Implemented feedback --- CLAUDE.md | 3 + assets/css/bundle.css | 36 +++-- content/docs/_index.md | 33 +---- content/docs/build/_index.md | 80 ++++------- content/docs/build/cloud-platforms.md | 67 --------- content/docs/build/cloud-quickstarts.md | 10 +- content/docs/build/getting-help.md | 10 +- content/docs/build/getting-started.md | 6 - content/docs/build/understand-context.md | 2 +- content/docs/developer-tools/_index.md | 128 ------------------ content/docs/esc/cli/_index.md | 7 +- content/docs/esc/faq.md | 5 - content/docs/esc/get-started/_index.md | 7 +- content/docs/esc/get-started/begin.md | 2 +- .../esc/get-started/create-environment.md | 2 +- .../esc/get-started/import-environments.md | 2 +- .../get-started/integrate-with-pulumi-iac.md | 2 +- .../get-started/retrieve-external-secrets.md | 2 +- .../get-started/store-and-retrieve-secrets.md | 2 +- .../get-started/use-short-term-credentials.md | 2 +- content/docs/get-started/_index.md | 4 + content/docs/get-started/tutorials.md | 12 ++ content/docs/iac/cli/_index.md | 20 +-- .../docs/iac/cli/command-line-completion.md | 5 + content/docs/iac/cli/commands/_index.md | 5 + content/docs/iac/cli/environment-variables.md | 5 + content/docs/iac/clouds/_index.md | 11 +- content/docs/iac/clouds/aws/_index.md | 2 + content/docs/iac/clouds/azure/_index.md | 2 + content/docs/iac/clouds/gcp/_index.md | 2 + content/docs/iac/clouds/kubernetes/_index.md | 2 + content/docs/iac/download-install/_index.md | 8 +- content/docs/iac/get-started/_index.md | 28 ++-- content/docs/iac/get-started/aws/_index.md | 8 +- content/docs/iac/get-started/aws/begin.md | 6 +- content/docs/iac/get-started/aws/configure.md | 6 +- .../iac/get-started/aws/create-component.md | 6 +- .../iac/get-started/aws/create-project.md | 6 +- .../docs/iac/get-started/aws/deploy-stack.md | 6 +- .../docs/iac/get-started/aws/destroy-stack.md | 6 +- .../iac/get-started/aws/modify-program.md | 6 +- .../docs/iac/get-started/aws/next-steps.md | 6 +- content/docs/iac/get-started/azure/_index.md | 10 +- content/docs/iac/get-started/azure/begin.md | 7 +- .../iac/get-started/azure/create-project.md | 7 +- .../iac/get-started/azure/deploy-changes.md | 7 +- .../iac/get-started/azure/deploy-stack.md | 7 +- .../iac/get-started/azure/destroy-stack.md | 7 +- .../iac/get-started/azure/modify-program.md | 7 +- .../docs/iac/get-started/azure/next-steps.md | 7 +- .../iac/get-started/azure/review-project.md | 7 +- content/docs/iac/get-started/gcp/_index.md | 10 +- content/docs/iac/get-started/gcp/begin.md | 7 +- .../iac/get-started/gcp/create-project.md | 7 +- .../iac/get-started/gcp/deploy-changes.md | 7 +- .../docs/iac/get-started/gcp/deploy-stack.md | 7 +- .../docs/iac/get-started/gcp/destroy-stack.md | 7 +- .../iac/get-started/gcp/modify-program.md | 7 +- .../docs/iac/get-started/gcp/next-steps.md | 7 +- .../iac/get-started/gcp/review-project.md | 7 +- .../docs/iac/get-started/kubernetes/_index.md | 8 +- .../docs/iac/get-started/kubernetes/begin.md | 7 +- .../get-started/kubernetes/create-project.md | 7 +- .../get-started/kubernetes/deploy-changes.md | 7 +- .../get-started/kubernetes/deploy-stack.md | 7 +- .../get-started/kubernetes/destroy-stack.md | 7 +- .../get-started/kubernetes/modify-program.md | 7 +- .../iac/get-started/kubernetes/next-steps.md | 7 +- .../get-started/kubernetes/review-project.md | 7 +- content/docs/iac/languages-sdks/_index.md | 5 - .../docs/iac/languages-sdks/dotnet/_index.md | 5 - content/docs/iac/languages-sdks/go/_index.md | 5 - .../docs/iac/languages-sdks/java/_index.md | 5 - .../iac/languages-sdks/javascript/_index.md | 5 - .../docs/iac/languages-sdks/python/_index.md | 5 - .../docs/iac/languages-sdks/yaml/_index.md | 5 - content/docs/management/_index.md | 7 - content/docs/platform/_index.md | 13 +- content/docs/pulumi-cli/_index.md | 5 + layouts/docs/home.html | 3 +- layouts/partials/docs-top-nav.html | 3 - layouts/partials/docs/breadcrumb.html | 9 +- layouts/partials/docs/menu.html | 2 +- .../docs/special-pages/docs-home.html | 8 +- layouts/partials/docs/top-nav.html | 22 +-- layouts/partials/top-nav.html | 2 +- theme/src/scss/docs/_docs-home.scss | 12 +- theme/tailwind.config.js | 3 + 88 files changed, 258 insertions(+), 632 deletions(-) delete mode 100644 content/docs/build/cloud-platforms.md delete mode 100644 content/docs/developer-tools/_index.md create mode 100644 content/docs/get-started/_index.md create mode 100644 content/docs/get-started/tutorials.md create mode 100644 content/docs/pulumi-cli/_index.md diff --git a/CLAUDE.md b/CLAUDE.md index 8bc19d73c613..4fba6f3a6d43 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -29,3 +29,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co - **Naming**: Use lowercase for non-proper nouns (e.g., "stack" not "Stack" in text) - **Ordered Lists**: All items should begin with `1.` regardless of their position in the list. +## Site Architecture Notes +- **Tutorial Collections**: The file `/data/tutorials/collections.yaml` defines tutorial collections that generate `/tutorials/{id}/` URLs (e.g., `/tutorials/aws/`). However, Hugo internally maps these to `/collections/{id}` paths, so navigation logic must check for both `/tutorials/` and `/collections/` path prefixes. + diff --git a/assets/css/bundle.css b/assets/css/bundle.css index 4a87ee09851c..e4b2e72216f5 100644 --- a/assets/css/bundle.css +++ b/assets/css/bundle.css @@ -4788,36 +4788,30 @@ section.docs-home div.header{ background-position: right bottom; background-repeat: no-repeat; padding: 1.5rem; - background-image:url("/images/docs/docs-home-header-background-mobile.svg"); } section.docs-home div.header p{ - max-width: 28rem + max-width: 50rem } @media (min-width: 768px){ section.docs-home div.header{ - background-size: auto; - background-image:url("/images/docs/docs-home-header-background-tablet.svg") + background-size: auto } } @media (min-width: 1024px){ - section.docs-home div.header{ - background-image:url("/images/docs/docs-home-header-background-desktop.svg") - } } @media (min-width: 1280px){ .docs-content-width-expanded section.docs-home div.header{ - background-image:url("/images/docs/docs-home-header-background-desktop-wide.svg"); background-position: right } } @media (min-width: 1536px){ .docs-content-width-expanded section.docs-home div.header p{ - max-width: 32rem + max-width: 50rem } } @@ -30278,6 +30272,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{ max-width: 1536px; } +.max-w-50rem{ + max-width: 50rem; +} + .flex-1{ flex: 1 1 0%; } @@ -61025,6 +61023,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{ max-width: 1536px; } + .sm\:max-w-50rem{ + max-width: 50rem; + } + .sm\:flex-1{ flex: 1 1 0%; } @@ -91729,6 +91731,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{ max-width: 1536px; } + .md\:max-w-50rem{ + max-width: 50rem; + } + .md\:flex-1{ flex: 1 1 0%; } @@ -122433,6 +122439,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{ max-width: 1536px; } + .lg\:max-w-50rem{ + max-width: 50rem; + } + .lg\:flex-1{ flex: 1 1 0%; } @@ -153137,6 +153147,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{ max-width: 1536px; } + .xl\:max-w-50rem{ + max-width: 50rem; + } + .xl\:flex-1{ flex: 1 1 0%; } @@ -183841,6 +183855,10 @@ section.newsletter-input pulumi-hubspot-form input.hs-input{ max-width: 1536px; } + .xxl\:max-w-50rem{ + max-width: 50rem; + } + .xxl\:flex-1{ flex: 1 1 0%; } diff --git a/content/docs/_index.md b/content/docs/_index.md index 7be2d2dcc7c3..4905352d1f28 100644 --- a/content/docs/_index.md +++ b/content/docs/_index.md @@ -24,31 +24,15 @@ sections: - heading: Build description: "Create and deploy cloud infrastructure using your favorite programming languages" link: /docs/build/ - primary_button_label: Get Started - primary_button_link: /docs/iac/get-started/ - secondary_button_label: Install - secondary_button_link: /docs/iac/download-install/ - heading: Platform description: "Enable teams with enterprise automation, collaboration, and internal developer platforms" link: /docs/platform/ - primary_button_label: Learn More - primary_button_link: /docs/platform/ - secondary_button_label: Create an account - secondary_button_link: https://app.pulumi.com/signup - heading: Management description: "Discover, govern, and optimize cloud infrastructure with AI-powered insights and compliance" link: /docs/management/ - primary_button_label: Get Started - primary_button_link: /docs/insights/get-started/ - secondary_button_label: Create an account - secondary_button_link: https://app.pulumi.com/signup - heading: Developer Tools description: "CLIs, SDKs, APIs, and AI-powered development tools for infrastructure as code" - link: /docs/developer-tools/ - primary_button_label: Explore Tools - primary_button_link: /docs/developer-tools/ - secondary_button_label: Install CLI - secondary_button_link: /docs/iac/download-install/ + link: /docs/pulumi-cli/ - type: cards-logo-label-link heading: Clouds description:

    Pulumi IaC supports AWS, Azure, Google Cloud, Kubernetes, and 120+ packages.

    @@ -102,20 +86,11 @@ sections: - heading: Pulumi Community Slack description: "Join the Pulumi Community on Slack where you can ask questions or share ideas about infrastructure as code. The community is vibrant and we are excited to have you. Welcome!" link: https://slack.pulumi.com - primary_button_label: Join Now - primary_button_link: https://slack.pulumi.com - - heading: Pulumi GitHub - description: "Pulumi is open-source and open-minded. Got a question, idea, or problem to report? Leave us an issue in our GitHub repo!" + link: https://github.com/pulumi - primary_button_label: File an issue - primary_button_link: https://github.com/pulumi/pulumi/issues - - heading: Troubleshooting Guide - description: "Check out this list of known issues and how to resolve them." + link: https://www.pulumi.com/docs/iac/support/troubleshooting/ - primary_button_label: Learn More - primary_button_link: https://www.pulumi.com/docs/iac/support/troubleshooting/ - -- type: flat + heading: Enterprise and Business Critical support description: |

    Pulumi provides a range of support options such as dedicated 24x7 support, premium training, onboarding, and professional services. Please see our pricing page for the support options available. To open a support ticket or view service status, please visit our enterprise support portal.

    diff --git a/content/docs/build/_index.md b/content/docs/build/_index.md index c4c8574a19c8..e75e1d96ccdd 100644 --- a/content/docs/build/_index.md +++ b/content/docs/build/_index.md @@ -4,28 +4,18 @@ linktitle: Build capability: build docs_home: true notitle: true -menu: - build: - identifier: build-home - weight: 1 expanded_menu_ids: - - build-get-started - - build-cloud-quickstarts - build-core-concepts - - build-configure-secure - build-languages - build-cloud-platforms +menu: + build: + identifier: build-home + weight: 1 meta_desc: Build and deploy cloud infrastructure with Pulumi. Manage stacks, environments, resources, and services for your daily engineering work. meta_image: /images/docs/meta-images/docs-meta.png h1: Build with Pulumi description:

    Everything you need for daily engineering work - creating stacks, managing environments, deploying resources, and building cloud services.

    -link_buttons: - primary: - label: Get Started - link: /docs/iac/get-started/ - secondary: - label: Create Environment - link: /docs/esc/get-started/ sections: - type: full-width-cards @@ -43,26 +33,11 @@ sections: heading: Resources description: Provision and manage cloud resources with infrastructure as code. link: /docs/iac/concepts/resources/ - - icon: 🧩 - heading: Components - description: Build reusable infrastructure components for consistent deployments. - link: /docs/iac/concepts/resources/components/ -- type: cards-logo-label-link - heading: Get Started Building - description: Jump into creating infrastructure on your preferred cloud platform. - cards: - - label: AWS Quick Start - icon: aws-40 - link: /docs/iac/get-started/aws/ - - label: Azure Quick Start - icon: azure-40 - link: /docs/iac/get-started/azure/ - - label: Google Cloud Quick Start - icon: google-cloud-40 - link: /docs/iac/get-started/gcp/ - - label: Kubernetes Quick Start - icon: kubernetes-40 - link: /docs/iac/get-started/kubernetes/ + - icon: πŸ€– + heading: Tasks + description: AI-powered infrastructure generation, optimization, and intelligent assistance. + link: /docs/ai/ + - type: full-width-cards heading: Essential Build Tasks cards: @@ -82,25 +57,7 @@ sections: heading: Organize Stacks description: Structure your infrastructure across development, staging, and production. link: /docs/pulumi-cloud/projects-and-stacks/ -- type: button-cards - heading: Popular Build Workflows - description: Common patterns for building and deploying cloud infrastructure. - cards: - - heading: Serverless Applications - description: "Deploy functions, APIs, and event-driven architectures on AWS Lambda, Azure Functions, and Google Cloud Functions." - link: /docs/iac/clouds/aws/guides/lambda/ - primary_button_label: View Examples - primary_button_link: /docs/iac/clouds/aws/guides/lambda/ - - heading: Container Workloads - description: "Deploy containerized applications on Kubernetes, AWS ECS, Azure Container Apps, and Google Cloud Run." - link: /docs/iac/clouds/kubernetes/ - primary_button_label: Get Started - primary_button_link: /docs/iac/get-started/kubernetes/ - - heading: Static Websites - description: "Build and deploy static sites with CDNs, SSL certificates, and custom domains." - link: /tutorials/ - primary_button_label: View Tutorials - primary_button_link: /tutorials/ + - type: cards-logo-label-link heading: Build in Your Language description: Use familiar programming languages for infrastructure as code. @@ -123,6 +80,23 @@ sections: - label: YAML icon: icon-32-32 yaml-color-32-32 link: /docs/iac/languages-sdks/yaml/ + +- type: cards-logo-label-link + heading: Get Started Building + description: Jump into creating infrastructure on your preferred cloud platform. + cards: + - label: AWS Quick Start + icon: aws-40 + link: /docs/iac/get-started/aws/ + - label: Azure Quick Start + icon: azure-40 + link: /docs/iac/get-started/azure/ + - label: Google Cloud Quick Start + icon: google-cloud-40 + link: /docs/iac/get-started/gcp/ + - label: Kubernetes Quick Start + icon: kubernetes-40 + link: /docs/iac/get-started/kubernetes/ - type: flat heading: Ready to build? description:

    Start with our Get Started guide, explore tutorials, or jump into environment configuration. Need help? Join us on Slack or contact support.

    diff --git a/content/docs/build/cloud-platforms.md b/content/docs/build/cloud-platforms.md deleted file mode 100644 index 59428b971ddd..000000000000 --- a/content/docs/build/cloud-platforms.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Cloud Platforms -h1: Cloud Platforms -capability: build -menu: - build: - name: Cloud Platforms - identifier: build-cloud-platforms - parent: build-home - weight: 40 -meta_desc: Build infrastructure on any cloud platform - AWS, Azure, Google Cloud, Kubernetes, and 100+ providers. -meta_image: /images/docs/meta-images/docs-meta.png ---- - -Build infrastructure on any cloud platform. Pulumi supports AWS, Azure, Google Cloud, Kubernetes, and over 100 cloud providers and services. - -## Cloud Platform Overview - -Choose your platform and get building: - -- **[Clouds Overview](/docs/iac/clouds/)** - Explore all supported cloud platforms -- **Multi-cloud by design** - Use the same tools across all platforms -- **Consistent experience** - Same languages, workflows, and tools everywhere - -## Major Cloud Platforms - -Get started building on the major cloud providers: - -- **[Amazon Web Services (AWS)](/docs/iac/clouds/aws/)** - Build on the world's most comprehensive cloud platform -- **[Microsoft Azure](/docs/iac/clouds/azure/)** - Enterprise cloud services and integration -- **[Google Cloud Platform (GCP)](/docs/iac/clouds/gcp/)** - Google's suite of cloud computing services -- **[Kubernetes](/docs/iac/clouds/kubernetes/)** - Container orchestration and cloud-native apps - -## Getting Started by Platform - -Jump right into building with platform-specific guides: - -- **[AWS Quickstart](/docs/iac/get-started/aws/)** - Deploy your first AWS resources -- **[Azure Quickstart](/docs/iac/get-started/azure/)** - Get started on Microsoft Azure -- **[GCP Quickstart](/docs/iac/get-started/gcp/)** - Build on Google Cloud Platform -- **[Kubernetes Quickstart](/docs/iac/get-started/kubernetes/)** - Deploy to Kubernetes clusters - -## Integration Patterns - -Connect your cloud infrastructure with configuration and secrets: - -- **[Infrastructure Integration](/docs/esc/integrations/infrastructure/)** - Connect ESC with cloud resources -- **[Pulumi IaC Integration](/docs/esc/integrations/infrastructure/pulumi-iac/)** - Use ESC with your infrastructure code -- **[Kubernetes Integration](/docs/esc/integrations/kubernetes/)** - Manage Kubernetes secrets and config - -## Multi-Cloud Advantages - -Build infrastructure that spans multiple clouds: - -- **Avoid vendor lock-in** - Use the same tools across all platforms -- **Best of breed** - Choose the best services from each cloud -- **Disaster recovery** - Build resilient multi-cloud architectures -- **Cost optimization** - Optimize costs across different providers - -## Next Steps - -Ready to build on your preferred platform? - -1. **Choose your cloud** - Pick AWS, Azure, GCP, or Kubernetes -2. **Follow the quickstart** - Complete your first deployment -3. **Explore advanced patterns** - Learn platform-specific best practices -4. **Connect configuration** - Set up [Configure & Secure](/docs/build/configure-secure/) workflows diff --git a/content/docs/build/cloud-quickstarts.md b/content/docs/build/cloud-quickstarts.md index 2190a5d399c7..0a38152aba14 100644 --- a/content/docs/build/cloud-quickstarts.md +++ b/content/docs/build/cloud-quickstarts.md @@ -1,12 +1,12 @@ --- title: Cloud Quickstarts h1: Cloud Quickstarts -capability: build +capability: get-started menu: - build: - name: Cloud Quickstarts (AWS, Azure, GCP, K8s) - identifier: build-cloud-quickstarts - parent: build-get-started + get-started: + name: Get Started with Infrastructure as Code + identifier: get-started-cloud-quickstarts + parent: get-started-home weight: 30 meta_desc: Get started building infrastructure on your preferred cloud platform - AWS, Azure, Google Cloud, or Kubernetes quickstart guides. meta_image: /images/docs/meta-images/docs-meta.png diff --git a/content/docs/build/getting-help.md b/content/docs/build/getting-help.md index a084b143ac40..97f1df87be6a 100644 --- a/content/docs/build/getting-help.md +++ b/content/docs/build/getting-help.md @@ -2,12 +2,6 @@ title: Getting Help h1: Getting Help capability: build -menu: - build: - name: Getting Help - identifier: build-getting-help - parent: build-home - weight: 80 meta_desc: Get help with building infrastructure using Pulumi - troubleshooting, FAQ, community support, and technical assistance. meta_image: /images/docs/meta-images/docs-meta.png --- @@ -28,7 +22,7 @@ Get help with common build and deployment issues: - **[Getting Started Problems](/docs/iac/get-started/)** - Common first-time setup issues - **[Configuration Errors](/docs/iac/concepts/config/)** - Fix configuration-related problems -For advanced troubleshooting and debugging tools, see [Developer Tools](/docs/developer-tools/). +For advanced troubleshooting and debugging tools, see [Developer Tools](/docs/pulumi-cli/). ## Community & Support @@ -82,6 +76,6 @@ When asking for help, please include: ## Next Steps - **Ready to build?** Start with [Getting Started](/docs/iac/get-started/) -- **Need advanced tools?** Explore [Developer Tools](/docs/developer-tools/) +- **Need advanced tools?** Explore [Developer Tools](/docs/pulumi-cli/) - **Building with a team?** Check out [Platform capabilities](/docs/platform/) - **Need compliance?** See [Management capabilities](/docs/management/) diff --git a/content/docs/build/getting-started.md b/content/docs/build/getting-started.md index 68cbe3e38f48..2b7822890d97 100644 --- a/content/docs/build/getting-started.md +++ b/content/docs/build/getting-started.md @@ -2,12 +2,6 @@ title: Getting Started h1: Getting Started capability: build -menu: - build: - name: Getting Started - identifier: build-get-started - parent: build-home - weight: 10 meta_desc: Get started building infrastructure with Pulumi - installation, first stack, cloud quickstarts, and environment setup. meta_image: /images/docs/meta-images/docs-meta.png --- diff --git a/content/docs/build/understand-context.md b/content/docs/build/understand-context.md index 17b10bc1ef6a..6b9925c028bd 100644 --- a/content/docs/build/understand-context.md +++ b/content/docs/build/understand-context.md @@ -42,7 +42,7 @@ Learn when and how to adopt Pulumi from other tools: - [Adopting Pulumi](/docs/iac/adopting-pulumi/) - Migration strategy overview - [Import existing resources](/docs/iac/adopting-pulumi/import/) - When and why to import existing infrastructure -- [Migration tools](/docs/developer-tools/) - Technical migration utilities and tools +- [Migration tools](/docs/pulumi-cli/) - Technical migration utilities and tools ## Key Pulumi Advantages diff --git a/content/docs/developer-tools/_index.md b/content/docs/developer-tools/_index.md deleted file mode 100644 index f305bbe88fba..000000000000 --- a/content/docs/developer-tools/_index.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Developer Tools -linktitle: Developer Tools -capability: developer-tools -docs_home: true -notitle: true -menu: - developer-tools: - identifier: developer-tools-home - weight: 1 -expanded_menu_ids: - - developer-tools-cli - - developer-tools-sdks -meta_desc: Technical interfaces and tools for developers. CLIs, SDKs, APIs, and AI-powered development assistance for infrastructure as code. -meta_image: /images/docs/meta-images/docs-meta.png -h1: Developer Tools and Interfaces -description:

    Technical tools and interfaces for developers - command-line tools, programming language SDKs, REST APIs, and AI-powered development assistance.

    -link_buttons: - primary: - label: Install CLI - link: /docs/iac/download-install/ - secondary: - label: Try Pulumi AI - link: /ai/ - -sections: -- type: full-width-cards - heading: Core Developer Tools - cards: - - icon: πŸ’» - heading: Command Line Interface - description: Powerful CLI for managing infrastructure deployments, configurations, and cloud resources. - link: /docs/iac/cli/ - - icon: πŸ”§ - heading: Language SDKs - description: Native SDKs for TypeScript, Python, Go, .NET, Java, and YAML with full IDE support. - link: /docs/iac/languages-sdks/ - - icon: πŸ”Œ - heading: REST APIs - description: Programmatic access to Pulumi Cloud services for custom integrations and automation. - link: /docs/pulumi-cloud/cloud-rest-api/ - - icon: πŸ€– - heading: Pulumi AI - description: AI-powered infrastructure generation, optimization, and intelligent assistance. - link: /ai/ -- type: cards-logo-label-link - heading: Programming Languages - description: Build infrastructure using your favorite programming language. - cards: - - label: TypeScript - icon: icon-32-32 node-color-32-32 - link: /docs/iac/languages-sdks/javascript/ - - label: Python - icon: icon-32-32 python-color-32-32 - link: /docs/iac/languages-sdks/python/ - - label: Go - icon: icon-32-32 go-color-32-32 - link: /docs/iac/languages-sdks/go/ - - label: .NET - icon: icon-32-32 dotnet-color-32-32 - link: /docs/iac/languages-sdks/dotnet/ - - label: Java - icon: icon-32-32 java-color-32-32 - link: /docs/iac/languages-sdks/java/ - - label: YAML - icon: icon-32-32 yaml-color-32-32 - link: /docs/iac/languages-sdks/yaml/ -- type: button-cards - heading: Development Environment - description: Tools and integrations for your development workflow. - cards: - - heading: IDE Extensions - description: "Rich IDE support with IntelliSense, syntax highlighting, and debugging for VS Code, IntelliJ, and more." - link: /docs/iac/languages-sdks/ - primary_button_label: Get Extensions - primary_button_link: /docs/iac/languages-sdks/ - - heading: Automation API - description: "Embed Pulumi directly in your applications with programmatic infrastructure deployment and management." - link: /docs/iac/automation-api/ - primary_button_label: Learn More - primary_button_link: /docs/iac/automation-api/ - - heading: Testing Framework - description: "Unit test and integration test your infrastructure code with familiar testing tools and patterns." - link: /docs/iac/using-pulumi/testing/ - primary_button_label: Start Testing - primary_button_link: /docs/iac/using-pulumi/testing/ -- type: full-width-cards - heading: Command Line Tools - cards: - - icon: pulumi-blue-21-21 - heading: Pulumi CLI - description: Deploy, manage, and operate cloud infrastructure with the main Pulumi command-line tool. - link: /docs/iac/cli/ - - icon: esc-blue-21-21 - heading: ESC CLI - description: Manage environments, secrets, and configuration with the dedicated ESC command-line tool. - link: /docs/esc/cli/ - - icon: convert-blue-21-21 - heading: Conversion Tools - description: Migrate from Terraform, CloudFormation, Kubernetes YAML, and other formats to Pulumi. - link: /docs/iac/adopting-pulumi/migrating-to-pulumi/ - - icon: ai-blue-21-21 - heading: AI-Powered Generation - description: Generate infrastructure code from natural language descriptions using Pulumi AI. - link: /ai/ -- type: full-width-cards - heading: Integration & Automation - cards: - - icon: webhook-blue-21-21 - heading: Webhooks - description: Integrate with external systems through webhooks for deployment notifications and triggers. - link: /docs/pulumi-cloud/webhooks/ - - icon: workflow-blue-21-21 - heading: CI/CD Integration - description: Seamless integration with GitHub Actions, GitLab CI, Azure DevOps, and other CI/CD systems. - link: /docs/iac/using-pulumi/continuous-delivery/ - - icon: script-blue-21-21 - heading: Scripting & Automation - description: Automate infrastructure operations with scripts, policies, and custom workflows. - link: /docs/iac/automation-api/ - - icon: debug-blue-21-21 - heading: Debugging & Troubleshooting - description: Tools and techniques for debugging infrastructure deployments and resolving issues. - link: /docs/iac/support/troubleshooting/ -- type: flat - heading: Ready to start developing? - description:

    Install the CLI, explore the SDKs, or try Pulumi AI. Check out our getting started guide and join us on Slack for support.

    ---- \ No newline at end of file diff --git a/content/docs/esc/cli/_index.md b/content/docs/esc/cli/_index.md index 6dbaa5e4fcad..a306687be35f 100644 --- a/content/docs/esc/cli/_index.md +++ b/content/docs/esc/cli/_index.md @@ -4,17 +4,12 @@ title_tag: Pulumi ESC CLI Overview meta_desc: An overview of the Pulumi ESC (Environments, Secrets, and Configuration) CLI. h1: Pulumi ESC CLI overview no_on_this_page: true -capability: developer-tools +capability: pulumi-cli menu: esc: parent: esc-home identifier: esc-cli-overview weight: 7 - developer-tools: - name: ESC CLI - identifier: developer-tools-esc-cli - parent: developer-tools-home - weight: 15 aliases: - /docs/esc-cli/ --- diff --git a/content/docs/esc/faq.md b/content/docs/esc/faq.md index c3ea69d9d389..5e81477bb8bc 100644 --- a/content/docs/esc/faq.md +++ b/content/docs/esc/faq.md @@ -10,11 +10,6 @@ menu: parent: esc-home weight: 12 identifier: faq - build: - name: ESC FAQ - identifier: build-esc-faq - parent: build-getting-help - weight: 10 aliases: - /docs/pulumi-cloud/esc/faq --- diff --git a/content/docs/esc/get-started/_index.md b/content/docs/esc/get-started/_index.md index 7cb74942196b..35ed5a902e0e 100644 --- a/content/docs/esc/get-started/_index.md +++ b/content/docs/esc/get-started/_index.md @@ -3,7 +3,7 @@ title: Get started title_tag: Get Started with Pulumi ESC (Environments, Secrets, and Configuration) h1: Get Started with Pulumi ESC (Environments, Secrets, and Configuration) meta_desc: Learn how to manage secrets and hierarchical configuration with Pulumi ESC. -capability: build +capability: get-started menu: esc: parent: esc-home @@ -14,6 +14,11 @@ menu: identifier: build-esc-get-started parent: build-configure-secure weight: 70 + get-started: + name: Get Started with Secrets & Configuration + identifier: get-started-esc + parent: get-started-home + weight: 40 aliases: - /docs/pulumi-cloud/esc/get-started/ --- diff --git a/content/docs/esc/get-started/begin.md b/content/docs/esc/get-started/begin.md index d36186f98fd6..24854d1ede68 100644 --- a/content/docs/esc/get-started/begin.md +++ b/content/docs/esc/get-started/begin.md @@ -3,7 +3,7 @@ title_tag: Before You Begin | Pulumi ESC title: Before you begin h1: "Pulumi ESC: Before you begin" meta_desc: This page provides an overview on how to get started with Pulumi ESC. -capability: build +capability: get-started weight: 2 menu: esc: diff --git a/content/docs/esc/get-started/create-environment.md b/content/docs/esc/get-started/create-environment.md index ab6a9196558b..8cdf6e9588c1 100644 --- a/content/docs/esc/get-started/create-environment.md +++ b/content/docs/esc/get-started/create-environment.md @@ -3,7 +3,7 @@ title_tag: Create a New Environment | Pulumi ESC title: Create environment h1: "Pulumi ESC: Create A New Environment" meta_desc: This page provides an overview on how to create a new Pulumi ESC environment. -capability: build +capability: get-started weight: 3 menu: esc: diff --git a/content/docs/esc/get-started/import-environments.md b/content/docs/esc/get-started/import-environments.md index b19e82833c52..cb3ce0d46c73 100644 --- a/content/docs/esc/get-started/import-environments.md +++ b/content/docs/esc/get-started/import-environments.md @@ -3,7 +3,7 @@ title_tag: Import Environments | Pulumi ESC title: Import environments h1: "Pulumi ESC: Import Environments" meta_desc: This page provides an overview on how to import environments in Pulumi ESC. -capability: build +capability: get-started weight: 5 menu: esc: diff --git a/content/docs/esc/get-started/integrate-with-pulumi-iac.md b/content/docs/esc/get-started/integrate-with-pulumi-iac.md index 9fd37738df1f..1c2ca49523a2 100644 --- a/content/docs/esc/get-started/integrate-with-pulumi-iac.md +++ b/content/docs/esc/get-started/integrate-with-pulumi-iac.md @@ -3,7 +3,7 @@ title_tag: Integrate with Pulumi IaC | Pulumi ESC title: Integrate with Pulumi IaC h1: "Pulumi ESC: Integrate with Pulumi IaC" meta_desc: This page provides an overview on how to use Pulumi ESC with Pulumi IaC. -capability: build +capability: get-started weight: 8 menu: esc: diff --git a/content/docs/esc/get-started/retrieve-external-secrets.md b/content/docs/esc/get-started/retrieve-external-secrets.md index ea0c0c69266b..9743d4dc57bd 100644 --- a/content/docs/esc/get-started/retrieve-external-secrets.md +++ b/content/docs/esc/get-started/retrieve-external-secrets.md @@ -3,7 +3,7 @@ title_tag: Retrieve External Secrets | Pulumi ESC title: Retrieve secrets from external sources h1: "Pulumi ESC: Retrieve Secrets from External Sources" meta_desc: This page provides an overview on how to retrieve secrets from external sources. -capability: build +capability: get-started weight: 7 menu: esc: diff --git a/content/docs/esc/get-started/store-and-retrieve-secrets.md b/content/docs/esc/get-started/store-and-retrieve-secrets.md index 2ef240b98048..7112ca130d5c 100644 --- a/content/docs/esc/get-started/store-and-retrieve-secrets.md +++ b/content/docs/esc/get-started/store-and-retrieve-secrets.md @@ -3,7 +3,7 @@ title_tag: Store and Retrieve Secrets | Pulumi ESC title: Store and retrieve secrets h1: "Pulumi ESC: Store and Retrieve Secrets" meta_desc: This page provides an overview on how to store and retrieve secrets in Pulumi ESC. -capability: build +capability: get-started weight: 4 menu: esc: diff --git a/content/docs/esc/get-started/use-short-term-credentials.md b/content/docs/esc/get-started/use-short-term-credentials.md index 85c7d3103d5d..d2f2e617f2d8 100644 --- a/content/docs/esc/get-started/use-short-term-credentials.md +++ b/content/docs/esc/get-started/use-short-term-credentials.md @@ -3,7 +3,7 @@ title_tag: Use Short Term Cloud Credentials | Pulumi ESC title: Use short term cloud credentials h1: "Use Short Term Cloud Credentials to Run Commands Without Local Secrets" meta_desc: This page provides an overview on how to get short term cloud credentials and run commands without using local secrets using the "esc run" command. -capability: build +capability: get-started weight: 6 menu: esc: diff --git a/content/docs/get-started/_index.md b/content/docs/get-started/_index.md new file mode 100644 index 000000000000..477a8d9d9a4c --- /dev/null +++ b/content/docs/get-started/_index.md @@ -0,0 +1,4 @@ +--- +title: Get Started +redirect_to: /docs/iac/get-started/ +--- \ No newline at end of file diff --git a/content/docs/get-started/tutorials.md b/content/docs/get-started/tutorials.md new file mode 100644 index 000000000000..0a29c7114319 --- /dev/null +++ b/content/docs/get-started/tutorials.md @@ -0,0 +1,12 @@ +--- +title: Tutorials +linktitle: Tutorials +meta_desc: Hands-on tutorials to learn Pulumi concepts and cloud infrastructure patterns. +capability: get-started +menu: + get-started: + name: Tutorials + parent: get-started-home + weight: 100 +redirect_to: /tutorials/ +--- \ No newline at end of file diff --git a/content/docs/iac/cli/_index.md b/content/docs/iac/cli/_index.md index bac41878e16c..72fd01c506e6 100644 --- a/content/docs/iac/cli/_index.md +++ b/content/docs/iac/cli/_index.md @@ -1,22 +1,24 @@ --- -title_tag: "Pulumi CLI Overview" -meta_desc: An overview of the Pulumi CLI and common commands used to deploy cloud applications. title: Pulumi CLI -h1: Pulumi CLI overview +linktitle: Pulumi CLI +capability: pulumi-cli +docs_home: true +notitle: true no_on_this_page: true +meta_desc: Pulumi CLI commands for deploying and managing cloud infrastructure. meta_image: /images/docs/meta-images/docs-meta.png -capability: developer-tools +h1: Pulumi CLI +description:

    Command line interface for deploying and managing cloud infrastructure with team collaboration and CI/CD integration.

    menu: iac: name: Pulumi CLI weight: 45 identifier: iac-cli parent: iac-home - developer-tools: + pulumi-cli: name: Pulumi CLI - identifier: developer-tools-cli - parent: developer-tools-home - weight: 10 + identifier: pulumi-cli-home + weight: 1 aliases: - /docs/reference/commands/ - /docs/tour/basics-deploying/ @@ -28,6 +30,8 @@ aliases: - /docs/cli --- +## Overview + Pulumi is controlled primarily using the command line interface (CLI). It works in conjunction with the Pulumi Cloud to deploy changes to your cloud apps and infrastructure. It keeps a history of who updated what in your team and when. This CLI has been designed for great inner loop productivity, in addition to diff --git a/content/docs/iac/cli/command-line-completion.md b/content/docs/iac/cli/command-line-completion.md index 555234d62e3f..ffc026515753 100644 --- a/content/docs/iac/cli/command-line-completion.md +++ b/content/docs/iac/cli/command-line-completion.md @@ -8,6 +8,11 @@ menu: iac: weight: 3 parent: iac-cli + pulumi-cli: + name: Command-line Completion + weight: 30 + parent: pulumi-cli-home + identifier: pulumi-cli-completion aliases: - /docs/cli/command-line-completion/ --- diff --git a/content/docs/iac/cli/commands/_index.md b/content/docs/iac/cli/commands/_index.md index b2e822f582e1..25030f3f4c32 100644 --- a/content/docs/iac/cli/commands/_index.md +++ b/content/docs/iac/cli/commands/_index.md @@ -9,6 +9,11 @@ menu: weight: 1 parent: iac-cli identifier: iac-cli-commands + pulumi-cli: + name: Commands + weight: 10 + parent: pulumi-cli-home + identifier: pulumi-cli-commands --- ## Common Commands diff --git a/content/docs/iac/cli/environment-variables.md b/content/docs/iac/cli/environment-variables.md index 6f5cc07b5678..c0e062bfbf85 100644 --- a/content/docs/iac/cli/environment-variables.md +++ b/content/docs/iac/cli/environment-variables.md @@ -8,6 +8,11 @@ menu: iac: weight: 2 parent: iac-cli + pulumi-cli: + name: Environment Variables + weight: 20 + parent: pulumi-cli-home + identifier: pulumi-cli-environment-variables aliases: - /docs/reference/cli/environment-variables/ - /docs/cli/environment-variables/ diff --git a/content/docs/iac/clouds/_index.md b/content/docs/iac/clouds/_index.md index 81351b016245..063481fb51a9 100644 --- a/content/docs/iac/clouds/_index.md +++ b/content/docs/iac/clouds/_index.md @@ -5,12 +5,14 @@ title: "Clouds" no_on_this_page: true meta_image: /images/docs/meta-images/docs-meta.png capability: build +expanded_menu_ids: + - build-cloud-platforms menu: build: - parent: build-cloud-platforms - name: Cloud Platform Overview - weight: 10 - identifier: build-cloud-platform-overview + parent: build-home + name: Cloud Platforms + weight: 60 + identifier: build-cloud-platforms iac: parent: iac-home name: Clouds @@ -18,6 +20,7 @@ menu: identifier: iac-clouds aliases: - /docs/clouds/ + - /docs/build/cloud-platforms/ --- Pulumi supports AWS, Azure, Google Cloud, Kubernetes, and over 100 other packages. diff --git a/content/docs/iac/clouds/aws/_index.md b/content/docs/iac/clouds/aws/_index.md index 05702aea8fc8..a06db6a4c235 100644 --- a/content/docs/iac/clouds/aws/_index.md +++ b/content/docs/iac/clouds/aws/_index.md @@ -5,6 +5,8 @@ title: "AWS" meta_image: /images/docs/meta-images/docs-clouds-aws-meta-image.png h1: AWS & Pulumi capability: build +expanded_menu_ids: + - build-cloud-platforms menu: iac: name: AWS diff --git a/content/docs/iac/clouds/azure/_index.md b/content/docs/iac/clouds/azure/_index.md index e3da804acd87..7129fcdd12f1 100644 --- a/content/docs/iac/clouds/azure/_index.md +++ b/content/docs/iac/clouds/azure/_index.md @@ -5,6 +5,8 @@ title: "Azure" meta_image: /images/docs/meta-images/docs-clouds-azure-meta-image.png h1: Azure & Pulumi capability: build +expanded_menu_ids: + - build-cloud-platforms menu: iac: name: Azure diff --git a/content/docs/iac/clouds/gcp/_index.md b/content/docs/iac/clouds/gcp/_index.md index da4d8a1c51ac..c8f0baf110bf 100644 --- a/content/docs/iac/clouds/gcp/_index.md +++ b/content/docs/iac/clouds/gcp/_index.md @@ -5,6 +5,8 @@ title: "Google Cloud" meta_image: /images/docs/meta-images/docs-clouds-google-cloud-meta-image.png h1: Google Cloud & Pulumi capability: build +expanded_menu_ids: + - build-cloud-platforms menu: iac: name: Google Cloud diff --git a/content/docs/iac/clouds/kubernetes/_index.md b/content/docs/iac/clouds/kubernetes/_index.md index 6199fc3ad764..08b763654cef 100644 --- a/content/docs/iac/clouds/kubernetes/_index.md +++ b/content/docs/iac/clouds/kubernetes/_index.md @@ -5,6 +5,8 @@ title: "Kubernetes" meta_image: /images/docs/meta-images/docs-clouds-kubernetes-meta-image.png h1: Kubernetes & Pulumi capability: build +expanded_menu_ids: + - build-cloud-platforms menu: iac: name: Kubernetes diff --git a/content/docs/iac/download-install/_index.md b/content/docs/iac/download-install/_index.md index 5a0e803f322f..4cdb94ca8ae3 100644 --- a/content/docs/iac/download-install/_index.md +++ b/content/docs/iac/download-install/_index.md @@ -4,16 +4,16 @@ meta_desc: This page contains detailed instructions for downloading and installi title: "Download & install" h1: Download & install Pulumi meta_image: /images/docs/meta-images/docs-meta.png -capability: build +capability: get-started menu: iac: parent: iac-home weight: 5 identifier: iac-install - build: + get-started: name: Install & Setup - identifier: build-install - parent: build-get-started + identifier: get-started-install + parent: get-started-home weight: 10 install: name: Overview diff --git a/content/docs/iac/get-started/_index.md b/content/docs/iac/get-started/_index.md index 45c9ae1b79be..722ca00a976f 100644 --- a/content/docs/iac/get-started/_index.md +++ b/content/docs/iac/get-started/_index.md @@ -1,22 +1,26 @@ --- +title: Get Started +linktitle: Get Started title_tag: Get Started with Pulumi meta_desc: Step-by-step guides for creating, deploying, and managing infrastructure with Pulumi on the cloud using your favorite language. -title: Get started -h1: Get started with Pulumi -no_on_this_page: true meta_image: /images/docs/meta-images/docs-meta.png -capability: build +h1: Get Started with Pulumi +description:

    Learn how to build, deploy, and manage infrastructure using your favorite programming languages with Pulumi. Choose your cloud provider and programming language to get started.

    +capability: get-started +docs_home: true +notitle: true +no_on_this_page: true +expanded_menu_ids: "get-started-install,get-started-cloud-quickstarts,get-started-aws,get-started-azure,get-started-gcp,get-started-kubernetes" menu: iac: name: Get started identifier: iac-get-started parent: iac-home weight: 10 - build: - name: Your First Stack - identifier: build-your-first-stack - parent: build-get-started - weight: 20 + get-started: + name: Get Started + identifier: get-started-home + weight: 1 getstarted: name: Overview weight: 2 @@ -27,8 +31,12 @@ aliases: - /get-started/ - /docs/tour/ - /docs/get-started + - /docs/getting-started/ + --- +## Overview + Pulumi is a modern [infrastructure as code](/what-is/what-is-infrastructure-as-code/) and [secrets management](/what-is/what-is-secrets-management/) platform that allows you to use familiar programming languages and tools to automate, secure and manage everything you run in the cloud. Pulumi IaC is free, [open source](https://github.com/pulumi/pulumi), and optionally pairs with the [Pulumi Cloud](/docs/pulumi-cloud/) to make managing infrastructure secure, reliable, and hassle-free. @@ -335,7 +343,7 @@ Select one of the following options to get started: Alternatively, you can watch the following video which provides a high level overview of how Pulumi works: -
    +