Microsoft.App builders/builds 2023-11-02-preview

  • Article

Bicep resource definition

The builders/builds 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.App/builders/builds resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.App/builders/builds@2023-11-02-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    configuration: {
      baseOs: 'string'
      environmentVariables: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      platform: 'string'
      platformVersion: 'string'
      preBuildSteps: [
        {
          description: 'string'
          httpGet: {
            fileName: 'string'
            headers: [
              'string'
            ]
            url: 'string'
          }
          scripts: [
            'string'
          ]
        }
      ]
    }
    destinationContainerRegistry: {
      image: 'string'
      server: 'string'
    }
  }
}

Property values

builders/builds

Name Description Value
name The resource name

See how to set names and types for child resources in Bicep.		 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: builders
properties The resource-specific properties for this resource. BuildProperties

BuildProperties

Name Description Value
configuration Configuration of the build. BuildConfiguration
destinationContainerRegistry Container registry that the final image will be uploaded to. ContainerRegistryWithCustomImage

BuildConfiguration

Name Description Value
baseOs Base OS used to build and run the app. string
environmentVariables List of environment variables to be passed to the build, secrets should not be used in environment variable. EnvironmentVariable[]
platform Platform to be used to build and run the app. string
platformVersion Platform version to be used to build and run the app. string
preBuildSteps List of steps to perform before the build. PreBuildStep[]

EnvironmentVariable

Name Description Value
name Environment variable name. string (required)
value Environment variable value. string (required)

PreBuildStep

Name Description Value
description Description of the pre-build step. string
httpGet Http get request to send before the build. HttpGet
scripts List of custom commands to run. string[]

HttpGet

Name Description Value
fileName Name of the file that the request should be saved to. string
headers List of headers to send with the request. string[]
url URL to make HTTP GET request against. string (required)

ContainerRegistryWithCustomImage

Name Description Value
image Full name that the final image should be uploaded as, including both image name and tag. string
server Login server of the container registry that the final image should be uploaded to. Builder resource needs to have this container registry defined along with an identity to use to access it. string (required)

ARM template resource definition

The builders/builds 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.App/builders/builds resource, add the following JSON to your template.

{
  "type": "Microsoft.App/builders/builds",
  "apiVersion": "2023-11-02-preview",
  "name": "string",
  "properties": {
    "configuration": {
      "baseOs": "string",
      "environmentVariables": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "platform": "string",
      "platformVersion": "string",
      "preBuildSteps": [
        {
          "description": "string",
          "httpGet": {
            "fileName": "string",
            "headers": [ "string" ],
            "url": "string"
          },
          "scripts": [ "string" ]
        }
      ]
    },
    "destinationContainerRegistry": {
      "image": "string",
      "server": "string"
    }
  }
}

Property values

builders/builds

Name Description Value
type The resource type 'Microsoft.App/builders/builds'
apiVersion The resource api version '2023-11-02-preview'
name The resource name

See how to set names and types for child resources in JSON ARM templates.		 string (required)
properties The resource-specific properties for this resource. BuildProperties

BuildProperties

Name Description Value
configuration Configuration of the build. BuildConfiguration
destinationContainerRegistry Container registry that the final image will be uploaded to. ContainerRegistryWithCustomImage

BuildConfiguration

Name Description Value
baseOs Base OS used to build and run the app. string
environmentVariables List of environment variables to be passed to the build, secrets should not be used in environment variable. EnvironmentVariable[]
platform Platform to be used to build and run the app. string
platformVersion Platform version to be used to build and run the app. string
preBuildSteps List of steps to perform before the build. PreBuildStep[]

EnvironmentVariable

Name Description Value
name Environment variable name. string (required)
value Environment variable value. string (required)

PreBuildStep

Name Description Value
description Description of the pre-build step. string
httpGet Http get request to send before the build. HttpGet
scripts List of custom commands to run. string[]

HttpGet

Name Description Value
fileName Name of the file that the request should be saved to. string
headers List of headers to send with the request. string[]
url URL to make HTTP GET request against. string (required)

ContainerRegistryWithCustomImage

Name Description Value
image Full name that the final image should be uploaded as, including both image name and tag. string
server Login server of the container registry that the final image should be uploaded to. Builder resource needs to have this container registry defined along with an identity to use to access it. string (required)

Terraform (AzAPI provider) resource definition

The builders/builds 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.App/builders/builds resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/builders/builds@2023-11-02-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      configuration = {
        baseOs = "string"
        environmentVariables = [
          {
            name = "string"
            value = "string"
          }
        ]
        platform = "string"
        platformVersion = "string"
        preBuildSteps = [
          {
            description = "string"
            httpGet = {
              fileName = "string"
              headers = [
                "string"
              ]
              url = "string"
            }
            scripts = [
              "string"
            ]
          }
        ]
      }
      destinationContainerRegistry = {
        image = "string"
        server = "string"
      }
    }
  })
}

Property values

builders/builds

Name Description Value
type The resource type "Microsoft.App/builders/builds@2023-11-02-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: builders
properties The resource-specific properties for this resource. BuildProperties

BuildProperties

Name Description Value
configuration Configuration of the build. BuildConfiguration
destinationContainerRegistry Container registry that the final image will be uploaded to. ContainerRegistryWithCustomImage

BuildConfiguration

Name Description Value
baseOs Base OS used to build and run the app. string
environmentVariables List of environment variables to be passed to the build, secrets should not be used in environment variable. EnvironmentVariable[]
platform Platform to be used to build and run the app. string
platformVersion Platform version to be used to build and run the app. string
preBuildSteps List of steps to perform before the build. PreBuildStep[]

EnvironmentVariable

Name Description Value
name Environment variable name. string (required)
value Environment variable value. string (required)

PreBuildStep

Name Description Value
description Description of the pre-build step. string
httpGet Http get request to send before the build. HttpGet
scripts List of custom commands to run. string[]

HttpGet

Name Description Value
fileName Name of the file that the request should be saved to. string
headers List of headers to send with the request. string[]
url URL to make HTTP GET request against. string (required)

ContainerRegistryWithCustomImage

Name Description Value
image Full name that the final image should be uploaded as, including both image name and tag. string
server Login server of the container registry that the final image should be uploaded to. Builder resource needs to have this container registry defined along with an identity to use to access it. string (required)