Freigeben über


Microsoft.ContainerRegistry-Registrierungen/Aufgaben

Bicep-Ressourcendefinition

Der Ressourcentyp "Registrierungen/Vorgänge" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ContainerRegistry/registries/tasks-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

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

TaskStepProperties-Objekte

Legen Sie den Typ Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für Docker Folgendes:

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

Verwenden Sie für EncodedTask Folgendes:

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

Verwenden Sie für FileTask Folgendes:

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

Eigenschaftswerte

Microsoft.ContainerRegistry/Registrierungen/Aufgaben

Name BESCHREIBUNG Wert
Identität Identität für die Ressource. IdentityProperties-
Standort Der Standort der Ressource. Dies kann nicht geändert werden, nachdem die Ressource erstellt wurde. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge

Zwänge:
Min. Länge = 5
Max. Länge = 50
Pattern = ^[a-zA-Z0-9-_]*$ (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: Register
Eigenschaften Die Eigenschaften eines Vorgangs. TaskProperties-
Schlagwörter Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

Agent-Eigenschaften

Name BESCHREIBUNG Wert
CPU Die CPU-Konfiguration in Bezug auf die Anzahl der für die Ausführung erforderlichen Kerne. INT

Streitpunkt

Name BESCHREIBUNG Wert
isSecret Kennzeichnen, um anzugeben, ob das Argument einen geheimen Schlüssel darstellt und aus Buildprotokollen entfernt werden soll. Boolesch
Name Der Name des Arguments. Zeichenfolge (erforderlich)
Wert Der Wert des Arguments. Zeichenfolge (erforderlich)

AuthInfo

Name BESCHREIBUNG Wert
läuft ab Zeit in Sekunden, die das Token gültig bleibt INT
refreshToken Das Aktualisierungstoken, das zum Aktualisieren des Zugriffstokens verwendet wird. Schnur
Umfang Der Bereich des Zugriffstokens. Schnur
Token Das Zugriffstoken, das für den Zugriff auf den Quellcodeverwaltungsanbieter verwendet wird. Zeichenfolge (erforderlich)
tokenType Der Typ des Authentifizierungstokens. "OAuth"
'PAT' (erforderlich)

BaseImageTrigger

Name BESCHREIBUNG Wert
baseImageTriggerType Der Typ des automatischen Triggers für Basisimageabhängigkeitsupdates. "Alle"
"Runtime" (erforderlich)
Name Der Name des Triggers. Zeichenfolge (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"
updateTriggerEndpoint Die Endpunkt-URL für den Empfang von Updatetriggern. Schnur
updateTriggerPayloadType Typ des Nutzlasttexts für Basisbildaktualisierungstrigger. 'Standard'
"Token"

Anmeldeinformationen

Name BESCHREIBUNG Wert
benutzerdefinierte Registries Beschreibt die Anmeldeinformationsparameter für den Zugriff auf andere benutzerdefinierte Registrierungen. Der Schlüssel
für das Wörterbuchelement ist der Registrierungsanmeldungsserver (myregistry.azurecr.io) und
Der Wert des Elements ist die Registrierungsanmeldeinformationen für den Zugriff auf die Registrierung.
AnmeldeinformationenBenutzerdefinierte Registrierungen
sourceRegistry Beschreibt die Anmeldeinformationsparameter für den Zugriff auf die Quellregistrierung. SourceRegistryCredentials

AnmeldeinformationenBenutzerdefinierte Registrierungen

Name BESCHREIBUNG Wert

CustomRegistryCredentials

Name BESCHREIBUNG Wert
Identität Gibt die verwaltete Identität an, die den benutzerdefinierten Anmeldeinformationen zugewiesen ist. Wenn eine vom Benutzer zugewiesene Identität
dieser Wert ist die Client-ID. Wenn eine vom System zugewiesene Identität vorhanden ist, lautet systemder Wert . In
bei einer vom System zugewiesenen Identität wird die Client-ID vom Läufer bestimmt. Das
Die Identität kann verwendet werden, um sich beim Key Vault zu authentifizieren, um Anmeldeinformationen abzurufen, oder dies ist die einzige
Quelle der Authentifizierung, die für den Zugriff auf die Registrierung verwendet wird.
Schnur
Kennwort Das Kennwort für die Anmeldung bei der benutzerdefinierten Registrierung. Das Kennwort ist ein Geheimschlüssel.
-Objekt, das mehrere Möglichkeiten zum Bereitstellen des Werts zulässt.
Secret-Objekt
Nutzername Der Benutzername für die Anmeldung bei der benutzerdefinierten Registrierung. Secret-Objekt

DockerBuildStep (Englisch)

Name BESCHREIBUNG Wert
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen dieses Buildschritts verwendet werden sollen. Argument[]
dockerFilePfad Der Docker-Dateipfad relativ zum Quellkontext. Zeichenfolge (erforderlich)
imageNames Die vollqualifizierten Bildnamen einschließlich Repository und Tag. Zeichenfolge[]
isPushEnabled Der Wert dieser Eigenschaft gibt an, ob das erstellte Image an die Registrierung übertragen werden soll. Boolesch
noCache Der Wert dieser Eigenschaft gibt an, ob der Bildcache aktiviert ist oder nicht. Boolesch
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Typ Der Typ des Schritts. "Docker" (erforderlich)

EncodedTaskStep

Name BESCHREIBUNG Wert
encodedTaskContent Base64-codierter Wert des Vorlagen-/Definitionsdateiinhalts. Zeichenfolge (erforderlich)
encodedValuesInhalt Base64-codierter Wert der Parameter/Werte-Dateiinhalte. Schnur
Typ Der Typ des Schritts. "EncodedTask" (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue[]

DateiAufgabenSchritt

Name BESCHREIBUNG Wert
taskFilePfad Der Dateipfad der Aufgabenvorlage/Definition relativ zum Quellkontext. Zeichenfolge (erforderlich)
Typ Der Typ des Schritts. 'FileTask' (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue[]
WerteDateiPfad Der Dateipfad für Vorgangswerte/Parameter relativ zum Quellkontext. Schnur

Identity-Eigenschaften

Name BESCHREIBUNG Wert
Typ Der Identitätstyp. "Keine"
'SystemZugewiesen'
"SystemAssigned, UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentität
Wörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Name BESCHREIBUNG Wert

Plattform-Eigenschaften

Name BESCHREIBUNG Wert
Architektur Die Betriebssystemarchitektur. '386'
"amd64"
"Arm"
"arm64"
'x86'
Os Der betriebssystemtyp, der für die Ausführung erforderlich ist. "Linux"
"Windows" (erforderlich)
Variante Variante der CPU. 'v6'
'V7'
'V8'

Ressourcen-Tags

Name BESCHREIBUNG Wert

Secret-Objekt

Name BESCHREIBUNG Wert
Typ Der Typ des geheimen Objekts, das bestimmt, wie der Wert des geheimen Objekts sein muss
interpretiert.
"Undurchsichtig"
"Vault-Geheimnis"
Wert Der Wert des geheimen Schlüssels. Das Format dieses Werts wird bestimmt.
basierend auf dem Typ des geheimen Objekts. Wenn der Typ Opaque ist, lautet der Wert
wird unverändert verwendet.
Schnur

SetValue (Setzwert)

Name BESCHREIBUNG Wert
isSecret Kennzeichnen, um anzugeben, ob der Wert einen geheimen Schlüssel darstellt oder nicht. Boolesch
Name Der Name des überschreibbaren Werts. Zeichenfolge (erforderlich)
Wert Der überschreibbare Wert. Zeichenfolge (erforderlich)

Source-Eigenschaften

Name BESCHREIBUNG Wert
Zweig Der Verzweigungsname des Quellcodes. Schnur
repositoryUrl Die vollständige URL zum Quellcode-Repository Zeichenfolge (erforderlich)
sourceControlAuthProperties Die Autorisierungseigenschaften für den Zugriff auf das Quellcode-Repository und zum Einrichten
Webhooks für Benachrichtigungen.
AuthInfo
sourceControlType Der Typ des Quellcodeverwaltungsdiensts. 'Github'
'VisualStudioTeamService' (erforderlich)

SourceRegistryCredentials

Name BESCHREIBUNG Wert
Identität Die Entra-Identität, die für die Quellregistrierungsanmeldung verwendet wird.
Der Wert ist [system] für vom System zugewiesene verwaltete Identität, [caller] für Anruferidentität,
und Client-ID für vom Benutzer zugewiesene verwaltete Identität.
Schnur
loginMode Der Authentifizierungsmodus, der den Anmeldebereich der Quellregistrierung bestimmt. Die Anmeldeinformationen für die Quellregistrierung
wird mithilfe des angegebenen Bereichs generiert. Diese Anmeldeinformationen werden zum Anmelden bei
die Quellregistrierung während der Ausführung.
'Standard'
"Keine"

SourceTrigger (Quelle)

Name BESCHREIBUNG Wert
Name Der Name des Triggers. Zeichenfolge (erforderlich)
source-Repository Die Eigenschaften, die den Quellcode für die Aufgabe beschreiben. SourceProperties (erforderlich)
sourceTriggerEreignisse Das Quellereignis, das dem Trigger entspricht. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'Verpflichten'
"pullrequest" (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"

AufgabenEigenschaften

Name BESCHREIBUNG Wert
agent-Konfiguration Die Computerkonfiguration des Ausführungs-Agents. Agent-Eigenschaften
agentPoolName Der dedizierte Agentpool für die Aufgabe. Schnur
Zugangsdaten Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Zugangsdaten
isSystemTask Der Wert dieser Eigenschaft gibt an, ob es sich bei der Vorgangsressource um einen Systemvorgang handelt oder nicht. Boolesch
logTemplate Die Vorlage, die die Repository- und Taginformationen für das Run-Protokollartefakt beschreibt. Schnur
Plattform Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. Plattform-Eigenschaften
Status Der aktuelle Status der Aufgabe. "Deaktiviert"
"Aktiviert"
Schritt Die Eigenschaften eines Vorgangsschritts. TaskStep-Eigenschaften
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Auslöser Die Eigenschaften, die alle Trigger für den Vorgang beschreiben. TriggerProperties-

TaskStep-Eigenschaften

Name BESCHREIBUNG Wert
contextAccessToken Das Token (Git PAT oder SAS-Token des Speicherkonto-Blobs), das dem Kontext für einen Schritt zugeordnet ist. Schnur
contextPath (englisch) Die URL(absolut oder relativ) des Quellkontexts für den Vorgangsschritt. Schnur
Typ Legen Sie für den Typ DockerBuildStep auf "Docker" fest. Für den Typ "EncodedTaskStep" auf "EncodedTaskStep" festgelegt. Legen Sie für den Typ "FileTaskStep" auf "FileTaskStep" fest. "Docker"
"EncodedTask"
'FileTask' (erforderlich)

TimerTrigger

Name BESCHREIBUNG Wert
Name Der Name des Triggers. Zeichenfolge (erforderlich)
Zeitplan Der CRON-Ausdruck für den Vorgangszeitplan Zeichenfolge (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"

Trigger-Eigenschaften

Name BESCHREIBUNG Wert
baseImageTrigger (englisch) Der Trigger basierend auf Basisbildabhängigkeiten. BaseImageTrigger
sourceTriggers Die Sammlung von Triggern basierend auf dem Quellcode-Repository. QuelleAuslöser[]
timerAuslöser Die Sammlung von Timertriggern. TimerTrigger[]

UserIdentity-Eigenschaften

Name BESCHREIBUNG Wert

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Registrierungen/Vorgänge" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ContainerRegistry/registries/tasks-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.

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

TaskStepProperties-Objekte

Legen Sie den Typ Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für Docker Folgendes:

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

Verwenden Sie für EncodedTask Folgendes:

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

Verwenden Sie für FileTask Folgendes:

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

Eigenschaftswerte

Microsoft.ContainerRegistry/Registrierungen/Aufgaben

Name BESCHREIBUNG Wert
apiVersion (Englisch) Die API-Version "2025-03-01-preview"
Identität Identität für die Ressource. IdentityProperties-
Standort Der Standort der Ressource. Dies kann nicht geändert werden, nachdem die Ressource erstellt wurde. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge

Zwänge:
Min. Länge = 5
Max. Länge = 50
Pattern = ^[a-zA-Z0-9-_]*$ (erforderlich)
Eigenschaften Die Eigenschaften eines Vorgangs. TaskProperties-
Schlagwörter Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Typ Der Ressourcentyp 'Microsoft.ContainerRegistry/registries/tasks'

Agent-Eigenschaften

Name BESCHREIBUNG Wert
CPU Die CPU-Konfiguration in Bezug auf die Anzahl der für die Ausführung erforderlichen Kerne. INT

Streitpunkt

Name BESCHREIBUNG Wert
isSecret Kennzeichnen, um anzugeben, ob das Argument einen geheimen Schlüssel darstellt und aus Buildprotokollen entfernt werden soll. Boolesch
Name Der Name des Arguments. Zeichenfolge (erforderlich)
Wert Der Wert des Arguments. Zeichenfolge (erforderlich)

AuthInfo

Name BESCHREIBUNG Wert
läuft ab Zeit in Sekunden, die das Token gültig bleibt INT
refreshToken Das Aktualisierungstoken, das zum Aktualisieren des Zugriffstokens verwendet wird. Schnur
Umfang Der Bereich des Zugriffstokens. Schnur
Token Das Zugriffstoken, das für den Zugriff auf den Quellcodeverwaltungsanbieter verwendet wird. Zeichenfolge (erforderlich)
tokenType Der Typ des Authentifizierungstokens. "OAuth"
'PAT' (erforderlich)

BaseImageTrigger

Name BESCHREIBUNG Wert
baseImageTriggerType Der Typ des automatischen Triggers für Basisimageabhängigkeitsupdates. "Alle"
"Runtime" (erforderlich)
Name Der Name des Triggers. Zeichenfolge (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"
updateTriggerEndpoint Die Endpunkt-URL für den Empfang von Updatetriggern. Schnur
updateTriggerPayloadType Typ des Nutzlasttexts für Basisbildaktualisierungstrigger. 'Standard'
"Token"

Anmeldeinformationen

Name BESCHREIBUNG Wert
benutzerdefinierte Registries Beschreibt die Anmeldeinformationsparameter für den Zugriff auf andere benutzerdefinierte Registrierungen. Der Schlüssel
für das Wörterbuchelement ist der Registrierungsanmeldungsserver (myregistry.azurecr.io) und
Der Wert des Elements ist die Registrierungsanmeldeinformationen für den Zugriff auf die Registrierung.
AnmeldeinformationenBenutzerdefinierte Registrierungen
sourceRegistry Beschreibt die Anmeldeinformationsparameter für den Zugriff auf die Quellregistrierung. SourceRegistryCredentials

AnmeldeinformationenBenutzerdefinierte Registrierungen

Name BESCHREIBUNG Wert

CustomRegistryCredentials

Name BESCHREIBUNG Wert
Identität Gibt die verwaltete Identität an, die den benutzerdefinierten Anmeldeinformationen zugewiesen ist. Wenn eine vom Benutzer zugewiesene Identität
dieser Wert ist die Client-ID. Wenn eine vom System zugewiesene Identität vorhanden ist, lautet systemder Wert . In
bei einer vom System zugewiesenen Identität wird die Client-ID vom Läufer bestimmt. Das
Die Identität kann verwendet werden, um sich beim Key Vault zu authentifizieren, um Anmeldeinformationen abzurufen, oder dies ist die einzige
Quelle der Authentifizierung, die für den Zugriff auf die Registrierung verwendet wird.
Schnur
Kennwort Das Kennwort für die Anmeldung bei der benutzerdefinierten Registrierung. Das Kennwort ist ein Geheimschlüssel.
-Objekt, das mehrere Möglichkeiten zum Bereitstellen des Werts zulässt.
Secret-Objekt
Nutzername Der Benutzername für die Anmeldung bei der benutzerdefinierten Registrierung. Secret-Objekt

DockerBuildStep (Englisch)

Name BESCHREIBUNG Wert
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen dieses Buildschritts verwendet werden sollen. Argument[]
dockerFilePfad Der Docker-Dateipfad relativ zum Quellkontext. Zeichenfolge (erforderlich)
imageNames Die vollqualifizierten Bildnamen einschließlich Repository und Tag. Zeichenfolge[]
isPushEnabled Der Wert dieser Eigenschaft gibt an, ob das erstellte Image an die Registrierung übertragen werden soll. Boolesch
noCache Der Wert dieser Eigenschaft gibt an, ob der Bildcache aktiviert ist oder nicht. Boolesch
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Typ Der Typ des Schritts. "Docker" (erforderlich)

EncodedTaskStep

Name BESCHREIBUNG Wert
encodedTaskContent Base64-codierter Wert des Vorlagen-/Definitionsdateiinhalts. Zeichenfolge (erforderlich)
encodedValuesInhalt Base64-codierter Wert der Parameter/Werte-Dateiinhalte. Schnur
Typ Der Typ des Schritts. "EncodedTask" (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue[]

DateiAufgabenSchritt

Name BESCHREIBUNG Wert
taskFilePfad Der Dateipfad der Aufgabenvorlage/Definition relativ zum Quellkontext. Zeichenfolge (erforderlich)
Typ Der Typ des Schritts. 'FileTask' (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue[]
WerteDateiPfad Der Dateipfad für Vorgangswerte/Parameter relativ zum Quellkontext. Schnur

Identity-Eigenschaften

Name BESCHREIBUNG Wert
Typ Der Identitätstyp. "Keine"
'SystemZugewiesen'
"SystemAssigned, UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentität
Wörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Name BESCHREIBUNG Wert

Plattform-Eigenschaften

Name BESCHREIBUNG Wert
Architektur Die Betriebssystemarchitektur. '386'
"amd64"
"Arm"
"arm64"
'x86'
Os Der betriebssystemtyp, der für die Ausführung erforderlich ist. "Linux"
"Windows" (erforderlich)
Variante Variante der CPU. 'v6'
'V7'
'V8'

Ressourcen-Tags

Name BESCHREIBUNG Wert

Secret-Objekt

Name BESCHREIBUNG Wert
Typ Der Typ des geheimen Objekts, das bestimmt, wie der Wert des geheimen Objekts sein muss
interpretiert.
"Undurchsichtig"
"Vault-Geheimnis"
Wert Der Wert des geheimen Schlüssels. Das Format dieses Werts wird bestimmt.
basierend auf dem Typ des geheimen Objekts. Wenn der Typ Opaque ist, lautet der Wert
wird unverändert verwendet.
Schnur

SetValue (Setzwert)

Name BESCHREIBUNG Wert
isSecret Kennzeichnen, um anzugeben, ob der Wert einen geheimen Schlüssel darstellt oder nicht. Boolesch
Name Der Name des überschreibbaren Werts. Zeichenfolge (erforderlich)
Wert Der überschreibbare Wert. Zeichenfolge (erforderlich)

Source-Eigenschaften

Name BESCHREIBUNG Wert
Zweig Der Verzweigungsname des Quellcodes. Schnur
repositoryUrl Die vollständige URL zum Quellcode-Repository Zeichenfolge (erforderlich)
sourceControlAuthProperties Die Autorisierungseigenschaften für den Zugriff auf das Quellcode-Repository und zum Einrichten
Webhooks für Benachrichtigungen.
AuthInfo
sourceControlType Der Typ des Quellcodeverwaltungsdiensts. 'Github'
'VisualStudioTeamService' (erforderlich)

SourceRegistryCredentials

Name BESCHREIBUNG Wert
Identität Die Entra-Identität, die für die Quellregistrierungsanmeldung verwendet wird.
Der Wert ist [system] für vom System zugewiesene verwaltete Identität, [caller] für Anruferidentität,
und Client-ID für vom Benutzer zugewiesene verwaltete Identität.
Schnur
loginMode Der Authentifizierungsmodus, der den Anmeldebereich der Quellregistrierung bestimmt. Die Anmeldeinformationen für die Quellregistrierung
wird mithilfe des angegebenen Bereichs generiert. Diese Anmeldeinformationen werden zum Anmelden bei
die Quellregistrierung während der Ausführung.
'Standard'
"Keine"

SourceTrigger (Quelle)

Name BESCHREIBUNG Wert
Name Der Name des Triggers. Zeichenfolge (erforderlich)
source-Repository Die Eigenschaften, die den Quellcode für die Aufgabe beschreiben. SourceProperties (erforderlich)
sourceTriggerEreignisse Das Quellereignis, das dem Trigger entspricht. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'Verpflichten'
"pullrequest" (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"

AufgabenEigenschaften

Name BESCHREIBUNG Wert
agent-Konfiguration Die Computerkonfiguration des Ausführungs-Agents. Agent-Eigenschaften
agentPoolName Der dedizierte Agentpool für die Aufgabe. Schnur
Zugangsdaten Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Zugangsdaten
isSystemTask Der Wert dieser Eigenschaft gibt an, ob es sich bei der Vorgangsressource um einen Systemvorgang handelt oder nicht. Boolesch
logTemplate Die Vorlage, die die Repository- und Taginformationen für das Run-Protokollartefakt beschreibt. Schnur
Plattform Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. Plattform-Eigenschaften
Status Der aktuelle Status der Aufgabe. "Deaktiviert"
"Aktiviert"
Schritt Die Eigenschaften eines Vorgangsschritts. TaskStep-Eigenschaften
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Auslöser Die Eigenschaften, die alle Trigger für den Vorgang beschreiben. TriggerProperties-

TaskStep-Eigenschaften

Name BESCHREIBUNG Wert
contextAccessToken Das Token (Git PAT oder SAS-Token des Speicherkonto-Blobs), das dem Kontext für einen Schritt zugeordnet ist. Schnur
contextPath (englisch) Die URL(absolut oder relativ) des Quellkontexts für den Vorgangsschritt. Schnur
Typ Legen Sie für den Typ DockerBuildStep auf "Docker" fest. Für den Typ "EncodedTaskStep" auf "EncodedTaskStep" festgelegt. Legen Sie für den Typ "FileTaskStep" auf "FileTaskStep" fest. "Docker"
"EncodedTask"
'FileTask' (erforderlich)

TimerTrigger

Name BESCHREIBUNG Wert
Name Der Name des Triggers. Zeichenfolge (erforderlich)
Zeitplan Der CRON-Ausdruck für den Vorgangszeitplan Zeichenfolge (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"

Trigger-Eigenschaften

Name BESCHREIBUNG Wert
baseImageTrigger (englisch) Der Trigger basierend auf Basisbildabhängigkeiten. BaseImageTrigger
sourceTriggers Die Sammlung von Triggern basierend auf dem Quellcode-Repository. QuelleAuslöser[]
timerAuslöser Die Sammlung von Timertriggern. TimerTrigger[]

UserIdentity-Eigenschaften

Name BESCHREIBUNG Wert

Verwendungsbeispiele

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Registrierungen/Vorgänge" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ContainerRegistry/registries/tasks-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

TaskStepProperties-Objekte

Legen Sie den Typ Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für Docker Folgendes:

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

Verwenden Sie für EncodedTask Folgendes:

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

Verwenden Sie für FileTask Folgendes:

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

Eigenschaftswerte

Microsoft.ContainerRegistry/Registrierungen/Aufgaben

Name BESCHREIBUNG Wert
Identität Identität für die Ressource. IdentityProperties-
Standort Der Standort der Ressource. Dies kann nicht geändert werden, nachdem die Ressource erstellt wurde. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge

Zwänge:
Min. Länge = 5
Max. Länge = 50
Pattern = ^[a-zA-Z0-9-_]*$ (erforderlich)
Eltern-ID Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Registrierungen
Eigenschaften Die Eigenschaften eines Vorgangs. TaskProperties-
Schlagwörter Ressourcenetiketten Wörterbuch der Tagnamen und -werte.
Typ Der Ressourcentyp "Microsoft.ContainerRegistry/registries/tasks@2025-03-01-preview"

Agent-Eigenschaften

Name BESCHREIBUNG Wert
CPU Die CPU-Konfiguration in Bezug auf die Anzahl der für die Ausführung erforderlichen Kerne. INT

Streitpunkt

Name BESCHREIBUNG Wert
isSecret Kennzeichnen, um anzugeben, ob das Argument einen geheimen Schlüssel darstellt und aus Buildprotokollen entfernt werden soll. Boolesch
Name Der Name des Arguments. Zeichenfolge (erforderlich)
Wert Der Wert des Arguments. Zeichenfolge (erforderlich)

AuthInfo

Name BESCHREIBUNG Wert
läuft ab Zeit in Sekunden, die das Token gültig bleibt INT
refreshToken Das Aktualisierungstoken, das zum Aktualisieren des Zugriffstokens verwendet wird. Schnur
Umfang Der Bereich des Zugriffstokens. Schnur
Token Das Zugriffstoken, das für den Zugriff auf den Quellcodeverwaltungsanbieter verwendet wird. Zeichenfolge (erforderlich)
tokenType Der Typ des Authentifizierungstokens. "OAuth"
'PAT' (erforderlich)

BaseImageTrigger

Name BESCHREIBUNG Wert
baseImageTriggerType Der Typ des automatischen Triggers für Basisimageabhängigkeitsupdates. "Alle"
"Runtime" (erforderlich)
Name Der Name des Triggers. Zeichenfolge (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"
updateTriggerEndpoint Die Endpunkt-URL für den Empfang von Updatetriggern. Schnur
updateTriggerPayloadType Typ des Nutzlasttexts für Basisbildaktualisierungstrigger. 'Standard'
"Token"

Anmeldeinformationen

Name BESCHREIBUNG Wert
benutzerdefinierte Registries Beschreibt die Anmeldeinformationsparameter für den Zugriff auf andere benutzerdefinierte Registrierungen. Der Schlüssel
für das Wörterbuchelement ist der Registrierungsanmeldungsserver (myregistry.azurecr.io) und
Der Wert des Elements ist die Registrierungsanmeldeinformationen für den Zugriff auf die Registrierung.
AnmeldeinformationenBenutzerdefinierte Registrierungen
sourceRegistry Beschreibt die Anmeldeinformationsparameter für den Zugriff auf die Quellregistrierung. SourceRegistryCredentials

AnmeldeinformationenBenutzerdefinierte Registrierungen

Name BESCHREIBUNG Wert

CustomRegistryCredentials

Name BESCHREIBUNG Wert
Identität Gibt die verwaltete Identität an, die den benutzerdefinierten Anmeldeinformationen zugewiesen ist. Wenn eine vom Benutzer zugewiesene Identität
dieser Wert ist die Client-ID. Wenn eine vom System zugewiesene Identität vorhanden ist, lautet systemder Wert . In
bei einer vom System zugewiesenen Identität wird die Client-ID vom Läufer bestimmt. Das
Die Identität kann verwendet werden, um sich beim Key Vault zu authentifizieren, um Anmeldeinformationen abzurufen, oder dies ist die einzige
Quelle der Authentifizierung, die für den Zugriff auf die Registrierung verwendet wird.
Schnur
Kennwort Das Kennwort für die Anmeldung bei der benutzerdefinierten Registrierung. Das Kennwort ist ein Geheimschlüssel.
-Objekt, das mehrere Möglichkeiten zum Bereitstellen des Werts zulässt.
Secret-Objekt
Nutzername Der Benutzername für die Anmeldung bei der benutzerdefinierten Registrierung. Secret-Objekt

DockerBuildStep (Englisch)

Name BESCHREIBUNG Wert
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen dieses Buildschritts verwendet werden sollen. Argument[]
dockerFilePfad Der Docker-Dateipfad relativ zum Quellkontext. Zeichenfolge (erforderlich)
imageNames Die vollqualifizierten Bildnamen einschließlich Repository und Tag. Zeichenfolge[]
isPushEnabled Der Wert dieser Eigenschaft gibt an, ob das erstellte Image an die Registrierung übertragen werden soll. Boolesch
noCache Der Wert dieser Eigenschaft gibt an, ob der Bildcache aktiviert ist oder nicht. Boolesch
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Typ Der Typ des Schritts. "Docker" (erforderlich)

EncodedTaskStep

Name BESCHREIBUNG Wert
encodedTaskContent Base64-codierter Wert des Vorlagen-/Definitionsdateiinhalts. Zeichenfolge (erforderlich)
encodedValuesInhalt Base64-codierter Wert der Parameter/Werte-Dateiinhalte. Schnur
Typ Der Typ des Schritts. "EncodedTask" (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue[]

DateiAufgabenSchritt

Name BESCHREIBUNG Wert
taskFilePfad Der Dateipfad der Aufgabenvorlage/Definition relativ zum Quellkontext. Zeichenfolge (erforderlich)
Typ Der Typ des Schritts. 'FileTask' (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue[]
WerteDateiPfad Der Dateipfad für Vorgangswerte/Parameter relativ zum Quellkontext. Schnur

Identity-Eigenschaften

Name BESCHREIBUNG Wert
Typ Der Identitätstyp. "Keine"
'SystemZugewiesen'
"SystemAssigned, UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentität
Wörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Name BESCHREIBUNG Wert

Plattform-Eigenschaften

Name BESCHREIBUNG Wert
Architektur Die Betriebssystemarchitektur. '386'
"amd64"
"Arm"
"arm64"
'x86'
Os Der betriebssystemtyp, der für die Ausführung erforderlich ist. "Linux"
"Windows" (erforderlich)
Variante Variante der CPU. 'v6'
'V7'
'V8'

Ressourcen-Tags

Name BESCHREIBUNG Wert

Secret-Objekt

Name BESCHREIBUNG Wert
Typ Der Typ des geheimen Objekts, das bestimmt, wie der Wert des geheimen Objekts sein muss
interpretiert.
"Undurchsichtig"
"Vault-Geheimnis"
Wert Der Wert des geheimen Schlüssels. Das Format dieses Werts wird bestimmt.
basierend auf dem Typ des geheimen Objekts. Wenn der Typ Opaque ist, lautet der Wert
wird unverändert verwendet.
Schnur

SetValue (Setzwert)

Name BESCHREIBUNG Wert
isSecret Kennzeichnen, um anzugeben, ob der Wert einen geheimen Schlüssel darstellt oder nicht. Boolesch
Name Der Name des überschreibbaren Werts. Zeichenfolge (erforderlich)
Wert Der überschreibbare Wert. Zeichenfolge (erforderlich)

Source-Eigenschaften

Name BESCHREIBUNG Wert
Zweig Der Verzweigungsname des Quellcodes. Schnur
repositoryUrl Die vollständige URL zum Quellcode-Repository Zeichenfolge (erforderlich)
sourceControlAuthProperties Die Autorisierungseigenschaften für den Zugriff auf das Quellcode-Repository und zum Einrichten
Webhooks für Benachrichtigungen.
AuthInfo
sourceControlType Der Typ des Quellcodeverwaltungsdiensts. 'Github'
'VisualStudioTeamService' (erforderlich)

SourceRegistryCredentials

Name BESCHREIBUNG Wert
Identität Die Entra-Identität, die für die Quellregistrierungsanmeldung verwendet wird.
Der Wert ist [system] für vom System zugewiesene verwaltete Identität, [caller] für Anruferidentität,
und Client-ID für vom Benutzer zugewiesene verwaltete Identität.
Schnur
loginMode Der Authentifizierungsmodus, der den Anmeldebereich der Quellregistrierung bestimmt. Die Anmeldeinformationen für die Quellregistrierung
wird mithilfe des angegebenen Bereichs generiert. Diese Anmeldeinformationen werden zum Anmelden bei
die Quellregistrierung während der Ausführung.
'Standard'
"Keine"

SourceTrigger (Quelle)

Name BESCHREIBUNG Wert
Name Der Name des Triggers. Zeichenfolge (erforderlich)
source-Repository Die Eigenschaften, die den Quellcode für die Aufgabe beschreiben. SourceProperties (erforderlich)
sourceTriggerEreignisse Das Quellereignis, das dem Trigger entspricht. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'Verpflichten'
"pullrequest" (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"

AufgabenEigenschaften

Name BESCHREIBUNG Wert
agent-Konfiguration Die Computerkonfiguration des Ausführungs-Agents. Agent-Eigenschaften
agentPoolName Der dedizierte Agentpool für die Aufgabe. Schnur
Zugangsdaten Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Zugangsdaten
isSystemTask Der Wert dieser Eigenschaft gibt an, ob es sich bei der Vorgangsressource um einen Systemvorgang handelt oder nicht. Boolesch
logTemplate Die Vorlage, die die Repository- und Taginformationen für das Run-Protokollartefakt beschreibt. Schnur
Plattform Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. Plattform-Eigenschaften
Status Der aktuelle Status der Aufgabe. "Deaktiviert"
"Aktiviert"
Schritt Die Eigenschaften eines Vorgangsschritts. TaskStep-Eigenschaften
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Auslöser Die Eigenschaften, die alle Trigger für den Vorgang beschreiben. TriggerProperties-

TaskStep-Eigenschaften

Name BESCHREIBUNG Wert
contextAccessToken Das Token (Git PAT oder SAS-Token des Speicherkonto-Blobs), das dem Kontext für einen Schritt zugeordnet ist. Schnur
contextPath (englisch) Die URL(absolut oder relativ) des Quellkontexts für den Vorgangsschritt. Schnur
Typ Legen Sie für den Typ DockerBuildStep auf "Docker" fest. Für den Typ "EncodedTaskStep" auf "EncodedTaskStep" festgelegt. Legen Sie für den Typ "FileTaskStep" auf "FileTaskStep" fest. "Docker"
"EncodedTask"
'FileTask' (erforderlich)

TimerTrigger

Name BESCHREIBUNG Wert
Name Der Name des Triggers. Zeichenfolge (erforderlich)
Zeitplan Der CRON-Ausdruck für den Vorgangszeitplan Zeichenfolge (erforderlich)
Status Der aktuelle Status des Triggers. "Deaktiviert"
"Aktiviert"

Trigger-Eigenschaften

Name BESCHREIBUNG Wert
baseImageTrigger (englisch) Der Trigger basierend auf Basisbildabhängigkeiten. BaseImageTrigger
sourceTriggers Die Sammlung von Triggern basierend auf dem Quellcode-Repository. QuelleAuslöser[]
timerAuslöser Die Sammlung von Timertriggern. TimerTrigger[]

UserIdentity-Eigenschaften

Name BESCHREIBUNG Wert