Application reference

Learn how to define an application

Resource format

resource app 'Applications.Core/applications@2023-10-01-preview' = {
  name: 'myapp'
  properties: {
    environment: environment
    extensions: [
      {
        kind: 'kubernetesNamespace'
        namespace: 'myapp'
      }
      {
        kind: 'kubernetesMetadata'
        labels: {
          'team.contact.name': 'frontend'
        }
      }
    ]
  }
}

Top-level

KeyRequiredDescriptionExample
nameyThe name of your resource. See common values for more information.frontend
locationyThe location of your resource. See common values for more information.global
propertiesyProperties of the resource.See below

Properties

KeyRequiredDescriptionExample
environmentyThe ID of the environment resource this container belongs to.env.id
extensionsnList of extensions on the container.See below

Extensions

Extensions allow you to customize how resources are generated or customized as part of deployment.

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 for more information on namespace mapping behavior.

KeyRequiredDescriptionExample
kindyThe kind of extension being used. Must be ‘kubernetesNamespace’kubernetesNamespace
namespaceyThe namespace where all application-scoped resources generate Kubernetes objects.default
kubernetesMetadata

The Kubernetes Metadata extension 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
KeyRequiredDescriptionExample
kindyThe kind of extension being used. Must be ‘kubernetesMetadata’kubernetesMetadata
labelsnThe Kubernetes labels to be set on the application and its resourcesSee below
annotationsnThe Kubernetes annotations to set on your application and its resourcesSee below
labels
KeyRequiredDescriptionExample
user defined label keyyThe key and value of the label to be set on the application and its resources.'team.name': 'frontend'
annotations
KeyRequiredDescriptionExample
user defined annotation keyyThe key and value of the annotation to be set on the application and its resources.'app.io/port': '8081'