Overview: Radius Environments
What is an environment?
Radius Environments are prepared “landing zones” for Radius Applications. Applications deployed to an environment will inherit the container runtime, configuration, Recipes, and other settings from the environment.
Environments are server-side resources that exist within the Radius control-plane. You can use the Radius API and rad CLI to interact with your installation’s environments.
The following configuration options are available for environments:
Radius Environments can be configured with a container runtime, where Radius containers will be deployed. Currently, only Kubernetes clusters are supported for container runtimes.
A Kubernetes namespace is specified on the environment to tell Radius where to render environment-scoped resources. For example, a shared database deployed to an environment will be deployed to the namespace specified on the environment. Application-scoped resources will be deployed into a new namespace for each application, in the format
<environment-namespace>-<application-name>. For example, if an application named
myapp is deployed to an environment with the namespace
default, the application-scoped resources will be deployed to the namespace
You can optionally configure cloud providers allow you to deploy and connect to cloud resources across various cloud platforms. For example, you can use the Radius Azure provider to run your application’s services in your Kubernetes cluster, while deploying Azure resources to a specified Azure subscription and resource group. More information on setting up a cloud provider can be found in the providers section.
Supported cloud providers
- Microsoft Azure
- Amazon Web Services
External identity provider
You can optionally specify an external identity provider for your environment. This allows you to add to a Radius container an external identity such as an Azure user-assigned managed identity, and then specify role-based access control (RBAC) policies for that identity on Azure resources.
Supported identity providers:
You can optionally designate an environment as “simulated”. When enabled, a simulated environment will not deploy any output any resources or run any Recipes when an application is deployed. This is useful for dry runs or testing.
The following commands let you interact with Radius Environments:
rad init initializes a new Kubernetes environment:
rad env show prints information on the default or specified environment:
rad env show
rad env delete deletes the specified environment:
rad env delete -e myenv
rad env switch switches the default environment:
rad env switch -e myenv
Visit the environment schema page to learn more about environment properties and values.Schema
Managing multiple environments
If you are working with multiple environments, you can use workspaces to manage them. Workspaces allow you to switch between different sets of environments, and can be used to manage different environments for different projects.Workspaces
Was this page helpful?
Sorry to hear that. If you would like to also contribute a suggestion visit and tell us how we can improve.