Partager via

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

  • Article

Définition de ressource Bicep

Le type de ressource générateurs/builds peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.App/builders/builds, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.App/builders/builds@2023-11-02-preview' = {
  parent: resourceSymbolicName
  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'
    }
  }
}

Valeurs de propriété

BuildConfiguration

Nom Description Valeur
baseOs Système d’exploitation de base utilisé pour générer et exécuter l’application. corde
environmentVariables Liste des variables d’environnement à passer à la build, les secrets ne doivent pas être utilisés dans la variable d’environnement. EnvironmentVariable[]
plateforme Plateforme à utiliser pour générer et exécuter l’application. corde
platformVersion Version de plateforme à utiliser pour générer et exécuter l’application. corde
preBuildSteps Liste des étapes à effectuer avant la génération. PreBuildStep[]

BuildProperties

Nom Description Valeur
configuration Configuration de la build. buildConfiguration
destinationContainerRegistry Registre de conteneurs vers lequel l’image finale sera chargée. ContainerRegistryWithCustomImage

ContainerRegistryWithCustomImage

Nom Description Valeur
image Nom complet que l’image finale doit être chargée, y compris le nom de l’image et la balise. corde
serveur Serveur de connexion du registre de conteneurs vers lequel l’image finale doit être chargée. La ressource Builder doit avoir ce registre de conteneurs défini avec une identité à utiliser pour y accéder. chaîne (obligatoire)

EnvironmentVariable

Nom Description Valeur
nom Nom de la variable d’environnement. chaîne (obligatoire)
valeur Valeur de variable d’environnement. chaîne (obligatoire)

HttpGet

Nom Description Valeur
Fichier Nom du fichier dans lequel la demande doit être enregistrée. corde
En-têtes Liste des en-têtes à envoyer avec la demande. string[]
URL URL sur laquelle effectuer une requête HTTP GET. chaîne (obligatoire)

Microsoft.App/builders/builds

Nom Description Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 2
Longueur maximale = 2
Modèle = ^[-\w\._\(\)]+$ (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.		 Nom symbolique de la ressource de type : générateurs
Propriétés Propriétés spécifiques à la ressource pour cette ressource. BuildProperties

PreBuildStep

Nom Description Valeur
description Description de l’étape de pré-build. corde
httpGet Demande d’obtention http à envoyer avant la génération. HttpGet
Scripts Liste des commandes personnalisées à exécuter. string[]

Définition de ressource de modèle ARM

Le type de ressource générateurs/builds peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.App/builders/builds, ajoutez le code JSON suivant à votre modèle.

{
  "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"
    }
  }
}

Valeurs de propriété

BuildConfiguration

Nom Description Valeur
baseOs Système d’exploitation de base utilisé pour générer et exécuter l’application. corde
environmentVariables Liste des variables d’environnement à passer à la build, les secrets ne doivent pas être utilisés dans la variable d’environnement. EnvironmentVariable[]
plateforme Plateforme à utiliser pour générer et exécuter l’application. corde
platformVersion Version de plateforme à utiliser pour générer et exécuter l’application. corde
preBuildSteps Liste des étapes à effectuer avant la génération. PreBuildStep[]

BuildProperties

Nom Description Valeur
configuration Configuration de la build. buildConfiguration
destinationContainerRegistry Registre de conteneurs vers lequel l’image finale sera chargée. ContainerRegistryWithCustomImage

ContainerRegistryWithCustomImage

Nom Description Valeur
image Nom complet que l’image finale doit être chargée, y compris le nom de l’image et la balise. corde
serveur Serveur de connexion du registre de conteneurs vers lequel l’image finale doit être chargée. La ressource Builder doit avoir ce registre de conteneurs défini avec une identité à utiliser pour y accéder. chaîne (obligatoire)

EnvironmentVariable

Nom Description Valeur
nom Nom de la variable d’environnement. chaîne (obligatoire)
valeur Valeur de variable d’environnement. chaîne (obligatoire)

HttpGet

Nom Description Valeur
Fichier Nom du fichier dans lequel la demande doit être enregistrée. corde
En-têtes Liste des en-têtes à envoyer avec la demande. string[]
URL URL sur laquelle effectuer une requête HTTP GET. chaîne (obligatoire)

Microsoft.App/builders/builds

Nom Description Valeur
apiVersion Version de l’API '2023-11-02-preview'
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 2
Longueur maximale = 2
Modèle = ^[-\w\._\(\)]+$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. BuildProperties
type Type de ressource 'Microsoft.App/builders/builds'

PreBuildStep

Nom Description Valeur
description Description de l’étape de pré-build. corde
httpGet Demande d’obtention http à envoyer avant la génération. HttpGet
Scripts Liste des commandes personnalisées à exécuter. string[]

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource générateurs/builds peut être déployé avec des opérations qui ciblent :

  • Groupe de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.App/builders/builds, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/builders/builds@2023-11-02-preview"
  name = "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"
      }
    }
  })
}

Valeurs de propriété

BuildConfiguration

Nom Description Valeur
baseOs Système d’exploitation de base utilisé pour générer et exécuter l’application. corde
environmentVariables Liste des variables d’environnement à passer à la build, les secrets ne doivent pas être utilisés dans la variable d’environnement. EnvironmentVariable[]
plateforme Plateforme à utiliser pour générer et exécuter l’application. corde
platformVersion Version de plateforme à utiliser pour générer et exécuter l’application. corde
preBuildSteps Liste des étapes à effectuer avant la génération. PreBuildStep[]

BuildProperties

Nom Description Valeur
configuration Configuration de la build. buildConfiguration
destinationContainerRegistry Registre de conteneurs vers lequel l’image finale sera chargée. ContainerRegistryWithCustomImage

ContainerRegistryWithCustomImage

Nom Description Valeur
image Nom complet que l’image finale doit être chargée, y compris le nom de l’image et la balise. corde
serveur Serveur de connexion du registre de conteneurs vers lequel l’image finale doit être chargée. La ressource Builder doit avoir ce registre de conteneurs défini avec une identité à utiliser pour y accéder. chaîne (obligatoire)

EnvironmentVariable

Nom Description Valeur
nom Nom de la variable d’environnement. chaîne (obligatoire)
valeur Valeur de variable d’environnement. chaîne (obligatoire)

HttpGet

Nom Description Valeur
Fichier Nom du fichier dans lequel la demande doit être enregistrée. corde
En-têtes Liste des en-têtes à envoyer avec la demande. string[]
URL URL sur laquelle effectuer une requête HTTP GET. chaîne (obligatoire)

Microsoft.App/builders/builds

Nom Description Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 2
Longueur maximale = 2
Modèle = ^[-\w\._\(\)]+$ (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : générateurs
Propriétés Propriétés spécifiques à la ressource pour cette ressource. BuildProperties
type Type de ressource « Microsoft.App/builders/builds@2023-11-02-preview »

PreBuildStep

Nom Description Valeur
description Description de l’étape de pré-build. corde
httpGet Demande d’obtention http à envoyer avant la génération. HttpGet
Scripts Liste des commandes personnalisées à exécuter. string[]