Partager via


Registres Microsoft.ContainerRegistry/taskRuns

Définition de ressource Bicep

Le type de ressource registres/taskRuns 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.ContainerRegistry/registrys/taskRuns, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    forceUpdateTag: 'string'
    runRequest: {
      agentPoolName: 'string'
      isArchiveEnabled: bool
      logTemplate: 'string'
      type: 'string'
      // For remaining properties, see RunRequest objects
    }
  }
}

Objets RunRequest

Définissez le type propriété pour spécifier le type d’objet.

Pour DockerBuildRequest, utilisez :

{
  agentConfiguration: {
    cpu: int
  }
  arguments: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
  credentials: {
    customRegistries: {
      {customized property}: {
        identity: 'string'
        password: {
          type: 'string'
          value: 'string'
        }
        userName: {
          type: 'string'
          value: 'string'
        }
      }
    }
    sourceRegistry: {
      loginMode: 'string'
    }
  }
  dockerFilePath: 'string'
  imageNames: [
    'string'
  ]
  isPushEnabled: bool
  noCache: bool
  platform: {
    architecture: 'string'
    os: 'string'
    variant: 'string'
  }
  sourceLocation: 'string'
  target: 'string'
  timeout: int
  type: 'DockerBuildRequest'
}

Pour encodedTaskRunRequest, utilisez :

{
  agentConfiguration: {
    cpu: int
  }
  credentials: {
    customRegistries: {
      {customized property}: {
        identity: 'string'
        password: {
          type: 'string'
          value: 'string'
        }
        userName: {
          type: 'string'
          value: 'string'
        }
      }
    }
    sourceRegistry: {
      loginMode: 'string'
    }
  }
  encodedTaskContent: 'string'
  encodedValuesContent: 'string'
  platform: {
    architecture: 'string'
    os: 'string'
    variant: 'string'
  }
  sourceLocation: 'string'
  timeout: int
  type: 'EncodedTaskRunRequest'
  values: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
}

Pour FileTaskRunRequest, utilisez :

{
  agentConfiguration: {
    cpu: int
  }
  credentials: {
    customRegistries: {
      {customized property}: {
        identity: 'string'
        password: {
          type: 'string'
          value: 'string'
        }
        userName: {
          type: 'string'
          value: 'string'
        }
      }
    }
    sourceRegistry: {
      loginMode: 'string'
    }
  }
  platform: {
    architecture: 'string'
    os: 'string'
    variant: 'string'
  }
  sourceLocation: 'string'
  taskFilePath: 'string'
  timeout: int
  type: 'FileTaskRunRequest'
  values: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
  valuesFilePath: 'string'
}

Pour TaskRunRequest, utilisez :

{
  overrideTaskStepProperties: {
    arguments: [
      {
        isSecret: bool
        name: 'string'
        value: 'string'
      }
    ]
    contextPath: 'string'
    file: 'string'
    target: 'string'
    updateTriggerToken: 'string'
    values: [
      {
        isSecret: bool
        name: 'string'
        value: 'string'
      }
    ]
  }
  taskId: 'string'
  type: 'TaskRunRequest'
}

Valeurs de propriété

AgentProperties

Nom Description Valeur
CPU Configuration du processeur en termes de nombre de cœurs requis pour l’exécution. Int

Argument

Nom Description Valeur
isSecret Indicateur pour indiquer si l’argument représente un secret et souhaitez être supprimé des journaux de génération. Bool
nom Nom de l’argument. chaîne (obligatoire)
valeur Valeur de l’argument. chaîne (obligatoire)

Pouvoirs

Nom Description Valeur
customRegistries Décrit les paramètres d’informations d’identification pour accéder à d’autres registres personnalisés. La clé
pour l’élément de dictionnaire sera le serveur de connexion du Registre (myregistry.azurecr.io) et
la valeur de l’élément sera les informations d’identification du Registre pour accéder au Registre.
CredentialsCustomRegistries
sourceRegistry Décrit les paramètres d’informations d’identification pour accéder au Registre source. SourceRegistryCredentials

CredentialsCustomRegistries

Nom Description Valeur

CustomRegistryCredentials

Nom Description Valeur
identité Indique l’identité managée affectée aux informations d’identification personnalisées. Si une identité affectée par l’utilisateur
cette valeur est l’ID client. Si une identité affectée par le système est system. Dans
le cas d’une identité affectée par le système, l’ID client est déterminé par l’exécuteur. Ceci
l’identité peut être utilisée pour s’authentifier auprès du coffre de clés pour récupérer des informations d’identification ou il peut s’agir du seul
source d’authentification utilisée pour accéder au Registre.
corde
mot de passe Mot de passe pour la connexion au Registre personnalisé. Le mot de passe est un secret
objet qui permet plusieurs façons de fournir la valeur pour celle-ci.
SecretObject
nom d’utilisateur Nom d’utilisateur pour la connexion au Registre personnalisé. SecretObject

DockerBuildRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Arguments Collection d’arguments de remplacement à utiliser lors de l’exécution de l’exécution. argument[]
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
dockerFilePath Chemin d’accès du fichier Docker par rapport à l’emplacement source. chaîne (obligatoire)
imageNames Noms complets d’images, y compris le référentiel et la balise. string[]
isPushEnabled La valeur de cette propriété indique si l’image générée doit être envoyée (push) au Registre ou non. Bool
noCache La valeur de cette propriété indique si le cache d’images est activé ou non. Bool
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
cible Nom de l’étape de génération cible pour la build Docker. corde
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'DockerBuildRequest' (obligatoire)

EncodedTaskRunRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
encodedTaskContent Valeur encodée en base64 du contenu du fichier de modèle/définition. chaîne (obligatoire)
encodedValuesContent Valeur encodée en base64 du contenu du fichier paramètres/valeurs. corde
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'EncodedTaskRunRequest' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]

FileTaskRunRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
taskFilePath Chemin d’accès du fichier de modèle/définition par rapport à la source. chaîne (obligatoire)
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'FileTaskRunRequest' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]
valuesFilePath Chemin d’accès du fichier valeurs/paramètres par rapport à la source. corde

IdentityProperties

Nom Description Valeur
principalId ID principal de l’identité de ressource. corde
tenantId ID de locataire de la ressource. corde
type Type d’identité. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités utilisateur associées à la ressource. Identité de l’utilisateur
Les références de clé de dictionnaire seront des ID de ressource ARM dans le formulaire :
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nom Description Valeur

Microsoft.ContainerRegistry/registrys/taskRuns

Nom Description Valeur
identité Identité de la ressource. IdentityProperties
emplacement Emplacement de la ressource corde
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 5
Longueur maximale = 5
Modèle = ^[a-zA-Z0-9-]*$ (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 : registres
Propriétés Propriétés associées à l’exécution de la tâche, c’est-à-dire demander et résultat de l’exécution TaskRunProperties

OverrideTaskStepProperties

Nom Description Valeur
Arguments Obtient ou définit la collection d’arguments de remplacement à utiliser lorsque
exécution d’une étape de génération.
argument[]
contextPath Contexte source sur lequel l’exécution doit être mise en file d’attente. corde
lime Fichier sur lequel l’exécution doit être mise en file d’attente. corde
cible Nom de l’étape de génération cible pour la build Docker. corde
updateTriggerToken Jeton de déclencheur de mise à jour encodé en base64 qui sera attaché au webhook du déclencheur d’image de base. corde
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]

PlatformProperties

Nom Description Valeur
architecture Architecture du système d’exploitation. '386'
'amd64'
'bras'
'arm64'
'x86'
Os Type de système d’exploitation requis pour l’exécution. 'Linux'
'Windows' (obligatoire)
variante Variante du processeur. 'v6'
'v7'
'v8'

RunRequest

Nom Description Valeur
agentPoolName Pool d’agents dédié pour l’exécution. corde
isArchiveEnabled Valeur qui indique si l’archivage est activé pour l’exécution ou non. Bool
logTemplate Modèle qui décrit le référentiel et les informations de balise pour l’artefact de journal d’exécution. corde
type Défini sur « DockerBuildRequest » pour le type DockerBuildRequest. Défini sur « EncodedTaskRunRequest » pour le type EncodedTaskRunRequest. Défini sur « FileTaskRunRequest » pour le type FileTaskRunRequest. Défini sur « TaskRunRequest » pour le type TaskRunRequest. 'DockerBuildRequest'
'EncodedTaskRunRequest'
'FileTaskRunRequest'
'TaskRunRequest' (obligatoire)

SecretObject

Nom Description Valeur
type Type de l’objet secret qui détermine la façon dont la valeur de l’objet secret doit être
Interprété.
'Opaque'
'Vaultsecret'
valeur Valeur du secret. Le format de cette valeur sera déterminé
en fonction du type de l’objet secret. Si le type est Opaque, la valeur sera
utilisé tel quel sans aucune modification.
corde

SetValue

Nom Description Valeur
isSecret Indicateur pour indiquer si la valeur représente un secret ou non. Bool
nom Nom de la valeur substituable. chaîne (obligatoire)
valeur Valeur substituable. chaîne (obligatoire)

SourceRegistryCredentials

Nom Description Valeur
loginMode Mode d’authentification qui détermine l’étendue de connexion du Registre source. Informations d’identification pour le registre source
sera généré à l’aide de l’étendue donnée. Ces informations d’identification seront utilisées pour se connecter à
registre source pendant l’exécution.
'Default'
'None'

TaskRunProperties

Nom Description Valeur
forceUpdateTag Comment l’exécution doit être forcée de réexécuter même si la configuration de la demande d’exécution n’a pas changé corde
runRequest Requête (paramètres) pour l’exécution RunRequest

TaskRunRequest

Nom Description Valeur
overrideTaskStepProperties Ensemble de paramètres substituables qui peuvent être passés lors de l’exécution d’une tâche. OverrideTaskStepProperties
taskId ID de ressource de la tâche sur laquelle l’exécution doit être mise en file d’attente. chaîne (obligatoire)
type Type de la requête d’exécution. 'TaskRunRequest' (obligatoire)

UserIdentityProperties

Nom Description Valeur
clientId ID client de l’identité affectée par l’utilisateur. corde
principalId ID principal de l’identité affectée par l’utilisateur. corde

Définition de ressource de modèle ARM

Le type de ressource registres/taskRuns 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.ContainerRegistry/registrys/taskRuns, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ContainerRegistry/registries/taskRuns",
  "apiVersion": "2019-06-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "forceUpdateTag": "string",
    "runRequest": {
      "agentPoolName": "string",
      "isArchiveEnabled": "bool",
      "logTemplate": "string",
      "type": "string"
      // For remaining properties, see RunRequest objects
    }
  }
}

Objets RunRequest

Définissez le type propriété pour spécifier le type d’objet.

Pour DockerBuildRequest, utilisez :

{
  "agentConfiguration": {
    "cpu": "int"
  },
  "arguments": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ],
  "credentials": {
    "customRegistries": {
      "{customized property}": {
        "identity": "string",
        "password": {
          "type": "string",
          "value": "string"
        },
        "userName": {
          "type": "string",
          "value": "string"
        }
      }
    },
    "sourceRegistry": {
      "loginMode": "string"
    }
  },
  "dockerFilePath": "string",
  "imageNames": [ "string" ],
  "isPushEnabled": "bool",
  "noCache": "bool",
  "platform": {
    "architecture": "string",
    "os": "string",
    "variant": "string"
  },
  "sourceLocation": "string",
  "target": "string",
  "timeout": "int",
  "type": "DockerBuildRequest"
}

Pour encodedTaskRunRequest, utilisez :

{
  "agentConfiguration": {
    "cpu": "int"
  },
  "credentials": {
    "customRegistries": {
      "{customized property}": {
        "identity": "string",
        "password": {
          "type": "string",
          "value": "string"
        },
        "userName": {
          "type": "string",
          "value": "string"
        }
      }
    },
    "sourceRegistry": {
      "loginMode": "string"
    }
  },
  "encodedTaskContent": "string",
  "encodedValuesContent": "string",
  "platform": {
    "architecture": "string",
    "os": "string",
    "variant": "string"
  },
  "sourceLocation": "string",
  "timeout": "int",
  "type": "EncodedTaskRunRequest",
  "values": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ]
}

Pour FileTaskRunRequest, utilisez :

{
  "agentConfiguration": {
    "cpu": "int"
  },
  "credentials": {
    "customRegistries": {
      "{customized property}": {
        "identity": "string",
        "password": {
          "type": "string",
          "value": "string"
        },
        "userName": {
          "type": "string",
          "value": "string"
        }
      }
    },
    "sourceRegistry": {
      "loginMode": "string"
    }
  },
  "platform": {
    "architecture": "string",
    "os": "string",
    "variant": "string"
  },
  "sourceLocation": "string",
  "taskFilePath": "string",
  "timeout": "int",
  "type": "FileTaskRunRequest",
  "values": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ],
  "valuesFilePath": "string"
}

Pour TaskRunRequest, utilisez :

{
  "overrideTaskStepProperties": {
    "arguments": [
      {
        "isSecret": "bool",
        "name": "string",
        "value": "string"
      }
    ],
    "contextPath": "string",
    "file": "string",
    "target": "string",
    "updateTriggerToken": "string",
    "values": [
      {
        "isSecret": "bool",
        "name": "string",
        "value": "string"
      }
    ]
  },
  "taskId": "string",
  "type": "TaskRunRequest"
}

Valeurs de propriété

AgentProperties

Nom Description Valeur
CPU Configuration du processeur en termes de nombre de cœurs requis pour l’exécution. Int

Argument

Nom Description Valeur
isSecret Indicateur pour indiquer si l’argument représente un secret et souhaitez être supprimé des journaux de génération. Bool
nom Nom de l’argument. chaîne (obligatoire)
valeur Valeur de l’argument. chaîne (obligatoire)

Pouvoirs

Nom Description Valeur
customRegistries Décrit les paramètres d’informations d’identification pour accéder à d’autres registres personnalisés. La clé
pour l’élément de dictionnaire sera le serveur de connexion du Registre (myregistry.azurecr.io) et
la valeur de l’élément sera les informations d’identification du Registre pour accéder au Registre.
CredentialsCustomRegistries
sourceRegistry Décrit les paramètres d’informations d’identification pour accéder au Registre source. SourceRegistryCredentials

CredentialsCustomRegistries

Nom Description Valeur

CustomRegistryCredentials

Nom Description Valeur
identité Indique l’identité managée affectée aux informations d’identification personnalisées. Si une identité affectée par l’utilisateur
cette valeur est l’ID client. Si une identité affectée par le système est system. Dans
le cas d’une identité affectée par le système, l’ID client est déterminé par l’exécuteur. Ceci
l’identité peut être utilisée pour s’authentifier auprès du coffre de clés pour récupérer des informations d’identification ou il peut s’agir du seul
source d’authentification utilisée pour accéder au Registre.
corde
mot de passe Mot de passe pour la connexion au Registre personnalisé. Le mot de passe est un secret
objet qui permet plusieurs façons de fournir la valeur pour celle-ci.
SecretObject
nom d’utilisateur Nom d’utilisateur pour la connexion au Registre personnalisé. SecretObject

DockerBuildRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Arguments Collection d’arguments de remplacement à utiliser lors de l’exécution de l’exécution. argument[]
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
dockerFilePath Chemin d’accès du fichier Docker par rapport à l’emplacement source. chaîne (obligatoire)
imageNames Noms complets d’images, y compris le référentiel et la balise. string[]
isPushEnabled La valeur de cette propriété indique si l’image générée doit être envoyée (push) au Registre ou non. Bool
noCache La valeur de cette propriété indique si le cache d’images est activé ou non. Bool
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
cible Nom de l’étape de génération cible pour la build Docker. corde
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'DockerBuildRequest' (obligatoire)

EncodedTaskRunRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
encodedTaskContent Valeur encodée en base64 du contenu du fichier de modèle/définition. chaîne (obligatoire)
encodedValuesContent Valeur encodée en base64 du contenu du fichier paramètres/valeurs. corde
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'EncodedTaskRunRequest' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]

FileTaskRunRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
taskFilePath Chemin d’accès du fichier de modèle/définition par rapport à la source. chaîne (obligatoire)
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'FileTaskRunRequest' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]
valuesFilePath Chemin d’accès du fichier valeurs/paramètres par rapport à la source. corde

IdentityProperties

Nom Description Valeur
principalId ID principal de l’identité de ressource. corde
tenantId ID de locataire de la ressource. corde
type Type d’identité. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités utilisateur associées à la ressource. Identité de l’utilisateur
Les références de clé de dictionnaire seront des ID de ressource ARM dans le formulaire :
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nom Description Valeur

Microsoft.ContainerRegistry/registrys/taskRuns

Nom Description Valeur
apiVersion Version de l’API '2019-06-01-preview'
identité Identité de la ressource. IdentityProperties
emplacement Emplacement de la ressource corde
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 5
Longueur maximale = 5
Modèle = ^[a-zA-Z0-9-]*$ (obligatoire)
Propriétés Propriétés associées à l’exécution de la tâche, c’est-à-dire demander et résultat de l’exécution TaskRunProperties
type Type de ressource 'Microsoft.ContainerRegistry/registrys/taskRuns'

OverrideTaskStepProperties

Nom Description Valeur
Arguments Obtient ou définit la collection d’arguments de remplacement à utiliser lorsque
exécution d’une étape de génération.
argument[]
contextPath Contexte source sur lequel l’exécution doit être mise en file d’attente. corde
lime Fichier sur lequel l’exécution doit être mise en file d’attente. corde
cible Nom de l’étape de génération cible pour la build Docker. corde
updateTriggerToken Jeton de déclencheur de mise à jour encodé en base64 qui sera attaché au webhook du déclencheur d’image de base. corde
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]

PlatformProperties

Nom Description Valeur
architecture Architecture du système d’exploitation. '386'
'amd64'
'bras'
'arm64'
'x86'
Os Type de système d’exploitation requis pour l’exécution. 'Linux'
'Windows' (obligatoire)
variante Variante du processeur. 'v6'
'v7'
'v8'

RunRequest

Nom Description Valeur
agentPoolName Pool d’agents dédié pour l’exécution. corde
isArchiveEnabled Valeur qui indique si l’archivage est activé pour l’exécution ou non. Bool
logTemplate Modèle qui décrit le référentiel et les informations de balise pour l’artefact de journal d’exécution. corde
type Défini sur « DockerBuildRequest » pour le type DockerBuildRequest. Défini sur « EncodedTaskRunRequest » pour le type EncodedTaskRunRequest. Défini sur « FileTaskRunRequest » pour le type FileTaskRunRequest. Défini sur « TaskRunRequest » pour le type TaskRunRequest. 'DockerBuildRequest'
'EncodedTaskRunRequest'
'FileTaskRunRequest'
'TaskRunRequest' (obligatoire)

SecretObject

Nom Description Valeur
type Type de l’objet secret qui détermine la façon dont la valeur de l’objet secret doit être
Interprété.
'Opaque'
'Vaultsecret'
valeur Valeur du secret. Le format de cette valeur sera déterminé
en fonction du type de l’objet secret. Si le type est Opaque, la valeur sera
utilisé tel quel sans aucune modification.
corde

SetValue

Nom Description Valeur
isSecret Indicateur pour indiquer si la valeur représente un secret ou non. Bool
nom Nom de la valeur substituable. chaîne (obligatoire)
valeur Valeur substituable. chaîne (obligatoire)

SourceRegistryCredentials

Nom Description Valeur
loginMode Mode d’authentification qui détermine l’étendue de connexion du Registre source. Informations d’identification pour le registre source
sera généré à l’aide de l’étendue donnée. Ces informations d’identification seront utilisées pour se connecter à
registre source pendant l’exécution.
'Default'
'None'

TaskRunProperties

Nom Description Valeur
forceUpdateTag Comment l’exécution doit être forcée de réexécuter même si la configuration de la demande d’exécution n’a pas changé corde
runRequest Requête (paramètres) pour l’exécution RunRequest

TaskRunRequest

Nom Description Valeur
overrideTaskStepProperties Ensemble de paramètres substituables qui peuvent être passés lors de l’exécution d’une tâche. OverrideTaskStepProperties
taskId ID de ressource de la tâche sur laquelle l’exécution doit être mise en file d’attente. chaîne (obligatoire)
type Type de la requête d’exécution. 'TaskRunRequest' (obligatoire)

UserIdentityProperties

Nom Description Valeur
clientId ID client de l’identité affectée par l’utilisateur. corde
principalId ID principal de l’identité affectée par l’utilisateur. corde

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource registres/taskRuns peut être déployé avec des opérations qui ciblent :

  • groupes 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.ContainerRegistry/registrys/taskRuns, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      forceUpdateTag = "string"
      runRequest = {
        agentPoolName = "string"
        isArchiveEnabled = bool
        logTemplate = "string"
        type = "string"
        // For remaining properties, see RunRequest objects
      }
    }
  })
}

Objets RunRequest

Définissez le type propriété pour spécifier le type d’objet.

Pour DockerBuildRequest, utilisez :

{
  agentConfiguration = {
    cpu = int
  }
  arguments = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
  credentials = {
    customRegistries = {
      {customized property} = {
        identity = "string"
        password = {
          type = "string"
          value = "string"
        }
        userName = {
          type = "string"
          value = "string"
        }
      }
    }
    sourceRegistry = {
      loginMode = "string"
    }
  }
  dockerFilePath = "string"
  imageNames = [
    "string"
  ]
  isPushEnabled = bool
  noCache = bool
  platform = {
    architecture = "string"
    os = "string"
    variant = "string"
  }
  sourceLocation = "string"
  target = "string"
  timeout = int
  type = "DockerBuildRequest"
}

Pour encodedTaskRunRequest, utilisez :

{
  agentConfiguration = {
    cpu = int
  }
  credentials = {
    customRegistries = {
      {customized property} = {
        identity = "string"
        password = {
          type = "string"
          value = "string"
        }
        userName = {
          type = "string"
          value = "string"
        }
      }
    }
    sourceRegistry = {
      loginMode = "string"
    }
  }
  encodedTaskContent = "string"
  encodedValuesContent = "string"
  platform = {
    architecture = "string"
    os = "string"
    variant = "string"
  }
  sourceLocation = "string"
  timeout = int
  type = "EncodedTaskRunRequest"
  values = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
}

Pour FileTaskRunRequest, utilisez :

{
  agentConfiguration = {
    cpu = int
  }
  credentials = {
    customRegistries = {
      {customized property} = {
        identity = "string"
        password = {
          type = "string"
          value = "string"
        }
        userName = {
          type = "string"
          value = "string"
        }
      }
    }
    sourceRegistry = {
      loginMode = "string"
    }
  }
  platform = {
    architecture = "string"
    os = "string"
    variant = "string"
  }
  sourceLocation = "string"
  taskFilePath = "string"
  timeout = int
  type = "FileTaskRunRequest"
  values = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
  valuesFilePath = "string"
}

Pour TaskRunRequest, utilisez :

{
  overrideTaskStepProperties = {
    arguments = [
      {
        isSecret = bool
        name = "string"
        value = "string"
      }
    ]
    contextPath = "string"
    file = "string"
    target = "string"
    updateTriggerToken = "string"
    values = [
      {
        isSecret = bool
        name = "string"
        value = "string"
      }
    ]
  }
  taskId = "string"
  type = "TaskRunRequest"
}

Valeurs de propriété

AgentProperties

Nom Description Valeur
CPU Configuration du processeur en termes de nombre de cœurs requis pour l’exécution. Int

Argument

Nom Description Valeur
isSecret Indicateur pour indiquer si l’argument représente un secret et souhaitez être supprimé des journaux de génération. Bool
nom Nom de l’argument. chaîne (obligatoire)
valeur Valeur de l’argument. chaîne (obligatoire)

Pouvoirs

Nom Description Valeur
customRegistries Décrit les paramètres d’informations d’identification pour accéder à d’autres registres personnalisés. La clé
pour l’élément de dictionnaire sera le serveur de connexion du Registre (myregistry.azurecr.io) et
la valeur de l’élément sera les informations d’identification du Registre pour accéder au Registre.
CredentialsCustomRegistries
sourceRegistry Décrit les paramètres d’informations d’identification pour accéder au Registre source. SourceRegistryCredentials

CredentialsCustomRegistries

Nom Description Valeur

CustomRegistryCredentials

Nom Description Valeur
identité Indique l’identité managée affectée aux informations d’identification personnalisées. Si une identité affectée par l’utilisateur
cette valeur est l’ID client. Si une identité affectée par le système est system. Dans
le cas d’une identité affectée par le système, l’ID client est déterminé par l’exécuteur. Ceci
l’identité peut être utilisée pour s’authentifier auprès du coffre de clés pour récupérer des informations d’identification ou il peut s’agir du seul
source d’authentification utilisée pour accéder au Registre.
corde
mot de passe Mot de passe pour la connexion au Registre personnalisé. Le mot de passe est un secret
objet qui permet plusieurs façons de fournir la valeur pour celle-ci.
SecretObject
nom d’utilisateur Nom d’utilisateur pour la connexion au Registre personnalisé. SecretObject

DockerBuildRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Arguments Collection d’arguments de remplacement à utiliser lors de l’exécution de l’exécution. argument[]
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
dockerFilePath Chemin d’accès du fichier Docker par rapport à l’emplacement source. chaîne (obligatoire)
imageNames Noms complets d’images, y compris le référentiel et la balise. string[]
isPushEnabled La valeur de cette propriété indique si l’image générée doit être envoyée (push) au Registre ou non. Bool
noCache La valeur de cette propriété indique si le cache d’images est activé ou non. Bool
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
cible Nom de l’étape de génération cible pour la build Docker. corde
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'DockerBuildRequest' (obligatoire)

EncodedTaskRunRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
encodedTaskContent Valeur encodée en base64 du contenu du fichier de modèle/définition. chaîne (obligatoire)
encodedValuesContent Valeur encodée en base64 du contenu du fichier paramètres/valeurs. corde
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'EncodedTaskRunRequest' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]

FileTaskRunRequest

Nom Description Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
Pouvoirs Propriétés qui décrivent un ensemble d’informations d’identification qui seront utilisées lors de l’appel de cette exécution. informations d’identification
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties (obligatoire)
sourceLocation URL (absolue ou relative) du contexte source. Il peut s’agir d’une URL vers un dépôt tar ou git.
S’il s’agit d’une URL relative, le chemin d’accès relatif doit être obtenu à partir de l’API listBuildSourceUploadUrl.
corde
taskFilePath Chemin d’accès du fichier de modèle/définition par rapport à la source. chaîne (obligatoire)
Timeout Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
type Type de la requête d’exécution. 'FileTaskRunRequest' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]
valuesFilePath Chemin d’accès du fichier valeurs/paramètres par rapport à la source. corde

IdentityProperties

Nom Description Valeur
principalId ID principal de l’identité de ressource. corde
tenantId ID de locataire de la ressource. corde
type Type d’identité. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités utilisateur associées à la ressource. Identité de l’utilisateur
Les références de clé de dictionnaire seront des ID de ressource ARM dans le formulaire :
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nom Description Valeur

Microsoft.ContainerRegistry/registrys/taskRuns

Nom Description Valeur
identité Identité de la ressource. IdentityProperties
emplacement Emplacement de la ressource corde
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 5
Longueur maximale = 5
Modèle = ^[a-zA-Z0-9-]*$ (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : registres
Propriétés Propriétés associées à l’exécution de la tâche, c’est-à-dire demander et résultat de l’exécution TaskRunProperties
type Type de ressource « Microsoft.ContainerRegistry/registrys/taskRuns@2019-06-01-preview »

OverrideTaskStepProperties

Nom Description Valeur
Arguments Obtient ou définit la collection d’arguments de remplacement à utiliser lorsque
exécution d’une étape de génération.
argument[]
contextPath Contexte source sur lequel l’exécution doit être mise en file d’attente. corde
lime Fichier sur lequel l’exécution doit être mise en file d’attente. corde
cible Nom de l’étape de génération cible pour la build Docker. corde
updateTriggerToken Jeton de déclencheur de mise à jour encodé en base64 qui sera attaché au webhook du déclencheur d’image de base. corde
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. SetValue[]

PlatformProperties

Nom Description Valeur
architecture Architecture du système d’exploitation. '386'
'amd64'
'bras'
'arm64'
'x86'
Os Type de système d’exploitation requis pour l’exécution. 'Linux'
'Windows' (obligatoire)
variante Variante du processeur. 'v6'
'v7'
'v8'

RunRequest

Nom Description Valeur
agentPoolName Pool d’agents dédié pour l’exécution. corde
isArchiveEnabled Valeur qui indique si l’archivage est activé pour l’exécution ou non. Bool
logTemplate Modèle qui décrit le référentiel et les informations de balise pour l’artefact de journal d’exécution. corde
type Défini sur « DockerBuildRequest » pour le type DockerBuildRequest. Défini sur « EncodedTaskRunRequest » pour le type EncodedTaskRunRequest. Défini sur « FileTaskRunRequest » pour le type FileTaskRunRequest. Défini sur « TaskRunRequest » pour le type TaskRunRequest. 'DockerBuildRequest'
'EncodedTaskRunRequest'
'FileTaskRunRequest'
'TaskRunRequest' (obligatoire)

SecretObject

Nom Description Valeur
type Type de l’objet secret qui détermine la façon dont la valeur de l’objet secret doit être
Interprété.
'Opaque'
'Vaultsecret'
valeur Valeur du secret. Le format de cette valeur sera déterminé
en fonction du type de l’objet secret. Si le type est Opaque, la valeur sera
utilisé tel quel sans aucune modification.
corde

SetValue

Nom Description Valeur
isSecret Indicateur pour indiquer si la valeur représente un secret ou non. Bool
nom Nom de la valeur substituable. chaîne (obligatoire)
valeur Valeur substituable. chaîne (obligatoire)

SourceRegistryCredentials

Nom Description Valeur
loginMode Mode d’authentification qui détermine l’étendue de connexion du Registre source. Informations d’identification pour le registre source
sera généré à l’aide de l’étendue donnée. Ces informations d’identification seront utilisées pour se connecter à
registre source pendant l’exécution.
'Default'
'None'

TaskRunProperties

Nom Description Valeur
forceUpdateTag Comment l’exécution doit être forcée de réexécuter même si la configuration de la demande d’exécution n’a pas changé corde
runRequest Requête (paramètres) pour l’exécution RunRequest

TaskRunRequest

Nom Description Valeur
overrideTaskStepProperties Ensemble de paramètres substituables qui peuvent être passés lors de l’exécution d’une tâche. OverrideTaskStepProperties
taskId ID de ressource de la tâche sur laquelle l’exécution doit être mise en file d’attente. chaîne (obligatoire)
type Type de la requête d’exécution. 'TaskRunRequest' (obligatoire)

UserIdentityProperties

Nom Description Valeur
clientId ID client de l’identité affectée par l’utilisateur. corde
principalId ID principal de l’identité affectée par l’utilisateur. corde