Partager via

Registres/tâches Microsoft.ContainerRegistry

Définition de ressource Bicep

Le type de ressource registres/tâches 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/tasks, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@2025-03-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentConfiguration: {
      cpu: int
    }
    agentPoolName: 'string'
    credentials: {
      customRegistries: {
        {customized property}: {
          identity: 'string'
          password: {
            type: 'string'
            value: 'string'
          }
          userName: {
            type: 'string'
            value: 'string'
          }
        }
      }
      sourceRegistry: {
        identity: 'string'
        loginMode: 'string'
      }
    }
    isSystemTask: bool
    logTemplate: 'string'
    platform: {
      architecture: 'string'
      os: 'string'
      variant: 'string'
    }
    status: 'string'
    step: {
      contextAccessToken: 'string'
      contextPath: 'string'
      type: 'string'
      // For remaining properties, see TaskStepProperties objects
    }
    timeout: int
    trigger: {
      baseImageTrigger: {
        baseImageTriggerType: 'string'
        name: 'string'
        status: 'string'
        updateTriggerEndpoint: 'string'
        updateTriggerPayloadType: 'string'
      }
      sourceTriggers: [
        {
          name: 'string'
          sourceRepository: {
            branch: 'string'
            repositoryUrl: 'string'
            sourceControlAuthProperties: {
              expiresIn: int
              refreshToken: 'string'
              scope: 'string'
              token: 'string'
              tokenType: 'string'
            }
            sourceControlType: 'string'
          }
          sourceTriggerEvents: [
            'string'
          ]
          status: 'string'
        }
      ]
      timerTriggers: [
        {
          name: 'string'
          schedule: 'string'
          status: 'string'
        }
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objets TaskStepProperties

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

Pour Docker, utilisez :

{
  arguments: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
  dockerFilePath: 'string'
  imageNames: [
    'string'
  ]
  isPushEnabled: bool
  noCache: bool
  target: 'string'
  type: 'Docker'
}

Pour EncodedTask, utilisez :

{
  encodedTaskContent: 'string'
  encodedValuesContent: 'string'
  type: 'EncodedTask'
  values: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
}

Pour FileTask, utilisez :

{
  taskFilePath: 'string'
  type: 'FileTask'
  values: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
  valuesFilePath: 'string'
}

Valeurs de propriété

Microsoft.ContainerRegistry/registrys/tasks

Nom Descriptif Valeur
identité Identité de la ressource. IdentityProperties
lieu Emplacement de la ressource. Cela ne peut pas être modifié une fois la ressource créée. chaîne (obligatoire)
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 5
Longueur maximale = 50
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 d’une tâche. TaskProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

AgentProperties

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

Raisonnement

Nom Descriptif Valeur
estSecret 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)

AuthInfo

Nom Descriptif Valeur
expiredIn Durée en secondes pendant laquelle le jeton reste valide Int
refreshToken Jeton d’actualisation utilisé pour actualiser le jeton d’accès. ficelle
portée Étendue du jeton d’accès. ficelle
jeton Jeton d’accès utilisé pour accéder au fournisseur de contrôle de code source. chaîne (obligatoire)
type de jeton Type de jeton d’authentification. 'OAuth'
'PAT' (obligatoire)

BaseImageTrigger

Nom Descriptif Valeur
baseImageTriggerType Type du déclencheur automatique pour les mises à jour des dépendances d’image de base. 'Tous'
'Runtime' (obligatoire)
nom Nom du déclencheur. chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'
updateTriggerEndpoint URL du point de terminaison pour la réception des déclencheurs de mise à jour. ficelle
updateTriggerPayloadType Type de corps de charge utile pour les déclencheurs de mise à jour d’image de base. Valeur par défaut
« Jeton »

Informations d’identification

Nom Descriptif 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.		 Informations d’identificationCustomRegistries
sourceRegistre Décrit les paramètres d’informations d’identification pour accéder au Registre source. SourceRegistryCredentials

Informations d’identificationCustomRegistries

Nom Descriptif Valeur

CustomRegistryCredentials

Nom Descriptif 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 définie, la valeur 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.		 ficelle
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

DockerBuildStep

Nom Descriptif Valeur
Arguments Collection d’arguments de remplacement à utiliser lors de l’exécution de cette étape de génération. Argument[]
dockerFilePath Chemin d’accès du fichier Docker par rapport au contexte source. chaîne (obligatoire)
imageNames Noms complets d’images, y compris le référentiel et la balise. chaîne de caractères[]
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
cible Nom de l’étape de génération cible pour la build Docker. ficelle
type Type de l’étape. 'Docker' (obligatoire)

EncodedTaskStep

Nom Descriptif Valeur
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. ficelle
type Type de l’étape. 'EncodedTask' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. DéfinirValeur[]

FileTaskStep

Nom Descriptif Valeur
taskFilePath Chemin du fichier de modèle/définition de tâche par rapport au contexte source. chaîne (obligatoire)
type Type de l’étape. 'FileTask' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. DéfinirValeur[]
valeurFilePath Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte source. ficelle

IdentityProperties

Nom Descriptif Valeur
type Type d’identité. « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
Identités attribuées par l'utilisateur 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 Descriptif Valeur

PlatformProperties

Nom Descriptif 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'

ResourceTags

Nom Descriptif Valeur

SecretObject

Nom Descriptif 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 »
« Secret de l’arche »
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.		 ficelle

Valeur définie

Nom Descriptif Valeur
estSecret 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)

SourceProperties

Nom Descriptif Valeur
branche Nom de branche du code source. ficelle
repositoryUrl URL complète du référentiel de code source chaîne (obligatoire)
sourceControlAuthProperties Propriétés d’autorisation pour accéder au référentiel de code source et configurer
webhooks pour les notifications.		 AuthInfo
sourceControlType Type de service de contrôle de code source. 'Github'
'VisualStudioTeamService' (obligatoire)

SourceRegistryCredentials

Nom Descriptif Valeur
identité Identité Entra utilisée pour la connexion au Registre source.
La valeur concerne [system] l’identité managée affectée par le système, [caller] pour l’identité de l’appelant,
et l’ID client pour l’identité managée affectée par l’utilisateur.		 ficelle
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.		 Valeur par défaut
« Aucun »

SourceTrigger

Nom Descriptif Valeur
nom Nom du déclencheur. chaîne (obligatoire)
sourceRepository Propriétés qui décrivent la source (code) de la tâche. SourceProperties (obligatoire)
sourceTriggerEvents Événement source correspondant au déclencheur. Tableau de chaînes contenant l’un des éléments suivants :
« S’engager »
'pullrequest' (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TaskProperties

Nom Descriptif Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
agentPoolName Pool d’agents dédié pour la tâche. ficelle
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. Identifiants
isSystemTask La valeur de cette propriété indique si la ressource de tâche est une tâche système 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. ficelle
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties
statut État actuel de la tâche. 'Désactivé'
'Activé'
pas Propriétés d’une étape de tâche. TaskStepProperties
Délai d'attente Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
déclencheur Propriétés qui décrivent tous les déclencheurs de la tâche. TriggerProperties

TaskStepProperties

Nom Descriptif Valeur
contextAccessToken Jeton (jeton GIT PAT ou SAP de l’objet blob de compte de stockage) associé au contexte d’une étape. ficelle
contextPath URL(absolue ou relative) du contexte source de l’étape de tâche. ficelle
type Définissez sur « Docker » pour le type DockerBuildStep. Définissez sur « EncodedTask » pour le type EncodedTaskStep. Définissez sur « FileTask » pour type FileTaskStep. 'Docker'
'Tâche encodée'
'FileTask' (obligatoire)

TimerTrigger

Nom Descriptif Valeur
nom Nom du déclencheur. chaîne (obligatoire)
calendrier Expression CRON pour la planification des tâches chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TriggerProperties

Nom Descriptif Valeur
baseImageTrigger Déclencheur basé sur les dépendances d’image de base. BaseImageTrigger
sourceTriggers Collection de déclencheurs basés sur le référentiel de code source. SourceTrigger[]
minuterieDéclencheurs Collection de déclencheurs du minuteur. TimerTrigger[]

UserIdentityProperties

Nom Descriptif Valeur

Définition de ressource de modèle ARM

Le type de ressource registres/tâches 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/tasks, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ContainerRegistry/registries/tasks",
  "apiVersion": "2025-03-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentConfiguration": {
      "cpu": "int"
    },
    "agentPoolName": "string",
    "credentials": {
      "customRegistries": {
        "{customized property}": {
          "identity": "string",
          "password": {
            "type": "string",
            "value": "string"
          },
          "userName": {
            "type": "string",
            "value": "string"
          }
        }
      },
      "sourceRegistry": {
        "identity": "string",
        "loginMode": "string"
      }
    },
    "isSystemTask": "bool",
    "logTemplate": "string",
    "platform": {
      "architecture": "string",
      "os": "string",
      "variant": "string"
    },
    "status": "string",
    "step": {
      "contextAccessToken": "string",
      "contextPath": "string",
      "type": "string"
      // For remaining properties, see TaskStepProperties objects
    },
    "timeout": "int",
    "trigger": {
      "baseImageTrigger": {
        "baseImageTriggerType": "string",
        "name": "string",
        "status": "string",
        "updateTriggerEndpoint": "string",
        "updateTriggerPayloadType": "string"
      },
      "sourceTriggers": [
        {
          "name": "string",
          "sourceRepository": {
            "branch": "string",
            "repositoryUrl": "string",
            "sourceControlAuthProperties": {
              "expiresIn": "int",
              "refreshToken": "string",
              "scope": "string",
              "token": "string",
              "tokenType": "string"
            },
            "sourceControlType": "string"
          },
          "sourceTriggerEvents": [ "string" ],
          "status": "string"
        }
      ],
      "timerTriggers": [
        {
          "name": "string",
          "schedule": "string",
          "status": "string"
        }
      ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objets TaskStepProperties

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

Pour Docker, utilisez :

{
  "arguments": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ],
  "dockerFilePath": "string",
  "imageNames": [ "string" ],
  "isPushEnabled": "bool",
  "noCache": "bool",
  "target": "string",
  "type": "Docker"
}

Pour EncodedTask, utilisez :

{
  "encodedTaskContent": "string",
  "encodedValuesContent": "string",
  "type": "EncodedTask",
  "values": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ]
}

Pour FileTask, utilisez :

{
  "taskFilePath": "string",
  "type": "FileTask",
  "values": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ],
  "valuesFilePath": "string"
}

Valeurs de propriété

Microsoft.ContainerRegistry/registrys/tasks

Nom Descriptif Valeur
apiVersion Version de l’API '2025-03-01-preview'
identité Identité de la ressource. IdentityProperties
lieu Emplacement de la ressource. Cela ne peut pas être modifié une fois la ressource créée. chaîne (obligatoire)
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 5
Longueur maximale = 50
Modèle = ^[a-zA-Z0-9-_]*$ (obligatoire)
Propriétés Propriétés d’une tâche. TaskProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.ContainerRegistry/registrys/tasks'

AgentProperties

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

Raisonnement

Nom Descriptif Valeur
estSecret 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)

AuthInfo

Nom Descriptif Valeur
expiredIn Durée en secondes pendant laquelle le jeton reste valide Int
refreshToken Jeton d’actualisation utilisé pour actualiser le jeton d’accès. ficelle
portée Étendue du jeton d’accès. ficelle
jeton Jeton d’accès utilisé pour accéder au fournisseur de contrôle de code source. chaîne (obligatoire)
type de jeton Type de jeton d’authentification. 'OAuth'
'PAT' (obligatoire)

BaseImageTrigger

Nom Descriptif Valeur
baseImageTriggerType Type du déclencheur automatique pour les mises à jour des dépendances d’image de base. 'Tous'
'Runtime' (obligatoire)
nom Nom du déclencheur. chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'
updateTriggerEndpoint URL du point de terminaison pour la réception des déclencheurs de mise à jour. ficelle
updateTriggerPayloadType Type de corps de charge utile pour les déclencheurs de mise à jour d’image de base. Valeur par défaut
« Jeton »

Informations d’identification

Nom Descriptif 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.		 Informations d’identificationCustomRegistries
sourceRegistre Décrit les paramètres d’informations d’identification pour accéder au Registre source. SourceRegistryCredentials

Informations d’identificationCustomRegistries

Nom Descriptif Valeur

CustomRegistryCredentials

Nom Descriptif 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 définie, la valeur 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.		 ficelle
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

DockerBuildStep

Nom Descriptif Valeur
Arguments Collection d’arguments de remplacement à utiliser lors de l’exécution de cette étape de génération. Argument[]
dockerFilePath Chemin d’accès du fichier Docker par rapport au contexte source. chaîne (obligatoire)
imageNames Noms complets d’images, y compris le référentiel et la balise. chaîne de caractères[]
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
cible Nom de l’étape de génération cible pour la build Docker. ficelle
type Type de l’étape. 'Docker' (obligatoire)

EncodedTaskStep

Nom Descriptif Valeur
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. ficelle
type Type de l’étape. 'EncodedTask' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. DéfinirValeur[]

FileTaskStep

Nom Descriptif Valeur
taskFilePath Chemin du fichier de modèle/définition de tâche par rapport au contexte source. chaîne (obligatoire)
type Type de l’étape. 'FileTask' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. DéfinirValeur[]
valeurFilePath Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte source. ficelle

IdentityProperties

Nom Descriptif Valeur
type Type d’identité. « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
Identités attribuées par l'utilisateur 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 Descriptif Valeur

PlatformProperties

Nom Descriptif 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'

ResourceTags

Nom Descriptif Valeur

SecretObject

Nom Descriptif 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 »
« Secret de l’arche »
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.		 ficelle

Valeur définie

Nom Descriptif Valeur
estSecret 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)

SourceProperties

Nom Descriptif Valeur
branche Nom de branche du code source. ficelle
repositoryUrl URL complète du référentiel de code source chaîne (obligatoire)
sourceControlAuthProperties Propriétés d’autorisation pour accéder au référentiel de code source et configurer
webhooks pour les notifications.		 AuthInfo
sourceControlType Type de service de contrôle de code source. 'Github'
'VisualStudioTeamService' (obligatoire)

SourceRegistryCredentials

Nom Descriptif Valeur
identité Identité Entra utilisée pour la connexion au Registre source.
La valeur concerne [system] l’identité managée affectée par le système, [caller] pour l’identité de l’appelant,
et l’ID client pour l’identité managée affectée par l’utilisateur.		 ficelle
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.		 Valeur par défaut
« Aucun »

SourceTrigger

Nom Descriptif Valeur
nom Nom du déclencheur. chaîne (obligatoire)
sourceRepository Propriétés qui décrivent la source (code) de la tâche. SourceProperties (obligatoire)
sourceTriggerEvents Événement source correspondant au déclencheur. Tableau de chaînes contenant l’un des éléments suivants :
« S’engager »
'pullrequest' (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TaskProperties

Nom Descriptif Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
agentPoolName Pool d’agents dédié pour la tâche. ficelle
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. Identifiants
isSystemTask La valeur de cette propriété indique si la ressource de tâche est une tâche système 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. ficelle
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties
statut État actuel de la tâche. 'Désactivé'
'Activé'
pas Propriétés d’une étape de tâche. TaskStepProperties
Délai d'attente Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
déclencheur Propriétés qui décrivent tous les déclencheurs de la tâche. TriggerProperties

TaskStepProperties

Nom Descriptif Valeur
contextAccessToken Jeton (jeton GIT PAT ou SAP de l’objet blob de compte de stockage) associé au contexte d’une étape. ficelle
contextPath URL(absolue ou relative) du contexte source de l’étape de tâche. ficelle
type Définissez sur « Docker » pour le type DockerBuildStep. Définissez sur « EncodedTask » pour le type EncodedTaskStep. Définissez sur « FileTask » pour type FileTaskStep. 'Docker'
'Tâche encodée'
'FileTask' (obligatoire)

TimerTrigger

Nom Descriptif Valeur
nom Nom du déclencheur. chaîne (obligatoire)
calendrier Expression CRON pour la planification des tâches chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TriggerProperties

Nom Descriptif Valeur
baseImageTrigger Déclencheur basé sur les dépendances d’image de base. BaseImageTrigger
sourceTriggers Collection de déclencheurs basés sur le référentiel de code source. SourceTrigger[]
minuterieDéclencheurs Collection de déclencheurs du minuteur. TimerTrigger[]

UserIdentityProperties

Nom Descriptif Valeur

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource registres/tâches 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/tasks, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/tasks@2025-03-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      agentConfiguration = {
        cpu = int
      }
      agentPoolName = "string"
      credentials = {
        customRegistries = {
          {customized property} = {
            identity = "string"
            password = {
              type = "string"
              value = "string"
            }
            userName = {
              type = "string"
              value = "string"
            }
          }
        }
        sourceRegistry = {
          identity = "string"
          loginMode = "string"
        }
      }
      isSystemTask = bool
      logTemplate = "string"
      platform = {
        architecture = "string"
        os = "string"
        variant = "string"
      }
      status = "string"
      step = {
        contextAccessToken = "string"
        contextPath = "string"
        type = "string"
        // For remaining properties, see TaskStepProperties objects
      }
      timeout = int
      trigger = {
        baseImageTrigger = {
          baseImageTriggerType = "string"
          name = "string"
          status = "string"
          updateTriggerEndpoint = "string"
          updateTriggerPayloadType = "string"
        }
        sourceTriggers = [
          {
            name = "string"
            sourceRepository = {
              branch = "string"
              repositoryUrl = "string"
              sourceControlAuthProperties = {
                expiresIn = int
                refreshToken = "string"
                scope = "string"
                token = "string"
                tokenType = "string"
              }
              sourceControlType = "string"
            }
            sourceTriggerEvents = [
              "string"
            ]
            status = "string"
          }
        ]
        timerTriggers = [
          {
            name = "string"
            schedule = "string"
            status = "string"
          }
        ]
      }
    }
  }
}

Objets TaskStepProperties

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

Pour Docker, utilisez :

{
  arguments = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
  dockerFilePath = "string"
  imageNames = [
    "string"
  ]
  isPushEnabled = bool
  noCache = bool
  target = "string"
  type = "Docker"
}

Pour EncodedTask, utilisez :

{
  encodedTaskContent = "string"
  encodedValuesContent = "string"
  type = "EncodedTask"
  values = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
}

Pour FileTask, utilisez :

{
  taskFilePath = "string"
  type = "FileTask"
  values = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
  valuesFilePath = "string"
}

Valeurs de propriété

Microsoft.ContainerRegistry/registrys/tasks

Nom Descriptif Valeur
identité Identité de la ressource. IdentityProperties
lieu Emplacement de la ressource. Cela ne peut pas être modifié une fois la ressource créée. chaîne (obligatoire)
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 5
Longueur maximale = 50
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 d’une tâche. TaskProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.ContainerRegistry/registrys/tasks@2025-03-01-preview »

AgentProperties

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

Raisonnement

Nom Descriptif Valeur
estSecret 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)

AuthInfo

Nom Descriptif Valeur
expiredIn Durée en secondes pendant laquelle le jeton reste valide Int
refreshToken Jeton d’actualisation utilisé pour actualiser le jeton d’accès. ficelle
portée Étendue du jeton d’accès. ficelle
jeton Jeton d’accès utilisé pour accéder au fournisseur de contrôle de code source. chaîne (obligatoire)
type de jeton Type de jeton d’authentification. 'OAuth'
'PAT' (obligatoire)

BaseImageTrigger

Nom Descriptif Valeur
baseImageTriggerType Type du déclencheur automatique pour les mises à jour des dépendances d’image de base. 'Tous'
'Runtime' (obligatoire)
nom Nom du déclencheur. chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'
updateTriggerEndpoint URL du point de terminaison pour la réception des déclencheurs de mise à jour. ficelle
updateTriggerPayloadType Type de corps de charge utile pour les déclencheurs de mise à jour d’image de base. Valeur par défaut
« Jeton »

Informations d’identification

Nom Descriptif 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.		 Informations d’identificationCustomRegistries
sourceRegistre Décrit les paramètres d’informations d’identification pour accéder au Registre source. SourceRegistryCredentials

Informations d’identificationCustomRegistries

Nom Descriptif Valeur

CustomRegistryCredentials

Nom Descriptif 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 définie, la valeur 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.		 ficelle
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

DockerBuildStep

Nom Descriptif Valeur
Arguments Collection d’arguments de remplacement à utiliser lors de l’exécution de cette étape de génération. Argument[]
dockerFilePath Chemin d’accès du fichier Docker par rapport au contexte source. chaîne (obligatoire)
imageNames Noms complets d’images, y compris le référentiel et la balise. chaîne de caractères[]
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
cible Nom de l’étape de génération cible pour la build Docker. ficelle
type Type de l’étape. 'Docker' (obligatoire)

EncodedTaskStep

Nom Descriptif Valeur
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. ficelle
type Type de l’étape. 'EncodedTask' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. DéfinirValeur[]

FileTaskStep

Nom Descriptif Valeur
taskFilePath Chemin du fichier de modèle/définition de tâche par rapport au contexte source. chaîne (obligatoire)
type Type de l’étape. 'FileTask' (obligatoire)
Valeurs Collection de valeurs substituables qui peuvent être passées lors de l’exécution d’une tâche. DéfinirValeur[]
valeurFilePath Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte source. ficelle

IdentityProperties

Nom Descriptif Valeur
type Type d’identité. « Aucun »
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
Identités attribuées par l'utilisateur 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 Descriptif Valeur

PlatformProperties

Nom Descriptif 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'

ResourceTags

Nom Descriptif Valeur

SecretObject

Nom Descriptif 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 »
« Secret de l’arche »
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.		 ficelle

Valeur définie

Nom Descriptif Valeur
estSecret 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)

SourceProperties

Nom Descriptif Valeur
branche Nom de branche du code source. ficelle
repositoryUrl URL complète du référentiel de code source chaîne (obligatoire)
sourceControlAuthProperties Propriétés d’autorisation pour accéder au référentiel de code source et configurer
webhooks pour les notifications.		 AuthInfo
sourceControlType Type de service de contrôle de code source. 'Github'
'VisualStudioTeamService' (obligatoire)

SourceRegistryCredentials

Nom Descriptif Valeur
identité Identité Entra utilisée pour la connexion au Registre source.
La valeur concerne [system] l’identité managée affectée par le système, [caller] pour l’identité de l’appelant,
et l’ID client pour l’identité managée affectée par l’utilisateur.		 ficelle
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.		 Valeur par défaut
« Aucun »

SourceTrigger

Nom Descriptif Valeur
nom Nom du déclencheur. chaîne (obligatoire)
sourceRepository Propriétés qui décrivent la source (code) de la tâche. SourceProperties (obligatoire)
sourceTriggerEvents Événement source correspondant au déclencheur. Tableau de chaînes contenant l’un des éléments suivants :
« S’engager »
'pullrequest' (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TaskProperties

Nom Descriptif Valeur
agentConfiguration Configuration de l’ordinateur de l’agent d’exécution. AgentProperties
agentPoolName Pool d’agents dédié pour la tâche. ficelle
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. Identifiants
isSystemTask La valeur de cette propriété indique si la ressource de tâche est une tâche système 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. ficelle
plateforme Propriétés de la plateforme sur lesquelles l’exécution doit se produire. PlatformProperties
statut État actuel de la tâche. 'Désactivé'
'Activé'
pas Propriétés d’une étape de tâche. TaskStepProperties
Délai d'attente Délai d’expiration de l’exécution en secondes. Int

Contraintes:
Valeur minimale = 300
Valeur maximale = 28800
déclencheur Propriétés qui décrivent tous les déclencheurs de la tâche. TriggerProperties

TaskStepProperties

Nom Descriptif Valeur
contextAccessToken Jeton (jeton GIT PAT ou SAP de l’objet blob de compte de stockage) associé au contexte d’une étape. ficelle
contextPath URL(absolue ou relative) du contexte source de l’étape de tâche. ficelle
type Définissez sur « Docker » pour le type DockerBuildStep. Définissez sur « EncodedTask » pour le type EncodedTaskStep. Définissez sur « FileTask » pour type FileTaskStep. 'Docker'
'Tâche encodée'
'FileTask' (obligatoire)

TimerTrigger

Nom Descriptif Valeur
nom Nom du déclencheur. chaîne (obligatoire)
calendrier Expression CRON pour la planification des tâches chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TriggerProperties

Nom Descriptif Valeur
baseImageTrigger Déclencheur basé sur les dépendances d’image de base. BaseImageTrigger
sourceTriggers Collection de déclencheurs basés sur le référentiel de code source. SourceTrigger[]
minuterieDéclencheurs Collection de déclencheurs du minuteur. TimerTrigger[]

UserIdentityProperties

Nom Descriptif Valeur