Merge branch 'edge' into reshma/troubleshootingapps

docs/content/guides/author-apps/containers/overview/index.md

@@ -8,41 +8,41 @@ categories: "Overview"
 tags: ["containers"]
 ---
 
-A Radius container provides an abstraction to model and run your container workloads as part of your Radius application. 
+A Radius container enables you to run a container workload as part of your application across different platforms and runtimes. Your container can be a frontend UI, a backend API, a database, or any other container you need to run as part of your app. Plus, with Radius connections, you can easily connect your container to other resources in your application, such as databases, message queues, and more and automatically configure your container with identity, secrets, and other configuration.
 
-{{< rad file="snippets/container.bicep" embed=true marker="//CONTAINER" >}}
+<img src="containers-splash.png" alt="Container graphic" width=300px >
 
-## Supported runtimes
-
-Containers are run on the same Kubernetes cluster as your [Radius installation]({{< ref "guides/operations/kubernetes" >}}). We plan to support additional container runtimes and configurations in the future
+> Adding a container and want to jump to the reference docs? Check out the [container resource schema]({{< ref "container-schema" >}}).
 
-## Capabilities
+## Supported runtimes
 
-Radius containers enables you to specify the image for the container, the ports the container provides and consumes, the environment variables to set, the volumes to mount, and the probes to run.
+Radius containers are portable across container runtimes, allowing you to define your container workload once and run it on any of the supported runtimes.
 
-Additionally you can customize the behavior of the containers with the help of [extensions](#extensions).
+### Kubernetes
 
-### Image
+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" >}}).
 
-An image can be specified for your container workload to pull and run. Refer to the [container reference docs]({{< ref container-schema >}}) for more information on image requirements.
+## Container definition
 
-If you want to pull the container image from a private container register, you need to allow access from your Kubernetes cluster. Follow the documentation to [configure private container registries access]({{< ref "/guides/operations/kubernetes/overview#configure-container-registry-access" >}}).
+Radius containers allow you to specify your image, ports, environment variables, volumes, and more. Refer to the [container resource schema]({{< ref "container-schema" >}}) for more information.
 
 ### Ports
 
 Ports allow you to expose your container to incoming network traffic. Refer to the [networking guide]({{< ref networking >}}) for more information on container networking.
 
-### Volumes
+## Volumes
 
-The volumes mounted to the container, either ephemeral or persistent, are defined in the volumes section.
+Volumes can be mounted to the container to provide access to data. There are two types of volumes, ephemeral and persistent.
 
 Ephemeral volumes have the same lifecycle as the container, being deployed and deleted with the container. They create an empty directory on the host and mount it to the container.
 
 Persistent volumes have life cycles that are separate from the container. Containers can mount these persistent volumes and restart without losing data. Persistent volumes can also be useful for storing data that needs to be accessed by multiple containers.
 
-### Probes
+## Health Probes
+
+Health probes are used to determine the health of a container. There are two types of probes, readiness and liveness. For more information on how to setup health probes, refer to the [container resource schema]({{< ref "container-schema" >}}).
 
-#### Readiness Probe
+### Readiness Probe
 
 Readiness probes detect when a container begins reporting it is ready to receive traffic, such as after loading a large configuration file that may take a couple seconds to process. There are three types of probes available, httpGet, tcp and exec. 
 
@@ -54,7 +54,7 @@ For an **exec probe**, a command is run within the container. A return code of 0
 
 Refer to the readiness probes section of the [container resource schema]({{< ref "container-schema#readiness-probes" >}}) for more details.
 
-#### Liveness Probe
+### Liveness Probe
 
 Liveness probes detect when a container is in a broken state, restarting the container to return it to a healthy state. There are three types of probes available, httpGet, tcp and exec.
 
@@ -66,45 +66,39 @@ For an **exec probe**, a command is run within the container. A return code of 0
 
 Refer to the probes section of the [container resource schema]({{< ref "container-schema#liveness-probes" >}}) for more details.
 
-### Connections
+## Connections
 
 When a connection between two resources is declared, Radius injects resource related information into environment variables that are then used to access the respective resource without having to hard code URIs, connection strings, access keys, or anything that application code needs to successfully communicate.
 
 These environment variables follow a naming convention that makes their use predictable. The naming pattern is derived from the connection name and resource type, which determines what values are required. This way the code that needs to read the values gets to define how they are named. Refer to the [reference documentation]({{< ref resource-schema >}}) of each resource for more information. 
 
-For example, adding a connection called `myconnection` that connects to a MongoDB resource would result in the following environment variables being injected:
+For example, adding a connection called `database` that connects to a MongoDB resource would result in the following environment variables being injected:
 
-```sh
-# the connection string to the resource
-CONNECTION_MYCONNECTION_CONNECTIONSTRING="mongodb://mongo:27017/mongo?authSource=admin"
-# Database name of the target resource
-CONNECTION_MYCONNECTION_DATABASE="my-database"
-# Username of the target resource
-CONNECTION_MYCONNECTION_USERNAME="admin"
-```
+| Key | Value |
+|-----|-------|
+| `CONNECTION_DATABASE_CONNECTIONSTRING` | The connection string to the database |
+| `CONNECTION_DATABASE_DATABASE` | Database name of the target database |
+| `CONNECTION_DATABASE_USERNAME` | Username of the target database |
+| `CONNECTION_DATABASE_PASSWORD` | Password of the target database |
 
 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. Refer to the [environment variables how-to guide]({{< ref howto-environment-variables >}}) for more details.
 
-### Extensions
+## Extensions
 
 Extensions define additional capabilities and configuration for a container.
 
-#### Kubernetes metadata extension
+### Kubernetes metadata extension
 
 The [Kubernetes metadata extension]({{< ref kubernetes-metadata>}}) enables you to configure the Kubernetes metadata for the container. This includes the labels and annotations for the container. Refer to to the extension overview page to get more details about the extension and how it works with other Radius resources.
 
-#### Manual scaling extension
+### Manual scaling extension
 
 The manualScaling extension configures the number of replicas of a compute instance (such as a container) to run. Refer to the [container resource schema]({{< ref "container-schema#extensions" >}}) for more details.
 
-#### Dapr sidecar extension
+### Dapr sidecar extension
 
 The `daprSidecar` extensions adds and configures a [Dapr](https://dapr.io) sidecar to your application. Refer to the [container resource schema]({{< ref "container-schema#extensions" >}}) for more details
 
-## Resource schema 
-
-- [Container schema]({{< ref container-schema >}})
-
 ## Further reading
 
-{{< categorizeby category="How-To" tag="containers" >}}
+- [Container schema]({{< ref container-schema >}})

docs/content/guides/operations/kubernetes/kubernetes-metadata/index.md

@@ -3,7 +3,7 @@ type: docs
 title: "Set Kubernetes metadata"
 linkTitle: "Kubernetes metadata"
 description: "Learn how to configure Kubernetes labels and annotations for generated objects"
-weight: 300
+weight: 400
 categories: "How-To"
 tags: ["containers","Kubernetes","applications","environments"]
 ---

docs/content/guides/operations/kubernetes/kubernetes-upgrade/index.md

@@ -0,0 +1,52 @@
+---
+type: docs
+title: "How-To: Upgrade Radius on Kubernetes "
+linkTitle: "Upgrade Radius on Kubernetes"
+description: "Learn how to upgrade Radius on Kubernetes"
+weight: 300
+categories: "How-To"
+---
+
+Radius does not offer backward compatibility with previous releases. Breaking changes may happen between releases and we recommend doing a fresh installation of the latest version of Radius after every release.
+
+## Step 1 : Delete any existing Radius environments 
+
+To delete any existing Radius environments, run the following command:
+
+```bash
+rad env delete 
+```
+
+## Step 2: Uninstall the existing Radius control-plane
+
+To uninstall the existing Radius control-plane, run the following command:
+
+```bash
+rad uninstall kubernetes
+```
+
+## Step 3: Install the rad CLI
+
+The rad CLI is the main tool for interacting with Radius. It is used to create and manage Radius environments, and to deploy and manage Radius applications.
+
+Visit the [rad CLI how-to guide]({{< ref howto-rad-cli >}}) for more information on how to install the rad CLI.
+
+{{< button text="How-To: rad CLI" page="howto-rad-cli" newtab="true" >}}
+
+## Step 4: Install the Radius-Bicep VS Code extension
+
+The Radius-Bicep VS Code extension provides a set of tools for working with Bicep files in VS Code. Visit the [VSCode how-to guide]({{< ref howto-vscode >}}) for more information on how to install the Radius-Bicep VS Code extension.
+
+{{< button text="How-To: VS Code" page="howto-vscode" newtab="true" >}}
+
+## Step 5: Initialize the Radius control-plane
+
+The Radius control-plane is a set of services that provide the core functionality of Radius. It is deployed as a set of containers in a Kubernetes cluster.
+
+Visit the [environments how-to guide]({{< ref howto-environment >}}) for more information on how to install the Radius control-plane and create your first Radius environment.
+
+{{< button text="How-To: Init an environment" page="howto-environment" newtab="true" >}}
+
+
+
+

docs/content/installation/index.md

@@ -31,3 +31,5 @@ The Radius control-plane is a set of services that provide the core functionalit
 Visit the [environments how-to guide]({{< ref howto-environment >}}) for more information on how to install the Radius control-plane and create your first Radius environment.
 
 {{< button text="How-To: Init an environment" page="howto-environment" newtab="true" >}}
+
+>If you are looking to upgrade Radius to the latest version, refer to [upgrade Radius on Kubernetes]({{< ref kubernetes-upgrade >}}) for more information.