How-To: Upgrade Radius on Kubernetes

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:

rad env delete

Step 2: Uninstall the existing Radius control-plane

To uninstall the existing Radius control-plane, run the following command:

rad uninstall kubernetes

Step 3: Install the rad CLI

The rad CLI manages your applications, resources, and environments. You can install it on your local machine with the following installation scripts:

• Linux/WSL
• MacOS
• Windows PowerShell
• GitHub Codespace
• Azure Cloud Shell
• Binaries

wget -q "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.sh" -O - | /bin/bash -s edge

curl -fsSL "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.sh" | /bin/bash -s edge

$script=iwr -useb "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.ps1"; $block=[ScriptBlock]::Create($script); invoke-command -ScriptBlock $block -ArgumentList edge

export RADIUS_INSTALL_DIR=./
wget -q "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.sh" -O - | /bin/bash

You may be prompted for your sudo password during installation, as the installer places the rad binary under /usr/local/bin. If you are unable to sudo you can install the rad CLI to another directory by setting the RADIUS_INSTALL_DIR environment variable with your intended install path. Make sure you add this to your path (Unix, Windows) if you wish to reference it via rad, like in the docs.

Verify the rad CLI is installed correctly by running rad version.

Example output:

RELEASE     VERSION     BICEP       COMMIT
0.26.0      edge        0.28.1     2e60bfb46de73ec5cc70485d53e67f8eaa914ba7

Step 4: Install the Bicep VS Code extension

Visual Studio Code offers the best authoring experience for Radius and Bicep. Download and install the Bicep extension to easily author and validate Bicep templates:

To install the Bicep extension, refer to their installation documentation

Step 5: Initialize the Radius control-plane and the Radius Environment

Initializing Radius installs the Radius control-plane and creates a Radius Environment. The control-plane is a set of services that provide the core functionality of Radius, running in the radius-system namespace.

1. Create a Kubernetes cluster

   Radius runs inside Kubernetes. Create one from the supported k8s clusters

   If you don’t have a preferred way to create Kubernetes clusters, you could try using k3d, which runs a minimal Kubernetes distribution in Docker.

   Ensure your cluster is set as your current context:

   kubectl config current-context
   

2. Initialize a new Radius Environment with rad init:

   rad init
   

   Select Yes to setup the application in the current directory. This will create app.bicep and bicepconfig.json files

   Initializing Radius...
   
   🕔 Install Radius edge
      - Kubernetes cluster: kind
      - Kubernetes namespace: radius-system
   ⏳ Create new environment default
      - Kubernetes namespace: default
      - Recipe pack: local-dev
   ⏳ Scaffold application
   ⏳ Update local configuration
   

3. Verify the initialization by running:

   kubectl get deployments -n radius-system
   

   You should see:

   NAME                      READY   UP-TO-DATE   AVAILABLE   AGE
   applications-rp           1/1     1            1           53s
   bicep-de                  1/1     1            1           53s
   controller                1/1     1            1           53s
   ucp                       1/1     1            1           53s
   contour-contour           1/1     1            1           46s
   

   You can also use rad env list to view your environment:

   rad env list