Microsoft.AppPlatform Spring/apps/deployments 2022-03-01-preview

Article
12/09/2024

Bicep resource definition

The Spring/apps/deployments resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.AppPlatform/Spring/apps/deployments resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.AppPlatform/Spring/apps/deployments@2022-03-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {
        {customized property}: {
          {customized property}: any(...)
        }
      }
      containerProbeSettings: {
        disableProbe: bool
      }
      environmentVariables: {
        {customized property}: 'string'
      }
      resourceRequests: {
        cpu: 'string'
        memory: 'string'
      }
    }
    source: {
      version: 'string'
      type: 'string'
      // For remaining properties, see UserSourceInfo objects
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
}

UserSourceInfo objects

Set the type property to specify the type of object.

For BuildResult, use:

{
  buildResultId: 'string'
  type: 'BuildResult'
}

For Container, use:

{
  customContainer: {
    args: [
      'string'
    ]
    command: [
      'string'
    ]
    containerImage: 'string'
    imageRegistryCredential: {
      password: 'string'
      username: 'string'
    }
    languageFramework: 'string'
    server: 'string'
  }
  type: 'Container'
}

For Jar, use:

{
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'Jar'
}

For NetCoreZip, use:

{
  netCoreMainEntryPath: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'NetCoreZip'
}

For Source, use:

{
  artifactSelector: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'Source'
}

Property Values

AddonProfile

Name	Description	Value

BuildResultUserSourceInfo

Name	Description	Value
buildResultId	Resource id of an existing succeeded build result under the same Spring instance.	string
type	Type of the source uploaded	'BuildResult' (required)

ContainerProbeSettings

Name	Description	Value
disableProbe	Indicates whether disable the liveness and readiness probe	bool

CustomContainer

Name	Description	Value
args	Arguments to the entrypoint. The docker image's CMD is used if this is not provided.	string[]
command	Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.	string[]
containerImage	Container image of the custom container. This should be in the form of <repository>:<tag> without the server name of the registry	string
imageRegistryCredential	Credential of the image registry	ImageRegistryCredential
languageFramework	Language framework of the container image uploaded	string
server	The name of the registry that contains the container image	string

CustomContainerUserSourceInfo

Name	Description	Value
customContainer	Custom container payload	CustomContainer
type	Type of the source uploaded	'Container' (required)

DeploymentResourceProperties

Name	Description	Value
active	Indicates whether the Deployment is active	bool
deploymentSettings	Deployment settings of the Deployment	DeploymentSettings
source	Uploaded source information of the deployment.	UserSourceInfo

DeploymentSettings

Name	Description	Value
addonConfigs	Collection of addons	DeploymentSettingsAddonConfigs
containerProbeSettings	Container liveness and readiness probe settings	ContainerProbeSettings
environmentVariables	Collection of environment variables	DeploymentSettingsEnvironmentVariables
resourceRequests	The requested resource quantity for required CPU and Memory. It is recommended that using this field to represent the required CPU and Memory, the old field cpu and memoryInGB will be deprecated later.	ResourceRequests

DeploymentSettingsAddonConfigs

Name	Description	Value

DeploymentSettingsEnvironmentVariables

Name	Description	Value

ImageRegistryCredential

Name	Description	Value
password	The password of the image registry credential	string
username	The username of the image registry credential	string

JarUploadedUserSourceInfo

Name	Description	Value
jvmOptions	JVM parameter	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the Jar file	string
type	Type of the source uploaded	'Jar' (required)

Microsoft.AppPlatform/Spring/apps/deployments

Name	Description	Value
name	The resource name	string (required)
parent	In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource.	Symbolic name for resource of type: Spring/apps
properties	Properties of the Deployment resource	DeploymentResourceProperties
sku	Sku of the Deployment resource	Sku

NetCoreZipUploadedUserSourceInfo

Name	Description	Value
netCoreMainEntryPath	The path to the .NET executable relative to zip root	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the .Net file	string
type	Type of the source uploaded	'NetCoreZip' (required)

ResourceRequests

Name	Description	Value
cpu	Required CPU. 1 core can be represented by 1 or 1000m. This should be 500m or 1 for Basic tier, and {500m, 1, 2, 3, 4} for Standard tier.	string
memory	Required memory. 1 GB can be represented by 1Gi or 1024Mi. This should be {512Mi, 1Gi, 2Gi} for Basic tier, and {512Mi, 1Gi, 2Gi, ..., 8Gi} for Standard tier.	string

Sku

Name	Description	Value
capacity	Current capacity of the target resource	int
name	Name of the Sku	string
tier	Tier of the Sku	string

SourceUploadedUserSourceInfo

Name	Description	Value
artifactSelector	Selector for the artifact to be used for the deployment for multi-module projects. This should be the relative path to the target module/project.	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the source file	string
type	Type of the source uploaded	'Source' (required)

UserSourceInfo

Name	Description	Value
type	Set to 'BuildResult' for type BuildResultUserSourceInfo. Set to 'Container' for type CustomContainerUserSourceInfo. Set to 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo.	'BuildResult' 'Container' 'Jar' 'NetCoreZip' 'Source' (required)
version	Version of the source	string

Usage Examples

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File	Description
Deploy a simple Azure Spring Apps microservice application	This template deploys a simple Azure Spring Apps microservice application to run on Azure.

ARM template resource definition

The Spring/apps/deployments resource type can be deployed with operations that target:

Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.AppPlatform/Spring/apps/deployments resource, add the following JSON to your template.

{
  "type": "Microsoft.AppPlatform/Spring/apps/deployments",
  "apiVersion": "2022-03-01-preview",
  "name": "string",
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {
        "{customized property}": {
          "{customized property}": {}
        }
      },
      "containerProbeSettings": {
        "disableProbe": "bool"
      },
      "environmentVariables": {
        "{customized property}": "string"
      },
      "resourceRequests": {
        "cpu": "string",
        "memory": "string"
      }
    },
    "source": {
      "version": "string",
      "type": "string"
      // For remaining properties, see UserSourceInfo objects
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  }
}

UserSourceInfo objects

Set the type property to specify the type of object.

For BuildResult, use:

{
  "buildResultId": "string",
  "type": "BuildResult"
}

For Container, use:

{
  "customContainer": {
    "args": [ "string" ],
    "command": [ "string" ],
    "containerImage": "string",
    "imageRegistryCredential": {
      "password": "string",
      "username": "string"
    },
    "languageFramework": "string",
    "server": "string"
  },
  "type": "Container"
}

For Jar, use:

{
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "Jar"
}

For NetCoreZip, use:

{
  "netCoreMainEntryPath": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "NetCoreZip"
}

For Source, use:

{
  "artifactSelector": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "Source"
}

Property Values

AddonProfile

Name	Description	Value

BuildResultUserSourceInfo

Name	Description	Value
buildResultId	Resource id of an existing succeeded build result under the same Spring instance.	string
type	Type of the source uploaded	'BuildResult' (required)

ContainerProbeSettings

Name	Description	Value
disableProbe	Indicates whether disable the liveness and readiness probe	bool

CustomContainer

Name	Description	Value
args	Arguments to the entrypoint. The docker image's CMD is used if this is not provided.	string[]
command	Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.	string[]
containerImage	Container image of the custom container. This should be in the form of <repository>:<tag> without the server name of the registry	string
imageRegistryCredential	Credential of the image registry	ImageRegistryCredential
languageFramework	Language framework of the container image uploaded	string
server	The name of the registry that contains the container image	string

CustomContainerUserSourceInfo

Name	Description	Value
customContainer	Custom container payload	CustomContainer
type	Type of the source uploaded	'Container' (required)

DeploymentResourceProperties

Name	Description	Value
active	Indicates whether the Deployment is active	bool
deploymentSettings	Deployment settings of the Deployment	DeploymentSettings
source	Uploaded source information of the deployment.	UserSourceInfo

DeploymentSettings

Name	Description	Value
addonConfigs	Collection of addons	DeploymentSettingsAddonConfigs
containerProbeSettings	Container liveness and readiness probe settings	ContainerProbeSettings
environmentVariables	Collection of environment variables	DeploymentSettingsEnvironmentVariables
resourceRequests	The requested resource quantity for required CPU and Memory. It is recommended that using this field to represent the required CPU and Memory, the old field cpu and memoryInGB will be deprecated later.	ResourceRequests

DeploymentSettingsAddonConfigs

Name	Description	Value

DeploymentSettingsEnvironmentVariables

Name	Description	Value

ImageRegistryCredential

Name	Description	Value
password	The password of the image registry credential	string
username	The username of the image registry credential	string

JarUploadedUserSourceInfo

Name	Description	Value
jvmOptions	JVM parameter	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the Jar file	string
type	Type of the source uploaded	'Jar' (required)

Microsoft.AppPlatform/Spring/apps/deployments

Name	Description	Value
apiVersion	The api version	'2022-03-01-preview'
name	The resource name	string (required)
properties	Properties of the Deployment resource	DeploymentResourceProperties
sku	Sku of the Deployment resource	Sku
type	The resource type	'Microsoft.AppPlatform/Spring/apps/deployments'

NetCoreZipUploadedUserSourceInfo

Name	Description	Value
netCoreMainEntryPath	The path to the .NET executable relative to zip root	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the .Net file	string
type	Type of the source uploaded	'NetCoreZip' (required)

ResourceRequests

Name	Description	Value
cpu	Required CPU. 1 core can be represented by 1 or 1000m. This should be 500m or 1 for Basic tier, and {500m, 1, 2, 3, 4} for Standard tier.	string
memory	Required memory. 1 GB can be represented by 1Gi or 1024Mi. This should be {512Mi, 1Gi, 2Gi} for Basic tier, and {512Mi, 1Gi, 2Gi, ..., 8Gi} for Standard tier.	string

Sku

Name	Description	Value
capacity	Current capacity of the target resource	int
name	Name of the Sku	string
tier	Tier of the Sku	string

SourceUploadedUserSourceInfo

Name	Description	Value
artifactSelector	Selector for the artifact to be used for the deployment for multi-module projects. This should be the relative path to the target module/project.	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the source file	string
type	Type of the source uploaded	'Source' (required)

UserSourceInfo

Name	Description	Value
type	Set to 'BuildResult' for type BuildResultUserSourceInfo. Set to 'Container' for type CustomContainerUserSourceInfo. Set to 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo.	'BuildResult' 'Container' 'Jar' 'NetCoreZip' 'Source' (required)
version	Version of the source	string

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template	Description
Deploy a simple Azure Spring Apps microservice application	This template deploys a simple Azure Spring Apps microservice application to run on Azure.

Terraform (AzAPI provider) resource definition

The Spring/apps/deployments resource type can be deployed with operations that target:

Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.AppPlatform/Spring/apps/deployments resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AppPlatform/Spring/apps/deployments@2022-03-01-preview"
  name = "string"
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  body = jsonencode({
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {
          {customized property} = {
            {customized property} = ?
          }
        }
        containerProbeSettings = {
          disableProbe = bool
        }
        environmentVariables = {
          {customized property} = "string"
        }
        resourceRequests = {
          cpu = "string"
          memory = "string"
        }
      }
      source = {
        version = "string"
        type = "string"
        // For remaining properties, see UserSourceInfo objects
      }
    }
  })
}

UserSourceInfo objects

Set the type property to specify the type of object.

For BuildResult, use:

{
  buildResultId = "string"
  type = "BuildResult"
}

For Container, use:

{
  customContainer = {
    args = [
      "string"
    ]
    command = [
      "string"
    ]
    containerImage = "string"
    imageRegistryCredential = {
      password = "string"
      username = "string"
    }
    languageFramework = "string"
    server = "string"
  }
  type = "Container"
}

For Jar, use:

{
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "Jar"
}

For NetCoreZip, use:

{
  netCoreMainEntryPath = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "NetCoreZip"
}

For Source, use:

{
  artifactSelector = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "Source"
}

Property Values

AddonProfile

Name	Description	Value

BuildResultUserSourceInfo

Name	Description	Value
buildResultId	Resource id of an existing succeeded build result under the same Spring instance.	string
type	Type of the source uploaded	'BuildResult' (required)

ContainerProbeSettings

Name	Description	Value
disableProbe	Indicates whether disable the liveness and readiness probe	bool

CustomContainer

Name	Description	Value
args	Arguments to the entrypoint. The docker image's CMD is used if this is not provided.	string[]
command	Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided.	string[]
containerImage	Container image of the custom container. This should be in the form of <repository>:<tag> without the server name of the registry	string
imageRegistryCredential	Credential of the image registry	ImageRegistryCredential
languageFramework	Language framework of the container image uploaded	string
server	The name of the registry that contains the container image	string

CustomContainerUserSourceInfo

Name	Description	Value
customContainer	Custom container payload	CustomContainer
type	Type of the source uploaded	'Container' (required)

DeploymentResourceProperties

Name	Description	Value
active	Indicates whether the Deployment is active	bool
deploymentSettings	Deployment settings of the Deployment	DeploymentSettings
source	Uploaded source information of the deployment.	UserSourceInfo

DeploymentSettings

Name	Description	Value
addonConfigs	Collection of addons	DeploymentSettingsAddonConfigs
containerProbeSettings	Container liveness and readiness probe settings	ContainerProbeSettings
environmentVariables	Collection of environment variables	DeploymentSettingsEnvironmentVariables
resourceRequests	The requested resource quantity for required CPU and Memory. It is recommended that using this field to represent the required CPU and Memory, the old field cpu and memoryInGB will be deprecated later.	ResourceRequests

DeploymentSettingsAddonConfigs

Name	Description	Value

DeploymentSettingsEnvironmentVariables

Name	Description	Value

ImageRegistryCredential

Name	Description	Value
password	The password of the image registry credential	string
username	The username of the image registry credential	string

JarUploadedUserSourceInfo

Name	Description	Value
jvmOptions	JVM parameter	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the Jar file	string
type	Type of the source uploaded	'Jar' (required)

Microsoft.AppPlatform/Spring/apps/deployments

Name	Description	Value
name	The resource name	string (required)
parent_id	The ID of the resource that is the parent for this resource.	ID for resource of type: Spring/apps
properties	Properties of the Deployment resource	DeploymentResourceProperties
sku	Sku of the Deployment resource	Sku
type	The resource type	"Microsoft.AppPlatform/Spring/apps/deployments@2022-03-01-preview"

NetCoreZipUploadedUserSourceInfo

Name	Description	Value
netCoreMainEntryPath	The path to the .NET executable relative to zip root	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the .Net file	string
type	Type of the source uploaded	'NetCoreZip' (required)

ResourceRequests

Name	Description	Value
cpu	Required CPU. 1 core can be represented by 1 or 1000m. This should be 500m or 1 for Basic tier, and {500m, 1, 2, 3, 4} for Standard tier.	string
memory	Required memory. 1 GB can be represented by 1Gi or 1024Mi. This should be {512Mi, 1Gi, 2Gi} for Basic tier, and {512Mi, 1Gi, 2Gi, ..., 8Gi} for Standard tier.	string

Sku

Name	Description	Value
capacity	Current capacity of the target resource	int
name	Name of the Sku	string
tier	Tier of the Sku	string

SourceUploadedUserSourceInfo

Name	Description	Value
artifactSelector	Selector for the artifact to be used for the deployment for multi-module projects. This should be the relative path to the target module/project.	string
relativePath	Relative path of the storage which stores the source	string
runtimeVersion	Runtime version of the source file	string
type	Type of the source uploaded	'Source' (required)

UserSourceInfo

Name	Description	Value
type	Set to 'BuildResult' for type BuildResultUserSourceInfo. Set to 'Container' for type CustomContainerUserSourceInfo. Set to 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo.	'BuildResult' 'Container' 'Jar' 'NetCoreZip' 'Source' (required)
version	Version of the source	string

Share via

Microsoft.AppPlatform Spring/apps/deployments 2022-03-01-preview

Bicep resource definition

Resource format

UserSourceInfo objects

Property Values

AddonProfile

BuildResultUserSourceInfo

ContainerProbeSettings

CustomContainer

CustomContainerUserSourceInfo

DeploymentResourceProperties

DeploymentSettings

DeploymentSettingsAddonConfigs

DeploymentSettingsEnvironmentVariables

ImageRegistryCredential

JarUploadedUserSourceInfo

Microsoft.AppPlatform/Spring/apps/deployments

NetCoreZipUploadedUserSourceInfo

ResourceRequests

Sku

SourceUploadedUserSourceInfo

UserSourceInfo

Usage Examples

Azure Quickstart Samples

ARM template resource definition

Resource format

UserSourceInfo objects

Property Values

AddonProfile

BuildResultUserSourceInfo

ContainerProbeSettings

CustomContainer

CustomContainerUserSourceInfo

DeploymentResourceProperties

DeploymentSettings

DeploymentSettingsAddonConfigs

DeploymentSettingsEnvironmentVariables

ImageRegistryCredential

JarUploadedUserSourceInfo

Microsoft.AppPlatform/Spring/apps/deployments

NetCoreZipUploadedUserSourceInfo

ResourceRequests

Sku

SourceUploadedUserSourceInfo

UserSourceInfo

Usage Examples

Azure Quickstart Templates

Terraform (AzAPI provider) resource definition

Resource format

UserSourceInfo objects

Property Values

AddonProfile

BuildResultUserSourceInfo

ContainerProbeSettings

CustomContainer

CustomContainerUserSourceInfo

DeploymentResourceProperties

DeploymentSettings

DeploymentSettingsAddonConfigs

DeploymentSettingsEnvironmentVariables

ImageRegistryCredential

JarUploadedUserSourceInfo

Microsoft.AppPlatform/Spring/apps/deployments

NetCoreZipUploadedUserSourceInfo

ResourceRequests

Sku

SourceUploadedUserSourceInfo

UserSourceInfo

Feedback

Additional resources