Freigeben über


Microsoft.ContainerRegistry-Registrierungen/taskRuns 2019-06-01-preview

Bicep-Ressourcendefinition

Der Ressourcentyp registries/taskRuns 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/taskRuns-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.ContainerRegistry/registries/taskRuns@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: {
    forceUpdateTag: 'string'
    runRequest: {
      agentPoolName: 'string'
      isArchiveEnabled: bool
      logTemplate: 'string'
      type: 'string'
      // For remaining properties, see RunRequest objects
    }
  }
}

RunRequest-Objekte

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

Verwenden Sie für DockerBuildRequest-:

{
  agentConfiguration: {
    cpu: int
  }
  arguments: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
  credentials: {
    customRegistries: {
      {customized property}: {
        identity: 'string'
        password: {
          type: 'string'
          value: 'string'
        }
        userName: {
          type: 'string'
          value: 'string'
        }
      }
    }
    sourceRegistry: {
      loginMode: 'string'
    }
  }
  dockerFilePath: 'string'
  imageNames: [
    'string'
  ]
  isPushEnabled: bool
  noCache: bool
  platform: {
    architecture: 'string'
    os: 'string'
    variant: 'string'
  }
  sourceLocation: 'string'
  target: 'string'
  timeout: int
  type: 'DockerBuildRequest'
}

Verwenden Sie für EncodedTaskRunRequest:

{
  agentConfiguration: {
    cpu: int
  }
  credentials: {
    customRegistries: {
      {customized property}: {
        identity: 'string'
        password: {
          type: 'string'
          value: 'string'
        }
        userName: {
          type: 'string'
          value: 'string'
        }
      }
    }
    sourceRegistry: {
      loginMode: 'string'
    }
  }
  encodedTaskContent: 'string'
  encodedValuesContent: 'string'
  platform: {
    architecture: 'string'
    os: 'string'
    variant: 'string'
  }
  sourceLocation: 'string'
  timeout: int
  type: 'EncodedTaskRunRequest'
  values: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
}

Verwenden Sie für FileTaskRunRequest:

{
  agentConfiguration: {
    cpu: int
  }
  credentials: {
    customRegistries: {
      {customized property}: {
        identity: 'string'
        password: {
          type: 'string'
          value: 'string'
        }
        userName: {
          type: 'string'
          value: 'string'
        }
      }
    }
    sourceRegistry: {
      loginMode: 'string'
    }
  }
  platform: {
    architecture: 'string'
    os: 'string'
    variant: 'string'
  }
  sourceLocation: 'string'
  taskFilePath: 'string'
  timeout: int
  type: 'FileTaskRunRequest'
  values: [
    {
      isSecret: bool
      name: 'string'
      value: 'string'
    }
  ]
  valuesFilePath: 'string'
}

Verwenden Sie für TaskRunRequest-Folgendes:

{
  overrideTaskStepProperties: {
    arguments: [
      {
        isSecret: bool
        name: 'string'
        value: 'string'
      }
    ]
    contextPath: 'string'
    file: 'string'
    target: 'string'
    updateTriggerToken: 'string'
    values: [
      {
        isSecret: bool
        name: 'string'
        value: 'string'
      }
    ]
  }
  taskId: 'string'
  type: 'TaskRunRequest'
}

Eigenschaftswerte

AgentProperties

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

Argument

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

Beglaubigungsschreiben

Name Beschreibung Wert
customRegistries 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.
CredentialsCustomRegistries
sourceRegistry Beschreibt die Anmeldeinformationsparameter für den Zugriff auf die Quellregistrierung. SourceRegistryCredentials-

CredentialsCustomRegistries

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, wird der Wert system. 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
Passwort 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.
SecretObject-
Nutzername Der Benutzername für die Anmeldung bei der benutzerdefinierten Registrierung. SecretObject-

DockerBuildRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen der Ausführung verwendet werden sollen. Argument[]
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
dockerFilePath Der Docker-Dateipfad relativ zum Quellspeicherort. Zeichenfolge (erforderlich)
imageNames Die vollqualifizierten Bildnamen einschließlich Repository und Tag. string[]
isPushEnabled Der Wert dieser Eigenschaft gibt an, ob das erstellte Image an die Registrierung übertragen werden soll. Bool
noCache Der Wert dieser Eigenschaft gibt an, ob der Bildcache aktiviert ist oder nicht. Bool
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. "DockerBuildRequest" (erforderlich)

EncodedTaskRunRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
encodedTaskContent Base64-codierter Wert des Vorlagen-/Definitionsdateiinhalts. Zeichenfolge (erforderlich)
encodedValuesContent Base64-codierter Wert der Parameter/Werte-Dateiinhalte. Schnur
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. "EncodedTaskRunRequest" (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]

FileTaskRunRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
taskFilePath Der Dateipfad der Vorlage/Definition relativ zur Quelle. Zeichenfolge (erforderlich)
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. 'FileTaskRunRequest' (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]
valuesFilePath Der Dateipfad für Werte/Parameter relativ zur Quelle. Schnur

IdentityProperties

Name Beschreibung Wert
principalId Die Prinzipal-ID der Ressourcenidentität. Schnur
tenantId Die Mandanten-ID der Ressource. Schnur
Art Der Identitätstyp. 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities 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

Microsoft.ContainerRegistry/registries/taskRuns

Name Beschreibung Wert
Identität Identität für die Ressource. IdentityProperties-
Ort Der Speicherort der Ressource Schnur
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 5
Max. Länge = 5
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, die der Aufgabenausführung zugeordnet sind, d. h. Anforderung und Ergebnis der Ausführung TaskRunProperties-

OverrideTaskStepProperties

Name Beschreibung Wert
Argumente Dient zum Abrufen oder Festlegen der Auflistung von Außerkraftsetzungsargumenten, die verwendet werden sollen, wenn
Ausführen eines Buildschritts.
Argument[]
contextPath Der Quellkontext, für den ausgeführt wird, muss in die Warteschlange gestellt werden. Schnur
Datei Die Datei, für die ausgeführt wird, muss in die Warteschlange gestellt werden. Schnur
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
updateTriggerToken Base64-codiertes Updatetriggertoken, das an den Basisbildtrigger-Webhook angefügt wird. Schnur
Werte Die Auflistung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]

PlatformProperties

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'

RunRequest

Name Beschreibung Wert
agentPoolName Der dedizierte Agentpool für die Ausführung. Schnur
isArchiveEnabled Der Wert, der angibt, ob die Archivierung für die Ausführung aktiviert ist oder nicht. Bool
logTemplate Die Vorlage, die die Repository- und Taginformationen für das Run-Protokollartefakt beschreibt. Schnur
Art Set to 'DockerBuildRequest' for type DockerBuildRequest. Legen Sie für den Typ EncodedTaskRunRequestauf "EncodedTaskRunRequest" fest. Legen Sie für den Typ FileTaskRunRequest-auf "FileTaskRunRequest" fest. Legen Sie für den Typ TaskRunRequest-auf "TaskRunRequest" fest. "DockerBuildRequest"
"EncodedTaskRunRequest"
'FileTaskRunRequest'
'TaskRunRequest' (erforderlich)

SecretObject

Name Beschreibung Wert
Art Der Typ des geheimen Objekts, das bestimmt, wie der Wert des geheimen Objekts sein muss
interpretiert.
"Undurchsichtig"
'Vaultsecret'
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

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

SourceRegistryCredentials

Name Beschreibung Wert
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'
'None'

TaskRunProperties

Name Beschreibung Wert
forceUpdateTag Wie die Ausführung erzwungen werden soll, auch wenn sich die Ausführungsanforderungskonfiguration nicht geändert hat Schnur
runRequest Die Anforderung (Parameter) für die Ausführung RunRequest-

TaskRunRequest

Name Beschreibung Wert
overrideTaskStepProperties Set of overridable parameters that can be passed when running a Task. OverrideTaskStepProperties
taskId Die Ressourcen-ID des Vorgangs, für den ausgeführt wird, muss in die Warteschlange gestellt werden. Zeichenfolge (erforderlich)
Art Der Typ der Ausführungsanforderung. 'TaskRunRequest' (erforderlich)

UserIdentityProperties

Name Beschreibung Wert
clientId Die Client-ID der vom Benutzer zugewiesenen Identität. Schnur
principalId Die Prinzipal-ID der vom Benutzer zugewiesenen Identität. Schnur

ARM-Vorlagenressourcendefinition

Der Ressourcentyp registries/taskRuns 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/taskRuns-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.ContainerRegistry/registries/taskRuns",
  "apiVersion": "2019-06-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "forceUpdateTag": "string",
    "runRequest": {
      "agentPoolName": "string",
      "isArchiveEnabled": "bool",
      "logTemplate": "string",
      "type": "string"
      // For remaining properties, see RunRequest objects
    }
  }
}

RunRequest-Objekte

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

Verwenden Sie für DockerBuildRequest-:

{
  "agentConfiguration": {
    "cpu": "int"
  },
  "arguments": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ],
  "credentials": {
    "customRegistries": {
      "{customized property}": {
        "identity": "string",
        "password": {
          "type": "string",
          "value": "string"
        },
        "userName": {
          "type": "string",
          "value": "string"
        }
      }
    },
    "sourceRegistry": {
      "loginMode": "string"
    }
  },
  "dockerFilePath": "string",
  "imageNames": [ "string" ],
  "isPushEnabled": "bool",
  "noCache": "bool",
  "platform": {
    "architecture": "string",
    "os": "string",
    "variant": "string"
  },
  "sourceLocation": "string",
  "target": "string",
  "timeout": "int",
  "type": "DockerBuildRequest"
}

Verwenden Sie für EncodedTaskRunRequest:

{
  "agentConfiguration": {
    "cpu": "int"
  },
  "credentials": {
    "customRegistries": {
      "{customized property}": {
        "identity": "string",
        "password": {
          "type": "string",
          "value": "string"
        },
        "userName": {
          "type": "string",
          "value": "string"
        }
      }
    },
    "sourceRegistry": {
      "loginMode": "string"
    }
  },
  "encodedTaskContent": "string",
  "encodedValuesContent": "string",
  "platform": {
    "architecture": "string",
    "os": "string",
    "variant": "string"
  },
  "sourceLocation": "string",
  "timeout": "int",
  "type": "EncodedTaskRunRequest",
  "values": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ]
}

Verwenden Sie für FileTaskRunRequest:

{
  "agentConfiguration": {
    "cpu": "int"
  },
  "credentials": {
    "customRegistries": {
      "{customized property}": {
        "identity": "string",
        "password": {
          "type": "string",
          "value": "string"
        },
        "userName": {
          "type": "string",
          "value": "string"
        }
      }
    },
    "sourceRegistry": {
      "loginMode": "string"
    }
  },
  "platform": {
    "architecture": "string",
    "os": "string",
    "variant": "string"
  },
  "sourceLocation": "string",
  "taskFilePath": "string",
  "timeout": "int",
  "type": "FileTaskRunRequest",
  "values": [
    {
      "isSecret": "bool",
      "name": "string",
      "value": "string"
    }
  ],
  "valuesFilePath": "string"
}

Verwenden Sie für TaskRunRequest-Folgendes:

{
  "overrideTaskStepProperties": {
    "arguments": [
      {
        "isSecret": "bool",
        "name": "string",
        "value": "string"
      }
    ],
    "contextPath": "string",
    "file": "string",
    "target": "string",
    "updateTriggerToken": "string",
    "values": [
      {
        "isSecret": "bool",
        "name": "string",
        "value": "string"
      }
    ]
  },
  "taskId": "string",
  "type": "TaskRunRequest"
}

Eigenschaftswerte

AgentProperties

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

Argument

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

Beglaubigungsschreiben

Name Beschreibung Wert
customRegistries 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.
CredentialsCustomRegistries
sourceRegistry Beschreibt die Anmeldeinformationsparameter für den Zugriff auf die Quellregistrierung. SourceRegistryCredentials-

CredentialsCustomRegistries

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, wird der Wert system. 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
Passwort 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.
SecretObject-
Nutzername Der Benutzername für die Anmeldung bei der benutzerdefinierten Registrierung. SecretObject-

DockerBuildRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen der Ausführung verwendet werden sollen. Argument[]
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
dockerFilePath Der Docker-Dateipfad relativ zum Quellspeicherort. Zeichenfolge (erforderlich)
imageNames Die vollqualifizierten Bildnamen einschließlich Repository und Tag. string[]
isPushEnabled Der Wert dieser Eigenschaft gibt an, ob das erstellte Image an die Registrierung übertragen werden soll. Bool
noCache Der Wert dieser Eigenschaft gibt an, ob der Bildcache aktiviert ist oder nicht. Bool
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. "DockerBuildRequest" (erforderlich)

EncodedTaskRunRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
encodedTaskContent Base64-codierter Wert des Vorlagen-/Definitionsdateiinhalts. Zeichenfolge (erforderlich)
encodedValuesContent Base64-codierter Wert der Parameter/Werte-Dateiinhalte. Schnur
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. "EncodedTaskRunRequest" (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]

FileTaskRunRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
taskFilePath Der Dateipfad der Vorlage/Definition relativ zur Quelle. Zeichenfolge (erforderlich)
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. 'FileTaskRunRequest' (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]
valuesFilePath Der Dateipfad für Werte/Parameter relativ zur Quelle. Schnur

IdentityProperties

Name Beschreibung Wert
principalId Die Prinzipal-ID der Ressourcenidentität. Schnur
tenantId Die Mandanten-ID der Ressource. Schnur
Art Der Identitätstyp. 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities 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

Microsoft.ContainerRegistry/registries/taskRuns

Name Beschreibung Wert
apiVersion Die API-Version "2019-06-01-preview"
Identität Identität für die Ressource. IdentityProperties-
Ort Der Speicherort der Ressource Schnur
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 5
Max. Länge = 5
Pattern = ^[a-zA-Z0-9-]*$ (erforderlich)
Eigenschaften Die Eigenschaften, die der Aufgabenausführung zugeordnet sind, d. h. Anforderung und Ergebnis der Ausführung TaskRunProperties-
Art Der Ressourcentyp 'Microsoft.ContainerRegistry/registries/taskRuns'

OverrideTaskStepProperties

Name Beschreibung Wert
Argumente Dient zum Abrufen oder Festlegen der Auflistung von Außerkraftsetzungsargumenten, die verwendet werden sollen, wenn
Ausführen eines Buildschritts.
Argument[]
contextPath Der Quellkontext, für den ausgeführt wird, muss in die Warteschlange gestellt werden. Schnur
Datei Die Datei, für die ausgeführt wird, muss in die Warteschlange gestellt werden. Schnur
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
updateTriggerToken Base64-codiertes Updatetriggertoken, das an den Basisbildtrigger-Webhook angefügt wird. Schnur
Werte Die Auflistung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]

PlatformProperties

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'

RunRequest

Name Beschreibung Wert
agentPoolName Der dedizierte Agentpool für die Ausführung. Schnur
isArchiveEnabled Der Wert, der angibt, ob die Archivierung für die Ausführung aktiviert ist oder nicht. Bool
logTemplate Die Vorlage, die die Repository- und Taginformationen für das Run-Protokollartefakt beschreibt. Schnur
Art Set to 'DockerBuildRequest' for type DockerBuildRequest. Legen Sie für den Typ EncodedTaskRunRequestauf "EncodedTaskRunRequest" fest. Legen Sie für den Typ FileTaskRunRequest-auf "FileTaskRunRequest" fest. Legen Sie für den Typ TaskRunRequest-auf "TaskRunRequest" fest. "DockerBuildRequest"
"EncodedTaskRunRequest"
'FileTaskRunRequest'
'TaskRunRequest' (erforderlich)

SecretObject

Name Beschreibung Wert
Art Der Typ des geheimen Objekts, das bestimmt, wie der Wert des geheimen Objekts sein muss
interpretiert.
"Undurchsichtig"
'Vaultsecret'
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

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

SourceRegistryCredentials

Name Beschreibung Wert
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'
'None'

TaskRunProperties

Name Beschreibung Wert
forceUpdateTag Wie die Ausführung erzwungen werden soll, auch wenn sich die Ausführungsanforderungskonfiguration nicht geändert hat Schnur
runRequest Die Anforderung (Parameter) für die Ausführung RunRequest-

TaskRunRequest

Name Beschreibung Wert
overrideTaskStepProperties Set of overridable parameters that can be passed when running a Task. OverrideTaskStepProperties
taskId Die Ressourcen-ID des Vorgangs, für den ausgeführt wird, muss in die Warteschlange gestellt werden. Zeichenfolge (erforderlich)
Art Der Typ der Ausführungsanforderung. 'TaskRunRequest' (erforderlich)

UserIdentityProperties

Name Beschreibung Wert
clientId Die Client-ID der vom Benutzer zugewiesenen Identität. Schnur
principalId Die Prinzipal-ID der vom Benutzer zugewiesenen Identität. Schnur

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp registries/taskRuns 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/taskRuns-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      forceUpdateTag = "string"
      runRequest = {
        agentPoolName = "string"
        isArchiveEnabled = bool
        logTemplate = "string"
        type = "string"
        // For remaining properties, see RunRequest objects
      }
    }
  })
}

RunRequest-Objekte

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

Verwenden Sie für DockerBuildRequest-:

{
  agentConfiguration = {
    cpu = int
  }
  arguments = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
  credentials = {
    customRegistries = {
      {customized property} = {
        identity = "string"
        password = {
          type = "string"
          value = "string"
        }
        userName = {
          type = "string"
          value = "string"
        }
      }
    }
    sourceRegistry = {
      loginMode = "string"
    }
  }
  dockerFilePath = "string"
  imageNames = [
    "string"
  ]
  isPushEnabled = bool
  noCache = bool
  platform = {
    architecture = "string"
    os = "string"
    variant = "string"
  }
  sourceLocation = "string"
  target = "string"
  timeout = int
  type = "DockerBuildRequest"
}

Verwenden Sie für EncodedTaskRunRequest:

{
  agentConfiguration = {
    cpu = int
  }
  credentials = {
    customRegistries = {
      {customized property} = {
        identity = "string"
        password = {
          type = "string"
          value = "string"
        }
        userName = {
          type = "string"
          value = "string"
        }
      }
    }
    sourceRegistry = {
      loginMode = "string"
    }
  }
  encodedTaskContent = "string"
  encodedValuesContent = "string"
  platform = {
    architecture = "string"
    os = "string"
    variant = "string"
  }
  sourceLocation = "string"
  timeout = int
  type = "EncodedTaskRunRequest"
  values = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
}

Verwenden Sie für FileTaskRunRequest:

{
  agentConfiguration = {
    cpu = int
  }
  credentials = {
    customRegistries = {
      {customized property} = {
        identity = "string"
        password = {
          type = "string"
          value = "string"
        }
        userName = {
          type = "string"
          value = "string"
        }
      }
    }
    sourceRegistry = {
      loginMode = "string"
    }
  }
  platform = {
    architecture = "string"
    os = "string"
    variant = "string"
  }
  sourceLocation = "string"
  taskFilePath = "string"
  timeout = int
  type = "FileTaskRunRequest"
  values = [
    {
      isSecret = bool
      name = "string"
      value = "string"
    }
  ]
  valuesFilePath = "string"
}

Verwenden Sie für TaskRunRequest-Folgendes:

{
  overrideTaskStepProperties = {
    arguments = [
      {
        isSecret = bool
        name = "string"
        value = "string"
      }
    ]
    contextPath = "string"
    file = "string"
    target = "string"
    updateTriggerToken = "string"
    values = [
      {
        isSecret = bool
        name = "string"
        value = "string"
      }
    ]
  }
  taskId = "string"
  type = "TaskRunRequest"
}

Eigenschaftswerte

AgentProperties

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

Argument

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

Beglaubigungsschreiben

Name Beschreibung Wert
customRegistries 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.
CredentialsCustomRegistries
sourceRegistry Beschreibt die Anmeldeinformationsparameter für den Zugriff auf die Quellregistrierung. SourceRegistryCredentials-

CredentialsCustomRegistries

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, wird der Wert system. 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
Passwort 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.
SecretObject-
Nutzername Der Benutzername für die Anmeldung bei der benutzerdefinierten Registrierung. SecretObject-

DockerBuildRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen der Ausführung verwendet werden sollen. Argument[]
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
dockerFilePath Der Docker-Dateipfad relativ zum Quellspeicherort. Zeichenfolge (erforderlich)
imageNames Die vollqualifizierten Bildnamen einschließlich Repository und Tag. string[]
isPushEnabled Der Wert dieser Eigenschaft gibt an, ob das erstellte Image an die Registrierung übertragen werden soll. Bool
noCache Der Wert dieser Eigenschaft gibt an, ob der Bildcache aktiviert ist oder nicht. Bool
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. "DockerBuildRequest" (erforderlich)

EncodedTaskRunRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
encodedTaskContent Base64-codierter Wert des Vorlagen-/Definitionsdateiinhalts. Zeichenfolge (erforderlich)
encodedValuesContent Base64-codierter Wert der Parameter/Werte-Dateiinhalte. Schnur
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. "EncodedTaskRunRequest" (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]

FileTaskRunRequest

Name Beschreibung Wert
agentConfiguration Die Computerkonfiguration des Ausführungs-Agents. AgentProperties-
Beglaubigungsschreiben Die Eigenschaften, die einen Satz von Anmeldeinformationen beschreiben, die verwendet werden, wenn diese Ausführung aufgerufen wird. Anmeldeinformationen
Bahnsteig Die Plattformeigenschaften, für die die Ausführung ausgeführt werden muss. PlatformProperties- (erforderlich)
sourceLocation Die URL(absolut oder relativ) des Quellkontexts. Dies kann eine URL zu einem Tar- oder Git-Repository sein.
Wenn es sich um relative URL handelt, sollte der relative Pfad aus der aufrufenden listBuildSourceUploadUrl-API abgerufen werden.
Schnur
taskFilePath Der Dateipfad der Vorlage/Definition relativ zur Quelle. Zeichenfolge (erforderlich)
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

Zwänge:
Min.-Wert = 300
Maximalwert = 28800
Art Der Typ der Ausführungsanforderung. 'FileTaskRunRequest' (erforderlich)
Werte Die Sammlung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]
valuesFilePath Der Dateipfad für Werte/Parameter relativ zur Quelle. Schnur

IdentityProperties

Name Beschreibung Wert
principalId Die Prinzipal-ID der Ressourcenidentität. Schnur
tenantId Die Mandanten-ID der Ressource. Schnur
Art Der Identitätstyp. 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities 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

Microsoft.ContainerRegistry/registries/taskRuns

Name Beschreibung Wert
Identität Identität für die Ressource. IdentityProperties-
Ort Der Speicherort der Ressource Schnur
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 5
Max. Länge = 5
Pattern = ^[a-zA-Z0-9-]*$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Registrierungen
Eigenschaften Die Eigenschaften, die der Aufgabenausführung zugeordnet sind, d. h. Anforderung und Ergebnis der Ausführung TaskRunProperties-
Art Der Ressourcentyp "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"

OverrideTaskStepProperties

Name Beschreibung Wert
Argumente Dient zum Abrufen oder Festlegen der Auflistung von Außerkraftsetzungsargumenten, die verwendet werden sollen, wenn
Ausführen eines Buildschritts.
Argument[]
contextPath Der Quellkontext, für den ausgeführt wird, muss in die Warteschlange gestellt werden. Schnur
Datei Die Datei, für die ausgeführt wird, muss in die Warteschlange gestellt werden. Schnur
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
updateTriggerToken Base64-codiertes Updatetriggertoken, das an den Basisbildtrigger-Webhook angefügt wird. Schnur
Werte Die Auflistung überschreibbarer Werte, die beim Ausführen einer Aufgabe übergeben werden können. SetValue-[]

PlatformProperties

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'

RunRequest

Name Beschreibung Wert
agentPoolName Der dedizierte Agentpool für die Ausführung. Schnur
isArchiveEnabled Der Wert, der angibt, ob die Archivierung für die Ausführung aktiviert ist oder nicht. Bool
logTemplate Die Vorlage, die die Repository- und Taginformationen für das Run-Protokollartefakt beschreibt. Schnur
Art Set to 'DockerBuildRequest' for type DockerBuildRequest. Legen Sie für den Typ EncodedTaskRunRequestauf "EncodedTaskRunRequest" fest. Legen Sie für den Typ FileTaskRunRequest-auf "FileTaskRunRequest" fest. Legen Sie für den Typ TaskRunRequest-auf "TaskRunRequest" fest. "DockerBuildRequest"
"EncodedTaskRunRequest"
'FileTaskRunRequest'
'TaskRunRequest' (erforderlich)

SecretObject

Name Beschreibung Wert
Art Der Typ des geheimen Objekts, das bestimmt, wie der Wert des geheimen Objekts sein muss
interpretiert.
"Undurchsichtig"
'Vaultsecret'
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

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

SourceRegistryCredentials

Name Beschreibung Wert
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'
'None'

TaskRunProperties

Name Beschreibung Wert
forceUpdateTag Wie die Ausführung erzwungen werden soll, auch wenn sich die Ausführungsanforderungskonfiguration nicht geändert hat Schnur
runRequest Die Anforderung (Parameter) für die Ausführung RunRequest-

TaskRunRequest

Name Beschreibung Wert
overrideTaskStepProperties Set of overridable parameters that can be passed when running a Task. OverrideTaskStepProperties
taskId Die Ressourcen-ID des Vorgangs, für den ausgeführt wird, muss in die Warteschlange gestellt werden. Zeichenfolge (erforderlich)
Art Der Typ der Ausführungsanforderung. 'TaskRunRequest' (erforderlich)

UserIdentityProperties

Name Beschreibung Wert
clientId Die Client-ID der vom Benutzer zugewiesenen Identität. Schnur
principalId Die Prinzipal-ID der vom Benutzer zugewiesenen Identität. Schnur