Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Définition de ressource Bicep
Le type de ressource registres/tâches peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Exemples d’utilisation
Exemples Bicep
Exemple de base de déploiement de la tâche Container Registry.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource registry 'Microsoft.ContainerRegistry/registries@2021-08-01-preview' = {
name: resourceName
location: location
sku: {
name: 'Basic'
tier: 'Basic'
}
properties: {
adminUserEnabled: false
anonymousPullEnabled: false
dataEndpointEnabled: false
encryption: {
status: 'disabled'
}
networkRuleBypassOptions: 'AzureServices'
policies: {
exportPolicy: {
status: 'enabled'
}
quarantinePolicy: {
status: 'disabled'
}
retentionPolicy: {
status: 'disabled'
}
trustPolicy: {
status: 'disabled'
}
}
publicNetworkAccess: 'Enabled'
zoneRedundancy: 'Disabled'
}
}
resource task 'Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview' = {
name: resourceName
location: location
parent: registry
properties: {
isSystemTask: true
status: 'Enabled'
timeout: 3600
}
}
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| Azure Container Registry (ACR) - Task | AVM Child Module for Azure Container Registry (ACR) - Task |
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@2018-09-01' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
agentConfiguration: {
cpu: int
}
credentials: {
customRegistries: {
{customized property}: {
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'
}
]
}
}
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 |
|---|---|---|
| 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 pour une 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é' |
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 |
|---|---|---|
| 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 |
PlatformProperties
| Nom | Descriptif | 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 | 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 » |
| 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 |
|---|---|---|
| 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 |
| 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 |
| 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) |
| 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) |
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[] |
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 :
- Groupes de ressources - Voir commandes de déploiement des groupes de ressources Pour une liste des propriétés modifiées dans chaque version d’API, voir journal des changements.
Exemples d’utilisation
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": "2018-09-01",
"name": "string",
"location": "string",
"properties": {
"agentConfiguration": {
"cpu": "int"
},
"credentials": {
"customRegistries": {
"{customized property}": {
"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"
}
]
}
},
"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 | '2018-09-01' |
| 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é' |
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 |
|---|---|---|
| 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 |
PlatformProperties
| Nom | Descriptif | 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 | 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 » |
| 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 |
|---|---|---|
| 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 |
| 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 |
| 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) |
| 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) |
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[] |
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 une liste des propriétés modifiées dans chaque version d’API, voir journal des modifications.
Exemples d’utilisation
Échantillons Terraform
Exemple de base de déploiement de la tâche Container Registry.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "registry" {
type = "Microsoft.ContainerRegistry/registries@2021-08-01-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
adminUserEnabled = false
anonymousPullEnabled = false
dataEndpointEnabled = false
encryption = {
status = "disabled"
}
networkRuleBypassOptions = "AzureServices"
policies = {
exportPolicy = {
status = "enabled"
}
quarantinePolicy = {
status = "disabled"
}
retentionPolicy = {
status = "disabled"
}
trustPolicy = {
status = "disabled"
}
}
publicNetworkAccess = "Enabled"
zoneRedundancy = "Disabled"
}
sku = {
name = "Basic"
tier = "Basic"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "task" {
type = "Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview"
parent_id = azapi_resource.registry.id
name = var.resource_name
location = var.location
body = {
properties = {
isSystemTask = true
status = "Enabled"
step = null
timeout = 3600
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
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@2018-09-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
agentConfiguration = {
cpu = int
}
credentials = {
customRegistries = {
{customized property} = {
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"
}
]
}
}
}
}
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 |
|---|---|---|
| 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 pour 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@2018-09-01 » |
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é' |
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 |
|---|---|---|
| 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 |
PlatformProperties
| Nom | Descriptif | 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 | 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 » |
| 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 |
|---|---|---|
| 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 |
| 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 |
| 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) |
| 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) |
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[] |