Condividi tramite


Registri Microsoft.ContainerRegistry/tasks 2019-06-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa registri/attività può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ContainerRegistry/registries/tasks, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentConfiguration: {
      cpu: int
    }
    agentPoolName: 'string'
    credentials: {
      customRegistries: {
        {customized property}: {
          identity: 'string'
          password: {
            type: 'string'
            value: 'string'
          }
          userName: {
            type: 'string'
            value: 'string'
          }
        }
      }
      sourceRegistry: {
        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'
  }
}

Oggetti TaskStepProperties

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Docker, usare:

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

Per EncodedTask, usare:

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

Per FileTask, usare:

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

Valori delle proprietà

AgentProperties

Nome Descrizione Valore
CPU La configurazione della CPU in termini di numero di core necessari per l'esecuzione. Int

Discussione

Nome Descrizione Valore
isSecret Flag per indicare se l'argomento rappresenta un segreto e vuole essere rimosso dai log di compilazione. Bool
nome Nome dell'argomento. stringa (obbligatorio)
valore Valore dell'argomento. stringa (obbligatorio)

AuthInfo

Nome Descrizione Valore
expiresIn Tempo in secondi in cui il token rimane valido Int
refreshToken Token di aggiornamento usato per aggiornare il token di accesso. corda
portata Ambito del token di accesso. corda
token Token di accesso usato per accedere al provider di controllo del codice sorgente. stringa (obbligatorio)
tokenType Tipo di token di autenticazione. 'OAuth'
'PAT' (obbligatorio)

BaseImageTrigger

Nome Descrizione Valore
baseImageTriggerType Tipo di trigger automatico per gli aggiornamenti delle dipendenze dell'immagine di base. 'All'
'Runtime' (obbligatorio)
nome Nome del trigger. stringa (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'
updateTriggerEndpoint URL dell'endpoint per la ricezione di trigger di aggiornamento. corda
updateTriggerPayloadType Tipo di corpo del payload per i trigger di aggiornamento dell'immagine di base. 'Default'
'Token'

Credenziali

Nome Descrizione Valore
customRegistries Descrive i parametri delle credenziali per l'accesso ad altri registri personalizzati. Chiave
per l'elemento del dizionario sarà il server di accesso del Registro di sistema (myregistry.azurecr.io) e
il valore dell'elemento sarà le credenziali del Registro di sistema per l'accesso al Registro di sistema.
CredentialsCustomRegistries
sourceRegistry Descrive i parametri delle credenziali per l'accesso al Registro di sistema di origine. SourceRegistryCredentials

CredentialsCustomRegistries

Nome Descrizione Valore

CustomRegistryCredentials

Nome Descrizione Valore
identità Indica l'identità gestita assegnata alle credenziali personalizzate. Se un'identità assegnata dall'utente
questo valore è l'ID client. Se un'identità assegnata dal sistema, il valore verrà system. In
il caso di un'identità assegnata dal sistema, l'ID client verrà determinato dallo strumento di esecuzione. Questo
l'identità può essere usata per eseguire l'autenticazione nell'insieme di credenziali delle chiavi per recuperare le credenziali o può essere l'unica
origine dell'autenticazione utilizzata per accedere al Registro di sistema.
corda
parola d’ordine Password per l'accesso al Registro di sistema personalizzato. La password è un segreto
oggetto che consente più modi di fornire il valore per esso.
SecretObject
nome utente Nome utente per l'accesso al Registro di sistema personalizzato. SecretObject

DockerBuildStep

Nome Descrizione Valore
Argomenti Raccolta di argomenti di override da usare durante l'esecuzione di questo passaggio di compilazione. argomento[]
dockerFilePath Percorso del file Docker relativo al contesto di origine. stringa (obbligatorio)
imageNames Nomi di immagine completi, inclusi il repository e il tag. string[]
isPushEnabled Il valore di questa proprietà indica se l'immagine compilata deve essere inserita nel Registro di sistema o meno. Bool
noCache Il valore di questa proprietà indica se la cache delle immagini è abilitata o meno. Bool
bersaglio Nome della fase di compilazione di destinazione per la compilazione docker. corda
digitare Tipo del passaggio. 'Docker' (obbligatorio)

EncodedTaskStep

Nome Descrizione Valore
encodedTaskContent Valore con codifica Base64 del contenuto del file di modello/definizione. stringa (obbligatorio)
encodedValuesContent Valore con codifica Base64 del contenuto del file parameters/values. corda
digitare Tipo del passaggio. 'EncodedTask' (obbligatorio)
valori Raccolta di valori sostituibili che possono essere passati durante l'esecuzione di un'attività. setvalue[]

FileTaskStep

Nome Descrizione Valore
taskFilePath Percorso del file modello/definizione dell'attività relativo al contesto di origine. stringa (obbligatorio)
digitare Tipo del passaggio. 'FileTask' (obbligatorio)
valori Raccolta di valori sostituibili che possono essere passati durante l'esecuzione di un'attività. setvalue[]
valuesFilePath Percorso del file valori/parametri dell'attività relativo al contesto di origine. corda

IdentityProperties

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare Tipo di identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità utente associate alla risorsa. Identità utente
I riferimenti alle chiavi del dizionario saranno GLI ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nome Descrizione Valore

Microsoft.ContainerRegistry/registries/tasks

Nome Descrizione Valore
identità Identità per la risorsa. IdentityProperties
ubicazione Posizione della risorsa. Questa operazione non può essere modificata dopo la creazione della risorsa. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 5
Lunghezza massima = 50
Pattern = ^[a-zA-Z0-9-_]*$ (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: registri
proprietà Proprietà di un'attività. Proprietà attività
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

PlatformProperties

Nome Descrizione Valore
architettura Architettura del sistema operativo. '386'
'amd64'
'arm'
'arm64'
'x86'
sistema operativo Tipo di sistema operativo necessario per l'esecuzione. 'Linux'
'Windows' (obbligatorio)
variante Variante della CPU. 'v6'
'v7'
'v8'

ResourceTags

Nome Descrizione Valore

SecretObject

Nome Descrizione Valore
digitare Tipo dell'oggetto segreto che determina come deve essere il valore dell'oggetto segreto
Interpretato.
'Opaco'
'Vaultsecret'
valore Valore del segreto. Il formato di questo valore verrà determinato
in base al tipo dell'oggetto segreto. Se il tipo è opaco, il valore sarà
utilizzato come è senza alcuna modifica.
corda

SetValue

Nome Descrizione Valore
isSecret Flag per indicare se il valore rappresenta o meno un segreto. Bool
nome Nome del valore di cui è possibile eseguire l'override. stringa (obbligatorio)
valore Valore sostituibile. stringa (obbligatorio)

SourceProperties

Nome Descrizione Valore
ramo Nome del ramo del codice sorgente. corda
repositoryUrl URL completo del repository del codice sorgente stringa (obbligatorio)
sourceControlAuthProperties Proprietà di autorizzazione per l'accesso al repository del codice sorgente e per la configurazione
webhook per le notifiche.
AuthInfo
sourceControlType Tipo di servizio di controllo del codice sorgente. 'Github'
'VisualStudioTeamService' (obbligatorio)

SourceRegistryCredentials

Nome Descrizione Valore
loginMode Modalità di autenticazione che determina l'ambito di accesso del Registro di sistema di origine. Credenziali per il Registro di sistema di origine
verrà generato usando l'ambito specificato. Queste credenziali verranno usate per accedere a
il Registro di sistema di origine durante l'esecuzione.
'Default'
'Nessuno'

SourceTrigger

Nome Descrizione Valore
nome Nome del trigger. stringa (obbligatorio)
sourceRepository Proprietà che descrivono il codice sorgente (codice) per l'attività. SourceProperties (obbligatorio)
sourceTriggerEvents Evento di origine corrispondente al trigger. Matrice di stringhe contenente uno dei seguenti elementi:
'commit'
'pullrequest' (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'

Proprietà attività

Nome Descrizione Valore
agentConfiguration Configurazione del computer dell'agente di esecuzione. AgentProperties
agentPoolName Pool di agenti dedicato per l'attività. corda
credenziali Proprietà che descrivono un set di credenziali che verranno usate quando viene richiamata questa esecuzione. credenziali
isSystemTask Il valore di questa proprietà indica se la risorsa attività è un'attività di sistema o meno. Bool
logTemplate Modello che descrive il repository e le informazioni sui tag per l'artefatto del log di esecuzione. corda
piattaforma Proprietà della piattaforma in cui deve verificarsi l'esecuzione. PlatformProperties
stato Stato corrente dell'attività. 'Disabilitato'
'Enabled'
passo Proprietà di un passaggio dell'attività. taskStepProperties di
Timeout Timeout di esecuzione in secondi. Int

Vincoli:
Valore minimo = 300
Valore massimo = 28800
Grilletto Proprietà che descrivono tutti i trigger per l'attività. TriggerProperties

TaskStepProperties

Nome Descrizione Valore
contextAccessToken Token (token GIT PAT o token di firma di accesso condiviso del BLOB dell'account di archiviazione) associato al contesto per un passaggio. corda
contextPath URL(assoluto o relativo) del contesto di origine per il passaggio dell'attività. corda
digitare Impostare su "Docker" per il tipo DockerBuildStep. Impostare su "EncodedTask" per il tipo EncodedTaskStep. Impostare su 'FileTask' per il tipo FileTaskStep. 'Docker'
'EncodedTask'
'FileTask' (obbligatorio)

TimerTrigger

Nome Descrizione Valore
nome Nome del trigger. stringa (obbligatorio)
Programma Espressione CRON per la pianificazione delle attività stringa (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'

TriggerProperties

Nome Descrizione Valore
baseImageTrigger Trigger basato sulle dipendenze dell'immagine di base. baseImageTrigger
sourceTriggers Raccolta di trigger basati sul repository del codice sorgente. SourceTrigger[]
timerTriggers Raccolta di trigger timer. timerTrigger[]

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. corda
principalId ID principale dell'identità assegnata dall'utente. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa registri/attività può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ContainerRegistry/registries/tasks, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.ContainerRegistry/registries/tasks",
  "apiVersion": "2019-06-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "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": {
        "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"
  }
}

Oggetti TaskStepProperties

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Docker, usare:

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

Per EncodedTask, usare:

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

Per FileTask, usare:

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

Valori delle proprietà

AgentProperties

Nome Descrizione Valore
CPU La configurazione della CPU in termini di numero di core necessari per l'esecuzione. Int

Discussione

Nome Descrizione Valore
isSecret Flag per indicare se l'argomento rappresenta un segreto e vuole essere rimosso dai log di compilazione. Bool
nome Nome dell'argomento. stringa (obbligatorio)
valore Valore dell'argomento. stringa (obbligatorio)

AuthInfo

Nome Descrizione Valore
expiresIn Tempo in secondi in cui il token rimane valido Int
refreshToken Token di aggiornamento usato per aggiornare il token di accesso. corda
portata Ambito del token di accesso. corda
token Token di accesso usato per accedere al provider di controllo del codice sorgente. stringa (obbligatorio)
tokenType Tipo di token di autenticazione. 'OAuth'
'PAT' (obbligatorio)

BaseImageTrigger

Nome Descrizione Valore
baseImageTriggerType Tipo di trigger automatico per gli aggiornamenti delle dipendenze dell'immagine di base. 'All'
'Runtime' (obbligatorio)
nome Nome del trigger. stringa (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'
updateTriggerEndpoint URL dell'endpoint per la ricezione di trigger di aggiornamento. corda
updateTriggerPayloadType Tipo di corpo del payload per i trigger di aggiornamento dell'immagine di base. 'Default'
'Token'

Credenziali

Nome Descrizione Valore
customRegistries Descrive i parametri delle credenziali per l'accesso ad altri registri personalizzati. Chiave
per l'elemento del dizionario sarà il server di accesso del Registro di sistema (myregistry.azurecr.io) e
il valore dell'elemento sarà le credenziali del Registro di sistema per l'accesso al Registro di sistema.
CredentialsCustomRegistries
sourceRegistry Descrive i parametri delle credenziali per l'accesso al Registro di sistema di origine. SourceRegistryCredentials

CredentialsCustomRegistries

Nome Descrizione Valore

CustomRegistryCredentials

Nome Descrizione Valore
identità Indica l'identità gestita assegnata alle credenziali personalizzate. Se un'identità assegnata dall'utente
questo valore è l'ID client. Se un'identità assegnata dal sistema, il valore verrà system. In
il caso di un'identità assegnata dal sistema, l'ID client verrà determinato dallo strumento di esecuzione. Questo
l'identità può essere usata per eseguire l'autenticazione nell'insieme di credenziali delle chiavi per recuperare le credenziali o può essere l'unica
origine dell'autenticazione utilizzata per accedere al Registro di sistema.
corda
parola d’ordine Password per l'accesso al Registro di sistema personalizzato. La password è un segreto
oggetto che consente più modi di fornire il valore per esso.
SecretObject
nome utente Nome utente per l'accesso al Registro di sistema personalizzato. SecretObject

DockerBuildStep

Nome Descrizione Valore
Argomenti Raccolta di argomenti di override da usare durante l'esecuzione di questo passaggio di compilazione. argomento[]
dockerFilePath Percorso del file Docker relativo al contesto di origine. stringa (obbligatorio)
imageNames Nomi di immagine completi, inclusi il repository e il tag. string[]
isPushEnabled Il valore di questa proprietà indica se l'immagine compilata deve essere inserita nel Registro di sistema o meno. Bool
noCache Il valore di questa proprietà indica se la cache delle immagini è abilitata o meno. Bool
bersaglio Nome della fase di compilazione di destinazione per la compilazione docker. corda
digitare Tipo del passaggio. 'Docker' (obbligatorio)

EncodedTaskStep

Nome Descrizione Valore
encodedTaskContent Valore con codifica Base64 del contenuto del file di modello/definizione. stringa (obbligatorio)
encodedValuesContent Valore con codifica Base64 del contenuto del file parameters/values. corda
digitare Tipo del passaggio. 'EncodedTask' (obbligatorio)
valori Raccolta di valori sostituibili che possono essere passati durante l'esecuzione di un'attività. setvalue[]

FileTaskStep

Nome Descrizione Valore
taskFilePath Percorso del file modello/definizione dell'attività relativo al contesto di origine. stringa (obbligatorio)
digitare Tipo del passaggio. 'FileTask' (obbligatorio)
valori Raccolta di valori sostituibili che possono essere passati durante l'esecuzione di un'attività. setvalue[]
valuesFilePath Percorso del file valori/parametri dell'attività relativo al contesto di origine. corda

IdentityProperties

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare Tipo di identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità utente associate alla risorsa. Identità utente
I riferimenti alle chiavi del dizionario saranno GLI ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nome Descrizione Valore

Microsoft.ContainerRegistry/registries/tasks

Nome Descrizione Valore
apiVersion Versione dell'API '2019-06-01-preview'
identità Identità per la risorsa. IdentityProperties
ubicazione Posizione della risorsa. Questa operazione non può essere modificata dopo la creazione della risorsa. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 5
Lunghezza massima = 50
Pattern = ^[a-zA-Z0-9-_]*$ (obbligatorio)
proprietà Proprietà di un'attività. Proprietà attività
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.ContainerRegistry/registries/tasks'

PlatformProperties

Nome Descrizione Valore
architettura Architettura del sistema operativo. '386'
'amd64'
'arm'
'arm64'
'x86'
sistema operativo Tipo di sistema operativo necessario per l'esecuzione. 'Linux'
'Windows' (obbligatorio)
variante Variante della CPU. 'v6'
'v7'
'v8'

ResourceTags

Nome Descrizione Valore

SecretObject

Nome Descrizione Valore
digitare Tipo dell'oggetto segreto che determina come deve essere il valore dell'oggetto segreto
Interpretato.
'Opaco'
'Vaultsecret'
valore Valore del segreto. Il formato di questo valore verrà determinato
in base al tipo dell'oggetto segreto. Se il tipo è opaco, il valore sarà
utilizzato come è senza alcuna modifica.
corda

SetValue

Nome Descrizione Valore
isSecret Flag per indicare se il valore rappresenta o meno un segreto. Bool
nome Nome del valore di cui è possibile eseguire l'override. stringa (obbligatorio)
valore Valore sostituibile. stringa (obbligatorio)

SourceProperties

Nome Descrizione Valore
ramo Nome del ramo del codice sorgente. corda
repositoryUrl URL completo del repository del codice sorgente stringa (obbligatorio)
sourceControlAuthProperties Proprietà di autorizzazione per l'accesso al repository del codice sorgente e per la configurazione
webhook per le notifiche.
AuthInfo
sourceControlType Tipo di servizio di controllo del codice sorgente. 'Github'
'VisualStudioTeamService' (obbligatorio)

SourceRegistryCredentials

Nome Descrizione Valore
loginMode Modalità di autenticazione che determina l'ambito di accesso del Registro di sistema di origine. Credenziali per il Registro di sistema di origine
verrà generato usando l'ambito specificato. Queste credenziali verranno usate per accedere a
il Registro di sistema di origine durante l'esecuzione.
'Default'
'Nessuno'

SourceTrigger

Nome Descrizione Valore
nome Nome del trigger. stringa (obbligatorio)
sourceRepository Proprietà che descrivono il codice sorgente (codice) per l'attività. SourceProperties (obbligatorio)
sourceTriggerEvents Evento di origine corrispondente al trigger. Matrice di stringhe contenente uno dei seguenti elementi:
'commit'
'pullrequest' (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'

Proprietà attività

Nome Descrizione Valore
agentConfiguration Configurazione del computer dell'agente di esecuzione. AgentProperties
agentPoolName Pool di agenti dedicato per l'attività. corda
credenziali Proprietà che descrivono un set di credenziali che verranno usate quando viene richiamata questa esecuzione. credenziali
isSystemTask Il valore di questa proprietà indica se la risorsa attività è un'attività di sistema o meno. Bool
logTemplate Modello che descrive il repository e le informazioni sui tag per l'artefatto del log di esecuzione. corda
piattaforma Proprietà della piattaforma in cui deve verificarsi l'esecuzione. PlatformProperties
stato Stato corrente dell'attività. 'Disabilitato'
'Enabled'
passo Proprietà di un passaggio dell'attività. taskStepProperties di
Timeout Timeout di esecuzione in secondi. Int

Vincoli:
Valore minimo = 300
Valore massimo = 28800
Grilletto Proprietà che descrivono tutti i trigger per l'attività. TriggerProperties

TaskStepProperties

Nome Descrizione Valore
contextAccessToken Token (token GIT PAT o token di firma di accesso condiviso del BLOB dell'account di archiviazione) associato al contesto per un passaggio. corda
contextPath URL(assoluto o relativo) del contesto di origine per il passaggio dell'attività. corda
digitare Impostare su "Docker" per il tipo DockerBuildStep. Impostare su "EncodedTask" per il tipo EncodedTaskStep. Impostare su 'FileTask' per il tipo FileTaskStep. 'Docker'
'EncodedTask'
'FileTask' (obbligatorio)

TimerTrigger

Nome Descrizione Valore
nome Nome del trigger. stringa (obbligatorio)
Programma Espressione CRON per la pianificazione delle attività stringa (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'

TriggerProperties

Nome Descrizione Valore
baseImageTrigger Trigger basato sulle dipendenze dell'immagine di base. baseImageTrigger
sourceTriggers Raccolta di trigger basati sul repository del codice sorgente. SourceTrigger[]
timerTriggers Raccolta di trigger timer. timerTrigger[]

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. corda
principalId ID principale dell'identità assegnata dall'utente. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa registri/attività può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ContainerRegistry/registries/tasks, aggiungere il file Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview"
  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
      }
      agentPoolName = "string"
      credentials = {
        customRegistries = {
          {customized property} = {
            identity = "string"
            password = {
              type = "string"
              value = "string"
            }
            userName = {
              type = "string"
              value = "string"
            }
          }
        }
        sourceRegistry = {
          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"
          }
        ]
      }
    }
  })
}

Oggetti TaskStepProperties

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Docker, usare:

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

Per EncodedTask, usare:

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

Per FileTask, usare:

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

Valori delle proprietà

AgentProperties

Nome Descrizione Valore
CPU La configurazione della CPU in termini di numero di core necessari per l'esecuzione. Int

Discussione

Nome Descrizione Valore
isSecret Flag per indicare se l'argomento rappresenta un segreto e vuole essere rimosso dai log di compilazione. Bool
nome Nome dell'argomento. stringa (obbligatorio)
valore Valore dell'argomento. stringa (obbligatorio)

AuthInfo

Nome Descrizione Valore
expiresIn Tempo in secondi in cui il token rimane valido Int
refreshToken Token di aggiornamento usato per aggiornare il token di accesso. corda
portata Ambito del token di accesso. corda
token Token di accesso usato per accedere al provider di controllo del codice sorgente. stringa (obbligatorio)
tokenType Tipo di token di autenticazione. 'OAuth'
'PAT' (obbligatorio)

BaseImageTrigger

Nome Descrizione Valore
baseImageTriggerType Tipo di trigger automatico per gli aggiornamenti delle dipendenze dell'immagine di base. 'All'
'Runtime' (obbligatorio)
nome Nome del trigger. stringa (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'
updateTriggerEndpoint URL dell'endpoint per la ricezione di trigger di aggiornamento. corda
updateTriggerPayloadType Tipo di corpo del payload per i trigger di aggiornamento dell'immagine di base. 'Default'
'Token'

Credenziali

Nome Descrizione Valore
customRegistries Descrive i parametri delle credenziali per l'accesso ad altri registri personalizzati. Chiave
per l'elemento del dizionario sarà il server di accesso del Registro di sistema (myregistry.azurecr.io) e
il valore dell'elemento sarà le credenziali del Registro di sistema per l'accesso al Registro di sistema.
CredentialsCustomRegistries
sourceRegistry Descrive i parametri delle credenziali per l'accesso al Registro di sistema di origine. SourceRegistryCredentials

CredentialsCustomRegistries

Nome Descrizione Valore

CustomRegistryCredentials

Nome Descrizione Valore
identità Indica l'identità gestita assegnata alle credenziali personalizzate. Se un'identità assegnata dall'utente
questo valore è l'ID client. Se un'identità assegnata dal sistema, il valore verrà system. In
il caso di un'identità assegnata dal sistema, l'ID client verrà determinato dallo strumento di esecuzione. Questo
l'identità può essere usata per eseguire l'autenticazione nell'insieme di credenziali delle chiavi per recuperare le credenziali o può essere l'unica
origine dell'autenticazione utilizzata per accedere al Registro di sistema.
corda
parola d’ordine Password per l'accesso al Registro di sistema personalizzato. La password è un segreto
oggetto che consente più modi di fornire il valore per esso.
SecretObject
nome utente Nome utente per l'accesso al Registro di sistema personalizzato. SecretObject

DockerBuildStep

Nome Descrizione Valore
Argomenti Raccolta di argomenti di override da usare durante l'esecuzione di questo passaggio di compilazione. argomento[]
dockerFilePath Percorso del file Docker relativo al contesto di origine. stringa (obbligatorio)
imageNames Nomi di immagine completi, inclusi il repository e il tag. string[]
isPushEnabled Il valore di questa proprietà indica se l'immagine compilata deve essere inserita nel Registro di sistema o meno. Bool
noCache Il valore di questa proprietà indica se la cache delle immagini è abilitata o meno. Bool
bersaglio Nome della fase di compilazione di destinazione per la compilazione docker. corda
digitare Tipo del passaggio. 'Docker' (obbligatorio)

EncodedTaskStep

Nome Descrizione Valore
encodedTaskContent Valore con codifica Base64 del contenuto del file di modello/definizione. stringa (obbligatorio)
encodedValuesContent Valore con codifica Base64 del contenuto del file parameters/values. corda
digitare Tipo del passaggio. 'EncodedTask' (obbligatorio)
valori Raccolta di valori sostituibili che possono essere passati durante l'esecuzione di un'attività. setvalue[]

FileTaskStep

Nome Descrizione Valore
taskFilePath Percorso del file modello/definizione dell'attività relativo al contesto di origine. stringa (obbligatorio)
digitare Tipo del passaggio. 'FileTask' (obbligatorio)
valori Raccolta di valori sostituibili che possono essere passati durante l'esecuzione di un'attività. setvalue[]
valuesFilePath Percorso del file valori/parametri dell'attività relativo al contesto di origine. corda

IdentityProperties

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare Tipo di identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità utente associate alla risorsa. Identità utente
I riferimenti alle chiavi del dizionario saranno GLI ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nome Descrizione Valore

Microsoft.ContainerRegistry/registries/tasks

Nome Descrizione Valore
identità Identità per la risorsa. IdentityProperties
ubicazione Posizione della risorsa. Questa operazione non può essere modificata dopo la creazione della risorsa. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 5
Lunghezza massima = 50
Pattern = ^[a-zA-Z0-9-_]*$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: registri
proprietà Proprietà di un'attività. Proprietà attività
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview"

PlatformProperties

Nome Descrizione Valore
architettura Architettura del sistema operativo. '386'
'amd64'
'arm'
'arm64'
'x86'
sistema operativo Tipo di sistema operativo necessario per l'esecuzione. 'Linux'
'Windows' (obbligatorio)
variante Variante della CPU. 'v6'
'v7'
'v8'

ResourceTags

Nome Descrizione Valore

SecretObject

Nome Descrizione Valore
digitare Tipo dell'oggetto segreto che determina come deve essere il valore dell'oggetto segreto
Interpretato.
'Opaco'
'Vaultsecret'
valore Valore del segreto. Il formato di questo valore verrà determinato
in base al tipo dell'oggetto segreto. Se il tipo è opaco, il valore sarà
utilizzato come è senza alcuna modifica.
corda

SetValue

Nome Descrizione Valore
isSecret Flag per indicare se il valore rappresenta o meno un segreto. Bool
nome Nome del valore di cui è possibile eseguire l'override. stringa (obbligatorio)
valore Valore sostituibile. stringa (obbligatorio)

SourceProperties

Nome Descrizione Valore
ramo Nome del ramo del codice sorgente. corda
repositoryUrl URL completo del repository del codice sorgente stringa (obbligatorio)
sourceControlAuthProperties Proprietà di autorizzazione per l'accesso al repository del codice sorgente e per la configurazione
webhook per le notifiche.
AuthInfo
sourceControlType Tipo di servizio di controllo del codice sorgente. 'Github'
'VisualStudioTeamService' (obbligatorio)

SourceRegistryCredentials

Nome Descrizione Valore
loginMode Modalità di autenticazione che determina l'ambito di accesso del Registro di sistema di origine. Credenziali per il Registro di sistema di origine
verrà generato usando l'ambito specificato. Queste credenziali verranno usate per accedere a
il Registro di sistema di origine durante l'esecuzione.
'Default'
'Nessuno'

SourceTrigger

Nome Descrizione Valore
nome Nome del trigger. stringa (obbligatorio)
sourceRepository Proprietà che descrivono il codice sorgente (codice) per l'attività. SourceProperties (obbligatorio)
sourceTriggerEvents Evento di origine corrispondente al trigger. Matrice di stringhe contenente uno dei seguenti elementi:
'commit'
'pullrequest' (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'

Proprietà attività

Nome Descrizione Valore
agentConfiguration Configurazione del computer dell'agente di esecuzione. AgentProperties
agentPoolName Pool di agenti dedicato per l'attività. corda
credenziali Proprietà che descrivono un set di credenziali che verranno usate quando viene richiamata questa esecuzione. credenziali
isSystemTask Il valore di questa proprietà indica se la risorsa attività è un'attività di sistema o meno. Bool
logTemplate Modello che descrive il repository e le informazioni sui tag per l'artefatto del log di esecuzione. corda
piattaforma Proprietà della piattaforma in cui deve verificarsi l'esecuzione. PlatformProperties
stato Stato corrente dell'attività. 'Disabilitato'
'Enabled'
passo Proprietà di un passaggio dell'attività. taskStepProperties di
Timeout Timeout di esecuzione in secondi. Int

Vincoli:
Valore minimo = 300
Valore massimo = 28800
Grilletto Proprietà che descrivono tutti i trigger per l'attività. TriggerProperties

TaskStepProperties

Nome Descrizione Valore
contextAccessToken Token (token GIT PAT o token di firma di accesso condiviso del BLOB dell'account di archiviazione) associato al contesto per un passaggio. corda
contextPath URL(assoluto o relativo) del contesto di origine per il passaggio dell'attività. corda
digitare Impostare su "Docker" per il tipo DockerBuildStep. Impostare su "EncodedTask" per il tipo EncodedTaskStep. Impostare su 'FileTask' per il tipo FileTaskStep. 'Docker'
'EncodedTask'
'FileTask' (obbligatorio)

TimerTrigger

Nome Descrizione Valore
nome Nome del trigger. stringa (obbligatorio)
Programma Espressione CRON per la pianificazione delle attività stringa (obbligatorio)
stato Stato corrente del trigger. 'Disabilitato'
'Enabled'

TriggerProperties

Nome Descrizione Valore
baseImageTrigger Trigger basato sulle dipendenze dell'immagine di base. baseImageTrigger
sourceTriggers Raccolta di trigger basati sul repository del codice sorgente. SourceTrigger[]
timerTriggers Raccolta di trigger timer. timerTrigger[]

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. corda
principalId ID principale dell'identità assegnata dall'utente. corda