Radius.Compute/containers@2025-08-01-preview

❗️ Preview Release: This documentation covers a preview of Radius which uses different Resource Types from the current release. Enable it by passing the --preview to the Radius CLI or settingRADIUS_PREVIEW=true.

Description

The Radius.Compute/containers Resource Type is the primary resource type for running one or more containers. It is always part of a Radius Application. To deploy a Container add a resource to the application definition Bicep file.

extension radius
param environment string 

resource myApplication 'Radius.Core/applications@2025-08-01-preview' = { ... }

resource myContainer 'Radius.Compute/containers@2025-08-01-preview' = {
  name: 'myContainer'
  properties: {
    environment: environment
    application: myApplication.id
    containers: {
      demo: {
        image: 'ghcr.io/radius-project/samples/demo:latest'
      }
    }
  }
}

By default, Containers deploys to Kubernetes. In this case, a Kubernetes Deployment named myContainer is deployed which includes a Pod named myContainer. Your Radius environment may deploy to other container platforms such as Azure Container Instances.

To accept network connections, expose a port on the container.

resource myContainer 'Radius.Compute/containers@2025-08-01-preview' = {
  name: 'myContainer'
  properties: {
    environment: environment
    application: myApplication.id
    containers: {
      demo: {
        image: 'ghcr.io/radius-project/samples/demo:latest'
        ports: {
          web: {
            containerPort: 3000
          }
        }
      }
    }
  }
}

When a port is included, a Kubernetes Service named demo with the type ClusterIP is created.

To create an ephemeral emptyDir shared between two containers add a Containers.properties.volumes.

resource myContainer 'Radius.Compute/containers@2025-08-01-preview' = {
  name: 'myContainer'
  properties: {
    environment: environment
    application: myApplication.id
    containers: {
      frontend: {
        image: 'frontend:latest'
        volumeMounts: [
          {
            volumeName: 'shared'
            mountPath: '/var/shared' 
          }
        ]
      }
      backend: {
        image: 'backend:latest'
        volumeMounts: [
          {
            volumeName: 'shared'
            mountPath: '/var/shared' 
          }
        ]
      }
    }
    volumes: {
      shared: {
        emptyDir: {}
      }
    }
  }
}

To mount a persistent volume or secret see the PersistentVolumes and Secrets Resource Types.

Top-Level Properties

Property	Type	Description
`application`	string	(Required) The Radius Application ID. `myApplication.id` for example.
`autoScaling`	object
`codeReference`	string	Optional URI to the source code of this resource type. ex: https://github.com/radius-project/radius/blob/4fab87e8127adf1db6f43b7029d5235fbe82c5c9/cmd/controller/main.go#L27
`connections`	object	(Optional) Map of resources this container is dependent upon. `db: { source: db.id } for example.
`containers`	object
`environment`	string	(Required) The Radius Environment ID. Typically set by the rad CLI. Typically value should be `environment`.
`extensions`	object	(Optional) Properties for additional functionality. daprSidecar is the only available option.
`platformOptions`	object	(Optional) If enabled by the platform engineer, properties to be passed to the Recipe for the specified platform.
`replicas`	integer	(Optional) The minimum number of replicas for the set of containers.
`restartPolicy`	string	(Optional) Defines how a containers behave when they terminate. `Always` will restart containers regardless of their exit status. `OnFailure` will restart containers if they return a non-zero exit code. Allowed values: `Always`, `Never`, `OnFailure`.
`volumes`	object	(Optional) List of volumes that can be mounted by a container.

Object Properties

`autoScaling`

Property	Type	Description
`maxReplicas`	integer	(Optional) The maximum number of replicas for the autoscaler.
`metrics`	object[]	(Required) The metric to measure and target used to autoscale.

`connections`

Property	Type	Description
`disableDefaultEnvVars`	boolean	(Optional) Disables the automatic injection of environment variables from connected resource properties.
`source`	string	(Required) The resource ID of the resource this container is dependent upon.

`containers`

Property	Type	Description
`args`	string array	(Optional) Arguments for the command. Overrides the container image CMD. `["echo Hello", "&&", "echo World"]` for example.
`command`	string array	(Optional) Command the container runs. Overrides the container image ENTRYPOINT. `["/bin/sh", "-c"]` for example.
`env`	object	(Optional) Environment variables injected into the container.
`image`	string	(Required) The container image. `ghcr.io/radius-project/samples/demo:latest` for example.
`initContainer`	boolean	(Optional) Set to true if container should run and succeed prior to other containers starting.
`livenessProbe`	object	(Optional) A liveness probe defines a check (a probe) to determine if a container is healthy.
`ports`	object	(Optional) Network ports exposed by the container. A network endpoint is created for each port. For L7 ingress create a Routes resource.
`readinessProbe`	object	(Optional) A readiness probe defines a check (a probe) to determine when a container is ready to begin accepting traffic.
`resources`	object	(Optional) Compute resource requirements for the container.
`volumeMounts`	object[]	(Optional) Volumes to mount in the container.
`workingDir`	string	(Optional) The working directory inside the container. `/usr/share` for example.

`extensions`

Property	Type	Description
`daprSidecar`	object	(Optional) When set the daprSidecar container is configured.

`volumes`

Property	Type	Description
`emptyDir`	object	(Optional) An empty directory.
`persistentVolume`	object	(Optional) Mount an existing Radius PersistentVolume resource.
`secretName`	string	(Optional) The Radius Secret resource name.

`autoScaling.metrics`

Property	Type	Description
`customMetric`	string	(Optional) The custom metric exposed by the application. Implementation specific. See platform engineer for further guidance.
`kind`	string	(Required) The metric to measure. Allowed values: `cpu`, `custom`, `memory`.
`target`	object	(Required) When the metric exceeds the target value specified, autoscaling is triggered. Only one target value can be specified dependent upon the type.

`containers.env`

Property	Type	Description
`value`	string	(Optional) String value of the environment variable.
`valueFrom`	object

`containers.livenessProbe`

Property	Type	Description
`exec`	object	(Optional) An exec probe runs a command within a container. If the command succeeds and returns 0 the probe is healthy.
`failureThreshold`	integer	(Optional) Minimum consecutive failures for the probe to be considered failed after having succeeded. Assumed to be 3 if not specified.
`httpGet`	object	(Optional) A httpGet probe performs a HTTP GET against the container on the specified port. If the HTTP server returns a code greater than or equal to 200 and less than 400 the probe is healthy.
`initialDelaySeconds`	integer	(Optional) Number of seconds after the container has started before probes are initiated.
`periodSeconds`	integer	(Optional) How often to perform the probe. Assumed to be 10 seconds if not specified.
`successThreshold`	integer	(Optional) Minimum consecutive successes for the probe to be considered successful after having failed. Assumed to be 1 if not specified.
`tcpSocket`	object	(Optional) A TCP socket probe establishes a TCP connection to the container on the specified port. If a connection is established the probe is healthy.
`terminationGracePeriodSeconds`	integer	(Optional) Number of seconds the container needs to terminate gracefully upon probe failure. The grace period amount of time between when a container is sent a termination signal and the time when the processes are forcibly halted with a kill signal.
`timeoutSeconds`	integer	(Optional) Number of seconds after which the probe times out. Assumed to be 1 second if not specified.

`containers.ports`

Property	Type	Description
`containerPort`	integer	(Required) The network port the container is listening on. `443` for example.
`protocol`	string	(Optional) The protocol. If not specified, `TCP` is assumed. Allowed values: `TCP`, `UDP`.

`containers.readinessProbe`

Property	Type	Description
`exec`	object	(Optional) An exec probe runs a command within a container. If the command succeeds and returns 0 the probe is healthy.
`failureThreshold`	integer	(Optional) Minimum consecutive failures for the probe to be considered failed after having succeeded. Assumed to be 3 if not specified.
`httpGet`	object	(Optional) A httpGet probe performs a HTTP GET against the container on the specified port. If the HTTP server returns a code greater than or equal to 200 and less than 400 the probe is healthy.
`initialDelaySeconds`	integer	(Optional) Number of seconds after the container has started before probes are initiated.
`periodSeconds`	integer	(Optional) How often to perform the probe. Assumed to be 10 seconds if not specified.
`successThreshold`	integer	(Optional) Minimum consecutive successes for the probe to be considered successful after having failed. Assumed to be 1 if not specified.
`tcpSocket`	object	(Optional) A TCP socket probe establishes a TCP connection to the container on the specified port. If a connection is established the probe is healthy.
`terminationGracePeriodSeconds`	integer	(Optional) Number of seconds the container needs to terminate gracefully upon probe failure. The grace period amount of time between when a container is sent a termination signal and the time when the processes are forcibly halted with a kill signal.
`timeoutSeconds`	integer	(Optional) Number of seconds after which the probe times out. Assumed to be 1 second if not specified.

`containers.resources`

Property	Type	Description
`limits`	object	(Optional) Limits define the maximum amount of CPU or memory the container can consume.
`requests`	object	(Optional) Requests define the minimum amount of CPU or memory that is required by the container.

`containers.volumeMounts`

Property	Type	Description
`mountPath`	string	(Required) The path to mount the volume in the container file system.
`volumeName`	string	(Required) The name of the volume defined in Containers.properties.volumes.

`extensions.daprSidecar`

Property	Type	Description
`appId`	string	(Optional) The unique ID of the Dapr application. Used for service discovery, state encapsulation and the pub/sub consumer ID.
`appPort`	integer	(Optional) The port your application is listening on.
`config`	string	(Optional) The Dapr Configuration resource name.

`volumes.emptyDir`

Property	Type	Description
`medium`	string	(Optional) Set to `memory` for a tmpfs (RAM backed filesystem). Note that while tmpfs is very fast storage counts against the memory limit of the container. Allowed values: `disk`, `memory`.

`volumes.persistentVolume`

Property	Type	Description
`accessMode`	string	(Optional) Set to `ReadWriteOnce` if no other Containers can mount in read/write mode. Set to `ReadOnlyMany` to enable other Containers to mount in read-only mode. Set to `ReadWriteMany` to allow multiple containers to mount in read/write mode. Assumed to be `ReadWriteOnce` if not specified. Allowed values: `ReadOnlyMany`, `ReadWriteMany`, `ReadWriteOnce`.
`resourceId`	string	(Required) The Radius PersistentVolume resource ID.

`autoScaling.metrics.target`

Property	Type	Description
`averageUtilization`	integer	(Optional) The average CPU or memory utilization across all containers expressed as a percentage. Kind must be CPU or memory.
`averageValue`	integer	(Optional) The average value of the metric as a quantity.
`value`	integer	(Optional) The absolute value of the metric as a quantity.

`containers.env.valueFrom`

Property	Type	Description
`secretKeyRef`	object	(Optional) Set the environment variable value based on a Radius Secrets resource.

`containers.livenessProbe.exec`

Property	Type	Description
`command`	string array	(Required) The command to run inside the container. `["cat", "/tmp/healthy"]` for example.

`containers.livenessProbe.httpGet`

Property	Type	Description
`httpHeaders`	object[]	(Optional) Custom HTTP headers to be included in the GET request.
`path`	string	(Required) The path to access on the HTTP server.
`port`	integer	(Required) The TCP port connect to on the container.
`scheme`	string	(Optional) HTTP or HTTPS. Assumes HTTP is not specified. Allowed values: `http`, `https`.

`containers.livenessProbe.tcpSocket`

Property	Type	Description
`port`	integer	(Required) The TCP port to connect to.

`containers.readinessProbe.exec`

Property	Type	Description
`command`	string array

`containers.readinessProbe.httpGet`

Property	Type	Description
`httpHeaders`	object[]	(Optional) Custom HTTP headers to be included in the GET request.
`path`	string	(Required) The path to access on the HTTP server.
`port`	integer	(Required) The TCP port connect to on the container.
`scheme`	string	(Optional) HTTP or HTTPS. Assumes HTTP is not specified. Allowed values: `http`, `https`.

`containers.readinessProbe.tcpSocket`

Property	Type	Description
`port`	integer	(Required) The TCP port to connect to.

`containers.resources.limits`

Property	Type	Description
`cpu`	string	(Optional) The maximum number of vCPUs which can be used by the container.
`memoryInMib`	integer	(Optional) The maximum amount of memory which can be used by the container in MiB.

`containers.resources.requests`

Property	Type	Description
`cpu`	string	(Optional) The minimum number of vCPUs required by the container. `0.1` results in one tenth of a vCPU being reserved.
`memoryInMib`	integer	(Optional) The minimum amount of memory required by the container in MiB. `1024` results in 1 GiB of memory being reserved.

`containers.env.valueFrom.secretKeyRef`

Property	Type	Description
`key`	string	(Optional) The key of the Radius Secrets resource. The value of the key will be used as the environment variable value.
`secretName`	string	(Optional) The name of the Radius Secrets resource.

`containers.livenessProbe.httpGet.httpHeaders`

Property	Type	Description
`value`	string	(Required) The header field value.

`containers.readinessProbe.httpGet.httpHeaders`

Property	Type	Description
`value`	string	(Required) The header field value.

Feedback

Was this page helpful?

Glad to hear it! Please feel free to star our repo and join our Discord server to stay up to date with the project.

Sorry to hear that. If you would like to also contribute a suggestion visit and tell us how we can improve.