Share via


Microsoft.AppPlatform Spring/apps/deployments 2022-04-01

Remarks

Note: Azure Spring Apps Application Deployments (Microsoft.AppPlatform/Spring/apps/deployments) is now deprecated and will be retired on 2028-05-31. See https://aka.ms/asaretirement for more information.

Bicep resource definition

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

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-04-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {
        {customized property}: {
          {customized property}: any(...)
        }
      }
      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 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

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

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)

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
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

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)

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 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo. 'BuildResult'
'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:

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-04-01",
  "name": "string",
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {
        "{customized property}": {
          "{customized property}": {}
        }
      },
      "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 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

Microsoft.AppPlatform/Spring/apps/deployments

Name Description Value
apiVersion The api version '2022-04-01'
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'

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)

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
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

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)

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 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo. 'BuildResult'
'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

Deploy to Azure
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:

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-04-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {
          {customized property} = {
            {customized property} = ?
          }
        }
        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 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

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-04-01"

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)

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
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

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)

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 'Jar' for type JarUploadedUserSourceInfo. Set to 'NetCoreZip' for type NetCoreZipUploadedUserSourceInfo. Set to 'Source' for type SourceUploadedUserSourceInfo. 'BuildResult'
'Jar'
'NetCoreZip'
'Source' (required)
version Version of the source string

Usage Examples

Terraform Samples

A basic example of deploying Spring Cloud Deployment.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "Spring" {
  type      = "Microsoft.AppPlatform/Spring@2023-05-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      zoneRedundant = false
    }
    sku = {
      name = "E0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "app" {
  type      = "Microsoft.AppPlatform/Spring/apps@2023-05-01-preview"
  parent_id = azapi_resource.Spring.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      customPersistentDisks = [
      ]
      enableEndToEndTLS = false
      public            = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "deployment" {
  type      = "Microsoft.AppPlatform/Spring/apps/deployments@2023-05-01-preview"
  parent_id = azapi_resource.app.id
  name      = var.resource_name
  body = {
    properties = {
      deploymentSettings = {
        environmentVariables = {
        }
      }
      source = {
        customContainer = {
          args = [
          ]
          command = [
          ]
          containerImage    = "springio/gs-spring-boot-docker"
          languageFramework = ""
          server            = "docker.io"
        }
        type = "Container"
      }
    }
    sku = {
      capacity = 1
      name     = "E0"
      tier     = "Enterprise"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}