From 0e0a4aa67a13cc2723fe86e3e832706dbb33d64a Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Tue, 8 Apr 2025 12:25:59 -0400 Subject: [PATCH 1/7] Restructure resource types Signed-off-by: Reshma Abdul Rahim --- docs/content/guides/installation/index.md | 7 +++++++ .../guides/installation/install-tools/_index.md | 7 +++++++ .../install-tools}/bicepconfig/_index.md | 0 .../install-tools}/bicepconfig/overview/index.md | 0 .../bicepconfig/overview/snippets/app.bicep | 0 .../install-tools}/dashboard/_index.md | 0 .../dashboard/overview/dashboard-home.png | Bin .../install-tools}/dashboard/overview/index.md | 0 .../install-tools}/rad-cli/_index.md | 0 .../install-tools}/rad-cli/howto-rad-cli/index.md | 0 .../install-tools}/rad-cli/overview/index.md | 0 .../install-tools}/vscode/_index.md | 0 .../vscode/howto-vscode-bicep/index.md | 0 .../install-tools}/vscode/overview/index.md | 0 .../install-tools}/vscode/overview/vscode-bicep.png | Bin .../providers/_index.md | 0 .../providers/aws-provider/_index.md | 0 .../howto-aws-provider-access-key/index.md | 0 .../howto-aws-provider-irsa/create-role.png | Bin .../howto-aws-provider-irsa/get-role-arn.png | Bin .../aws-provider/howto-aws-provider-irsa/index.md | 0 .../howto-aws-provider-irsa/select-trust-entity.png | Bin .../providers/azure-provider/_index.md | 0 .../azure-provider/howto-azure-provider-sp/index.md | 0 .../azure-provider/howto-azure-provider-wi/index.md | 0 .../snippets/install-radius-azwi.sh | 0 .../providers/overview/index.md | 0 .../providers/overview/provider.svg | 0 .../providers/overview/providers-overview.png | Bin .../guides/installation/setup-kubernetes/_index.md | 7 +++++++ .../setup-kubernetes}/kubernetes-install/index.md | 0 .../setup-kubernetes}/kubernetes-metadata/index.md | 0 .../kubernetes-metadata/snippets/env.bicep | 0 .../setup-kubernetes}/kubernetes-uninstall/index.md | 0 .../setup-kubernetes}/kubernetes-upgrade/index.md | 0 .../setup-kubernetes}/overview/index.md | 0 .../overview/kubernetes-mapping.png | Bin docs/content/guides/operations/kubernetes/_index.md | 7 ------- docs/content/guides/tooling/_index.md | 7 ------- 39 files changed, 21 insertions(+), 14 deletions(-) create mode 100644 docs/content/guides/installation/index.md create mode 100644 docs/content/guides/installation/install-tools/_index.md rename docs/content/guides/{tooling => installation/install-tools}/bicepconfig/_index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/bicepconfig/overview/index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/bicepconfig/overview/snippets/app.bicep (100%) rename docs/content/guides/{tooling => installation/install-tools}/dashboard/_index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/dashboard/overview/dashboard-home.png (100%) rename docs/content/guides/{tooling => installation/install-tools}/dashboard/overview/index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/rad-cli/_index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/rad-cli/howto-rad-cli/index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/rad-cli/overview/index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/vscode/_index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/vscode/howto-vscode-bicep/index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/vscode/overview/index.md (100%) rename docs/content/guides/{tooling => installation/install-tools}/vscode/overview/vscode-bicep.png (100%) rename docs/content/guides/{operations => installation}/providers/_index.md (100%) rename docs/content/guides/{operations => installation}/providers/aws-provider/_index.md (100%) rename docs/content/guides/{operations => installation}/providers/aws-provider/howto-aws-provider-access-key/index.md (100%) rename docs/content/guides/{operations => installation}/providers/aws-provider/howto-aws-provider-irsa/create-role.png (100%) rename docs/content/guides/{operations => installation}/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png (100%) rename docs/content/guides/{operations => installation}/providers/aws-provider/howto-aws-provider-irsa/index.md (100%) rename docs/content/guides/{operations => installation}/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png (100%) rename docs/content/guides/{operations => installation}/providers/azure-provider/_index.md (100%) rename docs/content/guides/{operations => installation}/providers/azure-provider/howto-azure-provider-sp/index.md (100%) rename docs/content/guides/{operations => installation}/providers/azure-provider/howto-azure-provider-wi/index.md (100%) rename docs/content/guides/{operations => installation}/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh (100%) rename docs/content/guides/{operations => installation}/providers/overview/index.md (100%) rename docs/content/guides/{operations => installation}/providers/overview/provider.svg (100%) rename docs/content/guides/{operations => installation}/providers/overview/providers-overview.png (100%) create mode 100644 docs/content/guides/installation/setup-kubernetes/_index.md rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/kubernetes-install/index.md (100%) rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/kubernetes-metadata/index.md (100%) rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/kubernetes-metadata/snippets/env.bicep (100%) rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/kubernetes-uninstall/index.md (100%) rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/kubernetes-upgrade/index.md (100%) rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/overview/index.md (100%) rename docs/content/guides/{operations/kubernetes => installation/setup-kubernetes}/overview/kubernetes-mapping.png (100%) delete mode 100644 docs/content/guides/operations/kubernetes/_index.md delete mode 100644 docs/content/guides/tooling/_index.md diff --git a/docs/content/guides/installation/index.md b/docs/content/guides/installation/index.md new file mode 100644 index 000000000..8cab3cc2c --- /dev/null +++ b/docs/content/guides/installation/index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "" +linkTitle: "Installation" +description: "Learn how Radius can be set up and run on " +weight: 100 +--- \ No newline at end of file diff --git a/docs/content/guides/installation/install-tools/_index.md b/docs/content/guides/installation/install-tools/_index.md new file mode 100644 index 000000000..d6b02d852 --- /dev/null +++ b/docs/content/guides/installation/install-tools/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Radius Install Tooling" +linkTitle: "Install Tools" +description: "Learn about Radius tools for managing your Radius installation and applications" +weight: 100 +--- diff --git a/docs/content/guides/tooling/bicepconfig/_index.md b/docs/content/guides/installation/install-tools/bicepconfig/_index.md similarity index 100% rename from docs/content/guides/tooling/bicepconfig/_index.md rename to docs/content/guides/installation/install-tools/bicepconfig/_index.md diff --git a/docs/content/guides/tooling/bicepconfig/overview/index.md b/docs/content/guides/installation/install-tools/bicepconfig/overview/index.md similarity index 100% rename from docs/content/guides/tooling/bicepconfig/overview/index.md rename to docs/content/guides/installation/install-tools/bicepconfig/overview/index.md diff --git a/docs/content/guides/tooling/bicepconfig/overview/snippets/app.bicep b/docs/content/guides/installation/install-tools/bicepconfig/overview/snippets/app.bicep similarity index 100% rename from docs/content/guides/tooling/bicepconfig/overview/snippets/app.bicep rename to docs/content/guides/installation/install-tools/bicepconfig/overview/snippets/app.bicep diff --git a/docs/content/guides/tooling/dashboard/_index.md b/docs/content/guides/installation/install-tools/dashboard/_index.md similarity index 100% rename from docs/content/guides/tooling/dashboard/_index.md rename to docs/content/guides/installation/install-tools/dashboard/_index.md diff --git a/docs/content/guides/tooling/dashboard/overview/dashboard-home.png b/docs/content/guides/installation/install-tools/dashboard/overview/dashboard-home.png similarity index 100% rename from docs/content/guides/tooling/dashboard/overview/dashboard-home.png rename to docs/content/guides/installation/install-tools/dashboard/overview/dashboard-home.png diff --git a/docs/content/guides/tooling/dashboard/overview/index.md b/docs/content/guides/installation/install-tools/dashboard/overview/index.md similarity index 100% rename from docs/content/guides/tooling/dashboard/overview/index.md rename to docs/content/guides/installation/install-tools/dashboard/overview/index.md diff --git a/docs/content/guides/tooling/rad-cli/_index.md b/docs/content/guides/installation/install-tools/rad-cli/_index.md similarity index 100% rename from docs/content/guides/tooling/rad-cli/_index.md rename to docs/content/guides/installation/install-tools/rad-cli/_index.md diff --git a/docs/content/guides/tooling/rad-cli/howto-rad-cli/index.md b/docs/content/guides/installation/install-tools/rad-cli/howto-rad-cli/index.md similarity index 100% rename from docs/content/guides/tooling/rad-cli/howto-rad-cli/index.md rename to docs/content/guides/installation/install-tools/rad-cli/howto-rad-cli/index.md diff --git a/docs/content/guides/tooling/rad-cli/overview/index.md b/docs/content/guides/installation/install-tools/rad-cli/overview/index.md similarity index 100% rename from docs/content/guides/tooling/rad-cli/overview/index.md rename to docs/content/guides/installation/install-tools/rad-cli/overview/index.md diff --git a/docs/content/guides/tooling/vscode/_index.md b/docs/content/guides/installation/install-tools/vscode/_index.md similarity index 100% rename from docs/content/guides/tooling/vscode/_index.md rename to docs/content/guides/installation/install-tools/vscode/_index.md diff --git a/docs/content/guides/tooling/vscode/howto-vscode-bicep/index.md b/docs/content/guides/installation/install-tools/vscode/howto-vscode-bicep/index.md similarity index 100% rename from docs/content/guides/tooling/vscode/howto-vscode-bicep/index.md rename to docs/content/guides/installation/install-tools/vscode/howto-vscode-bicep/index.md diff --git a/docs/content/guides/tooling/vscode/overview/index.md b/docs/content/guides/installation/install-tools/vscode/overview/index.md similarity index 100% rename from docs/content/guides/tooling/vscode/overview/index.md rename to docs/content/guides/installation/install-tools/vscode/overview/index.md diff --git a/docs/content/guides/tooling/vscode/overview/vscode-bicep.png b/docs/content/guides/installation/install-tools/vscode/overview/vscode-bicep.png similarity index 100% rename from docs/content/guides/tooling/vscode/overview/vscode-bicep.png rename to docs/content/guides/installation/install-tools/vscode/overview/vscode-bicep.png diff --git a/docs/content/guides/operations/providers/_index.md b/docs/content/guides/installation/providers/_index.md similarity index 100% rename from docs/content/guides/operations/providers/_index.md rename to docs/content/guides/installation/providers/_index.md diff --git a/docs/content/guides/operations/providers/aws-provider/_index.md b/docs/content/guides/installation/providers/aws-provider/_index.md similarity index 100% rename from docs/content/guides/operations/providers/aws-provider/_index.md rename to docs/content/guides/installation/providers/aws-provider/_index.md diff --git a/docs/content/guides/operations/providers/aws-provider/howto-aws-provider-access-key/index.md b/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-access-key/index.md similarity index 100% rename from docs/content/guides/operations/providers/aws-provider/howto-aws-provider-access-key/index.md rename to docs/content/guides/installation/providers/aws-provider/howto-aws-provider-access-key/index.md diff --git a/docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/create-role.png b/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/create-role.png similarity index 100% rename from docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/create-role.png rename to docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/create-role.png diff --git a/docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png b/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png similarity index 100% rename from docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png rename to docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png diff --git a/docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/index.md b/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/index.md similarity index 100% rename from docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/index.md rename to docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/index.md diff --git a/docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png b/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png similarity index 100% rename from docs/content/guides/operations/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png rename to docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png diff --git a/docs/content/guides/operations/providers/azure-provider/_index.md b/docs/content/guides/installation/providers/azure-provider/_index.md similarity index 100% rename from docs/content/guides/operations/providers/azure-provider/_index.md rename to docs/content/guides/installation/providers/azure-provider/_index.md diff --git a/docs/content/guides/operations/providers/azure-provider/howto-azure-provider-sp/index.md b/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-sp/index.md similarity index 100% rename from docs/content/guides/operations/providers/azure-provider/howto-azure-provider-sp/index.md rename to docs/content/guides/installation/providers/azure-provider/howto-azure-provider-sp/index.md diff --git a/docs/content/guides/operations/providers/azure-provider/howto-azure-provider-wi/index.md b/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/index.md similarity index 100% rename from docs/content/guides/operations/providers/azure-provider/howto-azure-provider-wi/index.md rename to docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/index.md diff --git a/docs/content/guides/operations/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh b/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh similarity index 100% rename from docs/content/guides/operations/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh rename to docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh diff --git a/docs/content/guides/operations/providers/overview/index.md b/docs/content/guides/installation/providers/overview/index.md similarity index 100% rename from docs/content/guides/operations/providers/overview/index.md rename to docs/content/guides/installation/providers/overview/index.md diff --git a/docs/content/guides/operations/providers/overview/provider.svg b/docs/content/guides/installation/providers/overview/provider.svg similarity index 100% rename from docs/content/guides/operations/providers/overview/provider.svg rename to docs/content/guides/installation/providers/overview/provider.svg diff --git a/docs/content/guides/operations/providers/overview/providers-overview.png b/docs/content/guides/installation/providers/overview/providers-overview.png similarity index 100% rename from docs/content/guides/operations/providers/overview/providers-overview.png rename to docs/content/guides/installation/providers/overview/providers-overview.png diff --git a/docs/content/guides/installation/setup-kubernetes/_index.md b/docs/content/guides/installation/setup-kubernetes/_index.md new file mode 100644 index 000000000..6406f675e --- /dev/null +++ b/docs/content/guides/installation/setup-kubernetes/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "" +linkTitle: "Setup Kubernetes" +description: "Learn how Radius can be set up and run on Kubernetes" +weight: 200 +--- diff --git a/docs/content/guides/operations/kubernetes/kubernetes-install/index.md b/docs/content/guides/installation/setup-kubernetes/kubernetes-install/index.md similarity index 100% rename from docs/content/guides/operations/kubernetes/kubernetes-install/index.md rename to docs/content/guides/installation/setup-kubernetes/kubernetes-install/index.md diff --git a/docs/content/guides/operations/kubernetes/kubernetes-metadata/index.md b/docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/index.md similarity index 100% rename from docs/content/guides/operations/kubernetes/kubernetes-metadata/index.md rename to docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/index.md diff --git a/docs/content/guides/operations/kubernetes/kubernetes-metadata/snippets/env.bicep b/docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/snippets/env.bicep similarity index 100% rename from docs/content/guides/operations/kubernetes/kubernetes-metadata/snippets/env.bicep rename to docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/snippets/env.bicep diff --git a/docs/content/guides/operations/kubernetes/kubernetes-uninstall/index.md b/docs/content/guides/installation/setup-kubernetes/kubernetes-uninstall/index.md similarity index 100% rename from docs/content/guides/operations/kubernetes/kubernetes-uninstall/index.md rename to docs/content/guides/installation/setup-kubernetes/kubernetes-uninstall/index.md diff --git a/docs/content/guides/operations/kubernetes/kubernetes-upgrade/index.md b/docs/content/guides/installation/setup-kubernetes/kubernetes-upgrade/index.md similarity index 100% rename from docs/content/guides/operations/kubernetes/kubernetes-upgrade/index.md rename to docs/content/guides/installation/setup-kubernetes/kubernetes-upgrade/index.md diff --git a/docs/content/guides/operations/kubernetes/overview/index.md b/docs/content/guides/installation/setup-kubernetes/overview/index.md similarity index 100% rename from docs/content/guides/operations/kubernetes/overview/index.md rename to docs/content/guides/installation/setup-kubernetes/overview/index.md diff --git a/docs/content/guides/operations/kubernetes/overview/kubernetes-mapping.png b/docs/content/guides/installation/setup-kubernetes/overview/kubernetes-mapping.png similarity index 100% rename from docs/content/guides/operations/kubernetes/overview/kubernetes-mapping.png rename to docs/content/guides/installation/setup-kubernetes/overview/kubernetes-mapping.png diff --git a/docs/content/guides/operations/kubernetes/_index.md b/docs/content/guides/operations/kubernetes/_index.md deleted file mode 100644 index 7853afc35..000000000 --- a/docs/content/guides/operations/kubernetes/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Kubernetes platform" -linkTitle: "Kubernetes" -description: "Learn how Radius can run on Kubernetes" -weight: 10 ---- diff --git a/docs/content/guides/tooling/_index.md b/docs/content/guides/tooling/_index.md deleted file mode 100644 index 82a0e9efd..000000000 --- a/docs/content/guides/tooling/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Radius Tooling" -linkTitle: "Tooling" -description: "Learn about Radius tools for managing your applications and Radius installation" -weight: 99 ---- From 32c28e08cd83f436bcdc9492fc56364390de74e4 Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Thu, 10 Apr 2025 08:48:26 -0400 Subject: [PATCH 2/7] Restructure folders Signed-off-by: Reshma Abdul Rahim --- docs/content/getting-started/index.md | 6 +++--- .../author-apps/application/overview/index.md | 4 ++-- .../author-apps/aws/howto-aws-resources/index.md | 2 +- .../azure/howto-azure-resources/index.md | 4 ++-- .../guides/author-apps/azure/overview/index.md | 2 +- .../containers/howto-keyvault-volume/index.md | 4 ++-- .../guides/author-apps/containers/overview/index.md | 2 +- .../author-apps/dapr/how-to-dapr-sidecar/index.md | 2 +- .../environments/howto-environment/index.md | 4 ++-- .../guides/deploy-apps/gitops/howto-flux/index.md | 2 +- .../howto-deploy/howto-deploy-cicd/index.md | 4 ++-- .../{installation => }/install-tools/_index.md | 0 .../install-tools/bicepconfig/_index.md | 0 .../install-tools/bicepconfig/overview/index.md | 0 .../bicepconfig/overview/snippets/app.bicep | 0 .../install-tools/dashboard/_index.md | 0 .../dashboard/overview/dashboard-home.png | Bin .../install-tools/dashboard/overview/index.md | 2 +- .../install-tools/rad-cli/_index.md | 0 .../install-tools/rad-cli/howto-rad-cli/index.md | 0 .../install-tools/rad-cli/overview/index.md | 0 .../install-tools/vscode/_index.md | 0 .../vscode/howto-vscode-bicep/index.md | 0 .../install-tools/vscode/overview/index.md | 0 .../install-tools/vscode/overview/vscode-bicep.png | Bin docs/content/guides/installation/index.md | 7 ------- .../operations/control-plane/logs/fluentd/index.md | 4 ++-- .../control-plane/metrics/prometheus/index.md | 2 +- .../operations/groups/howto-resourcegroups/index.md | 2 +- .../kubernetes-metadata/index.md | 2 +- .../kubernetes-metadata/snippets/env.bicep | 0 .../operations/workspaces/howto-workspaces/index.md | 2 +- .../guides/recipes/howto-dev-recipes/index.md | 4 ++-- .../setup-cloud-providers}/_index.md | 0 .../setup-cloud-providers}/aws-provider/_index.md | 0 .../howto-aws-provider-access-key/index.md | 0 .../howto-aws-provider-irsa/create-role.png | Bin .../howto-aws-provider-irsa/get-role-arn.png | Bin .../aws-provider/howto-aws-provider-irsa/index.md | 2 +- .../howto-aws-provider-irsa/select-trust-entity.png | Bin .../setup-cloud-providers}/azure-provider/_index.md | 0 .../azure-provider/howto-azure-provider-sp/index.md | 0 .../azure-provider/howto-azure-provider-wi/index.md | 2 +- .../snippets/install-radius-azwi.sh | 0 .../setup-cloud-providers}/overview/index.md | 0 .../setup-cloud-providers}/overview/provider.svg | 0 .../overview/providers-overview.png | Bin .../setup-kubernetes/_index.md | 0 .../setup-kubernetes/kubernetes-install/index.md | 2 +- .../setup-kubernetes/kubernetes-uninstall/index.md | 4 ++-- .../setup-kubernetes/kubernetes-upgrade/index.md | 0 .../setup-kubernetes/overview/index.md | 0 .../overview/kubernetes-mapping.png | Bin .../content/reference/cli/rad_install_kubernetes.md | 2 +- .../core-schema/application-schema/index.md | 4 ++-- .../core-schema/container-schema/index.md | 2 +- .../core-schema/environment-schema/index.md | 2 +- docs/content/tutorials/helm/index.md | 2 +- docs/content/tutorials/new-app/index.md | 6 +++--- docs/content/tutorials/tutorial-add-radius/index.md | 2 +- docs/content/tutorials/tutorial-dapr/index.md | 2 +- docs/content/tutorials/tutorial-recipe/index.md | 2 +- .../install-radius/initialize-radius.md | 2 +- 63 files changed, 45 insertions(+), 52 deletions(-) rename docs/content/guides/{installation => }/install-tools/_index.md (100%) rename docs/content/guides/{installation => }/install-tools/bicepconfig/_index.md (100%) rename docs/content/guides/{installation => }/install-tools/bicepconfig/overview/index.md (100%) rename docs/content/guides/{installation => }/install-tools/bicepconfig/overview/snippets/app.bicep (100%) rename docs/content/guides/{installation => }/install-tools/dashboard/_index.md (100%) rename docs/content/guides/{installation => }/install-tools/dashboard/overview/dashboard-home.png (100%) rename docs/content/guides/{installation => }/install-tools/dashboard/overview/index.md (97%) rename docs/content/guides/{installation => }/install-tools/rad-cli/_index.md (100%) rename docs/content/guides/{installation => }/install-tools/rad-cli/howto-rad-cli/index.md (100%) rename docs/content/guides/{installation => }/install-tools/rad-cli/overview/index.md (100%) rename docs/content/guides/{installation => }/install-tools/vscode/_index.md (100%) rename docs/content/guides/{installation => }/install-tools/vscode/howto-vscode-bicep/index.md (100%) rename docs/content/guides/{installation => }/install-tools/vscode/overview/index.md (100%) rename docs/content/guides/{installation => }/install-tools/vscode/overview/vscode-bicep.png (100%) delete mode 100644 docs/content/guides/installation/index.md rename docs/content/guides/{installation/setup-kubernetes => operations}/kubernetes-metadata/index.md (97%) rename docs/content/guides/{installation/setup-kubernetes => operations}/kubernetes-metadata/snippets/env.bicep (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/_index.md (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/aws-provider/_index.md (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/aws-provider/howto-aws-provider-access-key/index.md (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/aws-provider/howto-aws-provider-irsa/create-role.png (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/aws-provider/howto-aws-provider-irsa/get-role-arn.png (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/aws-provider/howto-aws-provider-irsa/index.md (97%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/aws-provider/howto-aws-provider-irsa/select-trust-entity.png (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/azure-provider/_index.md (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/azure-provider/howto-azure-provider-sp/index.md (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/azure-provider/howto-azure-provider-wi/index.md (97%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/overview/index.md (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/overview/provider.svg (100%) rename docs/content/guides/{installation/providers => setup-platform/setup-cloud-providers}/overview/providers-overview.png (100%) rename docs/content/guides/{installation => setup-platform}/setup-kubernetes/_index.md (100%) rename docs/content/guides/{installation => setup-platform}/setup-kubernetes/kubernetes-install/index.md (96%) rename docs/content/guides/{installation => setup-platform}/setup-kubernetes/kubernetes-uninstall/index.md (82%) rename docs/content/guides/{installation => setup-platform}/setup-kubernetes/kubernetes-upgrade/index.md (100%) rename docs/content/guides/{installation => setup-platform}/setup-kubernetes/overview/index.md (100%) rename docs/content/guides/{installation => setup-platform}/setup-kubernetes/overview/kubernetes-mapping.png (100%) diff --git a/docs/content/getting-started/index.md b/docs/content/getting-started/index.md index 3a57de544..d9033b381 100644 --- a/docs/content/getting-started/index.md +++ b/docs/content/getting-started/index.md @@ -25,8 +25,8 @@ The Radius getting-started guide can be [run **for free** in a GitHub Codespace] ## 1. Have your Kubernetes cluster handy -Radius runs inside [Kubernetes]({{< ref "guides/operations/kubernetes" >}}). However you run Kubernetes, get a cluster ready. -> *If you don't have a preferred way to create Kubernetes clusters, you could try using [k3d](https://k3d.io/), which runs a minimal Kubernetes distribution in Docker. Make sure to apply the [recommended configuration]({{< ref "guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}).* +Radius runs inside [Kubernetes]({{< ref "guides/setup-platform/setup-kubernetes/overview" >}}). However you run Kubernetes, get a cluster ready. +> *If you don't have a preferred way to create Kubernetes clusters, you could try using [k3d](https://k3d.io/), which runs a minimal Kubernetes distribution in Docker. Make sure to apply the [recommended configuration]({{< ref "guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}).* Ensure your cluster is set as your current context: @@ -70,7 +70,7 @@ Initializing Radius... Initialization complete! Have a RAD time 😎 ``` -In addition to starting Radius services in your Kubernetes cluster, this initialization command creates a default application (`app.bicep`) as your starting point. It contains a single container definition (`demo`). `rad init` also creates a [`bicepconfig.json`]({{< ref "/guides/tooling/bicepconfig/overview" >}}) file in your application's directory that has the necessary setup to use Radius with the official Bicep compiler. +In addition to starting Radius services in your Kubernetes cluster, this initialization command creates a default application (`app.bicep`) as your starting point. It contains a single container definition (`demo`). `rad init` also creates a [`bicepconfig.json`]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) file in your application's directory that has the necessary setup to use Radius with the official Bicep compiler. {{< rad file="snippets/app.bicep" embed=true markdownConfig="{linenos=table,linenostart=1}" >}} diff --git a/docs/content/guides/author-apps/application/overview/index.md b/docs/content/guides/author-apps/application/overview/index.md index 964985fe0..ad69836c8 100644 --- a/docs/content/guides/author-apps/application/overview/index.md +++ b/docs/content/guides/author-apps/application/overview/index.md @@ -26,11 +26,11 @@ Extensions allow you to customize how resources are generated or customized as p ### Kubernetes Namespace extension -The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/operations/kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior +The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior ### Kubernetes Metadata extension -The [Kubernetes Metadata extension]({{< ref "guides/operations/kubernetes/kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. ## Query and understand your application with the Radius Application Graph diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/index.md b/docs/content/guides/author-apps/aws/howto-aws-resources/index.md index eb060e669..0dac88332 100644 --- a/docs/content/guides/author-apps/aws/howto-aws-resources/index.md +++ b/docs/content/guides/author-apps/aws/howto-aws-resources/index.md @@ -58,7 +58,7 @@ Select 'No' when asked to setup application in the current directory. {{< read file= "/shared-content/installation/bicepconfig/manual.md" >}} -More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/tooling/bicepconfig/overview" >}}) +More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) ## Step 4: Create a Bicep file to model AWS Simple Storage Service (S3) diff --git a/docs/content/guides/author-apps/azure/howto-azure-resources/index.md b/docs/content/guides/author-apps/azure/howto-azure-resources/index.md index 5f9b6b134..9a7aa49df 100644 --- a/docs/content/guides/author-apps/azure/howto-azure-resources/index.md +++ b/docs/content/guides/author-apps/azure/howto-azure-resources/index.md @@ -21,7 +21,7 @@ The steps below will showcase a "rad-ified" version of the existing [Azure AD wo - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - [Azure AD Workload Identity](https://azure.github.io/azure-workload-identity/docs/installation.html) installed in your cluster, including the [Mutating Admission Webhook](https://azure.github.io/azure-workload-identity/docs/installation/mutating-admission-webhook.html) ## Step 1: Initialize Radius @@ -38,7 +38,7 @@ Select 'No' when asked to setup application in the current directory. {{< read file= "/shared-content/installation/bicepconfig/manual.md" >}} -More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/tooling/bicepconfig/overview" >}}) +More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) ## Step 3: Define a Radius Environment diff --git a/docs/content/guides/author-apps/azure/overview/index.md b/docs/content/guides/author-apps/azure/overview/index.md index ae03c5306..00374cb1d 100644 --- a/docs/content/guides/author-apps/azure/overview/index.md +++ b/docs/content/guides/author-apps/azure/overview/index.md @@ -12,7 +12,7 @@ Radius Applications are able to connect to and leverage every Azure resource wit ## Configure an Azure Provider -The Azure provider allows you to deploy and connect to Azure resources from a Radius Environment on any of the [supported clusters]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}). To configure an Azure provider, you can follow the documentation [here]({{< ref "/guides/operations/providers/azure-provider" >}}). +The Azure provider allows you to deploy and connect to Azure resources from a Radius Environment on any of the [supported clusters]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}). To configure an Azure provider, you can follow the documentation [here]({{< ref "/guides/operations/providers/azure-provider" >}}). ## Resource library diff --git a/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md b/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md index f722d4c2e..698b476ee 100644 --- a/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md +++ b/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md @@ -20,7 +20,7 @@ This how-to guide will provide an overview of how to: - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Supported Kubernetes cluster]({{< ref "guides/operations/kubernetes" >}}) +- [Supported Kubernetes cluster]({{< ref "guides/setup-platform/kubernetes/overview" >}}) - [Azure AD Workload Identity](https://azure.github.io/azure-workload-identity/docs/installation.html) installed on your cluster - [Azure Keyvault Provider](https://azure.github.io/secrets-store-csi-driver-provider-azure/docs/getting-started/installation/) - The above installation will also install the required [Secrets Store CSI Driver](https://secrets-store-csi-driver.sigs.k8s.io/getting-started/installation.html) @@ -39,7 +39,7 @@ Select 'No' when asked to setup application in the current directory. {{< read file= "/shared-content/installation/bicepconfig/manual.md" >}} -More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/tooling/bicepconfig/overview" >}}) +More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) ## Step 3: Define a Radius Environment diff --git a/docs/content/guides/author-apps/containers/overview/index.md b/docs/content/guides/author-apps/containers/overview/index.md index a1d10f08a..841e22674 100644 --- a/docs/content/guides/author-apps/containers/overview/index.md +++ b/docs/content/guides/author-apps/containers/overview/index.md @@ -20,7 +20,7 @@ Radius containers are portable across container runtimes, allowing you to define ### Kubernetes -Containers are deployed to the same Kubernetes cluster as your Radius installation, into the namespace that is defined in your application. For more information on how Radius resources map to Kubernetes objects, refer to the [Kubernetes mapping guide]({{< ref "/guides/operations/kubernetes/overview#resource-mapping" >}}). +Containers are deployed to the same Kubernetes cluster as your Radius installation, into the namespace that is defined in your application. For more information on how Radius resources map to Kubernetes objects, refer to the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}). #### Customize Kubernetes configurations diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md b/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md index 92413b895..fd3cb78fa 100644 --- a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md +++ b/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md @@ -14,7 +14,7 @@ This how-to guide will provide an overview of how to: ## Prerequisites -- [Supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}) - [rad CLI]({{< ref getting-started >}}) - [Dapr CLI](https://docs.dapr.io/getting-started/install-dapr-cli/) - [Radius initialized with `rad init`]({{< ref howto-environment >}}) diff --git a/docs/content/guides/deploy-apps/environments/howto-environment/index.md b/docs/content/guides/deploy-apps/environments/howto-environment/index.md index f4abd50d0..189fcc43a 100644 --- a/docs/content/guides/deploy-apps/environments/howto-environment/index.md +++ b/docs/content/guides/deploy-apps/environments/howto-environment/index.md @@ -14,7 +14,7 @@ Radius Environments can be setup with the rad CLI via two paths: interactive or ## Pre-requisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) @@ -25,7 +25,7 @@ Radius Environments can be setup with the rad CLI via two paths: interactive or rad init ``` - Select `Yes` to setup the application in the current directory. This will create `app.bicep` and [`bicepconfig.json`]({{< ref "/guides/tooling/bicepconfig/overview" >}}) files + Select `Yes` to setup the application in the current directory. This will create `app.bicep` and [`bicepconfig.json`]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) files ``` Initializing Radius... diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/index.md b/docs/content/guides/deploy-apps/gitops/howto-flux/index.md index e791fd110..4560e0067 100644 --- a/docs/content/guides/deploy-apps/gitops/howto-flux/index.md +++ b/docs/content/guides/deploy-apps/gitops/howto-flux/index.md @@ -16,7 +16,7 @@ This guide will provide an overview of how to: ## Prerequisites -- [Supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Radius environment]({{< ref "installation#step-3-initialize-radius" >}}) - A remote Git repository (e.g., GitHub, GitLab, etc.) to store your application files diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md index 3a23e29d9..282459e9c 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md +++ b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md @@ -12,7 +12,7 @@ It's easy to get Radius added to your GitHub Actions deployment pipelines. By le ## Prerequisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - Radius control plane [installed in your cluster]({{< ref kubernetes-install >}}) - GitHub repo with Actions enabled @@ -28,7 +28,7 @@ Make sure you have the following files checked into your repository under `iac/` {{< rad file="snippets/app.bicep" embed="true" >}} -### [`bicepconfig.json`]({{< ref "/guides/tooling/bicepconfig/overview" >}}) +### [`bicepconfig.json`]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) ```json { diff --git a/docs/content/guides/installation/install-tools/_index.md b/docs/content/guides/install-tools/_index.md similarity index 100% rename from docs/content/guides/installation/install-tools/_index.md rename to docs/content/guides/install-tools/_index.md diff --git a/docs/content/guides/installation/install-tools/bicepconfig/_index.md b/docs/content/guides/install-tools/bicepconfig/_index.md similarity index 100% rename from docs/content/guides/installation/install-tools/bicepconfig/_index.md rename to docs/content/guides/install-tools/bicepconfig/_index.md diff --git a/docs/content/guides/installation/install-tools/bicepconfig/overview/index.md b/docs/content/guides/install-tools/bicepconfig/overview/index.md similarity index 100% rename from docs/content/guides/installation/install-tools/bicepconfig/overview/index.md rename to docs/content/guides/install-tools/bicepconfig/overview/index.md diff --git a/docs/content/guides/installation/install-tools/bicepconfig/overview/snippets/app.bicep b/docs/content/guides/install-tools/bicepconfig/overview/snippets/app.bicep similarity index 100% rename from docs/content/guides/installation/install-tools/bicepconfig/overview/snippets/app.bicep rename to docs/content/guides/install-tools/bicepconfig/overview/snippets/app.bicep diff --git a/docs/content/guides/installation/install-tools/dashboard/_index.md b/docs/content/guides/install-tools/dashboard/_index.md similarity index 100% rename from docs/content/guides/installation/install-tools/dashboard/_index.md rename to docs/content/guides/install-tools/dashboard/_index.md diff --git a/docs/content/guides/installation/install-tools/dashboard/overview/dashboard-home.png b/docs/content/guides/install-tools/dashboard/overview/dashboard-home.png similarity index 100% rename from docs/content/guides/installation/install-tools/dashboard/overview/dashboard-home.png rename to docs/content/guides/install-tools/dashboard/overview/dashboard-home.png diff --git a/docs/content/guides/installation/install-tools/dashboard/overview/index.md b/docs/content/guides/install-tools/dashboard/overview/index.md similarity index 97% rename from docs/content/guides/installation/install-tools/dashboard/overview/index.md rename to docs/content/guides/install-tools/dashboard/overview/index.md index 81af91282..f16023a18 100644 --- a/docs/content/guides/installation/install-tools/dashboard/overview/index.md +++ b/docs/content/guides/install-tools/dashboard/overview/index.md @@ -31,7 +31,7 @@ The Radius Dashboard currently provides the following features: The Radius Dashboard is installed by default as a part of your Radius initialization and deployment. {{< alert title="Opting-out" color="warning" >}} -To opt-out of installing the dashboard, you can use the `--set dashboard.enabled=false` flag when running `rad init` or `rad install kubernetes`. See more instructions in the Radius [initialization]({{< ref "installation#step-3-initialize-radius" >}}) and [installation]({{< ref "guides/operations/kubernetes/kubernetes-install" >}}) guides. +To opt-out of installing the dashboard, you can use the `--set dashboard.enabled=false` flag when running `rad init` or `rad install kubernetes`. See more instructions in the Radius [initialization]({{< ref "installation#step-3-initialize-radius" >}}) and [installation]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-install" >}}) guides. {{< /alert >}} To remove the dashboard from your existing installation of Radius on your cluster, you can run: diff --git a/docs/content/guides/installation/install-tools/rad-cli/_index.md b/docs/content/guides/install-tools/rad-cli/_index.md similarity index 100% rename from docs/content/guides/installation/install-tools/rad-cli/_index.md rename to docs/content/guides/install-tools/rad-cli/_index.md diff --git a/docs/content/guides/installation/install-tools/rad-cli/howto-rad-cli/index.md b/docs/content/guides/install-tools/rad-cli/howto-rad-cli/index.md similarity index 100% rename from docs/content/guides/installation/install-tools/rad-cli/howto-rad-cli/index.md rename to docs/content/guides/install-tools/rad-cli/howto-rad-cli/index.md diff --git a/docs/content/guides/installation/install-tools/rad-cli/overview/index.md b/docs/content/guides/install-tools/rad-cli/overview/index.md similarity index 100% rename from docs/content/guides/installation/install-tools/rad-cli/overview/index.md rename to docs/content/guides/install-tools/rad-cli/overview/index.md diff --git a/docs/content/guides/installation/install-tools/vscode/_index.md b/docs/content/guides/install-tools/vscode/_index.md similarity index 100% rename from docs/content/guides/installation/install-tools/vscode/_index.md rename to docs/content/guides/install-tools/vscode/_index.md diff --git a/docs/content/guides/installation/install-tools/vscode/howto-vscode-bicep/index.md b/docs/content/guides/install-tools/vscode/howto-vscode-bicep/index.md similarity index 100% rename from docs/content/guides/installation/install-tools/vscode/howto-vscode-bicep/index.md rename to docs/content/guides/install-tools/vscode/howto-vscode-bicep/index.md diff --git a/docs/content/guides/installation/install-tools/vscode/overview/index.md b/docs/content/guides/install-tools/vscode/overview/index.md similarity index 100% rename from docs/content/guides/installation/install-tools/vscode/overview/index.md rename to docs/content/guides/install-tools/vscode/overview/index.md diff --git a/docs/content/guides/installation/install-tools/vscode/overview/vscode-bicep.png b/docs/content/guides/install-tools/vscode/overview/vscode-bicep.png similarity index 100% rename from docs/content/guides/installation/install-tools/vscode/overview/vscode-bicep.png rename to docs/content/guides/install-tools/vscode/overview/vscode-bicep.png diff --git a/docs/content/guides/installation/index.md b/docs/content/guides/installation/index.md deleted file mode 100644 index 8cab3cc2c..000000000 --- a/docs/content/guides/installation/index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "" -linkTitle: "Installation" -description: "Learn how Radius can be set up and run on " -weight: 100 ---- \ No newline at end of file diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/index.md b/docs/content/guides/operations/control-plane/logs/fluentd/index.md index e6ac7453c..967069b5b 100644 --- a/docs/content/guides/operations/control-plane/logs/fluentd/index.md +++ b/docs/content/guides/operations/control-plane/logs/fluentd/index.md @@ -10,7 +10,7 @@ tags: ["logs","observability"] ## Prerequisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/) - [Helm 3](https://helm.sh/) @@ -98,7 +98,7 @@ tags: ["logs","observability"] ## Install Radius control plane -Visit the [Kubernetes docs]({{< ref "guides/operations/kubernetes" >}}) to learn how to install the Radius control plane. By default, Radius has JSON logging enabled. +Visit the [Kubernetes docs]({{< ref "guides/setup-platform/kubernetes/overview" >}}) to learn how to install the Radius control plane. By default, Radius has JSON logging enabled. For Kubernetes, you can install with the rad CLI: diff --git a/docs/content/guides/operations/control-plane/metrics/prometheus/index.md b/docs/content/guides/operations/control-plane/metrics/prometheus/index.md index 809f65469..bbef67083 100644 --- a/docs/content/guides/operations/control-plane/metrics/prometheus/index.md +++ b/docs/content/guides/operations/control-plane/metrics/prometheus/index.md @@ -14,7 +14,7 @@ tags: ["metrics", "observability"] 1. Make sure you have the following pre-requisites: - - [Supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) + - [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/) - [Helm 3](https://helm.sh/) - [Radius control plane installed]({{< ref kubernetes-install >}}) diff --git a/docs/content/guides/operations/groups/howto-resourcegroups/index.md b/docs/content/guides/operations/groups/howto-resourcegroups/index.md index 7ff18769e..e0e4656f7 100644 --- a/docs/content/guides/operations/groups/howto-resourcegroups/index.md +++ b/docs/content/guides/operations/groups/howto-resourcegroups/index.md @@ -11,7 +11,7 @@ This guide will walk you through the process of managing resource groups in Radi ## Pre-requisites -- [Supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) ## Step 1: Ensure Radius is installed diff --git a/docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/index.md b/docs/content/guides/operations/kubernetes-metadata/index.md similarity index 97% rename from docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/index.md rename to docs/content/guides/operations/kubernetes-metadata/index.md index 226939407..76652dc7a 100644 --- a/docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/index.md +++ b/docs/content/guides/operations/kubernetes-metadata/index.md @@ -38,7 +38,7 @@ You can set labels and annotations on an environment, application, or container ## Cascading metadata -Kubernetes metadata can be applied at the environment, application, or container layers. Metadata cascades down from the environment to the application to the containers, gateway and route resources. For example, you can set labels and annotations at an environment level and all containers within the environment will gain these labels and annotation, without the need for an explicit extension on the containers. The following resources will gain the Kubernetes metadata for their [output resources]({{< ref "/guides/operations/kubernetes/overview#resource-mapping" >}}) from labels, annotations set at Environment, Application levels: +Kubernetes metadata can be applied at the environment, application, or container layers. Metadata cascades down from the environment to the application to the containers, gateway and route resources. For example, you can set labels and annotations at an environment level and all containers within the environment will gain these labels and annotation, without the need for an explicit extension on the containers. The following resources will gain the Kubernetes metadata for their [output resources]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) from labels, annotations set at Environment, Application levels: - Applications.Core/containers - Applications.Core/gateways diff --git a/docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/snippets/env.bicep b/docs/content/guides/operations/kubernetes-metadata/snippets/env.bicep similarity index 100% rename from docs/content/guides/installation/setup-kubernetes/kubernetes-metadata/snippets/env.bicep rename to docs/content/guides/operations/kubernetes-metadata/snippets/env.bicep diff --git a/docs/content/guides/operations/workspaces/howto-workspaces/index.md b/docs/content/guides/operations/workspaces/howto-workspaces/index.md index 6640b511b..99bb9a6d4 100644 --- a/docs/content/guides/operations/workspaces/howto-workspaces/index.md +++ b/docs/content/guides/operations/workspaces/howto-workspaces/index.md @@ -9,7 +9,7 @@ categories: "How-To" ## Pre-requisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) ## How-to: Use workspaces to switch between environments diff --git a/docs/content/guides/recipes/howto-dev-recipes/index.md b/docs/content/guides/recipes/howto-dev-recipes/index.md index 50217dd6e..93af6df43 100644 --- a/docs/content/guides/recipes/howto-dev-recipes/index.md +++ b/docs/content/guides/recipes/howto-dev-recipes/index.md @@ -14,7 +14,7 @@ Local development environments created by the rad init command include a set of - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) ## Step 1: Initialize a Radius environment @@ -59,7 +59,7 @@ Local development environments created by the rad init command include a set of {{< read file= "/shared-content/installation/bicepconfig/manual.md" >}} -More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/tooling/bicepconfig/overview" >}}) +More information on how to setup a `bicepconfig.json` can be found [here]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) ## Step 3: Define your application diff --git a/docs/content/guides/installation/providers/_index.md b/docs/content/guides/setup-platform/setup-cloud-providers/_index.md similarity index 100% rename from docs/content/guides/installation/providers/_index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/_index.md diff --git a/docs/content/guides/installation/providers/aws-provider/_index.md b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/_index.md similarity index 100% rename from docs/content/guides/installation/providers/aws-provider/_index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/_index.md diff --git a/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-access-key/index.md b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-access-key/index.md similarity index 100% rename from docs/content/guides/installation/providers/aws-provider/howto-aws-provider-access-key/index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-access-key/index.md diff --git a/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/create-role.png b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/create-role.png similarity index 100% rename from docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/create-role.png rename to docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/create-role.png diff --git a/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png similarity index 100% rename from docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png rename to docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png diff --git a/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/index.md b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/index.md similarity index 97% rename from docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/index.md index 8e0728616..7dd172034 100644 --- a/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/index.md +++ b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/index.md @@ -18,7 +18,7 @@ The AWS provider allows you to deploy and connect to AWS resources from a Radius - [AWS account](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account) and an [IAM user](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) - [Setup AWS CLI with your AWS credentials. ](https://docs.aws.amazon.com/cli/latest/reference/configure/) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - You will need the cluster's OIDC Issuer URL. [EKS Example](https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html) - [Create an IAM Policy](https://docs.aws.amazon.com/eks/latest/userguide/associate-service-account-role.html) diff --git a/docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png b/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png similarity index 100% rename from docs/content/guides/installation/providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png rename to docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png diff --git a/docs/content/guides/installation/providers/azure-provider/_index.md b/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/_index.md similarity index 100% rename from docs/content/guides/installation/providers/azure-provider/_index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/_index.md diff --git a/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-sp/index.md b/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-sp/index.md similarity index 100% rename from docs/content/guides/installation/providers/azure-provider/howto-azure-provider-sp/index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-sp/index.md diff --git a/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/index.md b/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/index.md similarity index 97% rename from docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/index.md index fc2bd7415..e9781643d 100644 --- a/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/index.md +++ b/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/index.md @@ -18,7 +18,7 @@ The Azure provider allows you to deploy and connect to Azure resources from a se - [Azure subscription](https://azure.com) - [az CLI](https://aka.ms/azcli) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) - You will need the cluster's OIDC Issuer URL. [AKS Example](https://azure.github.io/azure-workload-identity/docs/installation/managed-clusters.html#azure-kubernetes-service-aks) - [Azure AD Workload Identity](https://azure.github.io/azure-workload-identity/docs/installation.html) installed in your cluster, including the [Mutating Admission Webhook](https://azure.github.io/azure-workload-identity/docs/installation/mutating-admission-webhook.html) diff --git a/docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh b/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh similarity index 100% rename from docs/content/guides/installation/providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh rename to docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh diff --git a/docs/content/guides/installation/providers/overview/index.md b/docs/content/guides/setup-platform/setup-cloud-providers/overview/index.md similarity index 100% rename from docs/content/guides/installation/providers/overview/index.md rename to docs/content/guides/setup-platform/setup-cloud-providers/overview/index.md diff --git a/docs/content/guides/installation/providers/overview/provider.svg b/docs/content/guides/setup-platform/setup-cloud-providers/overview/provider.svg similarity index 100% rename from docs/content/guides/installation/providers/overview/provider.svg rename to docs/content/guides/setup-platform/setup-cloud-providers/overview/provider.svg diff --git a/docs/content/guides/installation/providers/overview/providers-overview.png b/docs/content/guides/setup-platform/setup-cloud-providers/overview/providers-overview.png similarity index 100% rename from docs/content/guides/installation/providers/overview/providers-overview.png rename to docs/content/guides/setup-platform/setup-cloud-providers/overview/providers-overview.png diff --git a/docs/content/guides/installation/setup-kubernetes/_index.md b/docs/content/guides/setup-platform/setup-kubernetes/_index.md similarity index 100% rename from docs/content/guides/installation/setup-kubernetes/_index.md rename to docs/content/guides/setup-platform/setup-kubernetes/_index.md diff --git a/docs/content/guides/installation/setup-kubernetes/kubernetes-install/index.md b/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-install/index.md similarity index 96% rename from docs/content/guides/installation/setup-kubernetes/kubernetes-install/index.md rename to docs/content/guides/setup-platform/setup-kubernetes/kubernetes-install/index.md index 289f0e3de..df28c1f57 100644 --- a/docs/content/guides/installation/setup-kubernetes/kubernetes-install/index.md +++ b/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-install/index.md @@ -13,7 +13,7 @@ Radius handles the deployment and management of environments, applications, and ## Prerequisites -- [Kubernetes cluster]({{< ref "guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Kubernetes cluster]({{< ref "guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) - [rad CLI]({{< ref howto-rad-cli >}}) diff --git a/docs/content/guides/installation/setup-kubernetes/kubernetes-uninstall/index.md b/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-uninstall/index.md similarity index 82% rename from docs/content/guides/installation/setup-kubernetes/kubernetes-uninstall/index.md rename to docs/content/guides/setup-platform/setup-kubernetes/kubernetes-uninstall/index.md index de50faeb6..dddc6ac69 100644 --- a/docs/content/guides/installation/setup-kubernetes/kubernetes-uninstall/index.md +++ b/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-uninstall/index.md @@ -10,7 +10,7 @@ tags: ["Kubernetes"] ## Prerequisites -- [Radius installed on Kubernetes cluster]({{< ref "guides/operations/kubernetes/kubernetes-install" >}}) +- [Radius installed on Kubernetes cluster]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-install" >}}) ## Step 1: Uninstall the Radius control-plane from your kubernetes cluster @@ -34,4 +34,4 @@ All Radius configuration and data will be removed as part of the namespace. This ## Step 3: Remove the rad CLI -You can remove the rad CLI by deleting the [ binary ]({{< ref "/guides/tooling/rad-cli/overview#binary-location" >}}) and ~/.rad folder from your machine. \ No newline at end of file +You can remove the rad CLI by deleting the [ binary ]({{< ref "/guides/install-tools/rad-cli/overview#binary-location" >}}) and ~/.rad folder from your machine. \ No newline at end of file diff --git a/docs/content/guides/installation/setup-kubernetes/kubernetes-upgrade/index.md b/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-upgrade/index.md similarity index 100% rename from docs/content/guides/installation/setup-kubernetes/kubernetes-upgrade/index.md rename to docs/content/guides/setup-platform/setup-kubernetes/kubernetes-upgrade/index.md diff --git a/docs/content/guides/installation/setup-kubernetes/overview/index.md b/docs/content/guides/setup-platform/setup-kubernetes/overview/index.md similarity index 100% rename from docs/content/guides/installation/setup-kubernetes/overview/index.md rename to docs/content/guides/setup-platform/setup-kubernetes/overview/index.md diff --git a/docs/content/guides/installation/setup-kubernetes/overview/kubernetes-mapping.png b/docs/content/guides/setup-platform/setup-kubernetes/overview/kubernetes-mapping.png similarity index 100% rename from docs/content/guides/installation/setup-kubernetes/overview/kubernetes-mapping.png rename to docs/content/guides/setup-platform/setup-kubernetes/overview/kubernetes-mapping.png diff --git a/docs/content/reference/cli/rad_install_kubernetes.md b/docs/content/reference/cli/rad_install_kubernetes.md index 1e6fda89b..e27ca0770 100644 --- a/docs/content/reference/cli/rad_install_kubernetes.md +++ b/docs/content/reference/cli/rad_install_kubernetes.md @@ -17,7 +17,7 @@ By default 'rad install kubernetes' will install Radius with the version matchin Radius will be installed in the 'radius-system' namespace. For more information visit https://docs.radapp.io/concepts/technical/architecture/ -Overrides can be set by specifying Helm chart values with the '--set' flag. For more information visit https://docs.radapp.io/guides/operations/kubernetes/install/. +Overrides can be set by specifying Helm chart values with the '--set' flag. For more information visit https://docs.radapp.io/guides/setup-platform/setup-kubernetes/overviewinstall/. ``` diff --git a/docs/content/reference/resource-schema/core-schema/application-schema/index.md b/docs/content/reference/resource-schema/core-schema/application-schema/index.md index f6ab3ad1d..d9702095c 100644 --- a/docs/content/reference/resource-schema/core-schema/application-schema/index.md +++ b/docs/content/reference/resource-schema/core-schema/application-schema/index.md @@ -31,7 +31,7 @@ Extensions allow you to customize how resources are generated or customized as p ##### kubernetesNamespace -The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/operations/kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior. +The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior. | Key | Required | Description | Example | |------|:--------:|-------------|---------| @@ -40,7 +40,7 @@ The Kubernetes namespace extension allows you to customize how all of the resour ##### kubernetesMetadata -The [Kubernetes Metadata extension]({{< ref "guides/operations/kubernetes/kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. ###### Properties diff --git a/docs/content/reference/resource-schema/core-schema/container-schema/index.md b/docs/content/reference/resource-schema/core-schema/container-schema/index.md index 28a086201..0784af94f 100644 --- a/docs/content/reference/resource-schema/core-schema/container-schema/index.md +++ b/docs/content/reference/resource-schema/core-schema/container-schema/index.md @@ -119,7 +119,7 @@ Additional properties are available and required depending on the 'kind' of the #### kubernetesMetadata -The [Kubernetes Metadata extension]({{< ref "guides/operations/kubernetes/kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples refer to the extension overview page. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples refer to the extension overview page. ##### Properties diff --git a/docs/content/reference/resource-schema/core-schema/environment-schema/index.md b/docs/content/reference/resource-schema/core-schema/environment-schema/index.md index 24c8e48d2..7f58388f7 100644 --- a/docs/content/reference/resource-schema/core-schema/environment-schema/index.md +++ b/docs/content/reference/resource-schema/core-schema/environment-schema/index.md @@ -100,7 +100,7 @@ Extensions allow you to customize how resources are generated or customized as p #### kubernetesMetadata -The [Kubernetes Metadata extension]({{< ref "guides/operations/kubernetes/kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. ##### Properties diff --git a/docs/content/tutorials/helm/index.md b/docs/content/tutorials/helm/index.md index 69dae21ec..da9c54579 100644 --- a/docs/content/tutorials/helm/index.md +++ b/docs/content/tutorials/helm/index.md @@ -19,7 +19,7 @@ This tutorial will teach you the following about Radius: - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Helm](https://helm.sh/docs/intro/install/) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) ## Step 1. Clone and open the sample code diff --git a/docs/content/tutorials/new-app/index.md b/docs/content/tutorials/new-app/index.md index 62eb0ec46..cecb8fec0 100644 --- a/docs/content/tutorials/new-app/index.md +++ b/docs/content/tutorials/new-app/index.md @@ -21,7 +21,7 @@ By the end of the tutorial, you will have created and deployed a new Radius Appl ## Prerequisites -- [Supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) @@ -42,7 +42,7 @@ By the end of the tutorial, you will have created and deployed a new Radius Appl rad init ``` - When asked if you want to create a new application select "Yes". This will create a new file named `app.bicep` in your directory where your application will be defined. It will also create a [`bicepconfig.json`]({{< ref "/guides/tooling/bicepconfig/overview" >}}) file that will contain the necessary setup to use Radius types with Bicep. + When asked if you want to create a new application select "Yes". This will create a new file named `app.bicep` in your directory where your application will be defined. It will also create a [`bicepconfig.json`]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) file that will contain the necessary setup to use Radius types with Bicep. {{< alert title="💡 Development Environments" color="info" >}} By default `rad init` gets you up and running with a local, development-focused environment where most of the environment configuration is handled for you, including Recipes (_more on that soon_). If you would like to fully customize your environment, you can run `rad init --full` @@ -154,7 +154,7 @@ Radius Applications are where all your app's resources and relationships come to ``` {{< alert title="💡 Kubernetes mapping" color="info" >}} - Radius Environments map how Applications "bind" to a particular platform. Earlier we saw the Application compute was set to `kubernetes` and the namespace was set to `default-myapp`. This means the container resources were deployed to the `default-myapp` namespace in the Kubernetes cluster where Radius is installed. Visit the [Kubernetes mapping docs]({{< ref "/guides/operations/kubernetes/overview#resource-mapping" >}}) to learn more. + Radius Environments map how Applications "bind" to a particular platform. Earlier we saw the Application compute was set to `kubernetes` and the namespace was set to `default-myapp`. This means the container resources were deployed to the `default-myapp` namespace in the Kubernetes cluster where Radius is installed. Visit the [Kubernetes mapping docs]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) to learn more. {{< /alert >}} ## Step 4: Run your application diff --git a/docs/content/tutorials/tutorial-add-radius/index.md b/docs/content/tutorials/tutorial-add-radius/index.md index 7c8a09f0c..0c002d2bc 100644 --- a/docs/content/tutorials/tutorial-add-radius/index.md +++ b/docs/content/tutorials/tutorial-add-radius/index.md @@ -20,7 +20,7 @@ By the end of this tutorial, you will have deployed an existing Kubernetes appli ## Prerequisites -- [Kubernetes cluster]({{< ref "guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Kubernetes cluster]({{< ref "guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) - [rad CLI]({{< ref howto-rad-cli >}}) diff --git a/docs/content/tutorials/tutorial-dapr/index.md b/docs/content/tutorials/tutorial-dapr/index.md index abbad640d..866775b41 100644 --- a/docs/content/tutorials/tutorial-dapr/index.md +++ b/docs/content/tutorials/tutorial-dapr/index.md @@ -21,7 +21,7 @@ For more details on the app and access to the source code, visit the `samples/da - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) - [Radius environment]({{< ref "installation#step-3-initialize-radius" >}}) -- [Setup a supported Kubernetes cluster](https://docs.radapp.io/guides/operations/kubernetes/overview/#supported-clusters) +- [Setup a supported Kubernetes cluster](https://docs.radapp.io/guides/setup-platform/setup-kubernetes/overview/#supported-clusters) - [Dapr installed on your Kubernetes cluster](https://docs.dapr.io/operations/hosting/kubernetes/kubernetes-deploy/) ## Step 1: Initialize a Radius Environment diff --git a/docs/content/tutorials/tutorial-recipe/index.md b/docs/content/tutorials/tutorial-recipe/index.md index 0fe4c09ae..15ec63526 100644 --- a/docs/content/tutorials/tutorial-recipe/index.md +++ b/docs/content/tutorials/tutorial-recipe/index.md @@ -34,7 +34,7 @@ Developers don't need to specify what cloud resources they're using in their app - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) ## Step 1: Initialize a Radius Environment diff --git a/docs/shared-content/installation/install-radius/initialize-radius.md b/docs/shared-content/installation/install-radius/initialize-radius.md index 67231c9f1..f01ef5b22 100644 --- a/docs/shared-content/installation/install-radius/initialize-radius.md +++ b/docs/shared-content/installation/install-radius/initialize-radius.md @@ -2,7 +2,7 @@ Initializing Radius installs the Radius control-plane and creates a Radius Envir 1. Create a Kubernetes cluster - Radius runs inside [Kubernetes]({{< ref "guides/operations/kubernetes" >}}). Create one from the [supported k8s clusters]({{< ref "/guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) + Radius runs inside [Kubernetes]({{< ref "guides/setup-platform/kubernetes/overview" >}}). Create one from the [supported k8s clusters]({{< ref "/guides/setup-platform/kubernetes/overview/overview#supported-kubernetes-clusters" >}}) > *If you don't have a preferred way to create Kubernetes clusters, you could try using [k3d](https://k3d.io/), which runs a minimal Kubernetes distribution in Docker.* Ensure your cluster is set as your current context: From 1acd82807219252f63ac7bd56d46ea243349de20 Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Wed, 7 May 2025 17:23:52 -0400 Subject: [PATCH 3/7] Draft restructure Signed-off-by: Reshma Abdul Rahim --- docs/content/concepts/faq/index.md | 10 ++--- .../why-radius/collaboration/index.md | 2 +- docs/content/getting-started/index.md | 6 +-- docs/content/guides/author-apps/_index.md | 6 +-- .../author-apps/application/overview/index.md | 8 ++-- docs/content/guides/author-apps/aws/_index.md | 7 ---- .../guides/author-apps/azure/_index.md | 7 ---- .../author-apps/bicep-extensions/_index.md | 7 ++++ .../guides/author-apps/custom/_index.md | 7 ---- .../guides/author-apps/kubernetes/_index.md | 7 ---- docs/content/guides/deploy-apps/_index.md | 6 +-- .../deploy-apps/gitops/howto-flux/index.md | 2 +- .../howto-deploy/howto-deploy-cicd/index.md | 2 +- .../howto-deploy-rad-cli/index.md | 2 +- .../howto-deploy/howto-run-app/index.md | 2 +- .../howto-troubleshootapps/index.md | 2 +- .../install-tools/dashboard/overview/index.md | 6 +-- .../install-tools/rad-cli/overview/index.md | 2 +- docs/content/guides/operations/_index.md | 2 +- .../control-plane/logs/fluentd/index.md | 2 +- .../control-plane/metrics/prometheus/index.md | 2 +- .../operations/kubernetes-metadata/index.md | 2 +- docs/content/guides/recipes/_index.md | 2 +- .../guides/recipes/howto-dev-recipes/index.md | 2 +- .../howto-private-bicep-registry/index.md | 6 +-- docs/content/guides/recipes/overview/index.md | 2 +- .../terraform/howto-custom-provider/index.md | 6 +-- .../terraform/howto-private-registry/index.md | 6 +-- docs/content/guides/resource-types/_index.md | 7 ++++ .../guides/resource-types/aws/_index.md | 7 ++++ .../aws/howto-aws-resources/icon.png | Bin .../aws/howto-aws-resources/index.md | 8 ++-- .../aws/howto-aws-resources/s3app.png | Bin .../aws/howto-aws-resources/s3appdiagram.png | Bin .../howto-aws-resources/snippets/app.bicep | 0 .../aws/howto-aws-resources/snippets/s3.bicep | 0 .../howto-aws-resources/snippets/s3app.bicep | 0 .../aws/overview/index.md | 4 +- .../aws/overview/snippets/aws.bicep | 0 .../guides/resource-types/azure/_index.md | 7 ++++ .../azure/howto-azure-resources/icon.png | Bin .../azure/howto-azure-resources/index.md | 6 +-- .../snippets/container-wi.bicep | 0 .../azure/overview/index.md | 4 +- .../overview/snippets/azure-connection.bicep | 0 .../core-resource-types/_index.md | 7 ++++ .../core-resource-types}/containers/_index.md | 0 .../demo-with-redis-screenshot.png | Bin .../howto-connect-dependencies/index.md | 8 ++-- .../snippets/app-with-redis.bicep | 0 .../snippets/app.bicep | 0 .../containers/howto-keyvault-volume/icon.png | Bin .../containers/howto-keyvault-volume/index.md | 2 +- .../snippets/keyvault-wi.bicep | 0 .../containers/howto-volumes/icon.png | Bin .../containers/howto-volumes/index.md | 2 +- .../howto-volumes/screenshot-empty.jpg | Bin .../howto-volumes/screenshot-error.jpg | Bin .../containers/howto-volumes/screenshot.jpg | Bin .../howto-volumes/snippets/1-app.bicep | 0 .../howto-volumes/snippets/2-app.bicep | 0 .../containers/overview/containers-splash.png | Bin .../containers/overview/index.md | 8 ++-- .../core-resource-types}/dapr/_index.md | 0 .../app-statestore.png | Bin .../dapr/how-to-dapr-building-block/index.md | 0 .../snippets/app-sidecar.bicep | 0 .../snippets/app-statestore.bicep | 0 .../dapr/how-to-dapr-secrets/index.md | 0 .../snippets/app-statestore-secret.bicep | 0 .../snippets/app-statestore.bicep | 0 .../dapr/how-to-dapr-sidecar/index.md | 6 +-- .../snippets/app-sidecar.bicep | 0 .../how-to-dapr-sidecar/snippets/app.bicep | 0 .../dapr/overview/dapr-buildingblocks.png | Bin .../dapr/overview/dapr-sidecar.png | Bin .../dapr/overview/index.md | 2 +- .../snippets/dapr-componentname.bicep | 0 .../snippets/service-invocation.bicep | 0 .../dapr/overview/snippets/sidecar.bicep | 0 .../dapr/overview/snippets/statestore.bicep | 0 .../core-resource-types}/networking/_index.md | 0 .../howto-gateways/demo-screenshot.png | Bin .../networking/howto-gateways/index.md | 2 +- .../howto-gateways/snippets/app.bicep | 0 .../backend-connection.png | Bin .../howto-service-networking/index.md | 0 .../howto-service-networking/overview.png | Bin .../snippets/1-app.bicep | 0 .../snippets/2-app.bicep | 0 .../networking/howto-tls/https-app.png | Bin .../networking/howto-tls/index.md | 4 +- .../howto-tls/snippets/app-existing.bicep | 0 .../howto-tls/snippets/app-new.bicep | 0 .../networking/overview/index.md | 0 .../overview/network-connection.png | Bin .../networking/overview/networking.png | Bin .../core-resource-types}/secrets/_index.md | 0 .../secrets/howto-new-secretstore/index.md | 0 .../snippets/secretstore.bicep | 0 .../secrets/overview/index.md | 4 +- .../overview/snippets/secretstore.bicep | 0 .../custom-resource-types/_index.md | 7 ++++ .../resource-types/kubernetes/_index.md | 7 ++++ .../kubernetes/how-to-access-secrets/index.md | 4 +- .../snippets/secrets-container.bicep | 0 .../snippets/secrets-patch.bicep | 0 .../demo-secret-object.png | Bin .../how-to-kubernetes-resource/index.md | 6 +-- .../snippets/app-kubernetes.bicep | 0 .../demoapp-howtopatchpod.png | Bin .../kubernetes/how-to-patch-pod/index.md | 4 +- .../snippets/patch-container.bicep | 0 .../snippets/patch-runtime.bicep | 0 .../kubernetes/overview/index.md | 0 .../snippets/kubernetes-connection.bicep | 0 .../snippets/kubernetes-resource.bicep | 0 .../guides/resource-types/overview/index.md | 36 ++++++++++++++++++ .../portable-resource-types}/_index.md | 6 +-- .../demo-with-redis-screenshot.png | Bin .../howto-author-portable-resources/index.md | 2 +- .../snippets/app-redis-manual.bicep | 0 .../snippets/app-redis-recipe.bicep | 0 .../overview/index.md | 8 ++-- .../overview/portable-resources.png | Bin docs/content/guides/setup-platform/_index.md | 7 ++++ .../_index.md | 2 +- .../aws-provider/_index.md | 0 .../howto-aws-provider-access-key/index.md | 0 .../howto-aws-provider-irsa/create-role.png | Bin .../howto-aws-provider-irsa/get-role-arn.png | Bin .../howto-aws-provider-irsa/index.md | 2 +- .../select-trust-entity.png | Bin .../azure-provider/_index.md | 0 .../howto-azure-provider-sp/index.md | 0 .../howto-azure-provider-wi/index.md | 2 +- .../snippets/install-radius-azwi.sh | 0 .../overview/index.md | 0 .../overview/provider.svg | 0 .../overview/providers-overview.png | Bin .../environments/_index.md | 2 +- .../environments/howto-environment/index.md | 12 +++--- .../environments/overview/index.md | 8 ++-- .../overview/providers-overview.png | Bin .../overview/snippets/environment.bicep | 0 .../groups/_index.md | 2 +- .../groups/howto-resourcegroups/index.md | 2 +- .../groups/overview/group-diagram.png | Bin .../groups/overview/group.svg | 0 .../groups/overview/index.md | 2 +- .../_index.md | 2 +- .../kubernetes-install/index.md | 2 +- .../kubernetes-uninstall/index.md | 2 +- .../kubernetes-upgrade/index.md | 0 .../overview/index.md | 2 +- .../overview/kubernetes-mapping.png | Bin .../workspaces/_index.md | 2 +- .../workspaces/howto-workspaces/index.md | 2 +- .../workspaces/overview/index.md | 2 +- .../workspaces/overview/workspaces.png | Bin .../reference/cli/rad_install_kubernetes.md | 2 +- docs/content/reference/limitations.md | 2 +- .../resource-schema/cache/redis/index.md | 4 +- .../core-schema/application-schema/index.md | 4 +- .../core-schema/container-schema/index.md | 4 +- .../core-schema/environment-schema/index.md | 4 +- .../volumes/volume-azure-keyvault/index.md | 2 +- .../dapr-configurationStore/index.md | 2 +- .../dapr-schema/dapr-extension/index.md | 2 +- .../dapr-schema/dapr-pubsub/index.md | 2 +- .../dapr-schema/dapr-secretstore/index.md | 2 +- .../dapr-schema/dapr-statestore/index.md | 2 +- .../databases/microsoft-sql/index.md | 2 +- .../databases/mongodb/index.md | 4 +- .../messaging/rabbitmq/index.md | 2 +- docs/content/tutorials/helm/index.md | 4 +- docs/content/tutorials/new-app/index.md | 8 ++-- .../tutorials/tutorial-add-radius/index.md | 8 ++-- docs/content/tutorials/tutorial-dapr/index.md | 6 +-- .../tutorials/tutorial-recipe/index.md | 6 +-- .../install-radius/initialize-radius.md | 6 +-- .../howto-extenders/index.md | 2 +- .../snippets/app-container.bicep | 0 .../howto-extenders/snippets/app.bicep | 0 .../custom => holding-pen}/overview/index.md | 0 185 files changed, 245 insertions(+), 181 deletions(-) delete mode 100644 docs/content/guides/author-apps/aws/_index.md delete mode 100644 docs/content/guides/author-apps/azure/_index.md create mode 100644 docs/content/guides/author-apps/bicep-extensions/_index.md delete mode 100644 docs/content/guides/author-apps/custom/_index.md delete mode 100644 docs/content/guides/author-apps/kubernetes/_index.md create mode 100644 docs/content/guides/resource-types/_index.md create mode 100644 docs/content/guides/resource-types/aws/_index.md rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/icon.png (100%) rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/index.md (91%) rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/s3app.png (100%) rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/s3appdiagram.png (100%) rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/snippets/app.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/snippets/s3.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/aws/howto-aws-resources/snippets/s3app.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/aws/overview/index.md (84%) rename docs/content/guides/{author-apps => resource-types}/aws/overview/snippets/aws.bicep (100%) create mode 100644 docs/content/guides/resource-types/azure/_index.md rename docs/content/guides/{author-apps => resource-types}/azure/howto-azure-resources/icon.png (100%) rename docs/content/guides/{author-apps => resource-types}/azure/howto-azure-resources/index.md (85%) rename docs/content/guides/{author-apps => resource-types}/azure/howto-azure-resources/snippets/container-wi.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/azure/overview/index.md (68%) rename docs/content/guides/{author-apps => resource-types}/azure/overview/snippets/azure-connection.bicep (100%) create mode 100644 docs/content/guides/resource-types/core-resource-types/_index.md rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/_index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-connect-dependencies/demo-with-redis-screenshot.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-connect-dependencies/index.md (85%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-connect-dependencies/snippets/app-with-redis.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-connect-dependencies/snippets/app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-keyvault-volume/icon.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-keyvault-volume/index.md (96%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-keyvault-volume/snippets/keyvault-wi.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/icon.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/index.md (96%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/screenshot-empty.jpg (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/screenshot-error.jpg (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/screenshot.jpg (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/snippets/1-app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/howto-volumes/snippets/2-app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/overview/containers-splash.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/containers/overview/index.md (92%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/_index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-building-block/app-statestore.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-building-block/index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-building-block/snippets/app-sidecar.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-building-block/snippets/app-statestore.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-secrets/index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-secrets/snippets/app-statestore-secret.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-secrets/snippets/app-statestore.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-sidecar/index.md (90%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-sidecar/snippets/app-sidecar.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/how-to-dapr-sidecar/snippets/app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/dapr-buildingblocks.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/dapr-sidecar.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/index.md (97%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/snippets/dapr-componentname.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/snippets/service-invocation.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/snippets/sidecar.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/dapr/overview/snippets/statestore.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/_index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-gateways/demo-screenshot.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-gateways/index.md (95%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-gateways/snippets/app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-service-networking/backend-connection.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-service-networking/index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-service-networking/overview.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-service-networking/snippets/1-app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-service-networking/snippets/2-app.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-tls/https-app.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-tls/index.md (93%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-tls/snippets/app-existing.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/howto-tls/snippets/app-new.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/overview/index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/overview/network-connection.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/networking/overview/networking.png (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/secrets/_index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/secrets/howto-new-secretstore/index.md (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/secrets/howto-new-secretstore/snippets/secretstore.bicep (100%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/secrets/overview/index.md (86%) rename docs/content/guides/{author-apps => resource-types/core-resource-types}/secrets/overview/snippets/secretstore.bicep (100%) create mode 100644 docs/content/guides/resource-types/custom-resource-types/_index.md create mode 100644 docs/content/guides/resource-types/kubernetes/_index.md rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-access-secrets/index.md (95%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-access-secrets/snippets/secrets-container.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-access-secrets/snippets/secrets-patch.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-kubernetes-resource/demo-secret-object.png (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-kubernetes-resource/index.md (89%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-kubernetes-resource/snippets/app-kubernetes.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-patch-pod/demoapp-howtopatchpod.png (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-patch-pod/index.md (96%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-patch-pod/snippets/patch-container.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/how-to-patch-pod/snippets/patch-runtime.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/overview/index.md (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/overview/snippets/kubernetes-connection.bicep (100%) rename docs/content/guides/{author-apps => resource-types}/kubernetes/overview/snippets/kubernetes-resource.bicep (100%) create mode 100644 docs/content/guides/resource-types/overview/index.md rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/_index.md (53%) rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/howto-author-portable-resources/demo-with-redis-screenshot.png (100%) rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/howto-author-portable-resources/index.md (96%) rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/howto-author-portable-resources/snippets/app-redis-manual.bicep (100%) rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/howto-author-portable-resources/snippets/app-redis-recipe.bicep (100%) rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/overview/index.md (73%) rename docs/content/guides/{author-apps/portable-resources => resource-types/portable-resource-types}/overview/portable-resources.png (100%) create mode 100644 docs/content/guides/setup-platform/_index.md rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/_index.md (92%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/aws-provider/_index.md (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/aws-provider/howto-aws-provider-access-key/index.md (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/aws-provider/howto-aws-provider-irsa/create-role.png (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/aws-provider/howto-aws-provider-irsa/get-role-arn.png (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/aws-provider/howto-aws-provider-irsa/index.md (99%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/aws-provider/howto-aws-provider-irsa/select-trust-entity.png (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/azure-provider/_index.md (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/azure-provider/howto-azure-provider-sp/index.md (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/azure-provider/howto-azure-provider-wi/index.md (98%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/overview/index.md (100%) rename docs/content/guides/setup-platform/{setup-cloud-providers => cloud-providers}/overview/provider.svg (100%) rename docs/content/guides/{deploy-apps/environments => setup-platform/cloud-providers}/overview/providers-overview.png (100%) rename docs/content/guides/{deploy-apps => setup-platform}/environments/_index.md (92%) rename docs/content/guides/{deploy-apps => setup-platform}/environments/howto-environment/index.md (91%) rename docs/content/guides/{deploy-apps => setup-platform}/environments/overview/index.md (87%) rename docs/content/guides/setup-platform/{setup-cloud-providers => environments}/overview/providers-overview.png (100%) rename docs/content/guides/{deploy-apps => setup-platform}/environments/overview/snippets/environment.bicep (100%) rename docs/content/guides/{operations => setup-platform}/groups/_index.md (92%) rename docs/content/guides/{operations => setup-platform}/groups/howto-resourcegroups/index.md (97%) rename docs/content/guides/{operations => setup-platform}/groups/overview/group-diagram.png (100%) rename docs/content/guides/{operations => setup-platform}/groups/overview/group.svg (100%) rename docs/content/guides/{operations => setup-platform}/groups/overview/index.md (98%) rename docs/content/guides/setup-platform/{setup-kubernetes => kubernetes}/_index.md (91%) rename docs/content/guides/setup-platform/{setup-kubernetes => kubernetes}/kubernetes-install/index.md (96%) rename docs/content/guides/setup-platform/{setup-kubernetes => kubernetes}/kubernetes-uninstall/index.md (95%) rename docs/content/guides/setup-platform/{setup-kubernetes => kubernetes}/kubernetes-upgrade/index.md (100%) rename docs/content/guides/setup-platform/{setup-kubernetes => kubernetes}/overview/index.md (99%) rename docs/content/guides/setup-platform/{setup-kubernetes => kubernetes}/overview/kubernetes-mapping.png (100%) rename docs/content/guides/{operations => setup-platform}/workspaces/_index.md (94%) rename docs/content/guides/{operations => setup-platform}/workspaces/howto-workspaces/index.md (97%) rename docs/content/guides/{operations => setup-platform}/workspaces/overview/index.md (91%) rename docs/content/guides/{operations => setup-platform}/workspaces/overview/workspaces.png (100%) rename {docs/content/guides/author-apps/custom => holding-pen}/howto-extenders/index.md (89%) rename {docs/content/guides/author-apps/custom => holding-pen}/howto-extenders/snippets/app-container.bicep (100%) rename {docs/content/guides/author-apps/custom => holding-pen}/howto-extenders/snippets/app.bicep (100%) rename {docs/content/guides/author-apps/custom => holding-pen}/overview/index.md (100%) diff --git a/docs/content/concepts/faq/index.md b/docs/content/concepts/faq/index.md index cd25d1cc4..a7d3c9221 100644 --- a/docs/content/concepts/faq/index.md +++ b/docs/content/concepts/faq/index.md @@ -37,13 +37,13 @@ Users can employ multiple environments for isolation and organization, for examp - Difference in hosting (standalone Kubernetes vs Microsoft Azure) - Multi-region deployments (deploy an application to multiple regions) -[Workspaces]({{< ref "/guides/operations/workspaces/overview" >}}) can be used to manage multiple environments from one machine. +[Workspaces]({{< ref "/guides/setup-platform/workspaces/overview" >}}) can be used to manage multiple environments from one machine. ## Recipes ### What resources do Recipes support? -Recipes currently support the set of [Radius portable resources]({{< ref "/guides/author-apps/portable-resources/overview" >}}): Redis, Mongo, RabbitMQ, SQL, Dapr State Stores, Dapr Secret Stores, Dapr Pub/Sub, and the untyped extender resource. Additional support for other resources (_Azure, AWS, etc._) will come in a future release. +Recipes currently support the set of [Radius portable resources]({{< ref "/guides/resource-types/portable-resource-types/overview" >}}): Redis, Mongo, RabbitMQ, SQL, Dapr State Stores, Dapr Secret Stores, Dapr Pub/Sub, and the untyped extender resource. Additional support for other resources (_Azure, AWS, etc._) will come in a future release. ### What infrastructure can Recipes deploy? @@ -61,7 +61,7 @@ No. Recipes are deployed on-behalf-of the Radius Environment so developers do no ### What AWS services does Radius support? -Radius Applications can include AWS services that are also supported by the AWS cloud control API. See the [AWS resource library]({{< ref "/guides/author-apps/aws/overview#resource-library" >}}) for the complete list of supported AWS resources. Connections from a Radius container to an AWS resource are not yet supported. Properties such as hostnames, ports, endpoints, and connection strings need to be manually specified as environment variables. Additional support for Connections to AWS resources is on our backlog. +Radius Applications can include AWS services that are also supported by the AWS cloud control API. See the [AWS resource library]({{< ref "/guides/resource-types/aws/overview#resource-library" >}}) for the complete list of supported AWS resources. Connections from a Radius container to an AWS resource are not yet supported. Properties such as hostnames, ports, endpoints, and connection strings need to be manually specified as environment variables. Additional support for Connections to AWS resources is on our backlog. ### What Azure services does Radius support? @@ -73,7 +73,7 @@ Not yet, but it is on the backlog. ### Does Radius support Dapr? -Yes. Radius has first-class support for [Dapr building blocks]({{< ref "/guides/author-apps/dapr" >}}) such as state stores, secret stores, and pub/sub brokers. Developers can add Dapr resources to their applications and operators can define Recipes that deploy and manage the underlying infrastructure. +Yes. Radius has first-class support for [Dapr building blocks]({{< ref "guides/resource-types/core-resource-types/dapr" >}}) such as state stores, secret stores, and pub/sub brokers. Developers can add Dapr resources to their applications and operators can define Recipes that deploy and manage the underlying infrastructure. ## Comparison to other tools @@ -116,7 +116,7 @@ Teams looking to leverage existing Terraform modules can use [Recipes]({{< ref " [Dapr](https://dapr.io/) is a portable, event-driven runtime that makes it easy for developers to build resilient, microservice stateless and stateful applications that run on the cloud and edge. Dapr is a great tool for writing microservice code, but doesn't provide a way to model or deploy an entire application and its infrastructure. -Radius provides [built-in Dapr support]({{< ref "/guides/author-apps/dapr" >}}) to make it easy to model Dapr building blocks and Dapr-enabled services within your app. Like peanut butter and jelly, Radius and Dapr are better together. +Radius provides [built-in Dapr support]({{< ref "/guides/resource-types/core-resource-types/dapr" >}}) to make it easy to model Dapr building blocks and Dapr-enabled services within your app. Like peanut butter and jelly, Radius and Dapr are better together. ### How does Radius compare to Acorn? diff --git a/docs/content/concepts/why-radius/collaboration/index.md b/docs/content/concepts/why-radius/collaboration/index.md index 2cfac0105..89c645e4c 100644 --- a/docs/content/concepts/why-radius/collaboration/index.md +++ b/docs/content/concepts/why-radius/collaboration/index.md @@ -29,7 +29,7 @@ Platform engineers and IT operators collaborate with application teams by managi When an Application is deployed, Radius will *bind* the Application to the configuration of the target Environment and apply the relevant settings. Storing the operational configuration in the Environment increases developer velocity because the Application does not need to change when it is deployed across Environments configured for different purposes or leveraging different infrastructure. -{{< button text="Learn more about Environments" page="/guides/deploy-apps/environments/overview" newtab="true" >}} +{{< button text="Learn more about Environments" page="/guides/setup-platform/environments/overview" newtab="true" >}} ## Recipes as part of the Environment diff --git a/docs/content/getting-started/index.md b/docs/content/getting-started/index.md index d9033b381..9dd632c4a 100644 --- a/docs/content/getting-started/index.md +++ b/docs/content/getting-started/index.md @@ -25,8 +25,8 @@ The Radius getting-started guide can be [run **for free** in a GitHub Codespace] ## 1. Have your Kubernetes cluster handy -Radius runs inside [Kubernetes]({{< ref "guides/setup-platform/setup-kubernetes/overview" >}}). However you run Kubernetes, get a cluster ready. -> *If you don't have a preferred way to create Kubernetes clusters, you could try using [k3d](https://k3d.io/), which runs a minimal Kubernetes distribution in Docker. Make sure to apply the [recommended configuration]({{< ref "guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}).* +Radius runs inside [Kubernetes]({{< ref "guides/setup-platform/kubernetes/overview" >}}). However you run Kubernetes, get a cluster ready. +> *If you don't have a preferred way to create Kubernetes clusters, you could try using [k3d](https://k3d.io/), which runs a minimal Kubernetes distribution in Docker. Make sure to apply the [recommended configuration]({{< ref "guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}).* Ensure your cluster is set as your current context: @@ -121,7 +121,7 @@ First add some new code to `app.bicep` by pasting in the content below at the en {{< rad file="snippets/app-with-redis-snippets.bicep" embed=true marker="//REDIS" markdownConfig="{linenos=table,linenostart=21}" >}} -Next, update your container definition to include `connections` inside `properties`. This code creates a connection between the container and the database. Based on this connection, Radius will [inject environment variables]({{< ref "/guides/author-apps/containers/overview#connections" >}}) into the container that inform the container how to connect. You will view these in the next step. +Next, update your container definition to include `connections` inside `properties`. This code creates a connection between the container and the database. Based on this connection, Radius will [inject environment variables]({{< ref "/guides/resource-types/core-resource-types/containers/overview#connections" >}}) into the container that inform the container how to connect. You will view these in the next step. {{< rad file="snippets/app-with-redis-snippets.bicep" embed=true marker="//CONNECTION" markdownConfig="{linenos=table,hl_lines=[\"13-17\"],linenostart=7}" >}} diff --git a/docs/content/guides/author-apps/_index.md b/docs/content/guides/author-apps/_index.md index e5bc51a70..13d37d78f 100644 --- a/docs/content/guides/author-apps/_index.md +++ b/docs/content/guides/author-apps/_index.md @@ -1,7 +1,7 @@ --- type: docs -title: "Authoring applications" -linkTitle: "Authoring applications" +title: "Authoring Applications" +linkTitle: "Authoring Applications" description: "Learn how to author a Radius Application" -weight: 100 +weight: 500 --- \ No newline at end of file diff --git a/docs/content/guides/author-apps/application/overview/index.md b/docs/content/guides/author-apps/application/overview/index.md index ad69836c8..fd81ed1a3 100644 --- a/docs/content/guides/author-apps/application/overview/index.md +++ b/docs/content/guides/author-apps/application/overview/index.md @@ -14,11 +14,11 @@ A Radius Application is the primary resource that brings all your "stuff" togeth ## Add portability to your application -Radius Applications are designed to be cloud and platform agnostic. This means that you can define your application once, and deploy it to any cloud or platform that Radius supports. This allows you to easily move your application between clouds, or even between cloud and on-premises environments. Developers can define their requirements and dependencies (_Redis, SQL, Dapr, etc._) and operators can define the [environments]({{< ref "guides/deploy-apps/environments/overview" >}}) and [Recipes]({{< ref "guides/recipes/overview" >}}) that bind those requirements to the appropriate cloud resources. +Radius Applications are designed to be cloud and platform agnostic. This means that you can define your application once, and deploy it to any cloud or platform that Radius supports. This allows you to easily move your application between clouds, or even between cloud and on-premises environments. Developers can define their requirements and dependencies (_Redis, SQL, Dapr, etc._) and operators can define the [environments]({{< ref "guides/setup-platform/environments/overview" >}}) and [Recipes]({{< ref "guides/recipes/overview" >}}) that bind those requirements to the appropriate cloud resources. {{< image src="portable-resources.png" alt="Diagram of portable resources binding to different clouds" width=600px >}} -Learn more about portable resources in the [portable resources docs]({{< ref "guides/author-apps/portable-resources/overview" >}}) and [Dapr docs]({{< ref "guides/author-apps/dapr/overview" >}}) +Learn more about portable resources in the [portable resources docs]({{< ref "guides/resource-types/portable-resource-types/overview" >}}) and [Dapr docs]({{< ref "/guides/resource-types/core-resource-types/dapr/overview" >}}) ## Customize your application with extensions @@ -26,11 +26,11 @@ Extensions allow you to customize how resources are generated or customized as p ### Kubernetes Namespace extension -The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior +The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior ### Kubernetes Metadata extension -The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/kubernetes/overview#kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. ## Query and understand your application with the Radius Application Graph diff --git a/docs/content/guides/author-apps/aws/_index.md b/docs/content/guides/author-apps/aws/_index.md deleted file mode 100644 index 4f0e8a85e..000000000 --- a/docs/content/guides/author-apps/aws/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "AWS resources" -linkTitle: "AWS" -description: "Deploy and connect to AWS resources in your application" -weight: 700 ---- \ No newline at end of file diff --git a/docs/content/guides/author-apps/azure/_index.md b/docs/content/guides/author-apps/azure/_index.md deleted file mode 100644 index b7d1a17be..000000000 --- a/docs/content/guides/author-apps/azure/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Microsoft Azure resources" -linkTitle: "Azure" -description: "Deploy and connect to Azure resources in your application" -weight: 800 ---- diff --git a/docs/content/guides/author-apps/bicep-extensions/_index.md b/docs/content/guides/author-apps/bicep-extensions/_index.md new file mode 100644 index 000000000..65c032c50 --- /dev/null +++ b/docs/content/guides/author-apps/bicep-extensions/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Bicep Extensions" +linkTitle: "Bicep Extensions" +description: "Learn about Bicep extensions for Radius" +weight: 100 +--- diff --git a/docs/content/guides/author-apps/custom/_index.md b/docs/content/guides/author-apps/custom/_index.md deleted file mode 100644 index c1fb44584..000000000 --- a/docs/content/guides/author-apps/custom/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Custom resources" -linkTitle: "Custom resources" -description: "Model and deploy your own resource types" -weight: 550 ---- diff --git a/docs/content/guides/author-apps/kubernetes/_index.md b/docs/content/guides/author-apps/kubernetes/_index.md deleted file mode 100644 index dbc77129d..000000000 --- a/docs/content/guides/author-apps/kubernetes/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Kubernetes resources" -linkTitle: "Kubernetes" -description: "Deploy and connect to Kubernetes resources in your application" -weight: 600 ---- \ No newline at end of file diff --git a/docs/content/guides/deploy-apps/_index.md b/docs/content/guides/deploy-apps/_index.md index 644ee0238..3a2795a40 100644 --- a/docs/content/guides/deploy-apps/_index.md +++ b/docs/content/guides/deploy-apps/_index.md @@ -1,7 +1,7 @@ --- type: docs -title: "Deploying applications" -linkTitle: "Deploying applications" +title: "Deploying Applications" +linkTitle: "Deploying Applications" description: "Learn how to deploy a Radius Application to an environment" -weight: 200 +weight: 500 --- \ No newline at end of file diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/index.md b/docs/content/guides/deploy-apps/gitops/howto-flux/index.md index 4560e0067..05a3e3e46 100644 --- a/docs/content/guides/deploy-apps/gitops/howto-flux/index.md +++ b/docs/content/guides/deploy-apps/gitops/howto-flux/index.md @@ -16,7 +16,7 @@ This guide will provide an overview of how to: ## Prerequisites -- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Radius environment]({{< ref "installation#step-3-initialize-radius" >}}) - A remote Git repository (e.g., GitHub, GitLab, etc.) to store your application files diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md index 282459e9c..309fa7873 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md +++ b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md @@ -12,7 +12,7 @@ It's easy to get Radius added to your GitHub Actions deployment pipelines. By le ## Prerequisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - Radius control plane [installed in your cluster]({{< ref kubernetes-install >}}) - GitHub repo with Actions enabled diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md index 3d6d33397..046c8082b 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md +++ b/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md @@ -10,7 +10,7 @@ tags: ["deployments"] ## Pre-requisites -- [An authored Radius Application]({{< ref author-apps >}}) +- [An authored Radius Application]({{< ref resource-types >}}) ## Step 1 : Deploy an application into a Radius Environment diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md b/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md index b9f168d21..9aac2639a 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md +++ b/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md @@ -10,7 +10,7 @@ tags: ["deployments"] ## Pre-requisites -- [An authored Radius Application]({{< ref author-apps >}}) +- [An authored Radius Application]({{< ref resource-types >}}) ## Step 1: Run an application diff --git a/docs/content/guides/deploy-apps/howto-troubleshootapps/index.md b/docs/content/guides/deploy-apps/howto-troubleshootapps/index.md index 494b9569a..14a4a1aa1 100644 --- a/docs/content/guides/deploy-apps/howto-troubleshootapps/index.md +++ b/docs/content/guides/deploy-apps/howto-troubleshootapps/index.md @@ -30,7 +30,7 @@ If your Radius Application is unresponsive or does not connect to its dependenci rad resource logs Applications.Core/containers -a ``` -> Also refer to the [connections section]({{< ref "guides/author-apps/containers/overview#connections" >}}) to know about the naming convention of the environment variables and inspect if your application uses the right variables. +> Also refer to the [connections section]({{< ref "/guides/resource-types/core-resource-types/containers/overview#connections" >}}) to know about the naming convention of the environment variables and inspect if your application uses the right variables. ## Step 3: Inspect control-plane logs diff --git a/docs/content/guides/install-tools/dashboard/overview/index.md b/docs/content/guides/install-tools/dashboard/overview/index.md index f16023a18..ea051a724 100644 --- a/docs/content/guides/install-tools/dashboard/overview/index.md +++ b/docs/content/guides/install-tools/dashboard/overview/index.md @@ -10,7 +10,7 @@ tags: ["dashboard"] ## What is the Radius Dashboard? -The Radius Dashboard is the frontend experience for Radius and provides a graphical interface for visualizing your [Application Graph]({{< ref "guides/author-apps/application/overview#query-and-understand-your-application-with-the-radius-application-graph" >}}), [Environments]({{< ref "guides/deploy-apps/environments/overview" >}}), and [Recipes]({{< ref "guides/recipes/overview" >}}). It provides both textual and visual representations of your Radius Applications and resources, as well as a directory of Recipes that are available in each Environment. +The Radius Dashboard is the frontend experience for Radius and provides a graphical interface for visualizing your [Application Graph]({{< ref "guides/author-apps/application/overview#query-and-understand-your-application-with-the-radius-application-graph" >}}), [Environments]({{< ref "guides/setup-platform/environments/overview" >}}), and [Recipes]({{< ref "guides/recipes/overview" >}}). It provides both textual and visual representations of your Radius Applications and resources, as well as a directory of Recipes that are available in each Environment. {{< image src="dashboard-home.png" alt="screenshot of an example Radius Dashboard home page" width=800 >}} @@ -23,7 +23,7 @@ The Radius Dashboard is built on [Backstage](https://backstage.io/), an open-sou The Radius Dashboard currently provides the following features: - **Application graph visualization**: A visualization of the [application graph]({{< ref "guides/author-apps/application/overview#query-and-understand-your-application-with-the-radius-application-graph" >}}) that shows how resources within an application are connected to each other and the underlying infrastructure. -- **Resource overview and details**: Detailed information about resources within Radius, including [applications]({{< ref "guides/author-apps/application/overview" >}}), [environments]({{< ref "guides/deploy-apps/environments/overview" >}}), and infrastructure. +- **Resource overview and details**: Detailed information about resources within Radius, including [applications]({{< ref "guides/author-apps/application/overview" >}}), [environments]({{< ref "guides/setup-platform/environments/overview" >}}), and infrastructure. - **Recipes directory**: A listing of all the Radius [Recipes]({{< ref "guides/recipes/overview" >}}) available to the user for a given environment. ## Installation @@ -31,7 +31,7 @@ The Radius Dashboard currently provides the following features: The Radius Dashboard is installed by default as a part of your Radius initialization and deployment. {{< alert title="Opting-out" color="warning" >}} -To opt-out of installing the dashboard, you can use the `--set dashboard.enabled=false` flag when running `rad init` or `rad install kubernetes`. See more instructions in the Radius [initialization]({{< ref "installation#step-3-initialize-radius" >}}) and [installation]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-install" >}}) guides. +To opt-out of installing the dashboard, you can use the `--set dashboard.enabled=false` flag when running `rad init` or `rad install kubernetes`. See more instructions in the Radius [initialization]({{< ref "installation#step-3-initialize-radius" >}}) and [installation]({{< ref "guides/setup-platform/kubernetes/kubernetes-install" >}}) guides. {{< /alert >}} To remove the dashboard from your existing installation of Radius on your cluster, you can run: diff --git a/docs/content/guides/install-tools/rad-cli/overview/index.md b/docs/content/guides/install-tools/rad-cli/overview/index.md index ff3fad377..104c61bcc 100644 --- a/docs/content/guides/install-tools/rad-cli/overview/index.md +++ b/docs/content/guides/install-tools/rad-cli/overview/index.md @@ -84,7 +84,7 @@ The rad CLI stores configuration under `%USERPROFILE%\.rad` ### `config.yaml` file -The rad CLI stores its configuration in a YAML file named `config.yaml` under the `rad` directory. This file contains [workspaces]({{< ref "/guides/operations/workspaces/overview" >}}), which point to your cluster, your default [resource group]({{< ref "/guides/operations/groups/overview" >}}), and your default [environment]({{< ref "/guides/deploy-apps/environments/overview" >}}). +The rad CLI stores its configuration in a YAML file named `config.yaml` under the `rad` directory. This file contains [workspaces]({{< ref "/guides/setup-platform/workspaces/overview" >}}), which point to your cluster, your default [resource group]({{< ref "/guides/setup-platform/groups/overview" >}}), and your default [environment]({{< ref "/guides/setup-platform/environments/overview" >}}). When the rad CLI runs commands, it will use the configuration in the `config.yaml` file to determine which cluster, resource group, and environment to target and use. diff --git a/docs/content/guides/operations/_index.md b/docs/content/guides/operations/_index.md index 8356acae6..76cb96767 100644 --- a/docs/content/guides/operations/_index.md +++ b/docs/content/guides/operations/_index.md @@ -3,5 +3,5 @@ type: docs title: "Environment operations guides" linkTitle: "Operations" description: "Learn how to deploy and operate Radius Environments" -weight: 400 +weight: 700 --- diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/index.md b/docs/content/guides/operations/control-plane/logs/fluentd/index.md index 967069b5b..3907cf6a5 100644 --- a/docs/content/guides/operations/control-plane/logs/fluentd/index.md +++ b/docs/content/guides/operations/control-plane/logs/fluentd/index.md @@ -10,7 +10,7 @@ tags: ["logs","observability"] ## Prerequisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/) - [Helm 3](https://helm.sh/) diff --git a/docs/content/guides/operations/control-plane/metrics/prometheus/index.md b/docs/content/guides/operations/control-plane/metrics/prometheus/index.md index bbef67083..832dda39d 100644 --- a/docs/content/guides/operations/control-plane/metrics/prometheus/index.md +++ b/docs/content/guides/operations/control-plane/metrics/prometheus/index.md @@ -14,7 +14,7 @@ tags: ["metrics", "observability"] 1. Make sure you have the following pre-requisites: - - [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) + - [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/) - [Helm 3](https://helm.sh/) - [Radius control plane installed]({{< ref kubernetes-install >}}) diff --git a/docs/content/guides/operations/kubernetes-metadata/index.md b/docs/content/guides/operations/kubernetes-metadata/index.md index 76652dc7a..cb918173e 100644 --- a/docs/content/guides/operations/kubernetes-metadata/index.md +++ b/docs/content/guides/operations/kubernetes-metadata/index.md @@ -38,7 +38,7 @@ You can set labels and annotations on an environment, application, or container ## Cascading metadata -Kubernetes metadata can be applied at the environment, application, or container layers. Metadata cascades down from the environment to the application to the containers, gateway and route resources. For example, you can set labels and annotations at an environment level and all containers within the environment will gain these labels and annotation, without the need for an explicit extension on the containers. The following resources will gain the Kubernetes metadata for their [output resources]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) from labels, annotations set at Environment, Application levels: +Kubernetes metadata can be applied at the environment, application, or container layers. Metadata cascades down from the environment to the application to the containers, gateway and route resources. For example, you can set labels and annotations at an environment level and all containers within the environment will gain these labels and annotation, without the need for an explicit extension on the containers. The following resources will gain the Kubernetes metadata for their [output resources]({{< ref "/guides/setup-platform/kubernetes/overview#resource-mapping" >}}) from labels, annotations set at Environment, Application levels: - Applications.Core/containers - Applications.Core/gateways diff --git a/docs/content/guides/recipes/_index.md b/docs/content/guides/recipes/_index.md index cf593bf01..2404f7d3c 100644 --- a/docs/content/guides/recipes/_index.md +++ b/docs/content/guides/recipes/_index.md @@ -3,5 +3,5 @@ type: docs title: "Radius Recipes" linkTitle: "Recipes" description: "Learn how to automate infrastructure deployment for your resources with Radius Recipes" -weight: 300 +weight: 400 --- diff --git a/docs/content/guides/recipes/howto-dev-recipes/index.md b/docs/content/guides/recipes/howto-dev-recipes/index.md index 93af6df43..915a48ecf 100644 --- a/docs/content/guides/recipes/howto-dev-recipes/index.md +++ b/docs/content/guides/recipes/howto-dev-recipes/index.md @@ -14,7 +14,7 @@ Local development environments created by the rad init command include a set of - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) ## Step 1: Initialize a Radius environment diff --git a/docs/content/guides/recipes/howto-private-bicep-registry/index.md b/docs/content/guides/recipes/howto-private-bicep-registry/index.md index d45492112..1da1efec8 100644 --- a/docs/content/guides/recipes/howto-private-bicep-registry/index.md +++ b/docs/content/guides/recipes/howto-private-bicep-registry/index.md @@ -29,9 +29,9 @@ Radius supports three authentication methods for accessing private container reg ## Step 2: Define a secret store resource -Create a [Radius Secret Store]({{< ref "/guides/author-apps/secrets/overview" >}}) to securely store and manage the secrets information required for authenticating with a private registry. Define the namespace for the cluster that will contain your [Kubernetes Secret](https://kubernetes.io/docs/concepts/configuration/secret/) with the `resource` property and specify the type of secret e.g. `basicAuthentication`, `azureWorkloadIdeneity`, `awsIRSA`. +Create a [Radius Secret Store]({{< ref "/guides/resource-types/core-resource-types/secrets/overview" >}}) to securely store and manage the secrets information required for authenticating with a private registry. Define the namespace for the cluster that will contain your [Kubernetes Secret](https://kubernetes.io/docs/concepts/configuration/secret/) with the `resource` property and specify the type of secret e.g. `basicAuthentication`, `azureWorkloadIdeneity`, `awsIRSA`. -> While this example shows a Radius-managed secret store where Radius creates the underlying secrets infrastructure, you can also bring your own existing secrets. Refer to the [secrets documentation]({{< ref "/guides/author-apps/secrets/overview" >}}) for more information. +> While this example shows a Radius-managed secret store where Radius creates the underlying secrets infrastructure, you can also bring your own existing secrets. Refer to the [secrets documentation]({{< ref "/guides/resource-types/core-resource-types/secrets/overview" >}}) for more information. Secret store example for secret type `awsIRSA`: {{< rad file="snippets/env.bicep" embed=true marker="//SECRETSTORE" >}} @@ -67,6 +67,6 @@ rad env delete my-env ## Further reading - [Recipes overview]({{< ref "/guides/recipes/overview" >}}) -- [Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}}) +- [Radius Environments]({{< ref "/guides/setup-platform/environments/overview" >}}) - [`rad recipe CLI reference`]({{< ref rad_recipe >}}) - [`rad env CLI reference`]({{< ref rad_environment >}}) \ No newline at end of file diff --git a/docs/content/guides/recipes/overview/index.md b/docs/content/guides/recipes/overview/index.md index d84027aa7..1218fc4fe 100644 --- a/docs/content/guides/recipes/overview/index.md +++ b/docs/content/guides/recipes/overview/index.md @@ -53,7 +53,7 @@ It's easy to author and register your own Recipes which define how to deploy and ## Supported resources -Recipes support all of the available portable resources listed [here]({{< ref "/guides/author-apps/portable-resources/overview" >}}). +Recipes support all of the available portable resources listed [here]({{< ref "/guides/resource-types/portable-resource-types/overview" >}}). ## Infrastructure linking diff --git a/docs/content/guides/recipes/terraform/howto-custom-provider/index.md b/docs/content/guides/recipes/terraform/howto-custom-provider/index.md index 49a356218..b7491c196 100644 --- a/docs/content/guides/recipes/terraform/howto-custom-provider/index.md +++ b/docs/content/guides/recipes/terraform/howto-custom-provider/index.md @@ -29,9 +29,9 @@ Before you get started, you'll need to make sure you have the following tools an ## Step 1: Define a secretStore resource for the custom provider -Configure a [Radius Secret Store]({{< ref "/guides/author-apps/secrets/overview" >}}) with any sensitive information needed as input configuration for the custom Terraform Provider. Define the namespace for the cluster that will contain your [Kubernetes Secret](https://kubernetes.io/docs/concepts/configuration/secret/) with the `resource` property. +Configure a [Radius Secret Store]({{< ref "/guides/resource-types/core-resource-types/secrets/overview" >}}) with any sensitive information needed as input configuration for the custom Terraform Provider. Define the namespace for the cluster that will contain your [Kubernetes Secret](https://kubernetes.io/docs/concepts/configuration/secret/) with the `resource` property. -> While this example shows a Radius-managed secret store where Radius creates the underlying secrets infrastructure, you can also bring your own existing secrets. Refer to the [secrets documentation]({{< ref "/guides/author-apps/secrets/overview" >}}) for more information. +> While this example shows a Radius-managed secret store where Radius creates the underlying secrets infrastructure, you can also bring your own existing secrets. Refer to the [secrets documentation]({{< ref "/guides/resource-types/core-resource-types/secrets/overview" >}}) for more information. Create a Bicep file `env.bicep` with the secretStore resource: @@ -82,6 +82,6 @@ rad env delete my-env ## Further reading - [Recipes overview]({{< ref "/guides/recipes/overview" >}}) -- [Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}}) +- [Radius Environments]({{< ref "/guides/setup-platform/environments/overview" >}}) - [`rad recipe CLI reference`]({{< ref rad_recipe >}}) - [`rad env CLI reference`]({{< ref rad_environment >}}) \ No newline at end of file diff --git a/docs/content/guides/recipes/terraform/howto-private-registry/index.md b/docs/content/guides/recipes/terraform/howto-private-registry/index.md index 6241c6728..16659eb53 100644 --- a/docs/content/guides/recipes/terraform/howto-private-registry/index.md +++ b/docs/content/guides/recipes/terraform/howto-private-registry/index.md @@ -30,9 +30,9 @@ The PAT should have access to read the files inside the specific private reposit ## Step 2: Define a secret store resource -Configure a [Radius Secret Store]({{< ref "/guides/author-apps/secrets/overview" >}}) with the personal access token or username + password you previously created, which has access to your private git repository. Define the namespace for the cluster that will contain your [Kubernetes Secret](https://kubernetes.io/docs/concepts/configuration/secret/) with the `resource` property. +Configure a [Radius Secret Store]({{< ref "/guides/resource-types/core-resource-types/secrets/overview" >}}) with the personal access token or username + password you previously created, which has access to your private git repository. Define the namespace for the cluster that will contain your [Kubernetes Secret](https://kubernetes.io/docs/concepts/configuration/secret/) with the `resource` property. -> While this example shows a Radius-managed secret store where Radius creates the underlying secrets infrastructure, you can also bring your own existing secrets. Refer to the [secrets documentation]({{< ref "/guides/author-apps/secrets/overview" >}}) for more information. +> While this example shows a Radius-managed secret store where Radius creates the underlying secrets infrastructure, you can also bring your own existing secrets. Refer to the [secrets documentation]({{< ref "/guides/resource-types/core-resource-types/secrets/overview" >}}) for more information. Create a Bicep file `env.bicep`, import Radius, and define your resource: @@ -77,6 +77,6 @@ rad env delete my-env ## Further reading - [Recipes overview]({{< ref "/guides/recipes/overview" >}}) -- [Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}}) +- [Radius Environments]({{< ref "/guides/setup-platform/environments/overview" >}}) - [`rad recipe CLI reference`]({{< ref rad_recipe >}}) - [`rad env CLI reference`]({{< ref rad_environment >}}) \ No newline at end of file diff --git a/docs/content/guides/resource-types/_index.md b/docs/content/guides/resource-types/_index.md new file mode 100644 index 000000000..9bb3b4eb7 --- /dev/null +++ b/docs/content/guides/resource-types/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Radius Resource Types" +linkTitle: "Resource Types" +description: "Learn how to create or use existing resource types" +weight: 300 +--- diff --git a/docs/content/guides/resource-types/aws/_index.md b/docs/content/guides/resource-types/aws/_index.md new file mode 100644 index 000000000..29a905c31 --- /dev/null +++ b/docs/content/guides/resource-types/aws/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "AWS Resource Types" +linkTitle: "AWS" +description: "Learn how to use AWS resource types in Radius" +weight: 500 +--- \ No newline at end of file diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/icon.png b/docs/content/guides/resource-types/aws/howto-aws-resources/icon.png similarity index 100% rename from docs/content/guides/author-apps/aws/howto-aws-resources/icon.png rename to docs/content/guides/resource-types/aws/howto-aws-resources/icon.png diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/index.md b/docs/content/guides/resource-types/aws/howto-aws-resources/index.md similarity index 91% rename from docs/content/guides/author-apps/aws/howto-aws-resources/index.md rename to docs/content/guides/resource-types/aws/howto-aws-resources/index.md index 0dac88332..a42451f68 100644 --- a/docs/content/guides/author-apps/aws/howto-aws-resources/index.md +++ b/docs/content/guides/resource-types/aws/howto-aws-resources/index.md @@ -36,7 +36,7 @@ eksctl create cluster --name --region= ## Step 2: Create a Radius Environment with the AWS cloud provider -Create a [Radius Environment]({{< ref "/guides/deploy-apps/environments/overview" >}}) where you will deploy your application. +Create a [Radius Environment]({{< ref "/guides/setup-platform/environments/overview" >}}) where you will deploy your application. Run [`rad init --full`]({{< ref rad_initialize >}}) to initialize a new environment into your current kubectl context: @@ -44,12 +44,12 @@ Run [`rad init --full`]({{< ref rad_initialize >}}) to initialize a new environm rad init --full ``` -Follow the prompts to install the [control plane services]({{< ref "/concepts/technical/architecture" >}}), create an [environment resource]({{< ref "/guides/deploy-apps/environments" >}}), and create a [local workspace]({{< ref workspaces >}}). You will be asked for: +Follow the prompts to install the [control plane services]({{< ref "/concepts/technical/architecture" >}}), create an [environment resource]({{< ref "/guides/setup-platform/environments" >}}), and create a [local workspace]({{< ref workspaces >}}). You will be asked for: - **Namespace** - When an application is deployed, this is the namespace where your containers and other Kubernetes resources will be run. By default, this will be in the `default` namespace. {{% alert title="💡 About namespaces" color="success" %}} When you initialize a Radius Kubernetes environment, Radius installs the control plane resources within the `radius-system` namespace in your cluster, separate from your applications. The namespace specified in this step will be used for your application deployments. {{% /alert %}} -- **Add AWS provider** - An [AWS cloud provider]({{< ref "/guides/operations/providers/aws-provider" >}}) allows you to deploy and manage AWS resources as part of your application. Follow the how-to guides to [configure the AWS provider]({{< ref "/guides/operations/providers/aws-provider/howto-aws-provider-access-key" >}}) with the preferred identity. +- **Add AWS provider** - An [AWS cloud provider]({{< ref "/guides/setup-platform/cloud-providers/aws-provider" >}}) allows you to deploy and manage AWS resources as part of your application. Follow the how-to guides to [configure the AWS provider]({{< ref "/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-access-key" >}}) with the preferred identity. - **Environment name** - The name of the environment to create. You can specify any name with lowercase letters, such as `myawsenv`. Select 'No' when asked to setup application in the current directory. @@ -66,7 +66,7 @@ Create a new file called `app.bicep` and add the following bicep code to model a {{< rad file="snippets/s3.bicep" embed=true >}} -Radius uses the [AWS Cloud Control API](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/what-is-cloudcontrolapi.html) to interact with AWS resources. This means that you can model your AWS resources in Bicep and Radius will be able to deploy and manage them. You can find the list of supported AWS resources in the [AWS resource library]({{< ref "guides/author-apps/aws/overview#resource-library" >}}). +Radius uses the [AWS Cloud Control API](https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/what-is-cloudcontrolapi.html) to interact with AWS resources. This means that you can model your AWS resources in Bicep and Radius will be able to deploy and manage them. You can find the list of supported AWS resources in the [AWS resource library]({{< ref "/guides/resource-types/aws/overview#resource-library" >}}). ## Step 5: Add a Radius container to interact with the AWS S3 Bucket diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/s3app.png b/docs/content/guides/resource-types/aws/howto-aws-resources/s3app.png similarity index 100% rename from docs/content/guides/author-apps/aws/howto-aws-resources/s3app.png rename to docs/content/guides/resource-types/aws/howto-aws-resources/s3app.png diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/s3appdiagram.png b/docs/content/guides/resource-types/aws/howto-aws-resources/s3appdiagram.png similarity index 100% rename from docs/content/guides/author-apps/aws/howto-aws-resources/s3appdiagram.png rename to docs/content/guides/resource-types/aws/howto-aws-resources/s3appdiagram.png diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/snippets/app.bicep b/docs/content/guides/resource-types/aws/howto-aws-resources/snippets/app.bicep similarity index 100% rename from docs/content/guides/author-apps/aws/howto-aws-resources/snippets/app.bicep rename to docs/content/guides/resource-types/aws/howto-aws-resources/snippets/app.bicep diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/snippets/s3.bicep b/docs/content/guides/resource-types/aws/howto-aws-resources/snippets/s3.bicep similarity index 100% rename from docs/content/guides/author-apps/aws/howto-aws-resources/snippets/s3.bicep rename to docs/content/guides/resource-types/aws/howto-aws-resources/snippets/s3.bicep diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/snippets/s3app.bicep b/docs/content/guides/resource-types/aws/howto-aws-resources/snippets/s3app.bicep similarity index 100% rename from docs/content/guides/author-apps/aws/howto-aws-resources/snippets/s3app.bicep rename to docs/content/guides/resource-types/aws/howto-aws-resources/snippets/s3app.bicep diff --git a/docs/content/guides/author-apps/aws/overview/index.md b/docs/content/guides/resource-types/aws/overview/index.md similarity index 84% rename from docs/content/guides/author-apps/aws/overview/index.md rename to docs/content/guides/resource-types/aws/overview/index.md index f4712d83e..47646d9d0 100644 --- a/docs/content/guides/author-apps/aws/overview/index.md +++ b/docs/content/guides/resource-types/aws/overview/index.md @@ -14,14 +14,14 @@ Radius uses the [AWS Cloud Control API](https://docs.aws.amazon.com/cloudcontrol ## Configure an AWS Provider -The AWS provider allows you to deploy and connect to AWS resources from a Radius Environment on an EKS cluster. To configure an AWS provider, you can follow the documentation [here]({{< ref "/guides/operations/providers/aws-provider" >}}). +The AWS provider allows you to deploy and connect to AWS resources from a Radius Environment on an EKS cluster. To configure an AWS provider, you can follow the documentation [here]({{< ref "/guides/setup-platform/cloud-providers/aws-provider" >}}). ## Example {{< tabs Bicep >}} {{% codetab %}} -In the following example, a [Container]({{< ref "guides/author-apps/containers" >}}) is connecting to an S3 bucket. +In the following example, a [Container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) is connecting to an S3 bucket. {{< rad file="snippets/aws.bicep" embed=true >}} {{% /codetab %}} diff --git a/docs/content/guides/author-apps/aws/overview/snippets/aws.bicep b/docs/content/guides/resource-types/aws/overview/snippets/aws.bicep similarity index 100% rename from docs/content/guides/author-apps/aws/overview/snippets/aws.bicep rename to docs/content/guides/resource-types/aws/overview/snippets/aws.bicep diff --git a/docs/content/guides/resource-types/azure/_index.md b/docs/content/guides/resource-types/azure/_index.md new file mode 100644 index 000000000..a468c89c4 --- /dev/null +++ b/docs/content/guides/resource-types/azure/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Azure Resource Types" +linkTitle: "Azure" +description: "Learn how to use Azure resource types in Radius" +weight: 500 +--- diff --git a/docs/content/guides/author-apps/azure/howto-azure-resources/icon.png b/docs/content/guides/resource-types/azure/howto-azure-resources/icon.png similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-resources/icon.png rename to docs/content/guides/resource-types/azure/howto-azure-resources/icon.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-resources/index.md b/docs/content/guides/resource-types/azure/howto-azure-resources/index.md similarity index 85% rename from docs/content/guides/author-apps/azure/howto-azure-resources/index.md rename to docs/content/guides/resource-types/azure/howto-azure-resources/index.md index 9a7aa49df..4dce65461 100644 --- a/docs/content/guides/author-apps/azure/howto-azure-resources/index.md +++ b/docs/content/guides/resource-types/azure/howto-azure-resources/index.md @@ -21,7 +21,7 @@ The steps below will showcase a "rad-ified" version of the existing [Azure AD wo - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - [Azure AD Workload Identity](https://azure.github.io/azure-workload-identity/docs/installation.html) installed in your cluster, including the [Mutating Admission Webhook](https://azure.github.io/azure-workload-identity/docs/installation/mutating-admission-webhook.html) ## Step 1: Initialize Radius @@ -42,13 +42,13 @@ More information on how to setup a `bicepconfig.json` can be found [here]({{< re ## Step 3: Define a Radius Environment -Create a file named `app.bicep` and define a Radius Environment with [identity property]({{< ref "/guides/deploy-apps/environments/overview" >}}) set. This configures your environment to use your Azure AD workload identity installation with your cluster's OIDC endpoint: +Create a file named `app.bicep` and define a Radius Environment with [identity property]({{< ref "/guides/setup-platform/environments/overview" >}}) set. This configures your environment to use your Azure AD workload identity installation with your cluster's OIDC endpoint: {{< rad file="snippets/container-wi.bicep" embed=true marker="//ENVIRONMENT">}} ## Step 4: Define an app and a container -Add a Radius Application, a Radius [container]({{< ref "guides/author-apps/containers" >}}), and an Azure Key Vault to your `app.bicep` file. Note the connection from the container to the Key Vault, with an iam property set for the Azure AD RBAC role: +Add a Radius Application, a Radius [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}), and an Azure Key Vault to your `app.bicep` file. Note the connection from the container to the Key Vault, with an iam property set for the Azure AD RBAC role: {{< rad file="snippets/container-wi.bicep" embed=true marker="//CONTAINER" >}} diff --git a/docs/content/guides/author-apps/azure/howto-azure-resources/snippets/container-wi.bicep b/docs/content/guides/resource-types/azure/howto-azure-resources/snippets/container-wi.bicep similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-resources/snippets/container-wi.bicep rename to docs/content/guides/resource-types/azure/howto-azure-resources/snippets/container-wi.bicep diff --git a/docs/content/guides/author-apps/azure/overview/index.md b/docs/content/guides/resource-types/azure/overview/index.md similarity index 68% rename from docs/content/guides/author-apps/azure/overview/index.md rename to docs/content/guides/resource-types/azure/overview/index.md index 00374cb1d..6325153a5 100644 --- a/docs/content/guides/author-apps/azure/overview/index.md +++ b/docs/content/guides/resource-types/azure/overview/index.md @@ -12,7 +12,7 @@ Radius Applications are able to connect to and leverage every Azure resource wit ## Configure an Azure Provider -The Azure provider allows you to deploy and connect to Azure resources from a Radius Environment on any of the [supported clusters]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}). To configure an Azure provider, you can follow the documentation [here]({{< ref "/guides/operations/providers/azure-provider" >}}). +The Azure provider allows you to deploy and connect to Azure resources from a Radius Environment on any of the [supported clusters]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}). To configure an Azure provider, you can follow the documentation [here]({{< ref "guides/setup-platform/cloud-providers/azure-provider" >}}). ## Resource library @@ -25,7 +25,7 @@ Visit [the Microsoft docs](https://docs.microsoft.com/azure/templates/) to refer {{< tabs Bicep >}} {{% codetab %}} -In the following example, a [Container]({{< ref "guides/author-apps/containers" >}}) is connecting to an Azure Cache for Redis resource. The Container is assigned the `Redis Cache Contributor` role: +In the following example, a [Container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) is connecting to an Azure Cache for Redis resource. The Container is assigned the `Redis Cache Contributor` role: {{< rad file="snippets/azure-connection.bicep" embed=true >}} {{% /codetab %}} diff --git a/docs/content/guides/author-apps/azure/overview/snippets/azure-connection.bicep b/docs/content/guides/resource-types/azure/overview/snippets/azure-connection.bicep similarity index 100% rename from docs/content/guides/author-apps/azure/overview/snippets/azure-connection.bicep rename to docs/content/guides/resource-types/azure/overview/snippets/azure-connection.bicep diff --git a/docs/content/guides/resource-types/core-resource-types/_index.md b/docs/content/guides/resource-types/core-resource-types/_index.md new file mode 100644 index 000000000..f18d5257e --- /dev/null +++ b/docs/content/guides/resource-types/core-resource-types/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Core Resource Types" +linkTitle: "Core Resource Types" +description: "Learn how to use core resource types available in Radius" +weight: 200 +--- \ No newline at end of file diff --git a/docs/content/guides/author-apps/containers/_index.md b/docs/content/guides/resource-types/core-resource-types/containers/_index.md similarity index 100% rename from docs/content/guides/author-apps/containers/_index.md rename to docs/content/guides/resource-types/core-resource-types/containers/_index.md diff --git a/docs/content/guides/author-apps/containers/howto-connect-dependencies/demo-with-redis-screenshot.png b/docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/demo-with-redis-screenshot.png similarity index 100% rename from docs/content/guides/author-apps/containers/howto-connect-dependencies/demo-with-redis-screenshot.png rename to docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/demo-with-redis-screenshot.png diff --git a/docs/content/guides/author-apps/containers/howto-connect-dependencies/index.md b/docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/index.md similarity index 85% rename from docs/content/guides/author-apps/containers/howto-connect-dependencies/index.md rename to docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/index.md index b39de88ac..383be7471 100644 --- a/docs/content/guides/author-apps/containers/howto-connect-dependencies/index.md +++ b/docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/index.md @@ -8,7 +8,7 @@ categories: "How-To" tags: ["containers"] --- -This how-to guide will teach how to connect to your dependencies via [connections]({{< ref "guides/author-apps/containers#connections" >}}) +This how-to guide will teach how to connect to your dependencies via [connections]({{< ref "guides/resource-types/core-resource-types/containers#connections" >}}) ## Prerequisites @@ -18,13 +18,13 @@ This how-to guide will teach how to connect to your dependencies via [connection ## Step 1: View the container definition -Open the `app.bicep` and view the [container]({{< ref "guides/author-apps/containers" >}}): +Open the `app.bicep` and view the [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}): {{< rad file="snippets/app.bicep" embed=true >}} ## Step 2: Add a Redis cache as a dependency -Next, add to `app.bicep` a [Redis cache]({{< ref "/guides/author-apps/portable-resources/overview" >}}), leveraging the default "local-dev" Recipe: +Next, add to `app.bicep` a [Redis cache]({{< ref "/guides/resource-types/portable-resource-types/overview" >}}), leveraging the default "local-dev" Recipe: {{< rad file="snippets/app-with-redis.bicep" embed=true marker="//DB" >}} @@ -88,5 +88,5 @@ rad app delete -a demo ## Further reading -- [Connections]({{< ref "guides/author-apps/containers/overview#connections" >}}) +- [Connections]({{< ref "guides/resource-types/core-resource-types/containers/overview#connections" >}}) - [Container schema]({{< ref container-schema >}}) diff --git a/docs/content/guides/author-apps/containers/howto-connect-dependencies/snippets/app-with-redis.bicep b/docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/snippets/app-with-redis.bicep similarity index 100% rename from docs/content/guides/author-apps/containers/howto-connect-dependencies/snippets/app-with-redis.bicep rename to docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/snippets/app-with-redis.bicep diff --git a/docs/content/guides/author-apps/containers/howto-connect-dependencies/snippets/app.bicep b/docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/snippets/app.bicep similarity index 100% rename from docs/content/guides/author-apps/containers/howto-connect-dependencies/snippets/app.bicep rename to docs/content/guides/resource-types/core-resource-types/containers/howto-connect-dependencies/snippets/app.bicep diff --git a/docs/content/guides/author-apps/containers/howto-keyvault-volume/icon.png b/docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/icon.png similarity index 100% rename from docs/content/guides/author-apps/containers/howto-keyvault-volume/icon.png rename to docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/icon.png diff --git a/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md b/docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/index.md similarity index 96% rename from docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md rename to docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/index.md index 698b476ee..ba5f1bafb 100644 --- a/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md +++ b/docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/index.md @@ -55,7 +55,7 @@ Add a Radius Application, an Azure Key Vault, and a Radius volume which uses the ## Step 5: Define an app, Key Vault, and volume -Now add a Radius [container]({{< ref "guides/author-apps/containers" >}}) with a volume mount for the Radius volume: +Now add a Radius [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) with a volume mount for the Radius volume: {{< rad file="snippets/keyvault-wi.bicep" embed=true marker="//CONTAINER" >}} diff --git a/docs/content/guides/author-apps/containers/howto-keyvault-volume/snippets/keyvault-wi.bicep b/docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/snippets/keyvault-wi.bicep similarity index 100% rename from docs/content/guides/author-apps/containers/howto-keyvault-volume/snippets/keyvault-wi.bicep rename to docs/content/guides/resource-types/core-resource-types/containers/howto-keyvault-volume/snippets/keyvault-wi.bicep diff --git a/docs/content/guides/author-apps/containers/howto-volumes/icon.png b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/icon.png similarity index 100% rename from docs/content/guides/author-apps/containers/howto-volumes/icon.png rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/icon.png diff --git a/docs/content/guides/author-apps/containers/howto-volumes/index.md b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/index.md similarity index 96% rename from docs/content/guides/author-apps/containers/howto-volumes/index.md rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/index.md index c12bf0a4d..dfd2af0ab 100644 --- a/docs/content/guides/author-apps/containers/howto-volumes/index.md +++ b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/index.md @@ -21,7 +21,7 @@ This how-to guide will provide an overview of how to: ## Step 1: Define an app and a container -Begin by creating a file named `app.bicep` with a Radius Application and [container]({{< ref "guides/author-apps/containers" >}}): +Begin by creating a file named `app.bicep` with a Radius Application and [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}): {{< rad file="snippets/1-app.bicep" embed=true >}} diff --git a/docs/content/guides/author-apps/containers/howto-volumes/screenshot-empty.jpg b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/screenshot-empty.jpg similarity index 100% rename from docs/content/guides/author-apps/containers/howto-volumes/screenshot-empty.jpg rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/screenshot-empty.jpg diff --git a/docs/content/guides/author-apps/containers/howto-volumes/screenshot-error.jpg b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/screenshot-error.jpg similarity index 100% rename from docs/content/guides/author-apps/containers/howto-volumes/screenshot-error.jpg rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/screenshot-error.jpg diff --git a/docs/content/guides/author-apps/containers/howto-volumes/screenshot.jpg b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/screenshot.jpg similarity index 100% rename from docs/content/guides/author-apps/containers/howto-volumes/screenshot.jpg rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/screenshot.jpg diff --git a/docs/content/guides/author-apps/containers/howto-volumes/snippets/1-app.bicep b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/snippets/1-app.bicep similarity index 100% rename from docs/content/guides/author-apps/containers/howto-volumes/snippets/1-app.bicep rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/snippets/1-app.bicep diff --git a/docs/content/guides/author-apps/containers/howto-volumes/snippets/2-app.bicep b/docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/snippets/2-app.bicep similarity index 100% rename from docs/content/guides/author-apps/containers/howto-volumes/snippets/2-app.bicep rename to docs/content/guides/resource-types/core-resource-types/containers/howto-volumes/snippets/2-app.bicep diff --git a/docs/content/guides/author-apps/containers/overview/containers-splash.png b/docs/content/guides/resource-types/core-resource-types/containers/overview/containers-splash.png similarity index 100% rename from docs/content/guides/author-apps/containers/overview/containers-splash.png rename to docs/content/guides/resource-types/core-resource-types/containers/overview/containers-splash.png diff --git a/docs/content/guides/author-apps/containers/overview/index.md b/docs/content/guides/resource-types/core-resource-types/containers/overview/index.md similarity index 92% rename from docs/content/guides/author-apps/containers/overview/index.md rename to docs/content/guides/resource-types/core-resource-types/containers/overview/index.md index 841e22674..212b5884b 100644 --- a/docs/content/guides/author-apps/containers/overview/index.md +++ b/docs/content/guides/resource-types/core-resource-types/containers/overview/index.md @@ -20,11 +20,11 @@ Radius containers are portable across container runtimes, allowing you to define ### Kubernetes -Containers are deployed to the same Kubernetes cluster as your Radius installation, into the namespace that is defined in your application. For more information on how Radius resources map to Kubernetes objects, refer to the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}). +Containers are deployed to the same Kubernetes cluster as your Radius installation, into the namespace that is defined in your application. For more information on how Radius resources map to Kubernetes objects, refer to the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/kubernetes/overview#resource-mapping" >}}). #### Customize Kubernetes configurations -Radius provides a way to apply custom Kubernetes configurations to container resources that are created by Radius. This allows you to make use of Kubernetes configurations or features that are not supported by Radius, yet remain composable with other Radius features like [Connections]({{< ref "guides/author-apps/containers/overview#connections" >}}). Additionally, it provides a way to migrate your existing Kubernetes applications into Radius without having to rewrite your Kubernetes configurations, while giving you the option to incrementally adopt Radius features over time. The customizations are applied to the container resource via the [`runtimes`]({{< ref "reference/resource-schema/core-schema/container-schema/_index.md#runtimes" >}}) property within the container resource definition. +Radius provides a way to apply custom Kubernetes configurations to container resources that are created by Radius. This allows you to make use of Kubernetes configurations or features that are not supported by Radius, yet remain composable with other Radius features like [Connections]({{< ref "/guides/resource-types/core-resource-types/containers/overview#connections" >}}). Additionally, it provides a way to migrate your existing Kubernetes applications into Radius without having to rewrite your Kubernetes configurations, while giving you the option to incrementally adopt Radius features over time. The customizations are applied to the container resource via the [`runtimes`]({{< ref "reference/resource-schema/core-schema/container-schema/_index.md#runtimes" >}}) property within the container resource definition. ##### Base Kubernetes YAML @@ -42,7 +42,7 @@ Radius currently supports the following Kubernetes resource types for the `base` ##### Pod patching -You can also "patch" the Kubernetes containers created and deployed by Radius using [PodSpec](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec) definitions. This allows for setting Kubernetes-specific configurations, as well as overriding Radius behaviors, which means that you may access all Kubernetes Pod features, even if they are not supported by Radius. For more information on how to patch Kubernetes pods, refer to the [Kubernetes pod patching guide]({{< ref "guides/author-apps/kubernetes/how-to-patch-pod" >}}). +You can also "patch" the Kubernetes containers created and deployed by Radius using [PodSpec](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec) definitions. This allows for setting Kubernetes-specific configurations, as well as overriding Radius behaviors, which means that you may access all Kubernetes Pod features, even if they are not supported by Radius. For more information on how to patch Kubernetes pods, refer to the [Kubernetes pod patching guide]({{< ref "guides/resource-types/kubernetes/how-to-patch-pod" >}}). ## Container definition @@ -105,7 +105,7 @@ For example, adding a connection called `database` that connects to a MongoDB re Alternatively, if you already have another convention you would like to follow or if you just prefer to be explicit, you may ignore the values generated by a connection and instead override it by setting your own environment variable values. - + ## Extensions diff --git a/docs/content/guides/author-apps/dapr/_index.md b/docs/content/guides/resource-types/core-resource-types/dapr/_index.md similarity index 100% rename from docs/content/guides/author-apps/dapr/_index.md rename to docs/content/guides/resource-types/core-resource-types/dapr/_index.md diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-building-block/app-statestore.png b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/app-statestore.png similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-building-block/app-statestore.png rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/app-statestore.png diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-building-block/index.md b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/index.md similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-building-block/index.md rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/index.md diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-building-block/snippets/app-sidecar.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/snippets/app-sidecar.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-building-block/snippets/app-sidecar.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/snippets/app-sidecar.bicep diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-building-block/snippets/app-statestore.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/snippets/app-statestore.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-building-block/snippets/app-statestore.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-building-block/snippets/app-statestore.bicep diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-secrets/index.md b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-secrets/index.md similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-secrets/index.md rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-secrets/index.md diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-secrets/snippets/app-statestore-secret.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-secrets/snippets/app-statestore-secret.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-secrets/snippets/app-statestore-secret.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-secrets/snippets/app-statestore-secret.bicep diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-secrets/snippets/app-statestore.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-secrets/snippets/app-statestore.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-secrets/snippets/app-statestore.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-secrets/snippets/app-statestore.bicep diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/index.md similarity index 90% rename from docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/index.md index fd3cb78fa..20981e73a 100644 --- a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md +++ b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/index.md @@ -14,7 +14,7 @@ This how-to guide will provide an overview of how to: ## Prerequisites -- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}) - [rad CLI]({{< ref getting-started >}}) - [Dapr CLI](https://docs.dapr.io/getting-started/install-dapr-cli/) - [Radius initialized with `rad init`]({{< ref howto-environment >}}) @@ -22,7 +22,7 @@ This how-to guide will provide an overview of how to: ## Step 1: Start with a container -Begin by creating a file named `app.bicep` with a Radius [container]({{< ref "guides/author-apps/containers" >}}): +Begin by creating a file named `app.bicep` with a Radius [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}): {{< rad file="snippets/app.bicep" embed=true >}} @@ -84,5 +84,5 @@ Run the following command to [delete]({{< ref "guides/deploy-apps/howto-delete" ## Further reading - [Radius Dapr tutorial]({{< ref "tutorials/tutorial-dapr" >}}) -- [Dapr in Radius containers]({{< ref "guides/author-apps/containers/overview#kubernetes" >}}) +- [Dapr in Radius containers]({{< ref "/guides/resource-types/core-resource-types/containers/overview#kubernetes" >}}) - [Dapr sidecar schema]({{< ref "reference/resource-schema/dapr-schema/dapr-extension" >}}) \ No newline at end of file diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/snippets/app-sidecar.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/snippets/app-sidecar.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/snippets/app-sidecar.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/snippets/app-sidecar.bicep diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/snippets/app.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/snippets/app.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/snippets/app.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/how-to-dapr-sidecar/snippets/app.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/dapr-buildingblocks.png b/docs/content/guides/resource-types/core-resource-types/dapr/overview/dapr-buildingblocks.png similarity index 100% rename from docs/content/guides/author-apps/dapr/overview/dapr-buildingblocks.png rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/dapr-buildingblocks.png diff --git a/docs/content/guides/author-apps/dapr/overview/dapr-sidecar.png b/docs/content/guides/resource-types/core-resource-types/dapr/overview/dapr-sidecar.png similarity index 100% rename from docs/content/guides/author-apps/dapr/overview/dapr-sidecar.png rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/dapr-sidecar.png diff --git a/docs/content/guides/author-apps/dapr/overview/index.md b/docs/content/guides/resource-types/core-resource-types/dapr/overview/index.md similarity index 97% rename from docs/content/guides/author-apps/dapr/overview/index.md rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/index.md index c26f7668e..eb20c0bc8 100644 --- a/docs/content/guides/author-apps/dapr/overview/index.md +++ b/docs/content/guides/resource-types/core-resource-types/dapr/overview/index.md @@ -22,7 +22,7 @@ A [Dapr sidecar](https://docs.dapr.io/concepts/dapr-services/sidecar/) allows yo {{< image src="dapr-sidecar.png" style="width:600px" alt="Diagram of the Dapr sidecar" >}}
-You can easily add the Dapr sidecar to your [Containers]({{< ref "guides/author-apps/containers" >}}) using a Dapr sidecar extension: +You can easily add the Dapr sidecar to your [Containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}) using a Dapr sidecar extension: {{< tabs Bicep >}} diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/dapr-componentname.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/dapr-componentname.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/overview/snippets/dapr-componentname.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/dapr-componentname.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/service-invocation.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/service-invocation.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/overview/snippets/service-invocation.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/service-invocation.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/sidecar.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/sidecar.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/overview/snippets/sidecar.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/sidecar.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/statestore.bicep b/docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/statestore.bicep similarity index 100% rename from docs/content/guides/author-apps/dapr/overview/snippets/statestore.bicep rename to docs/content/guides/resource-types/core-resource-types/dapr/overview/snippets/statestore.bicep diff --git a/docs/content/guides/author-apps/networking/_index.md b/docs/content/guides/resource-types/core-resource-types/networking/_index.md similarity index 100% rename from docs/content/guides/author-apps/networking/_index.md rename to docs/content/guides/resource-types/core-resource-types/networking/_index.md diff --git a/docs/content/guides/author-apps/networking/howto-gateways/demo-screenshot.png b/docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/demo-screenshot.png similarity index 100% rename from docs/content/guides/author-apps/networking/howto-gateways/demo-screenshot.png rename to docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/demo-screenshot.png diff --git a/docs/content/guides/author-apps/networking/howto-gateways/index.md b/docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/index.md similarity index 95% rename from docs/content/guides/author-apps/networking/howto-gateways/index.md rename to docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/index.md index aa053a75a..6c77eb43c 100644 --- a/docs/content/guides/author-apps/networking/howto-gateways/index.md +++ b/docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/index.md @@ -72,5 +72,5 @@ rad app delete gatewaydemo -y ## Further reading -- [Networking overview]({{< ref "/guides/author-apps/networking/overview" >}}) +- [Networking overview]({{< ref "/guides/resource-types/core-resource-types/networking/overview" >}}) - [Gateway reference]({{< ref "/reference/resource-schema/core-schema/gateway" >}}) diff --git a/docs/content/guides/author-apps/networking/howto-gateways/snippets/app.bicep b/docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/snippets/app.bicep similarity index 100% rename from docs/content/guides/author-apps/networking/howto-gateways/snippets/app.bicep rename to docs/content/guides/resource-types/core-resource-types/networking/howto-gateways/snippets/app.bicep diff --git a/docs/content/guides/author-apps/networking/howto-service-networking/backend-connection.png b/docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/backend-connection.png similarity index 100% rename from docs/content/guides/author-apps/networking/howto-service-networking/backend-connection.png rename to docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/backend-connection.png diff --git a/docs/content/guides/author-apps/networking/howto-service-networking/index.md b/docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/index.md similarity index 100% rename from docs/content/guides/author-apps/networking/howto-service-networking/index.md rename to docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/index.md diff --git a/docs/content/guides/author-apps/networking/howto-service-networking/overview.png b/docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/overview.png similarity index 100% rename from docs/content/guides/author-apps/networking/howto-service-networking/overview.png rename to docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/overview.png diff --git a/docs/content/guides/author-apps/networking/howto-service-networking/snippets/1-app.bicep b/docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/snippets/1-app.bicep similarity index 100% rename from docs/content/guides/author-apps/networking/howto-service-networking/snippets/1-app.bicep rename to docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/snippets/1-app.bicep diff --git a/docs/content/guides/author-apps/networking/howto-service-networking/snippets/2-app.bicep b/docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/snippets/2-app.bicep similarity index 100% rename from docs/content/guides/author-apps/networking/howto-service-networking/snippets/2-app.bicep rename to docs/content/guides/resource-types/core-resource-types/networking/howto-service-networking/snippets/2-app.bicep diff --git a/docs/content/guides/author-apps/networking/howto-tls/https-app.png b/docs/content/guides/resource-types/core-resource-types/networking/howto-tls/https-app.png similarity index 100% rename from docs/content/guides/author-apps/networking/howto-tls/https-app.png rename to docs/content/guides/resource-types/core-resource-types/networking/howto-tls/https-app.png diff --git a/docs/content/guides/author-apps/networking/howto-tls/index.md b/docs/content/guides/resource-types/core-resource-types/networking/howto-tls/index.md similarity index 93% rename from docs/content/guides/author-apps/networking/howto-tls/index.md rename to docs/content/guides/resource-types/core-resource-types/networking/howto-tls/index.md index d03221824..fe8a6daf1 100644 --- a/docs/content/guides/author-apps/networking/howto-tls/index.md +++ b/docs/content/guides/resource-types/core-resource-types/networking/howto-tls/index.md @@ -27,7 +27,7 @@ Begin by creating a file named `app.bicep`. Add a container which will be expose ## Step 2: Add a secret store -TLS certificates need to be referenced via a Radius [secret store]({{< ref "/guides/author-apps/secrets" >}}). You can either reference an existing secret, or define a new one with certificate data. +TLS certificates need to be referenced via a Radius [secret store]({{< ref "/guides/resource-types/core-resource-types/secrets" >}}). You can either reference an existing secret, or define a new one with certificate data. {{< tabs "Reference existing secrets" "Define new secrets" >}} @@ -115,5 +115,5 @@ rad app delete tlsdemo -y ## Further reading -- [Networking overview]({{< ref "/guides/author-apps/networking/overview" >}}) +- [Networking overview]({{< ref "/guides/resource-types/core-resource-types/networking/overview" >}}) - [Gateway reference]({{< ref "/reference/resource-schema/core-schema/gateway" >}}) diff --git a/docs/content/guides/author-apps/networking/howto-tls/snippets/app-existing.bicep b/docs/content/guides/resource-types/core-resource-types/networking/howto-tls/snippets/app-existing.bicep similarity index 100% rename from docs/content/guides/author-apps/networking/howto-tls/snippets/app-existing.bicep rename to docs/content/guides/resource-types/core-resource-types/networking/howto-tls/snippets/app-existing.bicep diff --git a/docs/content/guides/author-apps/networking/howto-tls/snippets/app-new.bicep b/docs/content/guides/resource-types/core-resource-types/networking/howto-tls/snippets/app-new.bicep similarity index 100% rename from docs/content/guides/author-apps/networking/howto-tls/snippets/app-new.bicep rename to docs/content/guides/resource-types/core-resource-types/networking/howto-tls/snippets/app-new.bicep diff --git a/docs/content/guides/author-apps/networking/overview/index.md b/docs/content/guides/resource-types/core-resource-types/networking/overview/index.md similarity index 100% rename from docs/content/guides/author-apps/networking/overview/index.md rename to docs/content/guides/resource-types/core-resource-types/networking/overview/index.md diff --git a/docs/content/guides/author-apps/networking/overview/network-connection.png b/docs/content/guides/resource-types/core-resource-types/networking/overview/network-connection.png similarity index 100% rename from docs/content/guides/author-apps/networking/overview/network-connection.png rename to docs/content/guides/resource-types/core-resource-types/networking/overview/network-connection.png diff --git a/docs/content/guides/author-apps/networking/overview/networking.png b/docs/content/guides/resource-types/core-resource-types/networking/overview/networking.png similarity index 100% rename from docs/content/guides/author-apps/networking/overview/networking.png rename to docs/content/guides/resource-types/core-resource-types/networking/overview/networking.png diff --git a/docs/content/guides/author-apps/secrets/_index.md b/docs/content/guides/resource-types/core-resource-types/secrets/_index.md similarity index 100% rename from docs/content/guides/author-apps/secrets/_index.md rename to docs/content/guides/resource-types/core-resource-types/secrets/_index.md diff --git a/docs/content/guides/author-apps/secrets/howto-new-secretstore/index.md b/docs/content/guides/resource-types/core-resource-types/secrets/howto-new-secretstore/index.md similarity index 100% rename from docs/content/guides/author-apps/secrets/howto-new-secretstore/index.md rename to docs/content/guides/resource-types/core-resource-types/secrets/howto-new-secretstore/index.md diff --git a/docs/content/guides/author-apps/secrets/howto-new-secretstore/snippets/secretstore.bicep b/docs/content/guides/resource-types/core-resource-types/secrets/howto-new-secretstore/snippets/secretstore.bicep similarity index 100% rename from docs/content/guides/author-apps/secrets/howto-new-secretstore/snippets/secretstore.bicep rename to docs/content/guides/resource-types/core-resource-types/secrets/howto-new-secretstore/snippets/secretstore.bicep diff --git a/docs/content/guides/author-apps/secrets/overview/index.md b/docs/content/guides/resource-types/core-resource-types/secrets/overview/index.md similarity index 86% rename from docs/content/guides/author-apps/secrets/overview/index.md rename to docs/content/guides/resource-types/core-resource-types/secrets/overview/index.md index 8a4e1f9fa..c05c9fb7e 100644 --- a/docs/content/guides/author-apps/secrets/overview/index.md +++ b/docs/content/guides/resource-types/core-resource-types/secrets/overview/index.md @@ -17,7 +17,7 @@ An independent resource with its own lifecycle, a Radius Secret Store ensures th ## Create a new Secret Store Radius leverages the secrets management solution available on the hosting platform to create and store the secret. For example, if you are deploying to Kubernetes, the secret will be created in Kubernetes Secrets. -Follow the [how-to guide on creating new secret store]({{< ref "/guides/author-apps/secrets/howto-new-secretstore" >}}) to learn more about creating a new secret store resource and storing a TLS certificate in it. +Follow the [how-to guide on creating new secret store]({{< ref "/guides/resource-types/core-resource-types/secrets/howto-new-secretstore" >}}) to learn more about creating a new secret store resource and storing a TLS certificate in it. ## Reference an existing Secret Store @@ -25,7 +25,7 @@ You can also reference an existing secrets management solution that is external ## Using Secret Stores -Secret Stores can currently be used for TLS certificates with [Radius Gateways]({{< ref "guides/author-apps/networking/overview#gateways" >}}). +Secret Stores can currently be used for TLS certificates with [Radius Gateways]({{< ref "/guides/resource-types/core-resource-types/networking/overview#gateways" >}}). Additional use-cases will be added in upcoming releases. diff --git a/docs/content/guides/author-apps/secrets/overview/snippets/secretstore.bicep b/docs/content/guides/resource-types/core-resource-types/secrets/overview/snippets/secretstore.bicep similarity index 100% rename from docs/content/guides/author-apps/secrets/overview/snippets/secretstore.bicep rename to docs/content/guides/resource-types/core-resource-types/secrets/overview/snippets/secretstore.bicep diff --git a/docs/content/guides/resource-types/custom-resource-types/_index.md b/docs/content/guides/resource-types/custom-resource-types/_index.md new file mode 100644 index 000000000..887e2eb47 --- /dev/null +++ b/docs/content/guides/resource-types/custom-resource-types/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Custom resource types" +linkTitle: "Custom resource types" +description: "Learn how to create your own resource types" +weight: 300 +--- \ No newline at end of file diff --git a/docs/content/guides/resource-types/kubernetes/_index.md b/docs/content/guides/resource-types/kubernetes/_index.md new file mode 100644 index 000000000..7f92614f6 --- /dev/null +++ b/docs/content/guides/resource-types/kubernetes/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Kubernetes" +linkTitle: "Kubernetes" +description: "Learn how to use Kubernetes resource types in Radius" +weight: 400 +--- \ No newline at end of file diff --git a/docs/content/guides/author-apps/kubernetes/how-to-access-secrets/index.md b/docs/content/guides/resource-types/kubernetes/how-to-access-secrets/index.md similarity index 95% rename from docs/content/guides/author-apps/kubernetes/how-to-access-secrets/index.md rename to docs/content/guides/resource-types/kubernetes/how-to-access-secrets/index.md index f23a86ad1..8676d3b55 100644 --- a/docs/content/guides/author-apps/kubernetes/how-to-access-secrets/index.md +++ b/docs/content/guides/resource-types/kubernetes/how-to-access-secrets/index.md @@ -21,7 +21,7 @@ This how-to guide will provide an overview of how to: ## Step 1: Define a container -Begin by creating a file named `app.bicep` with a Radius [container]({{< ref "guides/author-apps/containers" >}}): +Begin by creating a file named `app.bicep` with a Radius [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}): {{< rad file="snippets/secrets-container.bicep" embed=true >}} @@ -145,5 +145,5 @@ rad app delete demo ## Further reading -- [Kubernetes in Radius containers]({{< ref "guides/author-apps/containers/overview#kubernetes" >}}) +- [Kubernetes in Radius containers]({{< ref "/guides/resource-types/core-resource-types/containers/overview#kubernetes" >}}) - [PodSpec in Radius containers]({{< ref "reference/resource-schema/core-schema/container-schema#runtimes" >}}) \ No newline at end of file diff --git a/docs/content/guides/author-apps/kubernetes/how-to-access-secrets/snippets/secrets-container.bicep b/docs/content/guides/resource-types/kubernetes/how-to-access-secrets/snippets/secrets-container.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-access-secrets/snippets/secrets-container.bicep rename to docs/content/guides/resource-types/kubernetes/how-to-access-secrets/snippets/secrets-container.bicep diff --git a/docs/content/guides/author-apps/kubernetes/how-to-access-secrets/snippets/secrets-patch.bicep b/docs/content/guides/resource-types/kubernetes/how-to-access-secrets/snippets/secrets-patch.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-access-secrets/snippets/secrets-patch.bicep rename to docs/content/guides/resource-types/kubernetes/how-to-access-secrets/snippets/secrets-patch.bicep diff --git a/docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/demo-secret-object.png b/docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/demo-secret-object.png similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/demo-secret-object.png rename to docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/demo-secret-object.png diff --git a/docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/index.md b/docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/index.md similarity index 89% rename from docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/index.md rename to docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/index.md index 2d272f075..e9cf633c0 100644 --- a/docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/index.md +++ b/docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/index.md @@ -32,11 +32,11 @@ Add a [Kubernetes secret](https://kubernetes.io/docs/concepts/configuration/secr {{< rad file="snippets/app-kubernetes.bicep" embed=true marker="//SECRET" >}} -> Refer to the [Kubernetes overview page]({{< ref "/guides/author-apps/kubernetes/overview#resource-library" >}}) for additional information about available types. +> Refer to the [Kubernetes overview page]({{< ref "/guides/resource-types/kubernetes/overview#resource-library" >}}) for additional information about available types. ## Step 3: Add a container and use the secret you just defined -Add a Radius [container]({{< ref "guides/author-apps/containers" >}}) to your application: +Add a Radius [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) to your application: {{< rad file="snippets/app-kubernetes.bicep" embed=true marker="//APPLICATION" >}} @@ -115,4 +115,4 @@ secret "my-secret" deleted ## Further reading -- [Kubernetes in Radius containers]({{< ref "guides/author-apps/containers/overview#kubernetes" >}}) +- [Kubernetes in Radius containers]({{< ref "/guides/resource-types/core-resource-types/containers/overview#kubernetes" >}}) diff --git a/docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/snippets/app-kubernetes.bicep b/docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/snippets/app-kubernetes.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/snippets/app-kubernetes.bicep rename to docs/content/guides/resource-types/kubernetes/how-to-kubernetes-resource/snippets/app-kubernetes.bicep diff --git a/docs/content/guides/author-apps/kubernetes/how-to-patch-pod/demoapp-howtopatchpod.png b/docs/content/guides/resource-types/kubernetes/how-to-patch-pod/demoapp-howtopatchpod.png similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-patch-pod/demoapp-howtopatchpod.png rename to docs/content/guides/resource-types/kubernetes/how-to-patch-pod/demoapp-howtopatchpod.png diff --git a/docs/content/guides/author-apps/kubernetes/how-to-patch-pod/index.md b/docs/content/guides/resource-types/kubernetes/how-to-patch-pod/index.md similarity index 96% rename from docs/content/guides/author-apps/kubernetes/how-to-patch-pod/index.md rename to docs/content/guides/resource-types/kubernetes/how-to-patch-pod/index.md index 65afeaeb5..ff94b1b53 100644 --- a/docs/content/guides/author-apps/kubernetes/how-to-patch-pod/index.md +++ b/docs/content/guides/resource-types/kubernetes/how-to-patch-pod/index.md @@ -21,7 +21,7 @@ This how-to guide will provide an overview of how to: ## Step 1: Define a container -Begin by creating a file named `app.bicep` with a Radius [container]({{< ref "guides/author-apps/containers" >}}): +Begin by creating a file named `app.bicep` with a Radius [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}): {{< rad file="snippets/patch-container.bicep" embed=true >}} @@ -132,5 +132,5 @@ Run the following command to [delete]({{< ref "guides/deploy-apps/howto-delete" ## Further reading -- [Kubernetes in Radius containers]({{< ref "guides/author-apps/containers/overview#kubernetes" >}}) +- [Kubernetes in Radius containers]({{< ref "/guides/resource-types/core-resource-types/containers/overview#kubernetes" >}}) - [PodSpec in Radius containers]({{< ref "reference/resource-schema/core-schema/container-schema#runtimes" >}}) \ No newline at end of file diff --git a/docs/content/guides/author-apps/kubernetes/how-to-patch-pod/snippets/patch-container.bicep b/docs/content/guides/resource-types/kubernetes/how-to-patch-pod/snippets/patch-container.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-patch-pod/snippets/patch-container.bicep rename to docs/content/guides/resource-types/kubernetes/how-to-patch-pod/snippets/patch-container.bicep diff --git a/docs/content/guides/author-apps/kubernetes/how-to-patch-pod/snippets/patch-runtime.bicep b/docs/content/guides/resource-types/kubernetes/how-to-patch-pod/snippets/patch-runtime.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/how-to-patch-pod/snippets/patch-runtime.bicep rename to docs/content/guides/resource-types/kubernetes/how-to-patch-pod/snippets/patch-runtime.bicep diff --git a/docs/content/guides/author-apps/kubernetes/overview/index.md b/docs/content/guides/resource-types/kubernetes/overview/index.md similarity index 100% rename from docs/content/guides/author-apps/kubernetes/overview/index.md rename to docs/content/guides/resource-types/kubernetes/overview/index.md diff --git a/docs/content/guides/author-apps/kubernetes/overview/snippets/kubernetes-connection.bicep b/docs/content/guides/resource-types/kubernetes/overview/snippets/kubernetes-connection.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/overview/snippets/kubernetes-connection.bicep rename to docs/content/guides/resource-types/kubernetes/overview/snippets/kubernetes-connection.bicep diff --git a/docs/content/guides/author-apps/kubernetes/overview/snippets/kubernetes-resource.bicep b/docs/content/guides/resource-types/kubernetes/overview/snippets/kubernetes-resource.bicep similarity index 100% rename from docs/content/guides/author-apps/kubernetes/overview/snippets/kubernetes-resource.bicep rename to docs/content/guides/resource-types/kubernetes/overview/snippets/kubernetes-resource.bicep diff --git a/docs/content/guides/resource-types/overview/index.md b/docs/content/guides/resource-types/overview/index.md new file mode 100644 index 000000000..59b337429 --- /dev/null +++ b/docs/content/guides/resource-types/overview/index.md @@ -0,0 +1,36 @@ +--- +type: docs +title: "Overview: Radius Resource Types" +linkTitle: "Overview" +description: " Learn about the Radius Resource types" +weight: 100 +--- + +Radius resource types define resources in the Radius Application. These are abstractions that provides a consistent interface for deploying and managing resources irrespective of the underlying platform or runtime. They are used to model the different components of your application, such as containers, gateways, databases, and queues. Each resource type has its own namespace, API versions, properties and other metadata that define how the resource behaves and interacts with other resources. Radius provides a set of built-in core resource types that cover common use cases, but you can also create your own custom resource types to meet your specific needs. + +## Core Resource Types + +The core resource types are the built-in resource types that are provided by Radius out of the box. They provide the basic functionality needed for your application. The core resource types include: + +1. [Containers]({{< ref "/guides/resource-types/core-resource-types/containers" >}}) +2. [Gateways]({{< ref "/guides/resource-types/core-resource-types/networking" >}}) +3. [Secrets]({{< ref "/guides/resource-types/core-resource-types/secrets" >}}) +4. [Dapr]({{< ref "/guides/resource-types/core-resource-types/dapr" >}}) + +You can use them as part of your applications or extend them with custom resource types. These resource types don't require a [Recipe]({{< ref "/guides/recipes/overview" >}}) to deploy the backing infrastructure and are deployed by Radius. They can also be embedded inside Recipes when defining composite resource types. + +## Custom resource types + +Custom resource types allow you to define and create your own resource types that are specific to your application. They provide a way to extend the functionality of Radius and create resources that are tailored to your specific needs. You can model your own resource type using the same principles as the core resource types, but you have the flexibility to define your own properties, API versions, and other metadata. More information on custom resource types can be found in the [Custom Resource Types guide]({{< ref "/guides/resource-types/custom-resource-types" >}}). + +## Portable resource types + +Portable resource types are sample resource types designed to be used across different cloud providers. They provide a consistent interface for managing resources, regardless of the underlying cloud provider. More information on portable resource types can be found in the [Portable Resource Types guide]({{< ref "/guides/resource-types/portable-resource-types" >}}). + +## Other Resource Types + +There are other resource types that are platform specific and can be used to manage resources on specific cloud providers or platforms. They are designed to work specifically with the respective provider APIs. These include + +- [Kubernetes](<{{ ref "/guides/resource-types/kubernetes" >}})>) +- [AWS](<{{ ref "/guides/resource-types/aws" >}}>) +- [Azure](<{{ ref "/guides/resource-types/azure" >}}>) diff --git a/docs/content/guides/author-apps/portable-resources/_index.md b/docs/content/guides/resource-types/portable-resource-types/_index.md similarity index 53% rename from docs/content/guides/author-apps/portable-resources/_index.md rename to docs/content/guides/resource-types/portable-resource-types/_index.md index 0b08da29a..c61a7d054 100644 --- a/docs/content/guides/author-apps/portable-resources/_index.md +++ b/docs/content/guides/resource-types/portable-resource-types/_index.md @@ -1,8 +1,8 @@ --- type: docs -title: "Radius portable resources" -linkTitle: "Portable Resources" +title: "Radius Portable Resource Types" +linkTitle: "Portable Resource Types" description: "Learn how to make your applications portable" -weight: 400 +weight: 700 tags: ["portability"] --- diff --git a/docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/demo-with-redis-screenshot.png b/docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/demo-with-redis-screenshot.png similarity index 100% rename from docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/demo-with-redis-screenshot.png rename to docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/demo-with-redis-screenshot.png diff --git a/docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/index.md b/docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/index.md similarity index 96% rename from docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/index.md rename to docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/index.md index 415983eeb..091dd74c4 100644 --- a/docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/index.md +++ b/docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/index.md @@ -74,5 +74,5 @@ rad app delete -a demo ## Further reading -- [Portable resource overview]({{< ref "/guides/author-apps/portable-resources/overview" >}}) +- [Portable resource overview]({{< ref "/guides/resource-types/portable-resource-types/overview" >}}) - [Radius Application overview]({{< ref "/guides/author-apps/application/overview" >}}) diff --git a/docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/snippets/app-redis-manual.bicep b/docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/snippets/app-redis-manual.bicep similarity index 100% rename from docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/snippets/app-redis-manual.bicep rename to docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/snippets/app-redis-manual.bicep diff --git a/docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/snippets/app-redis-recipe.bicep b/docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/snippets/app-redis-recipe.bicep similarity index 100% rename from docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/snippets/app-redis-recipe.bicep rename to docs/content/guides/resource-types/portable-resource-types/howto-author-portable-resources/snippets/app-redis-recipe.bicep diff --git a/docs/content/guides/author-apps/portable-resources/overview/index.md b/docs/content/guides/resource-types/portable-resource-types/overview/index.md similarity index 73% rename from docs/content/guides/author-apps/portable-resources/overview/index.md rename to docs/content/guides/resource-types/portable-resource-types/overview/index.md index 5070a072f..2b470f1b6 100644 --- a/docs/content/guides/author-apps/portable-resources/overview/index.md +++ b/docs/content/guides/resource-types/portable-resource-types/overview/index.md @@ -1,6 +1,6 @@ --- type: docs -title: "Overview: Portable Resources" +title: "Overview: Portable Resource Types" linkTitle: "Overview" description: "Add portable resources to your Radius Application for infrastructure portability" weight: 100 @@ -10,13 +10,13 @@ tags: ["portability"] ## Overview -Portable resources provide **abstraction** and **portability** to Radius Applications. This allows development teams to depend on high level resource types and APIs, and let infra teams swap out the underlying resource and configuration. +Portable resource types provide **abstraction** and **portability** to Radius Applications. This allows development teams to depend on high level resource types and APIs, and let infra teams swap out the underlying resource and configuration. {{< image src="portable-resources.png" alt="Diagram of portable resources connecting to Azure CosmosDB, AWS MongoDB, and a MongoDB Docker container" width=700px >}} ## Available resources -The following portable resources are available to use within your application: +The following portable resource types are available to use within your application: - [`Applications.Core/extenders`]({{< ref api-extenders >}}) - [`Applications.Datastores/mongoDatabases`]({{< ref api-mongodatabases >}}) @@ -29,4 +29,4 @@ The following portable resources are available to use within your application: ## Reference -Refer to the [API reference docs]({{< ref "/concepts/technical/api" >}}) to learn more about the Radius API and the available portable resources plus their schema \ No newline at end of file +Refer to the [API reference docs]({{< ref "/concepts/technical/api" >}}) to learn more about the Radius API and the available portable resource types plus their schema \ No newline at end of file diff --git a/docs/content/guides/author-apps/portable-resources/overview/portable-resources.png b/docs/content/guides/resource-types/portable-resource-types/overview/portable-resources.png similarity index 100% rename from docs/content/guides/author-apps/portable-resources/overview/portable-resources.png rename to docs/content/guides/resource-types/portable-resource-types/overview/portable-resources.png diff --git a/docs/content/guides/setup-platform/_index.md b/docs/content/guides/setup-platform/_index.md new file mode 100644 index 000000000..c5c4301c1 --- /dev/null +++ b/docs/content/guides/setup-platform/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Setup Platform" +linkTitle: "Setup Platform" +description: "Learn how to set up the platform with Radius" +weight: 200 +--- diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/_index.md b/docs/content/guides/setup-platform/cloud-providers/_index.md similarity index 92% rename from docs/content/guides/setup-platform/setup-cloud-providers/_index.md rename to docs/content/guides/setup-platform/cloud-providers/_index.md index 4596372b2..35913a07e 100644 --- a/docs/content/guides/setup-platform/setup-cloud-providers/_index.md +++ b/docs/content/guides/setup-platform/cloud-providers/_index.md @@ -3,5 +3,5 @@ type: docs title: "Cloud providers" linkTitle: "Cloud providers" description: "Deploy across clouds and platforms with Radius cloud providers" -weight: 300 +weight: 500 --- diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/_index.md b/docs/content/guides/setup-platform/cloud-providers/aws-provider/_index.md similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/_index.md rename to docs/content/guides/setup-platform/cloud-providers/aws-provider/_index.md diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-access-key/index.md b/docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-access-key/index.md similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-access-key/index.md rename to docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-access-key/index.md diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/create-role.png b/docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/create-role.png similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/create-role.png rename to docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/create-role.png diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png b/docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png rename to docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/get-role-arn.png diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/index.md b/docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/index.md similarity index 99% rename from docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/index.md rename to docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/index.md index 7dd172034..9fad66222 100644 --- a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/index.md +++ b/docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/index.md @@ -18,7 +18,7 @@ The AWS provider allows you to deploy and connect to AWS resources from a Radius - [AWS account](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account) and an [IAM user](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) - [Setup AWS CLI with your AWS credentials. ](https://docs.aws.amazon.com/cli/latest/reference/configure/) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - You will need the cluster's OIDC Issuer URL. [EKS Example](https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html) - [Create an IAM Policy](https://docs.aws.amazon.com/eks/latest/userguide/associate-service-account-role.html) diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png b/docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png rename to docs/content/guides/setup-platform/cloud-providers/aws-provider/howto-aws-provider-irsa/select-trust-entity.png diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/_index.md b/docs/content/guides/setup-platform/cloud-providers/azure-provider/_index.md similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/_index.md rename to docs/content/guides/setup-platform/cloud-providers/azure-provider/_index.md diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-sp/index.md b/docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-sp/index.md similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-sp/index.md rename to docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-sp/index.md diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/index.md b/docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-wi/index.md similarity index 98% rename from docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/index.md rename to docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-wi/index.md index e9781643d..b51cf2bc4 100644 --- a/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/index.md +++ b/docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-wi/index.md @@ -18,7 +18,7 @@ The Azure provider allows you to deploy and connect to Azure resources from a se - [Azure subscription](https://azure.com) - [az CLI](https://aka.ms/azcli) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - You will need the cluster's OIDC Issuer URL. [AKS Example](https://azure.github.io/azure-workload-identity/docs/installation/managed-clusters.html#azure-kubernetes-service-aks) - [Azure AD Workload Identity](https://azure.github.io/azure-workload-identity/docs/installation.html) installed in your cluster, including the [Mutating Admission Webhook](https://azure.github.io/azure-workload-identity/docs/installation/mutating-admission-webhook.html) diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh b/docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh rename to docs/content/guides/setup-platform/cloud-providers/azure-provider/howto-azure-provider-wi/snippets/install-radius-azwi.sh diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/overview/index.md b/docs/content/guides/setup-platform/cloud-providers/overview/index.md similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/overview/index.md rename to docs/content/guides/setup-platform/cloud-providers/overview/index.md diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/overview/provider.svg b/docs/content/guides/setup-platform/cloud-providers/overview/provider.svg similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/overview/provider.svg rename to docs/content/guides/setup-platform/cloud-providers/overview/provider.svg diff --git a/docs/content/guides/deploy-apps/environments/overview/providers-overview.png b/docs/content/guides/setup-platform/cloud-providers/overview/providers-overview.png similarity index 100% rename from docs/content/guides/deploy-apps/environments/overview/providers-overview.png rename to docs/content/guides/setup-platform/cloud-providers/overview/providers-overview.png diff --git a/docs/content/guides/deploy-apps/environments/_index.md b/docs/content/guides/setup-platform/environments/_index.md similarity index 92% rename from docs/content/guides/deploy-apps/environments/_index.md rename to docs/content/guides/setup-platform/environments/_index.md index c345ea6b3..d9f47315b 100644 --- a/docs/content/guides/deploy-apps/environments/_index.md +++ b/docs/content/guides/setup-platform/environments/_index.md @@ -3,7 +3,7 @@ type: docs title: "Radius Environments" linkTitle: "Environments" description: "Learn about Radius Environments" -weight: 200 +weight: 400 tags: ["environments"] --- diff --git a/docs/content/guides/deploy-apps/environments/howto-environment/index.md b/docs/content/guides/setup-platform/environments/howto-environment/index.md similarity index 91% rename from docs/content/guides/deploy-apps/environments/howto-environment/index.md rename to docs/content/guides/setup-platform/environments/howto-environment/index.md index 189fcc43a..a7a4a1e03 100644 --- a/docs/content/guides/deploy-apps/environments/howto-environment/index.md +++ b/docs/content/guides/setup-platform/environments/howto-environment/index.md @@ -8,19 +8,19 @@ categories: "How-To" tags: ["environments"] --- -Radius Environments are prepared landing zones for applications that contain configuration and Recipes. To learn more visit the [environments overview]({{< ref "/guides/deploy-apps/environments/overview" >}}) page. +Radius Environments are prepared landing zones for applications that contain configuration and Recipes. To learn more visit the [environments overview]({{< ref "/guides/setup-platform/environments/overview" >}}) page. Radius Environments can be setup with the rad CLI via two paths: interactive or manual. ## Pre-requisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) ## Create a development environment -1. Initialize a new [Radius Environment]({{< ref "/guides/deploy-apps/environments/overview">}}) with [`rad init`]({{< ref rad_initialize >}}): +1. Initialize a new [Radius Environment]({{< ref "/guides/setup-platform/environments/overview">}}) with [`rad init`]({{< ref rad_initialize >}}): ```bash rad init ``` @@ -83,8 +83,8 @@ Radius Environments can be setup with the rad CLI via two paths: interactive or 1. Follow the prompts, specifying: - **Namespace** - The Kubernetes namespace where your application containers and networking resources will be deployed (different than the Radius control-plane namespace, `radius-system`) - - **Azure provider** (optional) - Allows you to [deploy and manage Azure resources]({{< ref "/guides/operations/providers/azure-provider" >}}) - - **AWS provider** (optional) - Allows you to [deploy and manage AWS resources]({{< ref "/guides/operations/providers/aws-provider" >}}) + - **Azure provider** (optional) - Allows you to [deploy and manage Azure resources]({{< ref "guides/setup-platform/cloud-providers/azure-provider" >}}) + - **AWS provider** (optional) - Allows you to [deploy and manage AWS resources]({{< ref "/guides/setup-platform/cloud-providers/aws-provider" >}}) - **Environment name** - The name of the environment to create You should see the following output: @@ -228,4 +228,4 @@ Radius can also be installed and an environment created with manual rad CLI comm ## Next steps -Follow the [cloud provider guides]({{< ref providers >}}) to configure cloud providers for your environment to deploy and manage cloud resources. \ No newline at end of file +Follow the [cloud provider guides]({{< ref cloud-providers >}}) to configure cloud providers for your environment to deploy and manage cloud resources. \ No newline at end of file diff --git a/docs/content/guides/deploy-apps/environments/overview/index.md b/docs/content/guides/setup-platform/environments/overview/index.md similarity index 87% rename from docs/content/guides/deploy-apps/environments/overview/index.md rename to docs/content/guides/setup-platform/environments/overview/index.md index 29cc3db64..a3f051038 100644 --- a/docs/content/guides/deploy-apps/environments/overview/index.md +++ b/docs/content/guides/setup-platform/environments/overview/index.md @@ -20,13 +20,13 @@ The following configuration options are available for environments: ### Container runtime -Radius Environments can be configured with a container runtime, where Radius [containers]({{< ref "guides/author-apps/containers" >}}) will be deployed. Currently, only Kubernetes clusters are supported for container runtimes. +Radius Environments can be configured with a container runtime, where Radius [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}) will be deployed. Currently, only Kubernetes clusters are supported for container runtimes. A Kubernetes namespace is specified on the environment to tell Radius where to render environment-scoped resources. For example, a shared database deployed to an environment will be deployed to the namespace specified on the environment. Application-scoped resources will be deployed into a new namespace for each application, in the format `-`. For example, if an application named `myapp` is deployed to an environment with the namespace `default`, the application-scoped resources will be deployed to the namespace `default-myapp`. ### Cloud provider -You can optionally configure cloud providers allow you to deploy and connect to cloud resources across various cloud platforms. For example, you can use the Radius Azure provider to run your application's services in your Kubernetes cluster, while deploying Azure resources to a specified Azure subscription and resource group. More information on setting up a cloud provider can be found in the [providers]({{< ref providers >}}) section. +You can optionally configure cloud providers allow you to deploy and connect to cloud resources across various cloud platforms. For example, you can use the Radius Azure provider to run your application's services in your Kubernetes cluster, while deploying Azure resources to a specified Azure subscription and resource group. More information on setting up a cloud provider can be found in the [providers]({{< ref cloud-providers >}}) section. #### Supported cloud providers @@ -101,6 +101,6 @@ Visit the [environment schema page]({{< ref environment-schema >}}) to learn mor ## Managing multiple environments -If you are working with multiple environments, you can use [workspaces]({{< ref "/guides/operations/workspaces/overview" >}}) to manage them. Workspaces allow you to switch between different sets of environments, and can be used to manage different environments for different projects. +If you are working with multiple environments, you can use [workspaces]({{< ref "/guides/setup-platform/workspaces/overview" >}}) to manage them. Workspaces allow you to switch between different sets of environments, and can be used to manage different environments for different projects. -{{< button page="/guides/operations/workspaces/overview" text="Workspaces" >}} +{{< button page="/guides/setup-platform/workspaces/overview" text="Workspaces" >}} diff --git a/docs/content/guides/setup-platform/setup-cloud-providers/overview/providers-overview.png b/docs/content/guides/setup-platform/environments/overview/providers-overview.png similarity index 100% rename from docs/content/guides/setup-platform/setup-cloud-providers/overview/providers-overview.png rename to docs/content/guides/setup-platform/environments/overview/providers-overview.png diff --git a/docs/content/guides/deploy-apps/environments/overview/snippets/environment.bicep b/docs/content/guides/setup-platform/environments/overview/snippets/environment.bicep similarity index 100% rename from docs/content/guides/deploy-apps/environments/overview/snippets/environment.bicep rename to docs/content/guides/setup-platform/environments/overview/snippets/environment.bicep diff --git a/docs/content/guides/operations/groups/_index.md b/docs/content/guides/setup-platform/groups/_index.md similarity index 92% rename from docs/content/guides/operations/groups/_index.md rename to docs/content/guides/setup-platform/groups/_index.md index 0d01fa5e0..bc0334175 100644 --- a/docs/content/guides/operations/groups/_index.md +++ b/docs/content/guides/setup-platform/groups/_index.md @@ -3,5 +3,5 @@ type: docs title: "Resource groups" linkTitle: "Resource groups" description: "Manage collections of resources with resource groups" -weight: 600 +weight: 300 --- diff --git a/docs/content/guides/operations/groups/howto-resourcegroups/index.md b/docs/content/guides/setup-platform/groups/howto-resourcegroups/index.md similarity index 97% rename from docs/content/guides/operations/groups/howto-resourcegroups/index.md rename to docs/content/guides/setup-platform/groups/howto-resourcegroups/index.md index e0e4656f7..1c2755d1c 100644 --- a/docs/content/guides/operations/groups/howto-resourcegroups/index.md +++ b/docs/content/guides/setup-platform/groups/howto-resourcegroups/index.md @@ -11,7 +11,7 @@ This guide will walk you through the process of managing resource groups in Radi ## Pre-requisites -- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) ## Step 1: Ensure Radius is installed diff --git a/docs/content/guides/operations/groups/overview/group-diagram.png b/docs/content/guides/setup-platform/groups/overview/group-diagram.png similarity index 100% rename from docs/content/guides/operations/groups/overview/group-diagram.png rename to docs/content/guides/setup-platform/groups/overview/group-diagram.png diff --git a/docs/content/guides/operations/groups/overview/group.svg b/docs/content/guides/setup-platform/groups/overview/group.svg similarity index 100% rename from docs/content/guides/operations/groups/overview/group.svg rename to docs/content/guides/setup-platform/groups/overview/group.svg diff --git a/docs/content/guides/operations/groups/overview/index.md b/docs/content/guides/setup-platform/groups/overview/index.md similarity index 98% rename from docs/content/guides/operations/groups/overview/index.md rename to docs/content/guides/setup-platform/groups/overview/index.md index 5a5bbafa8..35bcddcaf 100644 --- a/docs/content/guides/operations/groups/overview/index.md +++ b/docs/content/guides/setup-platform/groups/overview/index.md @@ -11,7 +11,7 @@ Resource groups are collections of resources that you can manage as a single uni {{< image src="group-diagram.png" alt="Diagram showing Radius resources inside of a Radius resource group" width=600px >}} {{% alert title="Radius vs. Azure Resource Groups" color="primary" %}} -Note that resource groups in Radius are not the same as [Azure resource groups](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal). Azure resource groups are used to organize Azure resources, while Radius resource groups are used to organize Radius resources, such as applications, environments, portable resources, and routes. When you deploy a template that contains both, Radius resources route to the Radius resource group defined in your workspace, and Azure resources route to the Azure resource group defined in your [cloud provider]({{< ref providers >}}). +Note that resource groups in Radius are not the same as [Azure resource groups](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal). Azure resource groups are used to organize Azure resources, while Radius resource groups are used to organize Radius resources, such as applications, environments, portable resources, and routes. When you deploy a template that contains both, Radius resources route to the Radius resource group defined in your workspace, and Azure resources route to the Azure resource group defined in your [cloud provider]({{< ref cloud-providers >}}). {{% /alert %}} ## Initialization diff --git a/docs/content/guides/setup-platform/setup-kubernetes/_index.md b/docs/content/guides/setup-platform/kubernetes/_index.md similarity index 91% rename from docs/content/guides/setup-platform/setup-kubernetes/_index.md rename to docs/content/guides/setup-platform/kubernetes/_index.md index 6406f675e..b07c990aa 100644 --- a/docs/content/guides/setup-platform/setup-kubernetes/_index.md +++ b/docs/content/guides/setup-platform/kubernetes/_index.md @@ -3,5 +3,5 @@ type: docs title: "" linkTitle: "Setup Kubernetes" description: "Learn how Radius can be set up and run on Kubernetes" -weight: 200 +weight: 100 --- diff --git a/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-install/index.md b/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md similarity index 96% rename from docs/content/guides/setup-platform/setup-kubernetes/kubernetes-install/index.md rename to docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md index df28c1f57..08617ad7d 100644 --- a/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-install/index.md +++ b/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md @@ -13,7 +13,7 @@ Radius handles the deployment and management of environments, applications, and ## Prerequisites -- [Kubernetes cluster]({{< ref "guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Kubernetes cluster]({{< ref "guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) - [rad CLI]({{< ref howto-rad-cli >}}) diff --git a/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-uninstall/index.md b/docs/content/guides/setup-platform/kubernetes/kubernetes-uninstall/index.md similarity index 95% rename from docs/content/guides/setup-platform/setup-kubernetes/kubernetes-uninstall/index.md rename to docs/content/guides/setup-platform/kubernetes/kubernetes-uninstall/index.md index dddc6ac69..b235b6b5a 100644 --- a/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-uninstall/index.md +++ b/docs/content/guides/setup-platform/kubernetes/kubernetes-uninstall/index.md @@ -10,7 +10,7 @@ tags: ["Kubernetes"] ## Prerequisites -- [Radius installed on Kubernetes cluster]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-install" >}}) +- [Radius installed on Kubernetes cluster]({{< ref "guides/setup-platform/kubernetes/kubernetes-install" >}}) ## Step 1: Uninstall the Radius control-plane from your kubernetes cluster diff --git a/docs/content/guides/setup-platform/setup-kubernetes/kubernetes-upgrade/index.md b/docs/content/guides/setup-platform/kubernetes/kubernetes-upgrade/index.md similarity index 100% rename from docs/content/guides/setup-platform/setup-kubernetes/kubernetes-upgrade/index.md rename to docs/content/guides/setup-platform/kubernetes/kubernetes-upgrade/index.md diff --git a/docs/content/guides/setup-platform/setup-kubernetes/overview/index.md b/docs/content/guides/setup-platform/kubernetes/overview/index.md similarity index 99% rename from docs/content/guides/setup-platform/setup-kubernetes/overview/index.md rename to docs/content/guides/setup-platform/kubernetes/overview/index.md index a837c9b7b..57edd3082 100644 --- a/docs/content/guides/setup-platform/setup-kubernetes/overview/index.md +++ b/docs/content/guides/setup-platform/kubernetes/overview/index.md @@ -8,7 +8,7 @@ categories: ["Overview"] tags: ["Kubernetes"] --- -Radius offers a Kubernetes-based platform for hosting the [Radius control plane]({{< ref "/guides/operations/control-plane" >}}) and [Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}}). +Radius offers a Kubernetes-based platform for hosting the [Radius control plane]({{< ref "/guides/operations/control-plane" >}}) and [Radius Environments]({{< ref "/guides/setup-platform/environments/overview" >}}). {{< image src="kubernetes-mapping.png" alt="Diagram showing Radius resources being mapped to Kubernetes objects" width=600px >}} diff --git a/docs/content/guides/setup-platform/setup-kubernetes/overview/kubernetes-mapping.png b/docs/content/guides/setup-platform/kubernetes/overview/kubernetes-mapping.png similarity index 100% rename from docs/content/guides/setup-platform/setup-kubernetes/overview/kubernetes-mapping.png rename to docs/content/guides/setup-platform/kubernetes/overview/kubernetes-mapping.png diff --git a/docs/content/guides/operations/workspaces/_index.md b/docs/content/guides/setup-platform/workspaces/_index.md similarity index 94% rename from docs/content/guides/operations/workspaces/_index.md rename to docs/content/guides/setup-platform/workspaces/_index.md index 070840a61..9d0aeba40 100644 --- a/docs/content/guides/operations/workspaces/_index.md +++ b/docs/content/guides/setup-platform/workspaces/_index.md @@ -3,6 +3,6 @@ type: docs title: "Overview: Radius workspaces" linkTitle: "Workspaces" description: "Learn how to handle multiple Radius platforms and environments with workspaces" -weight: 250 +weight: 200 categories: "Overview" --- \ No newline at end of file diff --git a/docs/content/guides/operations/workspaces/howto-workspaces/index.md b/docs/content/guides/setup-platform/workspaces/howto-workspaces/index.md similarity index 97% rename from docs/content/guides/operations/workspaces/howto-workspaces/index.md rename to docs/content/guides/setup-platform/workspaces/howto-workspaces/index.md index 99bb9a6d4..58ece949f 100644 --- a/docs/content/guides/operations/workspaces/howto-workspaces/index.md +++ b/docs/content/guides/setup-platform/workspaces/howto-workspaces/index.md @@ -9,7 +9,7 @@ categories: "How-To" ## Pre-requisites -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) ## How-to: Use workspaces to switch between environments diff --git a/docs/content/guides/operations/workspaces/overview/index.md b/docs/content/guides/setup-platform/workspaces/overview/index.md similarity index 91% rename from docs/content/guides/operations/workspaces/overview/index.md rename to docs/content/guides/setup-platform/workspaces/overview/index.md index 6ddefb2f7..9ca1aa310 100644 --- a/docs/content/guides/operations/workspaces/overview/index.md +++ b/docs/content/guides/setup-platform/workspaces/overview/index.md @@ -9,7 +9,7 @@ categories: "Overview" ## What are workspaces? -Workspaces allow you to manage multiple Radius [environments]({{< ref "/guides/deploy-apps/environments/Overview" >}}) using a local, client-side, configuration file. You can easily define and switch between workspaces to deploy and manage applications across separate environments. +Workspaces allow you to manage multiple Radius [environments]({{< ref "/guides/setup-platform/environments/overview" >}}) using a local, client-side, configuration file. You can easily define and switch between workspaces to deploy and manage applications across separate environments. {{< image src=workspaces.png alt="Diagram showing a Radius configuration file mapping workspaces to Kubernetes clusters" width=800px >}} diff --git a/docs/content/guides/operations/workspaces/overview/workspaces.png b/docs/content/guides/setup-platform/workspaces/overview/workspaces.png similarity index 100% rename from docs/content/guides/operations/workspaces/overview/workspaces.png rename to docs/content/guides/setup-platform/workspaces/overview/workspaces.png diff --git a/docs/content/reference/cli/rad_install_kubernetes.md b/docs/content/reference/cli/rad_install_kubernetes.md index e27ca0770..25cb975e4 100644 --- a/docs/content/reference/cli/rad_install_kubernetes.md +++ b/docs/content/reference/cli/rad_install_kubernetes.md @@ -17,7 +17,7 @@ By default 'rad install kubernetes' will install Radius with the version matchin Radius will be installed in the 'radius-system' namespace. For more information visit https://docs.radapp.io/concepts/technical/architecture/ -Overrides can be set by specifying Helm chart values with the '--set' flag. For more information visit https://docs.radapp.io/guides/setup-platform/setup-kubernetes/overviewinstall/. +Overrides can be set by specifying Helm chart values with the '--set' flag. For more information visit https://docs.radapp.io/guides/setup-platform/kubernetes/overviewinstall/. ``` diff --git a/docs/content/reference/limitations.md b/docs/content/reference/limitations.md index aee8fb314..f2b192748 100644 --- a/docs/content/reference/limitations.md +++ b/docs/content/reference/limitations.md @@ -47,7 +47,7 @@ As a workaround make sure to use distinct names for both containers and gateways ### Typos in Radius Resource Type Names Deploying a Radius Resources with a typo in the resource type or an unsupported resource type will result in an Azure provider related error being thrown during deployment. For example, when `Application.Core/Extenders` is defined as `Application.Core/Extender` you will get an error messaging similar to: ``` -Azure deployment failed, please ensure you have configured an Azure provider with your Radius environment: https://docs.radapp.io/guides/operations/providers/azure-provider/ +Azure deployment failed, please ensure you have configured an Azure provider with your Radius environment: https://docs.radapp.io/guides/setup-platform/cloud-providers/azure-provider ``` We are working on making this error clearer. In the meantime, when you see this error please ensure that the resource type name is correctly specified in your Radius Application or Environment Bicep file. diff --git a/docs/content/reference/resource-schema/cache/redis/index.md b/docs/content/reference/resource-schema/cache/redis/index.md index ecf1d7d29..3cc58c6e4 100644 --- a/docs/content/reference/resource-schema/cache/redis/index.md +++ b/docs/content/reference/resource-schema/cache/redis/index.md @@ -8,7 +8,7 @@ categories: "Schema" ## Overview -The `redislabs.com/Redis` is a [resource]({{< ref portable-resources >}}) which can be deployed to any platform Radius supports. +The `redislabs.com/Redis` is a [resource]({{< ref portable-resource-types >}}) which can be deployed to any platform Radius supports. ## Resource format @@ -93,7 +93,7 @@ If you want to manually manage your infrastructure provisioning without the use ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a Redis resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Redis named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Redis resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a Redis resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Redis named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Redis resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/core-schema/application-schema/index.md b/docs/content/reference/resource-schema/core-schema/application-schema/index.md index d9702095c..71264d963 100644 --- a/docs/content/reference/resource-schema/core-schema/application-schema/index.md +++ b/docs/content/reference/resource-schema/core-schema/application-schema/index.md @@ -31,7 +31,7 @@ Extensions allow you to customize how resources are generated or customized as p ##### kubernetesNamespace -The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior. +The Kubernetes namespace extension allows you to customize how all of the resources within your application generate Kubernetes resources. See the [Kubernetes mapping guide]({{< ref "/guides/setup-platform/kubernetes/overview#resource-mapping" >}}) for more information on namespace mapping behavior. | Key | Required | Description | Example | |------|:--------:|-------------|---------| @@ -40,7 +40,7 @@ The Kubernetes namespace extension allows you to customize how all of the resour ##### kubernetesMetadata -The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/kubernetes/overview#kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. ###### Properties diff --git a/docs/content/reference/resource-schema/core-schema/container-schema/index.md b/docs/content/reference/resource-schema/core-schema/container-schema/index.md index 0784af94f..61b53028b 100644 --- a/docs/content/reference/resource-schema/core-schema/container-schema/index.md +++ b/docs/content/reference/resource-schema/core-schema/container-schema/index.md @@ -119,7 +119,7 @@ Additional properties are available and required depending on the 'kind' of the #### kubernetesMetadata -The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples refer to the extension overview page. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/kubernetes/overview#kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples refer to the extension overview page. ##### Properties @@ -175,5 +175,5 @@ The `manualScaling` extension configures the number of replicas of a compute ins | Key | Required | Description | Example | |------|:--------:|-------------|---------| -| base | n | The base Kubernetes resource manifest on top of which Radius specified properties will be applied. Supported resource types are documented [here]({{}}). | `loadTextContent('manifest/base-container.yaml')` +| base | n | The base Kubernetes resource manifest on top of which Radius specified properties will be applied. Supported resource types are documented [here]({{}}). | `loadTextContent('manifest/base-container.yaml')` | pod | n | The pod specifications to apply to the Kubernetes resource created by Radius. Any field defined on [PodSpec](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec) can be set here. | [`topologySpreadConstraints`](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#scheduling) diff --git a/docs/content/reference/resource-schema/core-schema/environment-schema/index.md b/docs/content/reference/resource-schema/core-schema/environment-schema/index.md index 7f58388f7..d87a9f8aa 100644 --- a/docs/content/reference/resource-schema/core-schema/environment-schema/index.md +++ b/docs/content/reference/resource-schema/core-schema/environment-schema/index.md @@ -100,7 +100,7 @@ Extensions allow you to customize how resources are generated or customized as p #### kubernetesMetadata -The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kubernetes/overviewkubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. +The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/kubernetes/overview#kubernetes-metadata">}}) enables you set and cascade Kubernetes metadata such as labels and Annotations on all the Kubernetes resources defined with in your Radius Application. For examples, please refer to the extension overview page. ##### Properties @@ -124,4 +124,4 @@ The [Kubernetes Metadata extension]({{< ref "guides/setup-platform/setup-kuberne ## Further reading -- [Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}}) +- [Radius Environments]({{< ref "/guides/setup-platform/environments/overview" >}}) diff --git a/docs/content/reference/resource-schema/core-schema/volumes/volume-azure-keyvault/index.md b/docs/content/reference/resource-schema/core-schema/volumes/volume-azure-keyvault/index.md index 6fbb5c945..e640cd275 100644 --- a/docs/content/reference/resource-schema/core-schema/volumes/volume-azure-keyvault/index.md +++ b/docs/content/reference/resource-schema/core-schema/volumes/volume-azure-keyvault/index.md @@ -12,7 +12,7 @@ Radius supports mounting an Azure Key Vault as a persistent volume to the contai - [Azure Key Vault CSI Driver](https://azure.github.io/secrets-store-csi-driver-provider-azure/demos/standard-walkthrough/) installed on your cluster - [Azure AD Workload Identity](https://azure.github.io/azure-workload-identity/docs/installation.html) installed on your cluster -- `azure.com.workload` identity configured on your [environment]({{< ref "/guides/deploy-apps/environments/overview" >}}) +- `azure.com.workload` identity configured on your [environment]({{< ref "/guides/setup-platform/environments/overview" >}}) - Your Azure Key Vault access policy should be set to [Azure role-based access control](https://learn.microsoft.com/azure/key-vault/general/rbac-guide?tabs=azure-cli) ## Resource format diff --git a/docs/content/reference/resource-schema/dapr-schema/dapr-configurationStore/index.md b/docs/content/reference/resource-schema/dapr-schema/dapr-configurationStore/index.md index 0a42681a5..093a711a7 100644 --- a/docs/content/reference/resource-schema/dapr-schema/dapr-configurationStore/index.md +++ b/docs/content/reference/resource-schema/dapr-schema/dapr-configurationStore/index.md @@ -80,7 +80,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a Dapr configuration store resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr configuration store named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr configuration store resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a Dapr configuration store resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr configuration store named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr configuration store resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/dapr-schema/dapr-extension/index.md b/docs/content/reference/resource-schema/dapr-schema/dapr-extension/index.md index 0b92ec8ec..6fe1d9d68 100644 --- a/docs/content/reference/resource-schema/dapr-schema/dapr-extension/index.md +++ b/docs/content/reference/resource-schema/dapr-schema/dapr-extension/index.md @@ -14,7 +14,7 @@ The `daprSidecar` extensions adds and configures a [Dapr](https://dapr.io) sidec ## Extension format -In this example a [container]({{< ref "guides/author-apps/containers" >}}) adds a Dapr extension to add a Dapr sidecar: +In this example a [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) adds a Dapr extension to add a Dapr sidecar: {{< rad file="snippets/dapr.bicep" embed=true marker="//SAMPLE" replace-key-run="//CONTAINER" replace-value-run="container: {...}" >}} diff --git a/docs/content/reference/resource-schema/dapr-schema/dapr-pubsub/index.md b/docs/content/reference/resource-schema/dapr-schema/dapr-pubsub/index.md index 78b0c76c6..7515e5a91 100644 --- a/docs/content/reference/resource-schema/dapr-schema/dapr-pubsub/index.md +++ b/docs/content/reference/resource-schema/dapr-schema/dapr-pubsub/index.md @@ -80,7 +80,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a Dapr pub/sub resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr pub/sub named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr pub/sub resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a Dapr pub/sub resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr pub/sub named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr pub/sub resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/dapr-schema/dapr-secretstore/index.md b/docs/content/reference/resource-schema/dapr-schema/dapr-secretstore/index.md index f668bf6e7..467284560 100644 --- a/docs/content/reference/resource-schema/dapr-schema/dapr-secretstore/index.md +++ b/docs/content/reference/resource-schema/dapr-schema/dapr-secretstore/index.md @@ -78,7 +78,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a Dapr secret store resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr secret store named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr secret store resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a Dapr secret store resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr secret store named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr secret store resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/dapr-schema/dapr-statestore/index.md b/docs/content/reference/resource-schema/dapr-schema/dapr-statestore/index.md index fbec358ae..24b0124fd 100644 --- a/docs/content/reference/resource-schema/dapr-schema/dapr-statestore/index.md +++ b/docs/content/reference/resource-schema/dapr-schema/dapr-statestore/index.md @@ -80,7 +80,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a Dapr state store resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr state store named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr state store resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a Dapr state store resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Dapr state store named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Dapr state store resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/databases/microsoft-sql/index.md b/docs/content/reference/resource-schema/databases/microsoft-sql/index.md index 13fbb5551..fcf16cde2 100644 --- a/docs/content/reference/resource-schema/databases/microsoft-sql/index.md +++ b/docs/content/reference/resource-schema/databases/microsoft-sql/index.md @@ -84,7 +84,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a Azure SQL resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Azure SQL named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Azure SQL resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a Azure SQL resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to Azure SQL named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected Azure SQL resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/databases/mongodb/index.md b/docs/content/reference/resource-schema/databases/mongodb/index.md index 6485544fe..cfefdf156 100644 --- a/docs/content/reference/resource-schema/databases/mongodb/index.md +++ b/docs/content/reference/resource-schema/databases/mongodb/index.md @@ -7,7 +7,7 @@ description: "Learn how to use a Mongo database in your application" ## Overview -The `mongodb.com/MongoDatabase` [resource]({{< ref portable-resources >}}) represents a Mongo database. +The `mongodb.com/MongoDatabase` [resource]({{< ref portable-resource-types >}}) represents a Mongo database. ## Resource format @@ -93,7 +93,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a MongoDB resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to MongoDB named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected MongoDB resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a MongoDB resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to MongoDB named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected MongoDB resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/reference/resource-schema/messaging/rabbitmq/index.md b/docs/content/reference/resource-schema/messaging/rabbitmq/index.md index 6001a6c83..074edf872 100644 --- a/docs/content/reference/resource-schema/messaging/rabbitmq/index.md +++ b/docs/content/reference/resource-schema/messaging/rabbitmq/index.md @@ -94,7 +94,7 @@ If you want to manually manage your infrastructure provisioning outside of Recip ## Environment variables for connections -Other Radius resources, such as [containers]({{< ref "guides/author-apps/containers" >}}), may connect to a RabbitMQ resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to RabbitMQ named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected RabbitMQ resource: +Other Radius resources, such as [containers]({{< ref "guides/resource-types/core-resource-types/containers" >}}), may connect to a RabbitMQ resource via [connections]({{< ref "application-graph#connections-and-injected-values" >}}). When a connection to RabbitMQ named, for example, `myconnection` is declared, Radius injects values into environment variables that are then used to access the connected RabbitMQ resource: | Environment variable | Example(s) | |----------------------|------------| diff --git a/docs/content/tutorials/helm/index.md b/docs/content/tutorials/helm/index.md index da9c54579..1661f7c17 100644 --- a/docs/content/tutorials/helm/index.md +++ b/docs/content/tutorials/helm/index.md @@ -19,7 +19,7 @@ This tutorial will teach you the following about Radius: - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Helm](https://helm.sh/docs/intro/install/) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) ## Step 1. Clone and open the sample code @@ -247,7 +247,7 @@ From here you will go through a series of steps to incrementally add more Radius ```bash rad app graph -a demo -g default-demo ``` - where `-a demo` specifies the application name and `-g default-demo` specifies the resource group name. [Resource groups]({{< ref "guides/operations/groups/overview" >}}) are a way to organize resources in Radius. + where `-a demo` specifies the application name and `-g default-demo` specifies the resource group name. [Resource groups]({{< ref "guides/setup-platform/groups/overview" >}}) are a way to organize resources in Radius. The output should look like this: diff --git a/docs/content/tutorials/new-app/index.md b/docs/content/tutorials/new-app/index.md index cecb8fec0..c2686ff6a 100644 --- a/docs/content/tutorials/new-app/index.md +++ b/docs/content/tutorials/new-app/index.md @@ -21,13 +21,13 @@ By the end of the tutorial, you will have created and deployed a new Radius Appl ## Prerequisites -- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview" >}}) +- [Supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview" >}}) - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) ## Step 1: Initialize a Radius Environment and Application -[Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}}) are where applications are deployed. Environments determine how an application runs on a particular platform (_like AWS or Azure_). +[Radius Environments]({{< ref "/guides/setup-platform/environments/overview" >}}) are where applications are deployed. Environments determine how an application runs on a particular platform (_like AWS or Azure_). 1. Begin by creating a new directory for your application: @@ -154,7 +154,7 @@ Radius Applications are where all your app's resources and relationships come to ``` {{< alert title="💡 Kubernetes mapping" color="info" >}} - Radius Environments map how Applications "bind" to a particular platform. Earlier we saw the Application compute was set to `kubernetes` and the namespace was set to `default-myapp`. This means the container resources were deployed to the `default-myapp` namespace in the Kubernetes cluster where Radius is installed. Visit the [Kubernetes mapping docs]({{< ref "/guides/setup-platform/setup-kubernetes/overview#resource-mapping" >}}) to learn more. + Radius Environments map how Applications "bind" to a particular platform. Earlier we saw the Application compute was set to `kubernetes` and the namespace was set to `default-myapp`. This means the container resources were deployed to the `default-myapp` namespace in the Kubernetes cluster where Radius is installed. Visit the [Kubernetes mapping docs]({{< ref "/guides/setup-platform/kubernetes/overview#resource-mapping" >}}) to learn more. {{< /alert >}} ## Step 4: Run your application @@ -231,7 +231,7 @@ In addition to containers, you can add dependencies like Redis caches, Dapr Stat {{% rad file="snippets/2-app-mongo.bicep" embed=true marker="//CONTAINER" markdownConfig="{hl_lines=[\"16-20\"]}" %}} {{< alert title="💡 Radius Connections" color="info" >}} - Radius Connections are more than just bookkeeping. They are used to automatically configure access for your containers. Learn more in the [containers documentation]({{< ref "/guides/author-apps/containers/overview" >}}). + Radius Connections are more than just bookkeeping. They are used to automatically configure access for your containers. Learn more in the [containers documentation]({{< ref "/guides/resource-types/core-resource-types/containers/overview" >}}). {{< /alert >}} 1. Re-run your app with [`rad run`]({{< ref rad_run >}}) to deploy the Mongo database and container and start the port-forward and log stream: diff --git a/docs/content/tutorials/tutorial-add-radius/index.md b/docs/content/tutorials/tutorial-add-radius/index.md index 0c002d2bc..07707b91e 100644 --- a/docs/content/tutorials/tutorial-add-radius/index.md +++ b/docs/content/tutorials/tutorial-add-radius/index.md @@ -20,7 +20,7 @@ By the end of this tutorial, you will have deployed an existing Kubernetes appli ## Prerequisites -- [Kubernetes cluster]({{< ref "guides/setup-platform/setup-kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Kubernetes cluster]({{< ref "guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) - [rad CLI]({{< ref howto-rad-cli >}}) @@ -284,7 +284,7 @@ Resources: redis-replica (kubernetes: apps/Deployment) ``` -This output shows that Radius has detected the three container resources in the Kubernetes application that you have just deployed. Note that since you have not used Radius to define any connections between the resources, the `Connections` field is empty. However, your application is now ready to be further modified using the Radius features that are now available to you, , such as [Connections]({{< ref "guides/author-apps/containers/overview#connections" >}}), [Recipes]({{< ref "guides/recipes/overview" >}}), and more. +This output shows that Radius has detected the three container resources in the Kubernetes application that you have just deployed. Note that since you have not used Radius to define any connections between the resources, the `Connections` field is empty. However, your application is now ready to be further modified using the Radius features that are now available to you, , such as [Connections]({{< ref "/guides/resource-types/core-resource-types/containers/overview#connections" >}}), [Recipes]({{< ref "guides/recipes/overview" >}}), and more. ## Step 6: Clean up @@ -319,7 +319,7 @@ This output shows that Radius has detected the three container resources in the ## Next steps -- To learn more about authoring Radius applications, visit the [Authoring applications guide]({{< ref "guides/author-apps" >}}) +- To learn more about authoring Radius applications, visit the [Authoring applications guide]({{< ref "guides/resource-types" >}}) - To learn more about deploying applications using Radius, visit the [Deploying applications guide]({{< ref "guides/deploy-apps" >}}) -- To learn more about using the [Radius Connections]({{< ref "guides/author-apps/containers/overview#connections" >}}) annotations to connect your containers and resources, visit the [Radius Helm tutorial]({{< ref "tutorials/helm#step-6-add-connection" >}}) +- To learn more about using the [Radius Connections]({{< ref "/guides/resource-types/core-resource-types/containers/overview#connections" >}}) annotations to connect your containers and resources, visit the [Radius Helm tutorial]({{< ref "tutorials/helm#step-6-add-connection" >}}) - To learn more about Radius Recipes, visit the [Recipes guide]({{< ref "guides/recipes" >}}) diff --git a/docs/content/tutorials/tutorial-dapr/index.md b/docs/content/tutorials/tutorial-dapr/index.md index 866775b41..4edbaca2d 100644 --- a/docs/content/tutorials/tutorial-dapr/index.md +++ b/docs/content/tutorials/tutorial-dapr/index.md @@ -12,7 +12,7 @@ tags : ["Dapr"] This tutorial will teach you the following about Dapr: - How to use Radius to deploy a Dapr microservices sample application for an online shop -- How [Dapr and Radius]({{< ref "guides/author-apps/dapr" >}}) seamlessly work together +- How [Dapr and Radius]({{< ref "guides/resource-types/core-resource-types/dapr" >}}) seamlessly work together For more details on the app and access to the source code, visit the `samples/dapr` directory in the [samples repo](https://github.com/radius-project/samples). @@ -21,7 +21,7 @@ For more details on the app and access to the source code, visit the `samples/da - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) - [Radius environment]({{< ref "installation#step-3-initialize-radius" >}}) -- [Setup a supported Kubernetes cluster](https://docs.radapp.io/guides/setup-platform/setup-kubernetes/overview/#supported-clusters) +- [Setup a supported Kubernetes cluster](https://docs.radapp.io/guides/setup-platform/kubernetes/overview/#supported-clusters) - [Dapr installed on your Kubernetes cluster](https://docs.dapr.io/operations/hosting/kubernetes/kubernetes-deploy/) ## Step 1: Initialize a Radius Environment @@ -88,7 +88,7 @@ Begin by creating a new file named `dapr.bicep` with a Radius Application that c ## Step 4: Define the `frontend` container -Add a `frontend` [container]({{< ref "guides/author-apps/containers" >}}) which will serve as the application's user interface. +Add a `frontend` [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) which will serve as the application's user interface. {{< rad file="snippets/dapr.bicep" embed=true marker="//FRONTEND" >}} diff --git a/docs/content/tutorials/tutorial-recipe/index.md b/docs/content/tutorials/tutorial-recipe/index.md index 15ec63526..cd634c694 100644 --- a/docs/content/tutorials/tutorial-recipe/index.md +++ b/docs/content/tutorials/tutorial-recipe/index.md @@ -22,7 +22,7 @@ This tutorial will teach you the following about Recipes ## Application overview -This application is a simple to-do list which stores and visualizes to-do items. It consists of a frontend [container]({{< ref "guides/author-apps/containers" >}}) and a backend [Redis Cache]({{< ref redis >}}). +This application is a simple to-do list which stores and visualizes to-do items. It consists of a frontend [container]({{< ref "guides/resource-types/core-resource-types/containers" >}}) and a backend [Redis Cache]({{< ref redis >}}). {{< image src="recipe-tutorial-diagram.png" alt="Screenshot of the todoapp with Kubernetes, Azure and AWS Redis Cache options" style="width:500px" >}} @@ -34,7 +34,7 @@ Developers don't need to specify what cloud resources they're using in their app - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) - [Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) -- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/setup-kubernetes/overview#supported-clusters" >}}) +- [Setup a supported Kubernetes cluster]({{< ref "/guides/setup-platform/kubernetes/overview#supported-clusters" >}}) ## Step 1: Initialize a Radius Environment @@ -143,7 +143,7 @@ Note that no Recipe name is specified with 'db', so it will be using the default ## Step 4: Use Azure/AWS recipes in your application -This step requires an Azure subscription or an AWS account to deploy cloud resources, which will incur costs. You will need to add the [Azure/AWS cloud provider]({{< ref providers >}}) to your environment in order to deploy Azure/AWS resources and leverage Azure Recipes. +This step requires an Azure subscription or an AWS account to deploy cloud resources, which will incur costs. You will need to add the [Azure/AWS cloud provider]({{< ref cloud-providers >}}) to your environment in order to deploy Azure/AWS resources and leverage Azure Recipes. {{< tabs Azure AWS >}} diff --git a/docs/shared-content/installation/install-radius/initialize-radius.md b/docs/shared-content/installation/install-radius/initialize-radius.md index f01ef5b22..0ec463589 100644 --- a/docs/shared-content/installation/install-radius/initialize-radius.md +++ b/docs/shared-content/installation/install-radius/initialize-radius.md @@ -2,7 +2,7 @@ Initializing Radius installs the Radius control-plane and creates a Radius Envir 1. Create a Kubernetes cluster - Radius runs inside [Kubernetes]({{< ref "guides/setup-platform/kubernetes/overview" >}}). Create one from the [supported k8s clusters]({{< ref "/guides/setup-platform/kubernetes/overview/overview#supported-kubernetes-clusters" >}}) + Radius runs inside [Kubernetes]({{< ref "guides/setup-platform/kubernetes/overview" >}}). Create one from the [supported k8s clusters]({{< ref "/guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}) > *If you don't have a preferred way to create Kubernetes clusters, you could try using [k3d](https://k3d.io/), which runs a minimal Kubernetes distribution in Docker.* Ensure your cluster is set as your current context: @@ -11,13 +11,13 @@ Initializing Radius installs the Radius control-plane and creates a Radius Envir kubectl config current-context ``` -1. Initialize a new [Radius Environment]({{< ref "/guides/deploy-apps/environments/overview">}}) with [`rad init`]({{< ref rad_initialize >}}): +1. Initialize a new [Radius Environment]({{< ref "/guides/setup-platform/environments/overview">}}) with [`rad init`]({{< ref rad_initialize >}}): ```bash rad init ``` - Select `Yes` to setup the application in the current directory. This will create `app.bicep` and [`bicepconfig.json`]({{< ref "/guides/tooling/bicepconfig/overview" >}}) files + Select `Yes` to setup the application in the current directory. This will create `app.bicep` and [`bicepconfig.json`]({{< ref "/guides/install-tools/bicepconfig/overview" >}}) files ``` Initializing Radius... diff --git a/docs/content/guides/author-apps/custom/howto-extenders/index.md b/holding-pen/howto-extenders/index.md similarity index 89% rename from docs/content/guides/author-apps/custom/howto-extenders/index.md rename to holding-pen/howto-extenders/index.md index 99742ef36..222392595 100644 --- a/docs/content/guides/author-apps/custom/howto-extenders/index.md +++ b/holding-pen/howto-extenders/index.md @@ -6,7 +6,7 @@ description: "Learn how to use extenders in an application" weight: 300 --- -This guide will walk you through how to use an [extender]({{< ref "/guides/author-apps/custom/overview#extenders" >}}) in an application to model resources beyond those currently built into Radius. These might be abstractions or resources unique to your organization, or resources that don't yet have a native Radius type. +This guide will walk you through how to use an [extender]({{< ref "/guides/resource-types/custom-resource-types/overview#extenders" >}}) in an application to model resources beyond those currently built into Radius. These might be abstractions or resources unique to your organization, or resources that don't yet have a native Radius type. ## Prerequisites diff --git a/docs/content/guides/author-apps/custom/howto-extenders/snippets/app-container.bicep b/holding-pen/howto-extenders/snippets/app-container.bicep similarity index 100% rename from docs/content/guides/author-apps/custom/howto-extenders/snippets/app-container.bicep rename to holding-pen/howto-extenders/snippets/app-container.bicep diff --git a/docs/content/guides/author-apps/custom/howto-extenders/snippets/app.bicep b/holding-pen/howto-extenders/snippets/app.bicep similarity index 100% rename from docs/content/guides/author-apps/custom/howto-extenders/snippets/app.bicep rename to holding-pen/howto-extenders/snippets/app.bicep diff --git a/docs/content/guides/author-apps/custom/overview/index.md b/holding-pen/overview/index.md similarity index 100% rename from docs/content/guides/author-apps/custom/overview/index.md rename to holding-pen/overview/index.md From 311eb198cfd5f2c7645567e29abd31b512eaddee Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Wed, 7 May 2025 17:33:44 -0400 Subject: [PATCH 4/7] Resolve conflict Signed-off-by: Reshma Abdul Rahim --- .../setup-platform/kubernetes/kubernetes-install/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md b/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md index 08617ad7d..5f51b1188 100644 --- a/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md +++ b/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md @@ -13,7 +13,7 @@ Radius handles the deployment and management of environments, applications, and ## Prerequisites -- [Kubernetes cluster]({{< ref "guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Kubernetes cluster]({{< ref "guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) - [rad CLI]({{< ref howto-rad-cli >}}) @@ -42,7 +42,7 @@ rad install kubernetes --set-file global.rootCA.cert=/etc/ssl/your-root-ca.crt 1. Begin by adding the Radius Helm repository: ```bash - helm repo add radius https://radius.azurecr.io/helm/v1/repo + helm repo add radius oci://ghcr.io/radius-project/helm-chart helm repo update ``` @@ -73,4 +73,4 @@ rad install kubernetes --set-file global.rootCA.cert=/etc/ssl/your-root-ca.crt | `de.image` | `ghcr.io/radius-project/deployment-engine` | Location of the Bicep deployment engine (DE) image | `de.tag` | `latest` | Tag of the Bicep deployment engine (DE) image | `ucp.image` | `ghcr.io/radius-project/ucpd` | Location of universal control plane (UCP) image -| `ucp.tag` | `latest` | Tag of the universal control plane (UCP) image +| `ucp.tag` | `latest` | Tag of the universal control plane (UCP) image \ No newline at end of file From 749b5227302d223f13131893d7ef65da077acfee Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Wed, 7 May 2025 17:40:28 -0400 Subject: [PATCH 5/7] Fix ref Signed-off-by: Reshma Abdul Rahim --- .../setup-platform/kubernetes/kubernetes-install/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md b/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md index 5f51b1188..8fbc2b972 100644 --- a/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md +++ b/docs/content/guides/setup-platform/kubernetes/kubernetes-install/index.md @@ -13,7 +13,7 @@ Radius handles the deployment and management of environments, applications, and ## Prerequisites -- [Kubernetes cluster]({{< ref "guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) +- [Kubernetes cluster]({{< ref "guides/setup-platform/kubernetes/overview#supported-kubernetes-clusters" >}}) - [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) - [rad CLI]({{< ref howto-rad-cli >}}) From 6ab18ea8ea891a028b8e895dbe53a5e78818ea03 Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Wed, 7 May 2025 17:47:22 -0400 Subject: [PATCH 6/7] fix casing Signed-off-by: Reshma Abdul Rahim --- .../guides/resource-types/custom-resource-types/_index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/content/guides/resource-types/custom-resource-types/_index.md b/docs/content/guides/resource-types/custom-resource-types/_index.md index 887e2eb47..7fcd81e5e 100644 --- a/docs/content/guides/resource-types/custom-resource-types/_index.md +++ b/docs/content/guides/resource-types/custom-resource-types/_index.md @@ -1,7 +1,7 @@ --- type: docs -title: "Custom resource types" -linkTitle: "Custom resource types" +title: "Custom Resource Types" +linkTitle: "Custom Tesource Types" description: "Learn how to create your own resource types" weight: 300 --- \ No newline at end of file From 3f71a0b9434c486619ebdffcf9053502896fa5b8 Mon Sep 17 00:00:00 2001 From: Reshma Abdul Rahim Date: Wed, 7 May 2025 17:53:10 -0400 Subject: [PATCH 7/7] Fix ref Signed-off-by: Reshma Abdul Rahim --- .../guides/resource-types/custom-resource-types/_index.md | 2 +- docs/content/guides/resource-types/overview/index.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/content/guides/resource-types/custom-resource-types/_index.md b/docs/content/guides/resource-types/custom-resource-types/_index.md index 7fcd81e5e..990d0f2c1 100644 --- a/docs/content/guides/resource-types/custom-resource-types/_index.md +++ b/docs/content/guides/resource-types/custom-resource-types/_index.md @@ -1,7 +1,7 @@ --- type: docs title: "Custom Resource Types" -linkTitle: "Custom Tesource Types" +linkTitle: "Custom Resource Types" description: "Learn how to create your own resource types" weight: 300 --- \ No newline at end of file diff --git a/docs/content/guides/resource-types/overview/index.md b/docs/content/guides/resource-types/overview/index.md index 59b337429..c69bc53a2 100644 --- a/docs/content/guides/resource-types/overview/index.md +++ b/docs/content/guides/resource-types/overview/index.md @@ -31,6 +31,6 @@ Portable resource types are sample resource types designed to be used across dif There are other resource types that are platform specific and can be used to manage resources on specific cloud providers or platforms. They are designed to work specifically with the respective provider APIs. These include -- [Kubernetes](<{{ ref "/guides/resource-types/kubernetes" >}})>) -- [AWS](<{{ ref "/guides/resource-types/aws" >}}>) -- [Azure](<{{ ref "/guides/resource-types/azure" >}}>) +- [Kubernetes]({{< ref "/guides/resource-types/kubernetes" >}})) +- [AWS]({{<> ref "/guides/resource-types/aws" >}}) +- [Azure]({{< ref "/guides/resource-types/azure" >}})