diff --git a/docs/content/community/_index.md b/docs/content/community/_index.md deleted file mode 100644 index 99ddef454..000000000 --- a/docs/content/community/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Radius Community" -linkTitle: "Community" -description: "Information about the Radius community" -weight: 120 ---- \ No newline at end of file diff --git a/docs/content/concepts/applications/index.md b/docs/content/concepts/applications/index.md index 6a32bec13..72af1c46c 100644 --- a/docs/content/concepts/applications/index.md +++ b/docs/content/concepts/applications/index.md @@ -5,7 +5,7 @@ linkTitle: "Applications" description: "How Radius manages applications" weight: 40 aliases: - - /content/guides/author-apps/applications/overview + - /content/guides/applications/applications/overview --- A Radius Application is a resource that is a parent to other resources that make up the application. Applications and its resources are defined in an application definition file using the Bicep Infrastructure as Code (IaC) language. Since applications are a first-class Resource Type in Radius, developers perform operations on applications rather than individual resources. When deploying resources, developers simply deploy the Application. Radius also tracks all deployed resources and their dependencies in a graph. Developers can add to the graph by expressing explicit dependencies such as a container relying on a database. diff --git a/docs/content/concepts/environments/index.md b/docs/content/concepts/environments/index.md index 2988962c9..2f5232ef8 100644 --- a/docs/content/concepts/environments/index.md +++ b/docs/content/concepts/environments/index.md @@ -5,7 +5,7 @@ linkTitle: "Environments" description: "How Environments define how and where resources are deployed" weight: 30 aliases: - - /content/guides/deploy-apps/environments/overview + - /content/guides/environments/environments/howto-environment/overview --- All resources are deployed to an Environment. Environments define the deployment location as well as the set of Recipes to use to deploy resources to that Environment. The first component of an Environment definition is the deployment location, specified by `provider` property: diff --git a/docs/content/community/overview/index.md b/docs/content/contributing/community/index.md similarity index 100% rename from docs/content/community/overview/index.md rename to docs/content/contributing/community/index.md diff --git a/docs/content/community/media-coverage/index.md b/docs/content/contributing/media-coverage/index.md similarity index 100% rename from docs/content/community/media-coverage/index.md rename to docs/content/contributing/media-coverage/index.md diff --git a/docs/content/guides/applications/_index.md b/docs/content/guides/applications/_index.md new file mode 100644 index 000000000..99e642b3d --- /dev/null +++ b/docs/content/guides/applications/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Applications" +linkTitle: "Applications" +description: "Learn how to author and deploy Radius Applications" +weight: 500 +--- diff --git a/docs/content/guides/author-apps/aws/_index.md b/docs/content/guides/applications/aws/_index.md similarity index 100% rename from docs/content/guides/author-apps/aws/_index.md rename to docs/content/guides/applications/aws/_index.md diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/icon.png b/docs/content/guides/applications/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/applications/aws/howto-aws-resources/icon.png diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/index.md b/docs/content/guides/applications/aws/howto-aws-resources/index.md similarity index 92% rename from docs/content/guides/author-apps/aws/howto-aws-resources/index.md rename to docs/content/guides/applications/aws/howto-aws-resources/index.md index 95f5ab2e2..1ff6c1c97 100644 --- a/docs/content/guides/author-apps/aws/howto-aws-resources/index.md +++ b/docs/content/guides/applications/aws/howto-aws-resources/index.md @@ -44,12 +44,12 @@ Run [`rad init --full`]({{< ref rad_initialize >}}) to initialize a new environm rad init --full ``` -Follow the prompts to install Radius , 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 Radius , create an [environment resource]({{< ref "/guides/environments/environments/howto-environment" >}}), 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/installation/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/installation/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. @@ -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/installation/bicepconfig/overview" >}}) ## Step 4: Create a Bicep file to model AWS Simple Storage Service (S3) @@ -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/applications/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/applications/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/applications/aws/howto-aws-resources/s3app.png diff --git a/docs/content/guides/author-apps/aws/howto-aws-resources/s3appdiagram.png b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/aws/howto-aws-resources/snippets/s3app.bicep diff --git a/docs/content/guides/author-apps/aws/overview/index.md b/docs/content/guides/applications/aws/overview/index.md similarity index 86% rename from docs/content/guides/author-apps/aws/overview/index.md rename to docs/content/guides/applications/aws/overview/index.md index f4712d83e..032099241 100644 --- a/docs/content/guides/author-apps/aws/overview/index.md +++ b/docs/content/guides/applications/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/installation/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/applications/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/applications/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/applications/aws/overview/snippets/aws.bicep diff --git a/docs/content/guides/author-apps/azure/_index.md b/docs/content/guides/applications/azure/_index.md similarity index 100% rename from docs/content/guides/author-apps/azure/_index.md rename to docs/content/guides/applications/azure/_index.md diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/azure-portal-app.png b/docs/content/guides/applications/azure/howto-azure-container-instances/azure-portal-app.png similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/azure-portal-app.png rename to docs/content/guides/applications/azure/howto-azure-container-instances/azure-portal-app.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/azure-portal-env.png b/docs/content/guides/applications/azure/howto-azure-container-instances/azure-portal-env.png similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/azure-portal-env.png rename to docs/content/guides/applications/azure/howto-azure-container-instances/azure-portal-env.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/azure-portal-gateway.png b/docs/content/guides/applications/azure/howto-azure-container-instances/azure-portal-gateway.png similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/azure-portal-gateway.png rename to docs/content/guides/applications/azure/howto-azure-container-instances/azure-portal-gateway.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/demo-app-landing.png b/docs/content/guides/applications/azure/howto-azure-container-instances/demo-app-landing.png similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/demo-app-landing.png rename to docs/content/guides/applications/azure/howto-azure-container-instances/demo-app-landing.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/demo-app.png b/docs/content/guides/applications/azure/howto-azure-container-instances/demo-app.png similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/demo-app.png rename to docs/content/guides/applications/azure/howto-azure-container-instances/demo-app.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/index.md b/docs/content/guides/applications/azure/howto-azure-container-instances/index.md similarity index 94% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/index.md rename to docs/content/guides/applications/azure/howto-azure-container-instances/index.md index 21b6ae36d..4522a2fdd 100644 --- a/docs/content/guides/author-apps/azure/howto-azure-container-instances/index.md +++ b/docs/content/guides/applications/azure/howto-azure-container-instances/index.md @@ -18,8 +18,8 @@ This how-to guide will provide an overview of how to: - [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}}) The [Bicep extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}}) for VS Code is recommended for Bicep language support -- Radius [installed]({{< ref "/guides/operations/kubernetes/kubernetes-install" >}}) on a [supported Kubernetes cluster]({{< ref "/guides/operations/kubernetes/overview#supported-kubernetes-clusters" >}}) -- An Azure provider configured and registered with your Radius control plane, either through [Service Principal](https://docs.radapp.io/guides/operations/providers/azure-provider/howto-azure-provider-sp/) or [Workload Identity](https://docs.radapp.io/guides/operations/providers/azure-provider/howto-azure-provider-wi/) that have been assigned to the `Reader` role on the subscription and the `Contributor` role on the resource group where the ACI containers will be deployed +- Radius [installed]({{< ref "/guides/installation/kubernetes-install" >}}) on a [supported Kubernetes cluster]({{< ref "/guides/installation/overview#supported-kubernetes-clusters" >}}) +- An Azure provider configured and registered with your Radius control plane, either through [Service Principal](https://docs.radapp.io/guides/installation/providers/azure-provider/howto-azure-provider-sp/) or [Workload Identity](https://docs.radapp.io/guides/installation/providers/azure-provider/howto-azure-provider-wi/) that have been assigned to the `Reader` role on the subscription and the `Contributor` role on the resource group where the ACI containers will be deployed - A [managed identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/) is [required]({{< ref "/reference/resource-schema/core-schema/environment-schema#identity" >}}) for ACI deployments, if you choose to utilize a [user-assigned managed identity](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azp) then you need to ensure it is assigned to the `Contributor` and `Azure Container Instances Contributor` roles on the subscription and resource group where the ACI containers will be deployed ## Step 1: Create a Radius Resource Group and Workspace @@ -198,7 +198,7 @@ Navigate to the Todo List tab and test out the application. Using the Todo page {{< image src="azure-portal-env.png" alt="Screenshot of the Azure portal showing the resource group with the virtual network, internal load balancer, and network security group resources created by Radius" width=700px >}} ## Further reading -- [Azure resources overview]({{< ref "/guides/author-apps/azure/overview" >}}) +- [Azure resources overview]({{< ref "/guides/applications/azure/overview" >}}) - [Radius Environment schema]({{< ref "/reference/resource-schema/core-schema/environment-schema" >}}) - [Radius Application schema]({{< ref "/reference/resource-schema/core-schema/application-schema" >}}) - [Radius Container schema]({{< ref "/reference/resource-schema/core-schema/container-schema" >}}) \ No newline at end of file diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/snippets/app.bicep b/docs/content/guides/applications/azure/howto-azure-container-instances/snippets/app.bicep similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/snippets/app.bicep rename to docs/content/guides/applications/azure/howto-azure-container-instances/snippets/app.bicep diff --git a/docs/content/guides/author-apps/azure/howto-azure-container-instances/snippets/env.bicep b/docs/content/guides/applications/azure/howto-azure-container-instances/snippets/env.bicep similarity index 100% rename from docs/content/guides/author-apps/azure/howto-azure-container-instances/snippets/env.bicep rename to docs/content/guides/applications/azure/howto-azure-container-instances/snippets/env.bicep diff --git a/docs/content/guides/author-apps/azure/howto-azure-resources/icon.png b/docs/content/guides/applications/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/applications/azure/howto-azure-resources/icon.png diff --git a/docs/content/guides/author-apps/azure/howto-azure-resources/index.md b/docs/content/guides/applications/azure/howto-azure-resources/index.md similarity index 90% rename from docs/content/guides/author-apps/azure/howto-azure-resources/index.md rename to docs/content/guides/applications/azure/howto-azure-resources/index.md index 3f7eccb66..75e9743f8 100644 --- a/docs/content/guides/author-apps/azure/howto-azure-resources/index.md +++ b/docs/content/guides/applications/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/installation/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/installation/bicepconfig/overview" >}}) ## Step 3: Define a Radius Environment @@ -48,7 +48,7 @@ Create a file named `app.bicep` and define a [Radius Environment]({{< ref "conce ## 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/applications/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/applications/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/applications/azure/howto-azure-resources/snippets/container-wi.bicep diff --git a/docs/content/guides/author-apps/azure/overview/index.md b/docs/content/guides/applications/azure/overview/index.md similarity index 64% rename from docs/content/guides/author-apps/azure/overview/index.md rename to docs/content/guides/applications/azure/overview/index.md index 9ecbff7e5..747b21c09 100644 --- a/docs/content/guides/author-apps/azure/overview/index.md +++ b/docs/content/guides/applications/azure/overview/index.md @@ -12,13 +12,13 @@ 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 k8s clusters]({{< ref "/guides/operations/kubernetes/overview#supported-clusters" >}}) or [Azure Container Instances (ACI)]({{< ref "/guides/author-apps/azure/howto-azure-container-instances" >}}). 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 k8s clusters]({{< ref "/guides/installation/overview#supported-clusters" >}}) or [Azure Container Instances (ACI)]({{< ref "/guides/applications/azure/howto-azure-container-instances" >}}). To configure an Azure provider, you can follow the documentation [here]({{< ref "/guides/installation/providers/azure-provider" >}}). ## Set up an Azure compute environment Radius allows you to target the deployment of your application containers to either Azure Kubernetes Service (AKS) or Azure Container Instances (ACI). The underlying compute platform is preconfigured in the Radius Environment, which means that you are able to deploy a Radius application to either AKS or ACI without needing to change the application definition. To learn more, visit the following resources: -- The [Kubernetes operations guide](https://docs.radapp.io/guides/operations/kubernetes/overview/#supported-kubernetes-clusters) has more information about setting up Radius in an AKS cluster -- The [how-to guide for ACI]({{< ref "/guides/author-apps/azure/howto-azure-container-instances" >}}) details how to configure a Radius Environment with ACI as the underlying compute platform and deploy a Radius application to ACI +- The [Kubernetes operations guide](https://docs.radapp.io/guides/installation/overview/#supported-kubernetes-clusters) has more information about setting up Radius in an AKS cluster +- The [how-to guide for ACI]({{< ref "/guides/applications/azure/howto-azure-container-instances" >}}) details how to configure a Radius Environment with ACI as the underlying compute platform and deploy a Radius application to ACI ## Resource library @@ -31,7 +31,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/applications/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/applications/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/applications/azure/overview/snippets/azure-connection.bicep diff --git a/docs/content/guides/author-apps/containers/_index.md b/docs/content/guides/applications/containers/_index.md similarity index 100% rename from docs/content/guides/author-apps/containers/_index.md rename to docs/content/guides/applications/containers/_index.md diff --git a/docs/content/guides/author-apps/containers/howto-connect-dependencies/demo-with-redis-screenshot.png b/docs/content/guides/applications/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/applications/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/applications/containers/howto-connect-dependencies/index.md similarity index 87% rename from docs/content/guides/author-apps/containers/howto-connect-dependencies/index.md rename to docs/content/guides/applications/containers/howto-connect-dependencies/index.md index b39de88ac..203646762 100644 --- a/docs/content/guides/author-apps/containers/howto-connect-dependencies/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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-resources/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/containers/howto-keyvault-volume/icon.png diff --git a/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md b/docs/content/guides/applications/containers/howto-keyvault-volume/index.md similarity index 92% rename from docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md rename to docs/content/guides/applications/containers/howto-keyvault-volume/index.md index f722d4c2e..058266d36 100644 --- a/docs/content/guides/author-apps/containers/howto-keyvault-volume/index.md +++ b/docs/content/guides/applications/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/installation" >}}) - [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/installation/bicepconfig/overview" >}}) ## Step 3: Define a Radius Environment @@ -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/applications/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/applications/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/applications/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/applications/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/applications/containers/howto-volumes/icon.png diff --git a/docs/content/guides/author-apps/containers/howto-volumes/index.md b/docs/content/guides/applications/containers/howto-volumes/index.md similarity index 97% rename from docs/content/guides/author-apps/containers/howto-volumes/index.md rename to docs/content/guides/applications/containers/howto-volumes/index.md index c12bf0a4d..ddbd4fb20 100644 --- a/docs/content/guides/author-apps/containers/howto-volumes/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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/applications/containers/howto-volumes/screenshot-empty.jpg diff --git a/docs/content/guides/author-apps/containers/howto-volumes/screenshot-error.jpg b/docs/content/guides/applications/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/applications/containers/howto-volumes/screenshot-error.jpg diff --git a/docs/content/guides/author-apps/containers/howto-volumes/screenshot.jpg b/docs/content/guides/applications/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/applications/containers/howto-volumes/screenshot.jpg diff --git a/docs/content/guides/author-apps/containers/howto-volumes/snippets/1-app.bicep b/docs/content/guides/applications/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/applications/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/applications/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/applications/containers/howto-volumes/snippets/2-app.bicep diff --git a/docs/content/guides/author-apps/containers/overview/containers-splash.png b/docs/content/guides/applications/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/applications/containers/overview/containers-splash.png diff --git a/docs/content/guides/author-apps/containers/overview/index.md b/docs/content/guides/applications/containers/overview/index.md similarity index 91% rename from docs/content/guides/author-apps/containers/overview/index.md rename to docs/content/guides/applications/containers/overview/index.md index a63dd2960..a720ac03e 100644 --- a/docs/content/guides/author-apps/containers/overview/index.md +++ b/docs/content/guides/applications/containers/overview/index.md @@ -20,15 +20,15 @@ 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/installation/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/applications/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 -You can provide a Kubernetes YAML definition as a base or foundation upon which Radius will build your containers, enabling you to incrementally adopting Radius by starting with your existing YAML definition and use applying Radius customizations on top. The provided YAML is fully passed through to Kubernetes when Radius creates the container resource, which means that you may even provide a definition for a custom resources (CRD) that Radius has no visibility into. +You can provide a Kubernetes YAML definition as a base or foundation upon which Radius will build your containers, enabling you to incrementally adopting Radius by starting with your existing YAML definition and use applying Radius customizations on top. The provided YAML is fully passed through to Kubernetes when Radius creates the container resource, which means that you may even provide a definition for a custom resources (CRD) that Radius has no visibility into. Radius currently supports the following Kubernetes resource types for the `base` property: @@ -42,11 +42,11 @@ 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/applications/kubernetes/how-to-patch-pod" >}}). ### Azure Container Instances -Containers can be deployed to Azure Container Instances (ACI) using the `aci` runtime. This allows you to run your container workloads in a serverless environment without needing to manage any infrastructure. For more information on how to deploy containers to ACI, refer to the [Azure Container Instances guide]({{< ref "/guides/author-apps/azure/howto-azure-container-instances" >}}). +Containers can be deployed to Azure Container Instances (ACI) using the `aci` runtime. This allows you to run your container workloads in a serverless environment without needing to manage any infrastructure. For more information on how to deploy containers to ACI, refer to the [Azure Container Instances guide]({{< ref "/guides/applications/azure/howto-azure-container-instances" >}}). ## Container definition @@ -109,7 +109,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/operations/control-plane/_index.md b/docs/content/guides/applications/control-plane/_index.md similarity index 100% rename from docs/content/guides/operations/control-plane/_index.md rename to docs/content/guides/applications/control-plane/_index.md diff --git a/docs/content/guides/operations/control-plane/howto-postman/index.md b/docs/content/guides/applications/control-plane/howto-postman/index.md similarity index 100% rename from docs/content/guides/operations/control-plane/howto-postman/index.md rename to docs/content/guides/applications/control-plane/howto-postman/index.md diff --git a/docs/content/guides/operations/control-plane/howto-postman/postman-auth.png b/docs/content/guides/applications/control-plane/howto-postman/postman-auth.png similarity index 100% rename from docs/content/guides/operations/control-plane/howto-postman/postman-auth.png rename to docs/content/guides/applications/control-plane/howto-postman/postman-auth.png diff --git a/docs/content/guides/operations/control-plane/howto-postman/postman-url.png b/docs/content/guides/applications/control-plane/howto-postman/postman-url.png similarity index 100% rename from docs/content/guides/operations/control-plane/howto-postman/postman-url.png rename to docs/content/guides/applications/control-plane/howto-postman/postman-url.png diff --git a/docs/content/guides/operations/control-plane/logs/_index.md b/docs/content/guides/applications/control-plane/logs/_index.md similarity index 100% rename from docs/content/guides/operations/control-plane/logs/_index.md rename to docs/content/guides/applications/control-plane/logs/_index.md diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/fluentd-config-map.yaml b/docs/content/guides/applications/control-plane/logs/fluentd/fluentd-config-map.yaml similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/fluentd-config-map.yaml rename to docs/content/guides/applications/control-plane/logs/fluentd/fluentd-config-map.yaml diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/fluentd-radius-with-rbac.yaml b/docs/content/guides/applications/control-plane/logs/fluentd/fluentd-radius-with-rbac.yaml similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/fluentd-radius-with-rbac.yaml rename to docs/content/guides/applications/control-plane/logs/fluentd/fluentd-radius-with-rbac.yaml diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/index.md b/docs/content/guides/applications/control-plane/logs/fluentd/index.md similarity index 95% rename from docs/content/guides/operations/control-plane/logs/fluentd/index.md rename to docs/content/guides/applications/control-plane/logs/fluentd/index.md index e6ac7453c..14ba4d29e 100644 --- a/docs/content/guides/operations/control-plane/logs/fluentd/index.md +++ b/docs/content/guides/applications/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/installation/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/installation" >}}) 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/logs/fluentd/kibana-1.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-1.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-1.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-1.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-2.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-2.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-2.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-2.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-3.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-3.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-3.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-3.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-4.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-4.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-4.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-4.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-5.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-5.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-5.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-5.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-6.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-6.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-6.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-6.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-7.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-7.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-7.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-7.png diff --git a/docs/content/guides/operations/control-plane/logs/fluentd/kibana-8.png b/docs/content/guides/applications/control-plane/logs/fluentd/kibana-8.png similarity index 100% rename from docs/content/guides/operations/control-plane/logs/fluentd/kibana-8.png rename to docs/content/guides/applications/control-plane/logs/fluentd/kibana-8.png diff --git a/docs/content/guides/operations/control-plane/logs/overview/overview.md b/docs/content/guides/applications/control-plane/logs/overview/overview.md similarity index 100% rename from docs/content/guides/operations/control-plane/logs/overview/overview.md rename to docs/content/guides/applications/control-plane/logs/overview/overview.md diff --git a/docs/content/guides/operations/control-plane/metrics/_index.md b/docs/content/guides/applications/control-plane/metrics/_index.md similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/_index.md rename to docs/content/guides/applications/control-plane/metrics/_index.md diff --git a/docs/content/guides/operations/control-plane/metrics/grafana/index.md b/docs/content/guides/applications/control-plane/metrics/grafana/index.md similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/grafana/index.md rename to docs/content/guides/applications/control-plane/metrics/grafana/index.md diff --git a/docs/content/guides/operations/control-plane/metrics/grafana/radius-overview-1.png b/docs/content/guides/applications/control-plane/metrics/grafana/radius-overview-1.png similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/grafana/radius-overview-1.png rename to docs/content/guides/applications/control-plane/metrics/grafana/radius-overview-1.png diff --git a/docs/content/guides/operations/control-plane/metrics/grafana/radius-overview-2.png b/docs/content/guides/applications/control-plane/metrics/grafana/radius-overview-2.png similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/grafana/radius-overview-2.png rename to docs/content/guides/applications/control-plane/metrics/grafana/radius-overview-2.png diff --git a/docs/content/guides/operations/control-plane/metrics/grafana/radius-resource-provider-1.png b/docs/content/guides/applications/control-plane/metrics/grafana/radius-resource-provider-1.png similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/grafana/radius-resource-provider-1.png rename to docs/content/guides/applications/control-plane/metrics/grafana/radius-resource-provider-1.png diff --git a/docs/content/guides/operations/control-plane/metrics/grafana/radius-resource-provider-2.png b/docs/content/guides/applications/control-plane/metrics/grafana/radius-resource-provider-2.png similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/grafana/radius-resource-provider-2.png rename to docs/content/guides/applications/control-plane/metrics/grafana/radius-resource-provider-2.png diff --git a/docs/content/guides/operations/control-plane/metrics/overview/index.md b/docs/content/guides/applications/control-plane/metrics/overview/index.md similarity index 100% rename from docs/content/guides/operations/control-plane/metrics/overview/index.md rename to docs/content/guides/applications/control-plane/metrics/overview/index.md diff --git a/docs/content/guides/operations/control-plane/metrics/prometheus/index.md b/docs/content/guides/applications/control-plane/metrics/prometheus/index.md similarity index 96% rename from docs/content/guides/operations/control-plane/metrics/prometheus/index.md rename to docs/content/guides/applications/control-plane/metrics/prometheus/index.md index 809f65469..28921017e 100644 --- a/docs/content/guides/operations/control-plane/metrics/prometheus/index.md +++ b/docs/content/guides/applications/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/installation/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/control-plane/traces/_index.md b/docs/content/guides/applications/control-plane/traces/_index.md similarity index 100% rename from docs/content/guides/operations/control-plane/traces/_index.md rename to docs/content/guides/applications/control-plane/traces/_index.md diff --git a/docs/content/guides/operations/control-plane/traces/jaeger/index.md b/docs/content/guides/applications/control-plane/traces/jaeger/index.md similarity index 100% rename from docs/content/guides/operations/control-plane/traces/jaeger/index.md rename to docs/content/guides/applications/control-plane/traces/jaeger/index.md diff --git a/docs/content/guides/operations/control-plane/traces/jaeger/jaeger.yaml b/docs/content/guides/applications/control-plane/traces/jaeger/jaeger.yaml similarity index 100% rename from docs/content/guides/operations/control-plane/traces/jaeger/jaeger.yaml rename to docs/content/guides/applications/control-plane/traces/jaeger/jaeger.yaml diff --git a/docs/content/guides/operations/control-plane/traces/jaeger/jaeger_ui.png b/docs/content/guides/applications/control-plane/traces/jaeger/jaeger_ui.png similarity index 100% rename from docs/content/guides/operations/control-plane/traces/jaeger/jaeger_ui.png rename to docs/content/guides/applications/control-plane/traces/jaeger/jaeger_ui.png diff --git a/docs/content/guides/operations/control-plane/traces/zipkin/index.md b/docs/content/guides/applications/control-plane/traces/zipkin/index.md similarity index 100% rename from docs/content/guides/operations/control-plane/traces/zipkin/index.md rename to docs/content/guides/applications/control-plane/traces/zipkin/index.md diff --git a/docs/content/guides/operations/control-plane/traces/zipkin/zipkin_ui.png b/docs/content/guides/applications/control-plane/traces/zipkin/zipkin_ui.png similarity index 100% rename from docs/content/guides/operations/control-plane/traces/zipkin/zipkin_ui.png rename to docs/content/guides/applications/control-plane/traces/zipkin/zipkin_ui.png diff --git a/docs/content/guides/author-apps/dapr/_index.md b/docs/content/guides/applications/dapr/_index.md similarity index 100% rename from docs/content/guides/author-apps/dapr/_index.md rename to docs/content/guides/applications/dapr/_index.md diff --git a/docs/content/guides/author-apps/dapr/how-to-dapr-building-block/app-statestore.png b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/dapr/how-to-dapr-sidecar/index.md similarity index 85% rename from docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md rename to docs/content/guides/applications/dapr/how-to-dapr-sidecar/index.md index 9f8f1c831..27b167c6f 100644 --- a/docs/content/guides/author-apps/dapr/how-to-dapr-sidecar/index.md +++ b/docs/content/guides/applications/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/installation/overview#supported-kubernetes-clusters" >}}) - rad CLI - [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/applications/containers" >}}): {{< rad file="snippets/app.bicep" embed=true >}} @@ -75,7 +75,7 @@ You've successfully deployed a Radius container with a Dapr sidecar! You can now ## Cleanup -Run the following command to [delete]({{< ref "guides/deploy-apps/howto-delete" >}}) your app and container: +Run the following command to [delete]({{< ref "guides/applications/howto-delete" >}}) your app and container: ```bash rad app delete -a demo @@ -84,5 +84,5 @@ Run the following command to [delete]({{< ref "guides/deploy-apps/howto-delete" ## Further reading - [Radius Dapr tutorial]({{< ref "reference/samples/tutorial-dapr" >}}) -- [Dapr in Radius containers]({{< ref "guides/author-apps/containers/overview#kubernetes" >}}) +- [Dapr in Radius containers]({{< ref "guides/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/dapr/overview/dapr-buildingblocks.png diff --git a/docs/content/guides/author-apps/dapr/overview/dapr-sidecar.png b/docs/content/guides/applications/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/applications/dapr/overview/dapr-sidecar.png diff --git a/docs/content/guides/author-apps/dapr/overview/index.md b/docs/content/guides/applications/dapr/overview/index.md similarity index 98% rename from docs/content/guides/author-apps/dapr/overview/index.md rename to docs/content/guides/applications/dapr/overview/index.md index c26f7668e..745cdb4c1 100644 --- a/docs/content/guides/author-apps/dapr/overview/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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/applications/dapr/overview/snippets/dapr-componentname.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/service-invocation.bicep b/docs/content/guides/applications/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/applications/dapr/overview/snippets/service-invocation.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/sidecar.bicep b/docs/content/guides/applications/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/applications/dapr/overview/snippets/sidecar.bicep diff --git a/docs/content/guides/author-apps/dapr/overview/snippets/statestore.bicep b/docs/content/guides/applications/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/applications/dapr/overview/snippets/statestore.bicep diff --git a/docs/content/guides/deploy-apps/gitops/_index.md b/docs/content/guides/applications/gitops/_index.md similarity index 100% rename from docs/content/guides/deploy-apps/gitops/_index.md rename to docs/content/guides/applications/gitops/_index.md diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/index.md b/docs/content/guides/applications/gitops/howto-flux/index.md similarity index 98% rename from docs/content/guides/deploy-apps/gitops/howto-flux/index.md rename to docs/content/guides/applications/gitops/howto-flux/index.md index e791fd110..bb38f4024 100644 --- a/docs/content/guides/deploy-apps/gitops/howto-flux/index.md +++ b/docs/content/guides/applications/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/installation/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/gitops/howto-flux/snippets/2-app-with-environment.bicep b/docs/content/guides/applications/gitops/howto-flux/snippets/2-app-with-environment.bicep similarity index 100% rename from docs/content/guides/deploy-apps/gitops/howto-flux/snippets/2-app-with-environment.bicep rename to docs/content/guides/applications/gitops/howto-flux/snippets/2-app-with-environment.bicep diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/snippets/2-radius-gitops-config.yaml b/docs/content/guides/applications/gitops/howto-flux/snippets/2-radius-gitops-config.yaml similarity index 100% rename from docs/content/guides/deploy-apps/gitops/howto-flux/snippets/2-radius-gitops-config.yaml rename to docs/content/guides/applications/gitops/howto-flux/snippets/2-radius-gitops-config.yaml diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/snippets/3-app-add-replicas.bicep b/docs/content/guides/applications/gitops/howto-flux/snippets/3-app-add-replicas.bicep similarity index 100% rename from docs/content/guides/deploy-apps/gitops/howto-flux/snippets/3-app-add-replicas.bicep rename to docs/content/guides/applications/gitops/howto-flux/snippets/3-app-add-replicas.bicep diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/snippets/3-app.bicepparam b/docs/content/guides/applications/gitops/howto-flux/snippets/3-app.bicepparam similarity index 100% rename from docs/content/guides/deploy-apps/gitops/howto-flux/snippets/3-app.bicepparam rename to docs/content/guides/applications/gitops/howto-flux/snippets/3-app.bicepparam diff --git a/docs/content/guides/deploy-apps/gitops/howto-flux/snippets/3-radius-gitops-config.yaml b/docs/content/guides/applications/gitops/howto-flux/snippets/3-radius-gitops-config.yaml similarity index 100% rename from docs/content/guides/deploy-apps/gitops/howto-flux/snippets/3-radius-gitops-config.yaml rename to docs/content/guides/applications/gitops/howto-flux/snippets/3-radius-gitops-config.yaml diff --git a/docs/content/guides/deploy-apps/gitops/overview/index.md b/docs/content/guides/applications/gitops/overview/index.md similarity index 97% rename from docs/content/guides/deploy-apps/gitops/overview/index.md rename to docs/content/guides/applications/gitops/overview/index.md index 5992fa3c0..c81fbc3ba 100644 --- a/docs/content/guides/deploy-apps/gitops/overview/index.md +++ b/docs/content/guides/applications/gitops/overview/index.md @@ -30,4 +30,4 @@ GitOps is a popular set of practices, implemented as popular tools like [Flux](h Today, Radius has integrated first-class support for [Flux](https://fluxcd.io/), a popular GitOps tool. Flux is designed to work with Kubernetes and provides a powerful set of features for managing applications and infrastructure through Git. -To get started with using Radius and Flux, check out the [how-to guide for Radius + Flux]({{< ref "guides/deploy-apps/gitops/howto-flux" >}}). +To get started with using Radius and Flux, check out the [how-to guide for Radius + Flux]({{< ref "guides/applications/gitops/howto-flux" >}}). diff --git a/docs/content/guides/deploy-apps/howto-delete/index.md b/docs/content/guides/applications/howto-delete/index.md similarity index 94% rename from docs/content/guides/deploy-apps/howto-delete/index.md rename to docs/content/guides/applications/howto-delete/index.md index bb7eda08a..d29612a63 100644 --- a/docs/content/guides/deploy-apps/howto-delete/index.md +++ b/docs/content/guides/applications/howto-delete/index.md @@ -10,7 +10,7 @@ tags: ["delete"] ## Pre-requisites -- A [deployed application]({{< ref deploy-apps >}}) in a Radius Environment. +- A [deployed application]({{< ref "guides/applications/howto-deploy" >}}) in a Radius Environment. ## Step 1: Delete the Radius Application from the environment diff --git a/docs/content/guides/deploy-apps/howto-deploy/_index.md b/docs/content/guides/applications/howto-deploy/_index.md similarity index 100% rename from docs/content/guides/deploy-apps/howto-deploy/_index.md rename to docs/content/guides/applications/howto-deploy/_index.md diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/icon.png b/docs/content/guides/applications/howto-deploy/howto-deploy-cicd/icon.png similarity index 100% rename from docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/icon.png rename to docs/content/guides/applications/howto-deploy/howto-deploy-cicd/icon.png diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md b/docs/content/guides/applications/howto-deploy/howto-deploy-cicd/index.md similarity index 95% rename from docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md rename to docs/content/guides/applications/howto-deploy/howto-deploy-cicd/index.md index a3f7c94f6..72987142e 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/index.md +++ b/docs/content/guides/applications/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/installation/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/installation/bicepconfig/overview" >}}) ```json { diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/snippets/app.bicep b/docs/content/guides/applications/howto-deploy/howto-deploy-cicd/snippets/app.bicep similarity index 100% rename from docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/snippets/app.bicep rename to docs/content/guides/applications/howto-deploy/howto-deploy-cicd/snippets/app.bicep diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/snippets/env.bicep b/docs/content/guides/applications/howto-deploy/howto-deploy-cicd/snippets/env.bicep similarity index 100% rename from docs/content/guides/deploy-apps/howto-deploy/howto-deploy-cicd/snippets/env.bicep rename to docs/content/guides/applications/howto-deploy/howto-deploy-cicd/snippets/env.bicep diff --git a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md b/docs/content/guides/applications/howto-deploy/howto-deploy-rad-cli/index.md similarity index 94% rename from docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md rename to docs/content/guides/applications/howto-deploy/howto-deploy-rad-cli/index.md index 3d6d33397..af1e73c4d 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-deploy-rad-cli/index.md +++ b/docs/content/guides/applications/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 "guides/applications" >}}) ## 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/applications/howto-deploy/howto-run-app/index.md similarity index 94% rename from docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md rename to docs/content/guides/applications/howto-deploy/howto-run-app/index.md index b9f168d21..e356f67fa 100644 --- a/docs/content/guides/deploy-apps/howto-deploy/howto-run-app/index.md +++ b/docs/content/guides/applications/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 "guides/applications" >}}) ## Step 1: Run an application diff --git a/docs/content/guides/deploy-apps/howto-troubleshootapps/index.md b/docs/content/guides/applications/howto-troubleshootapps/index.md similarity index 81% rename from docs/content/guides/deploy-apps/howto-troubleshootapps/index.md rename to docs/content/guides/applications/howto-troubleshootapps/index.md index 494b9569a..dda23bf50 100644 --- a/docs/content/guides/deploy-apps/howto-troubleshootapps/index.md +++ b/docs/content/guides/applications/howto-troubleshootapps/index.md @@ -10,7 +10,7 @@ tags: ["troubleshooting"] ## Pre-requisites -- A [deployed application]({{< ref deploy-apps >}}) in a Radius Environment. +- A [deployed application]({{< ref "guides/applications/howto-deploy" >}}) in a Radius Environment. ## Step 1: Port-forward container to your local machine @@ -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/applications/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/operations/kubernetes/kubernetes-metadata/index.md b/docs/content/guides/applications/kubernetes-metadata/index.md similarity index 97% rename from docs/content/guides/operations/kubernetes/kubernetes-metadata/index.md rename to docs/content/guides/applications/kubernetes-metadata/index.md index 226939407..e83cfcdff 100644 --- a/docs/content/guides/operations/kubernetes/kubernetes-metadata/index.md +++ b/docs/content/guides/applications/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/installation/overview#resource-mapping" >}}) from labels, annotations set at Environment, Application levels: - Applications.Core/containers - Applications.Core/gateways diff --git a/docs/content/guides/operations/kubernetes/kubernetes-metadata/snippets/env.bicep b/docs/content/guides/applications/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/applications/kubernetes-metadata/snippets/env.bicep diff --git a/docs/content/guides/author-apps/kubernetes/_index.md b/docs/content/guides/applications/kubernetes/_index.md similarity index 100% rename from docs/content/guides/author-apps/kubernetes/_index.md rename to docs/content/guides/applications/kubernetes/_index.md diff --git a/docs/content/guides/author-apps/kubernetes/how-to-access-secrets/index.md b/docs/content/guides/applications/kubernetes/how-to-access-secrets/index.md similarity index 93% rename from docs/content/guides/author-apps/kubernetes/how-to-access-secrets/index.md rename to docs/content/guides/applications/kubernetes/how-to-access-secrets/index.md index 3cee7bbc8..75388ee4f 100644 --- a/docs/content/guides/author-apps/kubernetes/how-to-access-secrets/index.md +++ b/docs/content/guides/applications/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/applications/containers" >}}): {{< rad file="snippets/secrets-container.bicep" embed=true >}} @@ -137,7 +137,7 @@ kubectl -n dev-demo exec demo-d64cc4d6d-xjnjz -- env | findstr MY_SECRET ## Cleanup -Run the following command to [delete]({{< ref "guides/deploy-apps/howto-delete" >}}) your app and container: +Run the following command to [delete]({{< ref "guides/applications/howto-delete" >}}) your app and container: ```bash rad app delete demo @@ -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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/kubernetes/how-to-kubernetes-resource/index.md similarity index 90% rename from docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/index.md rename to docs/content/guides/applications/kubernetes/how-to-kubernetes-resource/index.md index 0e3fa11da..9fe9ae8a6 100644 --- a/docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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/applications/containers/overview#kubernetes" >}}) diff --git a/docs/content/guides/author-apps/kubernetes/how-to-kubernetes-resource/snippets/app-kubernetes.bicep b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/kubernetes/how-to-patch-pod/index.md similarity index 95% rename from docs/content/guides/author-apps/kubernetes/how-to-patch-pod/index.md rename to docs/content/guides/applications/kubernetes/how-to-patch-pod/index.md index 0b3248a08..2f05615ff 100644 --- a/docs/content/guides/author-apps/kubernetes/how-to-patch-pod/index.md +++ b/docs/content/guides/applications/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/applications/containers" >}}): {{< rad file="snippets/patch-container.bicep" embed=true >}} @@ -124,7 +124,7 @@ Add the following [`runtimes`]({{< ref "reference/resource-schema/core-schema/co ## Cleanup -Run the following command to [delete]({{< ref "guides/deploy-apps/howto-delete" >}}) your app and container: +Run the following command to [delete]({{< ref "guides/applications/howto-delete" >}}) your app and container: ```bash rad app delete demo @@ -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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/kubernetes/overview/index.md similarity index 100% rename from docs/content/guides/author-apps/kubernetes/overview/index.md rename to docs/content/guides/applications/kubernetes/overview/index.md diff --git a/docs/content/guides/author-apps/kubernetes/overview/snippets/kubernetes-connection.bicep b/docs/content/guides/applications/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/applications/kubernetes/overview/snippets/kubernetes-connection.bicep diff --git a/docs/content/guides/author-apps/kubernetes/overview/snippets/kubernetes-resource.bicep b/docs/content/guides/applications/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/applications/kubernetes/overview/snippets/kubernetes-resource.bicep diff --git a/docs/content/guides/author-apps/networking/_index.md b/docs/content/guides/applications/networking/_index.md similarity index 100% rename from docs/content/guides/author-apps/networking/_index.md rename to docs/content/guides/applications/networking/_index.md diff --git a/docs/content/guides/author-apps/networking/howto-gateways/demo-screenshot.png b/docs/content/guides/applications/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/applications/networking/howto-gateways/demo-screenshot.png diff --git a/docs/content/guides/author-apps/networking/howto-gateways/index.md b/docs/content/guides/applications/networking/howto-gateways/index.md similarity index 96% rename from docs/content/guides/author-apps/networking/howto-gateways/index.md rename to docs/content/guides/applications/networking/howto-gateways/index.md index aa053a75a..af996cdef 100644 --- a/docs/content/guides/author-apps/networking/howto-gateways/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/networking/howto-service-networking/index.md diff --git a/docs/content/guides/author-apps/networking/howto-service-networking/overview.png b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/networking/howto-tls/https-app.png diff --git a/docs/content/guides/author-apps/networking/howto-tls/index.md b/docs/content/guides/applications/networking/howto-tls/index.md similarity index 94% rename from docs/content/guides/author-apps/networking/howto-tls/index.md rename to docs/content/guides/applications/networking/howto-tls/index.md index d03221824..dde9980f2 100644 --- a/docs/content/guides/author-apps/networking/howto-tls/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/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/applications/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/applications/networking/howto-tls/snippets/app-new.bicep diff --git a/docs/content/guides/author-apps/networking/overview/index.md b/docs/content/guides/applications/networking/overview/index.md similarity index 100% rename from docs/content/guides/author-apps/networking/overview/index.md rename to docs/content/guides/applications/networking/overview/index.md diff --git a/docs/content/guides/author-apps/networking/overview/network-connection.png b/docs/content/guides/applications/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/applications/networking/overview/network-connection.png diff --git a/docs/content/guides/author-apps/networking/overview/networking.png b/docs/content/guides/applications/networking/overview/networking.png similarity index 100% rename from docs/content/guides/author-apps/networking/overview/networking.png rename to docs/content/guides/applications/networking/overview/networking.png diff --git a/docs/content/guides/author-apps/secrets/_index.md b/docs/content/guides/applications/secrets/_index.md similarity index 100% rename from docs/content/guides/author-apps/secrets/_index.md rename to docs/content/guides/applications/secrets/_index.md diff --git a/docs/content/guides/author-apps/secrets/howto-new-secretstore/index.md b/docs/content/guides/applications/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/applications/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/applications/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/applications/secrets/howto-new-secretstore/snippets/secretstore.bicep diff --git a/docs/content/guides/author-apps/secrets/overview/index.md b/docs/content/guides/applications/secrets/overview/index.md similarity index 88% rename from docs/content/guides/author-apps/secrets/overview/index.md rename to docs/content/guides/applications/secrets/overview/index.md index 8a4e1f9fa..3b669eff0 100644 --- a/docs/content/guides/author-apps/secrets/overview/index.md +++ b/docs/content/guides/applications/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/applications/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/applications/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/applications/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/applications/secrets/overview/snippets/secretstore.bicep diff --git a/docs/content/guides/author-apps/_index.md b/docs/content/guides/author-apps/_index.md deleted file mode 100644 index e5bc51a70..000000000 --- a/docs/content/guides/author-apps/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Authoring applications" -linkTitle: "Authoring applications" -description: "Learn how to author a Radius Application" -weight: 100 ---- \ No newline at end of file diff --git a/docs/content/guides/deploy-apps/_index.md b/docs/content/guides/deploy-apps/_index.md deleted file mode 100644 index 644ee0238..000000000 --- a/docs/content/guides/deploy-apps/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -type: docs -title: "Deploying applications" -linkTitle: "Deploying applications" -description: "Learn how to deploy a Radius Application to an environment" -weight: 200 ---- \ No newline at end of file diff --git a/docs/content/guides/operations/_index.md b/docs/content/guides/environments/_index.md similarity index 60% rename from docs/content/guides/operations/_index.md rename to docs/content/guides/environments/_index.md index 8356acae6..0a0886f95 100644 --- a/docs/content/guides/operations/_index.md +++ b/docs/content/guides/environments/_index.md @@ -1,7 +1,7 @@ --- type: docs -title: "Environment operations guides" -linkTitle: "Operations" +title: "Environments" +linkTitle: "Environments" description: "Learn how to deploy and operate Radius Environments" weight: 400 --- diff --git a/docs/content/guides/deploy-apps/environments/_index.md b/docs/content/guides/environments/environments/_index.md similarity index 100% rename from docs/content/guides/deploy-apps/environments/_index.md rename to docs/content/guides/environments/environments/_index.md diff --git a/docs/content/guides/deploy-apps/environments/howto-environment/index.md b/docs/content/guides/environments/environments/howto-environment/index.md similarity index 95% rename from docs/content/guides/deploy-apps/environments/howto-environment/index.md rename to docs/content/guides/environments/environments/howto-environment/index.md index 45b174a64..8eeee31b4 100644 --- a/docs/content/guides/deploy-apps/environments/howto-environment/index.md +++ b/docs/content/guides/environments/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/installation/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/installation/bicepconfig/overview" >}}) files ``` Initializing Radius... @@ -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/installation/providers/azure-provider" >}}) + - **AWS provider** (optional) - Allows you to [deploy and manage AWS resources]({{< ref "/guides/installation/providers/aws-provider" >}}) - **Environment name** - The name of the environment to create You should see the following output: diff --git a/docs/content/guides/operations/groups/_index.md b/docs/content/guides/environments/groups/_index.md similarity index 100% rename from docs/content/guides/operations/groups/_index.md rename to docs/content/guides/environments/groups/_index.md diff --git a/docs/content/guides/operations/groups/howto-resourcegroups/index.md b/docs/content/guides/environments/groups/howto-resourcegroups/index.md similarity index 95% rename from docs/content/guides/operations/groups/howto-resourcegroups/index.md rename to docs/content/guides/environments/groups/howto-resourcegroups/index.md index 7ff18769e..2d7650bf8 100644 --- a/docs/content/guides/operations/groups/howto-resourcegroups/index.md +++ b/docs/content/guides/environments/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/installation/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/environments/groups/overview/group-diagram.png similarity index 100% rename from docs/content/guides/operations/groups/overview/group-diagram.png rename to docs/content/guides/environments/groups/overview/group-diagram.png diff --git a/docs/content/guides/operations/groups/overview/group.svg b/docs/content/guides/environments/groups/overview/group.svg similarity index 100% rename from docs/content/guides/operations/groups/overview/group.svg rename to docs/content/guides/environments/groups/overview/group.svg diff --git a/docs/content/guides/operations/groups/overview/index.md b/docs/content/guides/environments/groups/overview/index.md similarity index 100% rename from docs/content/guides/operations/groups/overview/index.md rename to docs/content/guides/environments/groups/overview/index.md diff --git a/docs/content/guides/operations/workspaces/_index.md b/docs/content/guides/environments/workspaces/_index.md similarity index 100% rename from docs/content/guides/operations/workspaces/_index.md rename to docs/content/guides/environments/workspaces/_index.md diff --git a/docs/content/guides/operations/workspaces/howto-workspaces/index.md b/docs/content/guides/environments/workspaces/howto-workspaces/index.md similarity index 96% rename from docs/content/guides/operations/workspaces/howto-workspaces/index.md rename to docs/content/guides/environments/workspaces/howto-workspaces/index.md index 6640b511b..bc77cdf0a 100644 --- a/docs/content/guides/operations/workspaces/howto-workspaces/index.md +++ b/docs/content/guides/environments/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/installation/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/environments/workspaces/overview/index.md similarity index 100% rename from docs/content/guides/operations/workspaces/overview/index.md rename to docs/content/guides/environments/workspaces/overview/index.md diff --git a/docs/content/guides/operations/workspaces/overview/workspaces.png b/docs/content/guides/environments/workspaces/overview/workspaces.png similarity index 100% rename from docs/content/guides/operations/workspaces/overview/workspaces.png rename to docs/content/guides/environments/workspaces/overview/workspaces.png diff --git a/docs/content/guides/installation/_index.md b/docs/content/guides/installation/_index.md new file mode 100644 index 000000000..54af46fa9 --- /dev/null +++ b/docs/content/guides/installation/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Installation" +linkTitle: "Installation" +description: "Install Radius on Kubernetes, configure cloud providers, and set up developer workstations" +weight: 100 +--- diff --git a/docs/content/guides/tooling/bicepconfig/_index.md b/docs/content/guides/installation/bicepconfig/_index.md similarity index 100% rename from docs/content/guides/tooling/bicepconfig/_index.md rename to docs/content/guides/installation/bicepconfig/_index.md diff --git a/docs/content/guides/tooling/bicepconfig/overview/index.md b/docs/content/guides/installation/bicepconfig/overview/index.md similarity index 100% rename from docs/content/guides/tooling/bicepconfig/overview/index.md rename to docs/content/guides/installation/bicepconfig/overview/index.md diff --git a/docs/content/guides/tooling/bicepconfig/overview/snippets/app.bicep b/docs/content/guides/installation/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/bicepconfig/overview/snippets/app.bicep diff --git a/docs/content/guides/tooling/dashboard/_index.md b/docs/content/guides/installation/dashboard/_index.md similarity index 100% rename from docs/content/guides/tooling/dashboard/_index.md rename to docs/content/guides/installation/dashboard/_index.md diff --git a/docs/content/guides/tooling/dashboard/overview/dashboard-home.png b/docs/content/guides/installation/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/dashboard/overview/dashboard-home.png diff --git a/docs/content/guides/tooling/dashboard/overview/index.md b/docs/content/guides/installation/dashboard/overview/index.md similarity index 97% rename from docs/content/guides/tooling/dashboard/overview/index.md rename to docs/content/guides/installation/dashboard/overview/index.md index bdec6e3d1..a73fb35b9 100644 --- a/docs/content/guides/tooling/dashboard/overview/index.md +++ b/docs/content/guides/installation/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/installation/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/operations/kubernetes/kubernetes-install/index.md b/docs/content/guides/installation/kubernetes-install/index.md similarity index 97% rename from docs/content/guides/operations/kubernetes/kubernetes-install/index.md rename to docs/content/guides/installation/kubernetes-install/index.md index 960a9e740..43cc88754 100644 --- a/docs/content/guides/operations/kubernetes/kubernetes-install/index.md +++ b/docs/content/guides/installation/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/installation/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/operations/kubernetes/kubernetes-rollback/index.md b/docs/content/guides/installation/kubernetes-rollback/index.md similarity index 94% rename from docs/content/guides/operations/kubernetes/kubernetes-rollback/index.md rename to docs/content/guides/installation/kubernetes-rollback/index.md index 94214d97a..0894d2bf1 100644 --- a/docs/content/guides/operations/kubernetes/kubernetes-rollback/index.md +++ b/docs/content/guides/installation/kubernetes-rollback/index.md @@ -12,7 +12,7 @@ Radius supports rolling back to previous versions on Kubernetes clusters using t ## Prerequisites -- [Radius installed on Kubernetes cluster]({{< ref "guides/operations/kubernetes/kubernetes-install" >}}) +- [Radius installed on Kubernetes cluster]({{< ref "guides/installation/kubernetes-install" >}}) - [rad CLI]({{< ref howto-rad-cli >}}) - Previous Radius installation to rollback to @@ -179,7 +179,7 @@ helm rollback radius 2 -n radius-system ## Next steps -- Learn about [upgrading Radius]({{< ref "guides/operations/kubernetes/kubernetes-upgrade" >}}) -- Review [Radius versioning]({{< ref "guides/operations/versioning" >}}) for version compatibility +- Learn about [upgrading Radius]({{< ref "guides/installation/kubernetes-upgrade" >}}) +- Review [Radius versioning]({{< ref "reference/limitations" >}}) for version compatibility - Check [release notes](https://github.com/radius-project/radius/releases) for version-specific information - Refer to the [`rad rollback kubernetes`]({{< ref "reference/cli/rad_rollback_kubernetes" >}}) CLI reference docs for more details diff --git a/docs/content/guides/operations/kubernetes/kubernetes-uninstall/index.md b/docs/content/guides/installation/kubernetes-uninstall/index.md similarity index 84% rename from docs/content/guides/operations/kubernetes/kubernetes-uninstall/index.md rename to docs/content/guides/installation/kubernetes-uninstall/index.md index de50faeb6..cd3130b8b 100644 --- a/docs/content/guides/operations/kubernetes/kubernetes-uninstall/index.md +++ b/docs/content/guides/installation/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/installation/kubernetes-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/installation/rad-cli/overview#binary-location" >}}) and ~/.rad folder from your machine. \ No newline at end of file diff --git a/docs/content/guides/operations/kubernetes/kubernetes-upgrade/index.md b/docs/content/guides/installation/kubernetes-upgrade/index.md similarity index 90% rename from docs/content/guides/operations/kubernetes/kubernetes-upgrade/index.md rename to docs/content/guides/installation/kubernetes-upgrade/index.md index f68837244..dd6853d8a 100644 --- a/docs/content/guides/operations/kubernetes/kubernetes-upgrade/index.md +++ b/docs/content/guides/installation/kubernetes-upgrade/index.md @@ -12,7 +12,7 @@ Radius supports in-place upgrades on Kubernetes clusters using the `rad upgrade ## Prerequisites -- [Radius installed on Kubernetes cluster]({{< ref "guides/operations/kubernetes/kubernetes-install" >}}) +- [Radius installed on Kubernetes cluster]({{< ref "guides/installation/kubernetes-install" >}}) - [Latest rad CLI]({{< ref howto-rad-cli >}}) ## Step 1: Upgrade the rad CLI @@ -81,7 +81,7 @@ While Radius supports in-place upgrades, breaking changes may still occur betwee ### Rollback capability -If an upgrade encounters issues, you can rollback to a previous version using the [`rad rollback kubernetes` command]({{< ref "guides/operations/kubernetes/kubernetes-rollback" >}}). +If an upgrade encounters issues, you can rollback to a previous version using the [`rad rollback kubernetes` command]({{< ref "guides/installation/kubernetes-rollback" >}}). It's recommended to backup your environment configurations before upgrading, which you may do with something like `rad env show -o json > env-backup.json`. @@ -115,6 +115,6 @@ If you prefer to do a fresh installation instead of an in-place upgrade, follow ## Next steps -- Learn how to [rollback Radius]({{< ref "guides/operations/kubernetes/kubernetes-rollback" >}}) if needed -- Review [Radius versioning]({{< ref "guides/operations/versioning" >}}) for version compatibility information +- Learn how to [rollback Radius]({{< ref "guides/installation/kubernetes-rollback" >}}) if needed +- Review [Radius versioning]({{< ref "reference/limitations" >}}) for version compatibility information - Refer to the [`rad upgrade`]({{< ref "reference/cli/rad_upgrade_kubernetes" >}}) CLI reference docs for more details diff --git a/docs/content/guides/operations/kubernetes/overview/index.md b/docs/content/guides/installation/overview/index.md similarity index 98% rename from docs/content/guides/operations/kubernetes/overview/index.md rename to docs/content/guides/installation/overview/index.md index 03e48d978..4b41fdde5 100644 --- a/docs/content/guides/operations/kubernetes/overview/index.md +++ b/docs/content/guides/installation/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 "concepts/environments" >}}). +Radius offers a Kubernetes-based platform for hosting the [Radius control plane]({{< ref "/guides/applications/control-plane" >}}) and [Radius Environments]({{< ref "concepts/environments" >}}). {{< image src="kubernetes-mapping.png" alt="Diagram showing Radius resources being mapped to Kubernetes objects" width=600px >}} diff --git a/docs/content/guides/operations/kubernetes/overview/kubernetes-mapping.png b/docs/content/guides/installation/overview/kubernetes-mapping.png similarity index 100% rename from docs/content/guides/operations/kubernetes/overview/kubernetes-mapping.png rename to docs/content/guides/installation/overview/kubernetes-mapping.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 98% 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 index 8e0728616..8bcb289e6 100644 --- 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 @@ -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/installation/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/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 97% 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 index fc2bd7415..81038e2dc 100644 --- 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 @@ -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/installation/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/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/tooling/rad-cli/_index.md b/docs/content/guides/installation/rad-cli/_index.md similarity index 100% rename from docs/content/guides/tooling/rad-cli/_index.md rename to docs/content/guides/installation/rad-cli/_index.md diff --git a/docs/content/guides/tooling/rad-cli/howto-rad-cli/index.md b/docs/content/guides/installation/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/rad-cli/howto-rad-cli/index.md diff --git a/docs/content/guides/tooling/rad-cli/overview/index.md b/docs/content/guides/installation/rad-cli/overview/index.md similarity index 93% rename from docs/content/guides/tooling/rad-cli/overview/index.md rename to docs/content/guides/installation/rad-cli/overview/index.md index 163cb75d0..fe60331e3 100644 --- a/docs/content/guides/tooling/rad-cli/overview/index.md +++ b/docs/content/guides/installation/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 "concepts/environments" >}}). +The rad CLI stores its configuration in a YAML file named `config.yaml` under the `rad` directory. This file contains [workspaces]({{< ref "/guides/environments/workspaces/overview" >}}), which point to your cluster, your default [resource group]({{< ref "/guides/environments/groups/overview" >}}), and your default [environment]({{< ref "concepts/environments" >}}). 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/versioning.md b/docs/content/guides/installation/versioning.md similarity index 100% rename from docs/content/guides/operations/versioning.md rename to docs/content/guides/installation/versioning.md diff --git a/docs/content/guides/tooling/vscode/_index.md b/docs/content/guides/installation/vscode/_index.md similarity index 100% rename from docs/content/guides/tooling/vscode/_index.md rename to docs/content/guides/installation/vscode/_index.md diff --git a/docs/content/guides/tooling/vscode/howto-vscode-bicep/index.md b/docs/content/guides/installation/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/vscode/howto-vscode-bicep/index.md diff --git a/docs/content/guides/tooling/vscode/overview/index.md b/docs/content/guides/installation/vscode/overview/index.md similarity index 100% rename from docs/content/guides/tooling/vscode/overview/index.md rename to docs/content/guides/installation/vscode/overview/index.md diff --git a/docs/content/guides/tooling/vscode/overview/vscode-bicep.png b/docs/content/guides/installation/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/vscode/overview/vscode-bicep.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/recipes/howto-dev-recipes/index.md b/docs/content/guides/recipes/howto-dev-recipes/index.md index 03711ee8e..eb8852110 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/installation/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/installation/bicepconfig/overview" >}}) ## Step 3: Define your application 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 c8474921f..1cb897e8b 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/applications/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/applications/secrets/overview" >}}) for more information. Secret store example for secret type `awsIRSA`: {{< rad file="snippets/env.bicep" embed=true marker="//SECRETSTORE" >}} 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 8e684ff74..7bfc56841 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/applications/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/applications/secrets/overview" >}}) for more information. Create a Bicep file `env.bicep` with the secretStore resource: 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 60fd2fdc0..c894b83a8 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 username and personal access token (or password) you previously created. Both are required to access 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/applications/secrets/overview" >}}) with the username and personal access token (or password) you previously created. Both are required to access 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/applications/secrets/overview" >}}) for more information. Create a Bicep file `env.bicep`, import Radius, and define your resource: diff --git a/docs/content/guides/resource-types/_index.md b/docs/content/guides/resource-types/_index.md new file mode 100644 index 000000000..5cbe42b5d --- /dev/null +++ b/docs/content/guides/resource-types/_index.md @@ -0,0 +1,7 @@ +--- +type: docs +title: "Resource Types" +linkTitle: "Resource Types" +description: "Learn about the different resource types available in Radius" +weight: 200 +--- diff --git a/docs/content/guides/author-apps/portable-resources/_index.md b/docs/content/guides/resource-types/portable-resources/_index.md similarity index 100% rename from docs/content/guides/author-apps/portable-resources/_index.md rename to docs/content/guides/resource-types/portable-resources/_index.md 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-resources/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-resources/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-resources/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-resources/howto-author-portable-resources/index.md index 9d948d136..46baf7f0a 100644 --- a/docs/content/guides/author-apps/portable-resources/howto-author-portable-resources/index.md +++ b/docs/content/guides/resource-types/portable-resources/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-resources/overview" >}}) - [Radius Application overview]({{< ref "concepts/applications" >}}) 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-resources/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-resources/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-resources/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-resources/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-resources/overview/index.md similarity index 100% rename from docs/content/guides/author-apps/portable-resources/overview/index.md rename to docs/content/guides/resource-types/portable-resources/overview/index.md diff --git a/docs/content/guides/author-apps/portable-resources/overview/portable-resources.png b/docs/content/guides/resource-types/portable-resources/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-resources/overview/portable-resources.png 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 ---- diff --git a/docs/content/quick-start/index.md b/docs/content/quick-start/index.md index f84a71484..3c79e069e 100644 --- a/docs/content/quick-start/index.md +++ b/docs/content/quick-start/index.md @@ -16,7 +16,7 @@ This guide will show you how to quickly get started with Radius. You will do a b ## Prerequisites -For this quick start, you will only need a **Kubernetes cluster**. To install Radius your user must have the cluster-admin role. Radius supports AKS, EKS, k3d, and kind clusters. For this quick start, running a Kubernetes cluster on your workstation with k3d or kind is recommended. +For this quick start, you will only need a **Kubernetes cluster**. To install Radius your user must have the cluster-admin role. Radius supports AKS, EKS, k3d, and kind clusters. For this quick start, running a Kubernetes cluster on your workstation with k3d or kind is recommended. ## Install the Radius CLI diff --git a/docs/content/reference/limitations.md b/docs/content/reference/limitations.md index ac24eb403..5fc233682 100644 --- a/docs/content/reference/limitations.md +++ b/docs/content/reference/limitations.md @@ -49,7 +49,7 @@ As a workaround make sure to use distinct names for both containers and gateways 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/installation/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 1fa90076c..7542043ce 100644 --- a/docs/content/reference/resource-schema/cache/redis/index.md +++ b/docs/content/reference/resource-schema/cache/redis/index.md @@ -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. 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/applications/containers" >}}), may connect to a Redis resource via connections. 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 9571361a1..537262fda 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/installation/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/applications/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 10ad264f2..4061caa56 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/applications/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 @@ -176,7 +176,7 @@ 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) #### ACI 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 90dae76e9..52ef8d9f2 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 @@ -103,7 +103,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/applications/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/dapr-schema/dapr-configurationStore/index.md b/docs/content/reference/resource-schema/dapr-schema/dapr-configurationStore/index.md index a37bef48f..c7fa8cfe1 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. 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/applications/containers" >}}), may connect to a Dapr configuration store resource via connections. 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..59a9d2f89 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/applications/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 2e738b55e..be1d9b66b 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. 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/applications/containers" >}}), may connect to a Dapr pub/sub resource via connections. 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 ee3e9a271..f2979a3d5 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. 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/applications/containers" >}}), may connect to a Dapr secret store resource via connections. 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 37207f315..f6e141f53 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. 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/applications/containers" >}}), may connect to a Dapr state store resource via connections. 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 ad6d8e9ab..fe0e66998 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. 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/applications/containers" >}}), may connect to a Azure SQL resource via connections. 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 a5b72857d..311097a7d 100644 --- a/docs/content/reference/resource-schema/databases/mongodb/index.md +++ b/docs/content/reference/resource-schema/databases/mongodb/index.md @@ -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. 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/applications/containers" >}}), may connect to a MongoDB resource via connections. 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 cf54f14b6..44bd69cf8 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. 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/applications/containers" >}}), may connect to a RabbitMQ resource via connections. 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/reference/samples/helm/index.md b/docs/content/reference/samples/helm/index.md index beef78ea8..71cc6324d 100644 --- a/docs/content/reference/samples/helm/index.md +++ b/docs/content/reference/samples/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/installation/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/environments/groups/overview" >}}) are a way to organize resources in Radius. The output should look like this: diff --git a/docs/content/reference/samples/tutorial-add-radius/index.md b/docs/content/reference/samples/tutorial-add-radius/index.md index c24f9ef67..80bf1f05e 100644 --- a/docs/content/reference/samples/tutorial-add-radius/index.md +++ b/docs/content/reference/samples/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/installation/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 "concepts/recipes" >}}), 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/applications/containers/overview#connections" >}}), [Recipes]({{< ref "concepts/recipes" >}}), 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 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 "reference/samples/helm#step-6-add-connection" >}}) +- To learn more about authoring Radius applications, visit the [Authoring applications guide]({{< ref "guides/applications" >}}) +- To learn more about deploying applications using Radius, visit the [Deploying applications guide]({{< ref "guides/applications/howto-deploy" >}}) +- To learn more about using the [Radius Connections]({{< ref "guides/applications/containers/overview#connections" >}}) annotations to connect your containers and resources, visit the [Radius Helm tutorial]({{< ref "reference/samples/helm#step-6-add-connection" >}}) - To learn more about Radius Recipes, visit the [Recipes guide]({{< ref "guides/recipes" >}}) diff --git a/docs/content/reference/samples/tutorial-dapr/index.md b/docs/content/reference/samples/tutorial-dapr/index.md index 88b63b1c9..b076c0bba 100644 --- a/docs/content/reference/samples/tutorial-dapr/index.md +++ b/docs/content/reference/samples/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/applications/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/operations/kubernetes/overview/#supported-clusters) +- [Setup a supported Kubernetes cluster](https://docs.radapp.io/guides/installation/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/applications/containers" >}}) which will serve as the application's user interface. {{< rad file="snippets/dapr.bicep" embed=true marker="//FRONTEND" >}} diff --git a/docs/shared-content/installation/_index.md b/docs/shared-content/installation/_index.md new file mode 100644 index 000000000..ca03031f1 --- /dev/null +++ b/docs/shared-content/installation/_index.md @@ -0,0 +1,3 @@ +--- +headless: true +--- diff --git a/docs/shared-content/installation/install-radius/initialize-radius.md b/docs/shared-content/installation/install-radius/initialize-radius.md index 597fc7470..9af80bc38 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/installation" >}}). Create one from the [supported k8s clusters]({{< ref "/guides/installation/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: @@ -17,7 +17,7 @@ Initializing Radius installs the Radius control-plane and creates a Radius Envir 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/installation/bicepconfig/overview" >}}) files ``` Initializing Radius...