Partager via


Registres/tâches Microsoft.ContainerRegistry 2019-04-01

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@2019-04-01' = {
  parent: resourceSymbolicName
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    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'
    }
    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'
      }
      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é

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)

AuthInfo

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

BaseImageTrigger

Nom Description Valeur
baseImageTriggerType Type du déclencheur automatique pour les mises à jour des dépendances d’image de base. 'All'
'Runtime' (obligatoire)
nom Nom du déclencheur. chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

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

DockerBuildStep

Nom Description 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. 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
cible Nom de l’étape de génération cible pour la build Docker. corde
type Type de l’étape. 'Docker' (obligatoire)

EncodedTaskStep

Nom Description 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. corde
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. SetValue[]

FileTaskStep

Nom Description 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. SetValue[]
valuesFilePath Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte 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/tasks

Nom Description Valeur
identité Identité de la ressource. IdentityProperties
emplacement Emplacement de la ressource. Cela ne peut pas être modifié une fois la ressource créée. chaîne (obligatoire)
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 d’une tâche. TaskProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

PlatformProperties

Nom Description Valeur
architecture Architecture du système d’exploitation. 'amd64'
'bras'
'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 Description Valeur

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)

SourceProperties

Nom Description Valeur
branche Nom de branche du code source. corde
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 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'

SourceTrigger

Nom Description 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 :
'commit'
'pullrequest' (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TaskProperties

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)
statut État actuel de la tâche. 'Désactivé'
'Activé'
pas Propriétés d’une étape de tâche. TaskStepProperties (obligatoire)
Timeout Délai d’expiration de l’exécution en secondes. Int

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

TaskStepProperties

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

TimerTrigger

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

TriggerProperties

Nom Description 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[]
timerTriggers Collection de déclencheurs du minuteur. TimerTrigger[]

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/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": "2019-04-01",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "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"
    },
    "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"
      },
      "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é

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)

AuthInfo

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

BaseImageTrigger

Nom Description Valeur
baseImageTriggerType Type du déclencheur automatique pour les mises à jour des dépendances d’image de base. 'All'
'Runtime' (obligatoire)
nom Nom du déclencheur. chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

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

DockerBuildStep

Nom Description 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. 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
cible Nom de l’étape de génération cible pour la build Docker. corde
type Type de l’étape. 'Docker' (obligatoire)

EncodedTaskStep

Nom Description 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. corde
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. SetValue[]

FileTaskStep

Nom Description 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. SetValue[]
valuesFilePath Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte 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/tasks

Nom Description Valeur
apiVersion Version de l’API '2019-04-01'
identité Identité de la ressource. IdentityProperties
emplacement Emplacement de la ressource. Cela ne peut pas être modifié une fois la ressource créée. chaîne (obligatoire)
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 d’une tâche. TaskProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.ContainerRegistry/registrys/tasks'

PlatformProperties

Nom Description Valeur
architecture Architecture du système d’exploitation. 'amd64'
'bras'
'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 Description Valeur

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)

SourceProperties

Nom Description Valeur
branche Nom de branche du code source. corde
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 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'

SourceTrigger

Nom Description 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 :
'commit'
'pullrequest' (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TaskProperties

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)
statut État actuel de la tâche. 'Désactivé'
'Activé'
pas Propriétés d’une étape de tâche. TaskStepProperties (obligatoire)
Timeout Délai d’expiration de l’exécution en secondes. Int

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

TaskStepProperties

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

TimerTrigger

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

TriggerProperties

Nom Description 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[]
timerTriggers Collection de déclencheurs du minuteur. TimerTrigger[]

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/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@2019-04-01"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      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"
      }
      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"
        }
        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é

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)

AuthInfo

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

BaseImageTrigger

Nom Description Valeur
baseImageTriggerType Type du déclencheur automatique pour les mises à jour des dépendances d’image de base. 'All'
'Runtime' (obligatoire)
nom Nom du déclencheur. chaîne (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

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

DockerBuildStep

Nom Description 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. 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
cible Nom de l’étape de génération cible pour la build Docker. corde
type Type de l’étape. 'Docker' (obligatoire)

EncodedTaskStep

Nom Description 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. corde
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. SetValue[]

FileTaskStep

Nom Description 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. SetValue[]
valuesFilePath Chemin d’accès du fichier de valeurs/paramètres de tâche par rapport au contexte 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/tasks

Nom Description Valeur
identité Identité de la ressource. IdentityProperties
emplacement Emplacement de la ressource. Cela ne peut pas être modifié une fois la ressource créée. chaîne (obligatoire)
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 d’une tâche. TaskProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.ContainerRegistry/registrys/tasks@2019-04-01 »

PlatformProperties

Nom Description Valeur
architecture Architecture du système d’exploitation. 'amd64'
'bras'
'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 Description Valeur

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)

SourceProperties

Nom Description Valeur
branche Nom de branche du code source. corde
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 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'

SourceTrigger

Nom Description 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 :
'commit'
'pullrequest' (obligatoire)
statut État actuel du déclencheur. 'Désactivé'
'Activé'

TaskProperties

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)
statut État actuel de la tâche. 'Désactivé'
'Activé'
pas Propriétés d’une étape de tâche. TaskStepProperties (obligatoire)
Timeout Délai d’expiration de l’exécution en secondes. Int

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

TaskStepProperties

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

TimerTrigger

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

TriggerProperties

Nom Description 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[]
timerTriggers Collection de déclencheurs du minuteur. TimerTrigger[]

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