Microsoft.AppPlatform Spring/apps/deployments 2022-05-01-preview
- Latest
- 2024-05-01-preview
- 2024-01-01-preview
- 2023-12-01
- 2023-11-01-preview
- 2023-09-01-preview
- 2023-07-01-preview
- 2023-05-01-preview
- 2023-03-01-preview
- 2023-01-01-preview
- 2022-12-01
- 2022-11-01-preview
- 2022-09-01-preview
- 2022-05-01-preview
- 2022-04-01
- 2022-03-01-preview
- 2022-01-01-preview
- 2021-09-01-preview
- 2021-06-01-preview
- 2020-11-01-preview
- 2020-07-01
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-05-01-preview' = {
name: 'string'
sku: {
capacity: int
name: 'string'
tier: 'string'
}
parent: resourceSymbolicName
properties: {
active: bool
deploymentSettings: {
addonConfigs: {
{customized property}: {
{customized property}: any()
}
}
containerProbeSettings: {
disableProbe: bool
}
environmentVariables: {
{customized property}: 'string'
}
livenessProbe: {
disableProbe: bool
failureThreshold: int
initialDelaySeconds: int
periodSeconds: int
probeAction: {
type: 'string'
// For remaining properties, see ProbeAction objects
}
successThreshold: int
timeoutSeconds: int
}
readinessProbe: {
disableProbe: bool
failureThreshold: int
initialDelaySeconds: int
periodSeconds: int
probeAction: {
type: 'string'
// For remaining properties, see ProbeAction objects
}
successThreshold: int
timeoutSeconds: int
}
resourceRequests: {
cpu: 'string'
memory: 'string'
}
startupProbe: {
disableProbe: bool
failureThreshold: int
initialDelaySeconds: int
periodSeconds: int
probeAction: {
type: 'string'
// For remaining properties, see ProbeAction objects
}
successThreshold: int
timeoutSeconds: int
}
terminationGracePeriodSeconds: int
}
source: {
version: 'string'
type: 'string'
// For remaining properties, see UserSourceInfo objects
}
}
}
ProbeAction objects
Set the type property to specify the type of object.
For ExecAction, use:
type: 'ExecAction'
command: [
'string'
]
For HTTPGetAction, use:
type: 'HTTPGetAction'
path: 'string'
scheme: 'string'
For TCPSocketAction, use:
type: 'TCPSocketAction'
UserSourceInfo objects
Set the type property to specify the type of object.
For BuildResult, use:
type: 'BuildResult'
buildResultId: 'string'
For Container, use:
type: 'Container'
customContainer: {
args: [
'string'
]
command: [
'string'
]
containerImage: 'string'
imageRegistryCredential: {
password: 'string'
username: 'string'
}
languageFramework: 'string'
server: 'string'
}
For Jar, use:
type: 'Jar'
jvmOptions: 'string'
relativePath: 'string'
runtimeVersion: 'string'
For NetCoreZip, use:
type: 'NetCoreZip'
netCoreMainEntryPath: 'string'
relativePath: 'string'
runtimeVersion: 'string'
For Source, use:
type: 'Source'
artifactSelector: 'string'
relativePath: 'string'
runtimeVersion: 'string'
Property values
Spring/apps/deployments
Name | Description | Value |
---|---|---|
name | The resource name See how to set names and types for child resources in Bicep. |
string (required) |
sku | Sku of the Deployment resource | Sku |
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: apps |
properties | Properties of the Deployment resource | DeploymentResourceProperties |
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 |
livenessProbe | Periodic probe of App Instance liveness. App Instance will be restarted if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
readinessProbe | Periodic probe of App Instance service readiness. App Instance will be removed from service endpoints if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
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 |
startupProbe | StartupProbe indicates that the App Instance has successfully initialized. If specified, no other probes are executed until this completes successfully. If this probe fails, the Pod will be restarted, just as if the livenessProbe failed. This can be used to provide different probe parameters at the beginning of a App Instance's lifecycle, when it might take a long time to load data or warm a cache, than during steady-state operation. This cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
terminationGracePeriodSeconds | Optional duration in seconds the App Instance needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the App Instance are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 90 seconds. | int |
DeploymentSettingsAddonConfigs
Name | Description | Value |
---|---|---|
{customized property} | AddonProfile |
AddonProfile
Name | Description | Value |
---|---|---|
{customized property} | For Bicep, you can use the any() function. |
ContainerProbeSettings
Name | Description | Value |
---|---|---|
disableProbe | Indicates whether disable the liveness and readiness probe | bool |
DeploymentSettingsEnvironmentVariables
Name | Description | Value |
---|---|---|
{customized property} | string |
Probe
Name | Description | Value |
---|---|---|
disableProbe | Indicate whether the probe is disabled. | bool (required) |
failureThreshold | Minimum consecutive failures for the probe to be considered failed after having succeeded. Minimum value is 1. | int |
initialDelaySeconds | Number of seconds after the App Instance has started before probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
int |
periodSeconds | How often (in seconds) to perform the probe. Minimum value is 1. | int |
probeAction | The action of the probe. | ProbeAction |
successThreshold | Minimum consecutive successes for the probe to be considered successful after having failed. Must be 1 for liveness and startup. Minimum value is 1. | int |
timeoutSeconds | Number of seconds after which the probe times out. Minimum value is 1. | int |
ProbeAction
Name | Description | Value |
---|---|---|
type | Set the object type | ExecAction HTTPGetAction TCPSocketAction (required) |
ExecAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | 'ExecAction' (required) |
command | Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is not run inside a shell, so traditional shell instructions (',', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy. | string[] |
HttpGetAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | 'HTTPGetAction' (required) |
path | Path to access on the HTTP server. | string |
scheme | Scheme to use for connecting to the host. Defaults to HTTP. Possible enum values: - "HTTP" means that the scheme used will be http:// - "HTTPS" means that the scheme used will be https:// |
'HTTP' 'HTTPS' |
TCPSocketAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | 'TCPSocketAction' (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 |
UserSourceInfo
Name | Description | Value |
---|---|---|
version | Version of the source | string |
type | Set the object type | BuildResult Container Jar NetCoreZip Source (required) |
BuildResultUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'BuildResult' (required) |
buildResultId | Resource id of an existing succeeded build result under the same Spring instance. | string |
CustomContainerUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'Container' (required) |
customContainer | Custom container payload | CustomContainer |
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 |
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 |
---|---|---|
type | Type of the source uploaded | 'Jar' (required) |
jvmOptions | JVM parameter | string |
relativePath | Relative path of the storage which stores the source | string |
runtimeVersion | Runtime version of the Jar file | string |
NetCoreZipUploadedUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'NetCoreZip' (required) |
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 |
SourceUploadedUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'Source' (required) |
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 |
Sku
Name | Description | Value |
---|---|---|
capacity | Current capacity of the target resource | int |
name | Name of the Sku | string |
tier | Tier of the Sku | string |
Quickstart templates
The following 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. |
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-05-01-preview",
"name": "string",
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"properties": {
"active": "bool",
"deploymentSettings": {
"addonConfigs": {
"{customized property}": {
"{customized property}": {}
}
},
"containerProbeSettings": {
"disableProbe": "bool"
},
"environmentVariables": {
"{customized property}": "string"
},
"livenessProbe": {
"disableProbe": "bool",
"failureThreshold": "int",
"initialDelaySeconds": "int",
"periodSeconds": "int",
"probeAction": {
"type": "string"
// For remaining properties, see ProbeAction objects
},
"successThreshold": "int",
"timeoutSeconds": "int"
},
"readinessProbe": {
"disableProbe": "bool",
"failureThreshold": "int",
"initialDelaySeconds": "int",
"periodSeconds": "int",
"probeAction": {
"type": "string"
// For remaining properties, see ProbeAction objects
},
"successThreshold": "int",
"timeoutSeconds": "int"
},
"resourceRequests": {
"cpu": "string",
"memory": "string"
},
"startupProbe": {
"disableProbe": "bool",
"failureThreshold": "int",
"initialDelaySeconds": "int",
"periodSeconds": "int",
"probeAction": {
"type": "string"
// For remaining properties, see ProbeAction objects
},
"successThreshold": "int",
"timeoutSeconds": "int"
},
"terminationGracePeriodSeconds": "int"
},
"source": {
"version": "string",
"type": "string"
// For remaining properties, see UserSourceInfo objects
}
}
}
ProbeAction objects
Set the type property to specify the type of object.
For ExecAction, use:
"type": "ExecAction",
"command": [ "string" ]
For HTTPGetAction, use:
"type": "HTTPGetAction",
"path": "string",
"scheme": "string"
For TCPSocketAction, use:
"type": "TCPSocketAction"
UserSourceInfo objects
Set the type property to specify the type of object.
For BuildResult, use:
"type": "BuildResult",
"buildResultId": "string"
For Container, use:
"type": "Container",
"customContainer": {
"args": [ "string" ],
"command": [ "string" ],
"containerImage": "string",
"imageRegistryCredential": {
"password": "string",
"username": "string"
},
"languageFramework": "string",
"server": "string"
}
For Jar, use:
"type": "Jar",
"jvmOptions": "string",
"relativePath": "string",
"runtimeVersion": "string"
For NetCoreZip, use:
"type": "NetCoreZip",
"netCoreMainEntryPath": "string",
"relativePath": "string",
"runtimeVersion": "string"
For Source, use:
"type": "Source",
"artifactSelector": "string",
"relativePath": "string",
"runtimeVersion": "string"
Property values
Spring/apps/deployments
Name | Description | Value |
---|---|---|
type | The resource type | 'Microsoft.AppPlatform/Spring/apps/deployments' |
apiVersion | The resource api version | '2022-05-01-preview' |
name | The resource name See how to set names and types for child resources in JSON ARM templates. |
string (required) |
sku | Sku of the Deployment resource | Sku |
properties | Properties of the Deployment resource | DeploymentResourceProperties |
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 |
livenessProbe | Periodic probe of App Instance liveness. App Instance will be restarted if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
readinessProbe | Periodic probe of App Instance service readiness. App Instance will be removed from service endpoints if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
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 |
startupProbe | StartupProbe indicates that the App Instance has successfully initialized. If specified, no other probes are executed until this completes successfully. If this probe fails, the Pod will be restarted, just as if the livenessProbe failed. This can be used to provide different probe parameters at the beginning of a App Instance's lifecycle, when it might take a long time to load data or warm a cache, than during steady-state operation. This cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
terminationGracePeriodSeconds | Optional duration in seconds the App Instance needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the App Instance are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 90 seconds. | int |
DeploymentSettingsAddonConfigs
Name | Description | Value |
---|---|---|
{customized property} | AddonProfile |
AddonProfile
Name | Description | Value |
---|---|---|
{customized property} |
ContainerProbeSettings
Name | Description | Value |
---|---|---|
disableProbe | Indicates whether disable the liveness and readiness probe | bool |
DeploymentSettingsEnvironmentVariables
Name | Description | Value |
---|---|---|
{customized property} | string |
Probe
Name | Description | Value |
---|---|---|
disableProbe | Indicate whether the probe is disabled. | bool (required) |
failureThreshold | Minimum consecutive failures for the probe to be considered failed after having succeeded. Minimum value is 1. | int |
initialDelaySeconds | Number of seconds after the App Instance has started before probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
int |
periodSeconds | How often (in seconds) to perform the probe. Minimum value is 1. | int |
probeAction | The action of the probe. | ProbeAction |
successThreshold | Minimum consecutive successes for the probe to be considered successful after having failed. Must be 1 for liveness and startup. Minimum value is 1. | int |
timeoutSeconds | Number of seconds after which the probe times out. Minimum value is 1. | int |
ProbeAction
Name | Description | Value |
---|---|---|
type | Set the object type | ExecAction HTTPGetAction TCPSocketAction (required) |
ExecAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | 'ExecAction' (required) |
command | Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is not run inside a shell, so traditional shell instructions (',', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy. | string[] |
HttpGetAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | 'HTTPGetAction' (required) |
path | Path to access on the HTTP server. | string |
scheme | Scheme to use for connecting to the host. Defaults to HTTP. Possible enum values: - "HTTP" means that the scheme used will be http:// - "HTTPS" means that the scheme used will be https:// |
'HTTP' 'HTTPS' |
TCPSocketAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | 'TCPSocketAction' (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 |
UserSourceInfo
Name | Description | Value |
---|---|---|
version | Version of the source | string |
type | Set the object type | BuildResult Container Jar NetCoreZip Source (required) |
BuildResultUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'BuildResult' (required) |
buildResultId | Resource id of an existing succeeded build result under the same Spring instance. | string |
CustomContainerUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'Container' (required) |
customContainer | Custom container payload | CustomContainer |
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 |
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 |
---|---|---|
type | Type of the source uploaded | 'Jar' (required) |
jvmOptions | JVM parameter | string |
relativePath | Relative path of the storage which stores the source | string |
runtimeVersion | Runtime version of the Jar file | string |
NetCoreZipUploadedUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'NetCoreZip' (required) |
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 |
SourceUploadedUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | 'Source' (required) |
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 |
Sku
Name | Description | Value |
---|---|---|
capacity | Current capacity of the target resource | int |
name | Name of the Sku | string |
tier | Tier of the Sku | string |
Quickstart templates
The following 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-05-01-preview"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
active = bool
deploymentSettings = {
addonConfigs = {
{customized property} = {}
}
containerProbeSettings = {
disableProbe = bool
}
environmentVariables = {
{customized property} = "string"
}
livenessProbe = {
disableProbe = bool
failureThreshold = int
initialDelaySeconds = int
periodSeconds = int
probeAction = {
type = "string"
// For remaining properties, see ProbeAction objects
}
successThreshold = int
timeoutSeconds = int
}
readinessProbe = {
disableProbe = bool
failureThreshold = int
initialDelaySeconds = int
periodSeconds = int
probeAction = {
type = "string"
// For remaining properties, see ProbeAction objects
}
successThreshold = int
timeoutSeconds = int
}
resourceRequests = {
cpu = "string"
memory = "string"
}
startupProbe = {
disableProbe = bool
failureThreshold = int
initialDelaySeconds = int
periodSeconds = int
probeAction = {
type = "string"
// For remaining properties, see ProbeAction objects
}
successThreshold = int
timeoutSeconds = int
}
terminationGracePeriodSeconds = int
}
source = {
version = "string"
type = "string"
// For remaining properties, see UserSourceInfo objects
}
}
sku = {
capacity = int
name = "string"
tier = "string"
}
})
}
ProbeAction objects
Set the type property to specify the type of object.
For ExecAction, use:
type = "ExecAction"
command = [
"string"
]
For HTTPGetAction, use:
type = "HTTPGetAction"
path = "string"
scheme = "string"
For TCPSocketAction, use:
type = "TCPSocketAction"
UserSourceInfo objects
Set the type property to specify the type of object.
For BuildResult, use:
type = "BuildResult"
buildResultId = "string"
For Container, use:
type = "Container"
customContainer = {
args = [
"string"
]
command = [
"string"
]
containerImage = "string"
imageRegistryCredential = {
password = "string"
username = "string"
}
languageFramework = "string"
server = "string"
}
For Jar, use:
type = "Jar"
jvmOptions = "string"
relativePath = "string"
runtimeVersion = "string"
For NetCoreZip, use:
type = "NetCoreZip"
netCoreMainEntryPath = "string"
relativePath = "string"
runtimeVersion = "string"
For Source, use:
type = "Source"
artifactSelector = "string"
relativePath = "string"
runtimeVersion = "string"
Property values
Spring/apps/deployments
Name | Description | Value |
---|---|---|
type | The resource type | "Microsoft.AppPlatform/Spring/apps/deployments@2022-05-01-preview" |
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: apps |
sku | Sku of the Deployment resource | Sku |
properties | Properties of the Deployment resource | DeploymentResourceProperties |
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 |
livenessProbe | Periodic probe of App Instance liveness. App Instance will be restarted if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
readinessProbe | Periodic probe of App Instance service readiness. App Instance will be removed from service endpoints if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
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 |
startupProbe | StartupProbe indicates that the App Instance has successfully initialized. If specified, no other probes are executed until this completes successfully. If this probe fails, the Pod will be restarted, just as if the livenessProbe failed. This can be used to provide different probe parameters at the beginning of a App Instance's lifecycle, when it might take a long time to load data or warm a cache, than during steady-state operation. This cannot be updated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
Probe |
terminationGracePeriodSeconds | Optional duration in seconds the App Instance needs to terminate gracefully. May be decreased in delete request. Value must be non-negative integer. The value zero indicates stop immediately via the kill signal (no opportunity to shut down). If this value is nil, the default grace period will be used instead. The grace period is the duration in seconds after the processes running in the App Instance are sent a termination signal and the time when the processes are forcibly halted with a kill signal. Set this value longer than the expected cleanup time for your process. Defaults to 90 seconds. | int |
DeploymentSettingsAddonConfigs
Name | Description | Value |
---|---|---|
{customized property} | AddonProfile |
AddonProfile
Name | Description | Value |
---|---|---|
{customized property} |
ContainerProbeSettings
Name | Description | Value |
---|---|---|
disableProbe | Indicates whether disable the liveness and readiness probe | bool |
DeploymentSettingsEnvironmentVariables
Name | Description | Value |
---|---|---|
{customized property} | string |
Probe
Name | Description | Value |
---|---|---|
disableProbe | Indicate whether the probe is disabled. | bool (required) |
failureThreshold | Minimum consecutive failures for the probe to be considered failed after having succeeded. Minimum value is 1. | int |
initialDelaySeconds | Number of seconds after the App Instance has started before probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
int |
periodSeconds | How often (in seconds) to perform the probe. Minimum value is 1. | int |
probeAction | The action of the probe. | ProbeAction |
successThreshold | Minimum consecutive successes for the probe to be considered successful after having failed. Must be 1 for liveness and startup. Minimum value is 1. | int |
timeoutSeconds | Number of seconds after which the probe times out. Minimum value is 1. | int |
ProbeAction
Name | Description | Value |
---|---|---|
type | Set the object type | ExecAction HTTPGetAction TCPSocketAction (required) |
ExecAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | "ExecAction" (required) |
command | Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is not run inside a shell, so traditional shell instructions (',', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy. | string[] |
HttpGetAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | "HTTPGetAction" (required) |
path | Path to access on the HTTP server. | string |
scheme | Scheme to use for connecting to the host. Defaults to HTTP. Possible enum values: - "HTTP" means that the scheme used will be http:// - "HTTPS" means that the scheme used will be https:// |
"HTTP" "HTTPS" |
TCPSocketAction
Name | Description | Value |
---|---|---|
type | The type of the action to take to perform the health check. | "TCPSocketAction" (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 |
UserSourceInfo
Name | Description | Value |
---|---|---|
version | Version of the source | string |
type | Set the object type | BuildResult Container Jar NetCoreZip Source (required) |
BuildResultUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | "BuildResult" (required) |
buildResultId | Resource id of an existing succeeded build result under the same Spring instance. | string |
CustomContainerUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | "Container" (required) |
customContainer | Custom container payload | CustomContainer |
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 |
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 |
---|---|---|
type | Type of the source uploaded | "Jar" (required) |
jvmOptions | JVM parameter | string |
relativePath | Relative path of the storage which stores the source | string |
runtimeVersion | Runtime version of the Jar file | string |
NetCoreZipUploadedUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | "NetCoreZip" (required) |
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 |
SourceUploadedUserSourceInfo
Name | Description | Value |
---|---|---|
type | Type of the source uploaded | "Source" (required) |
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 |
Sku
Name | Description | Value |
---|---|---|
capacity | Current capacity of the target resource | int |
name | Name of the Sku | string |
tier | Tier of the Sku | string |