Freigeben über


Microsoft.ContainerRegistry-Registrierungen/Aufgaben 2018-09-01

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@2018-09-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    agentConfiguration: {
      cpu: int
    }
    credentials: {
      customRegistries: {
        {customized property}: {
          password: {
            type: 'string'
            value: 'string'
          }
          userName: {
            type: 'string'
            value: 'string'
          }
        }
      }
      sourceRegistry: {
        loginMode: 'string'
      }
    }
    platform: {
      architecture: 'string'
      os: 'string'
      variant: 'string'
    }
    status: 'string'
    step: {
      contextAccessToken: 'string'
      contextPath: 'string'
      type: 'string'
      // For remaining properties, see TaskStepProperties objects
    }
    timeout: int
    trigger: {
      baseImageTrigger: {
        baseImageTriggerType: 'string'
        name: 'string'
        status: 'string'
      }
      sourceTriggers: [
        {
          name: 'string'
          sourceRepository: {
            branch: 'string'
            repositoryUrl: 'string'
            sourceControlAuthProperties: {
              expiresIn: int
              refreshToken: 'string'
              scope: 'string'
              token: 'string'
              tokenType: 'string'
            }
            sourceControlType: 'string'
          }
          sourceTriggerEvents: [
            'string'
          ]
          status: 'string'
        }
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

TaskStepProperties-Objekte

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

Verwenden Sie für Docker-:

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

Verwenden Sie für EncodedTask-:

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

Verwenden Sie für FileTask-:

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

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)

AuthInfo

Name Beschreibung Wert
expiresIn 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
Zeichen 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"

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
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-

DockerBuildStep

Name Beschreibung Wert
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen dieses Buildschritts verwendet werden sollen. Argument[]
dockerFilePath Der Docker-Dateipfad relativ zum Quellkontext. 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
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Art Der Typ des Schritts. "Docker" (erforderlich)

EncodedTaskStep

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

FileTaskStep

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

Microsoft.ContainerRegistry/registries/tasks

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Dies kann nicht geändert werden, nachdem die Ressource erstellt wurde. Zeichenfolge (erforderlich)
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 eines Vorgangs. TaskProperties-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

PlatformProperties

Name Beschreibung Wert
Architektur Die Betriebssystemarchitektur. "amd64"
"Arm"
'x86'
Os Der betriebssystemtyp, der für die Ausführung erforderlich ist. "Linux"
"Windows" (erforderlich)
Variante Variante der CPU. 'v6'
'v7'
'v8'

ResourceTags

Name Beschreibung Wert

SecretObject

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

SourceProperties

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
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'

SourceTrigger

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

TaskProperties

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)
Status Der aktuelle Status der Aufgabe. "Deaktiviert"
"Aktiviert"
Schritt Die Eigenschaften eines Vorgangsschritts. TaskStepProperties- (erforderlich)
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

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

TaskStepProperties

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 Die URL(absolut oder relativ) des Quellkontexts für den Vorgangsschritt. Schnur
Art Set to 'Docker' for type DockerBuildStep. Legen Sie für den Typ EncodedTaskStepauf "EncodedTaskStep" fest. Legen Sie für den Typ FileTaskStepauf "FileTaskStep" fest. "Docker"
"EncodedTask"
'FileTask' (erforderlich)

TriggerProperties

Name Beschreibung Wert
baseImageTrigger Der Trigger basierend auf Basisbildabhängigkeiten. BaseImageTrigger-
sourceTriggers Die Sammlung von Triggern basierend auf dem Quellcode-Repository. SourceTrigger-[]

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": "2018-09-01",
  "name": "string",
  "location": "string",
  "properties": {
    "agentConfiguration": {
      "cpu": "int"
    },
    "credentials": {
      "customRegistries": {
        "{customized property}": {
          "password": {
            "type": "string",
            "value": "string"
          },
          "userName": {
            "type": "string",
            "value": "string"
          }
        }
      },
      "sourceRegistry": {
        "loginMode": "string"
      }
    },
    "platform": {
      "architecture": "string",
      "os": "string",
      "variant": "string"
    },
    "status": "string",
    "step": {
      "contextAccessToken": "string",
      "contextPath": "string",
      "type": "string"
      // For remaining properties, see TaskStepProperties objects
    },
    "timeout": "int",
    "trigger": {
      "baseImageTrigger": {
        "baseImageTriggerType": "string",
        "name": "string",
        "status": "string"
      },
      "sourceTriggers": [
        {
          "name": "string",
          "sourceRepository": {
            "branch": "string",
            "repositoryUrl": "string",
            "sourceControlAuthProperties": {
              "expiresIn": "int",
              "refreshToken": "string",
              "scope": "string",
              "token": "string",
              "tokenType": "string"
            },
            "sourceControlType": "string"
          },
          "sourceTriggerEvents": [ "string" ],
          "status": "string"
        }
      ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

TaskStepProperties-Objekte

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

Verwenden Sie für Docker-:

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

Verwenden Sie für EncodedTask-:

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

Verwenden Sie für FileTask-:

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

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)

AuthInfo

Name Beschreibung Wert
expiresIn 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
Zeichen 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"

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
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-

DockerBuildStep

Name Beschreibung Wert
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen dieses Buildschritts verwendet werden sollen. Argument[]
dockerFilePath Der Docker-Dateipfad relativ zum Quellkontext. 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
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Art Der Typ des Schritts. "Docker" (erforderlich)

EncodedTaskStep

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

FileTaskStep

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

Microsoft.ContainerRegistry/registries/tasks

Name Beschreibung Wert
apiVersion Die API-Version '2018-09-01'
Ort Der Speicherort der Ressource. Dies kann nicht geändert werden, nachdem die Ressource erstellt wurde. Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

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

PlatformProperties

Name Beschreibung Wert
Architektur Die Betriebssystemarchitektur. "amd64"
"Arm"
'x86'
Os Der betriebssystemtyp, der für die Ausführung erforderlich ist. "Linux"
"Windows" (erforderlich)
Variante Variante der CPU. 'v6'
'v7'
'v8'

ResourceTags

Name Beschreibung Wert

SecretObject

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

SourceProperties

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
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'

SourceTrigger

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

TaskProperties

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)
Status Der aktuelle Status der Aufgabe. "Deaktiviert"
"Aktiviert"
Schritt Die Eigenschaften eines Vorgangsschritts. TaskStepProperties- (erforderlich)
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

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

TaskStepProperties

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 Die URL(absolut oder relativ) des Quellkontexts für den Vorgangsschritt. Schnur
Art Set to 'Docker' for type DockerBuildStep. Legen Sie für den Typ EncodedTaskStepauf "EncodedTaskStep" fest. Legen Sie für den Typ FileTaskStepauf "FileTaskStep" fest. "Docker"
"EncodedTask"
'FileTask' (erforderlich)

TriggerProperties

Name Beschreibung Wert
baseImageTrigger Der Trigger basierend auf Basisbildabhängigkeiten. BaseImageTrigger-
sourceTriggers Die Sammlung von Triggern basierend auf dem Quellcode-Repository. SourceTrigger-[]

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@2018-09-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      agentConfiguration = {
        cpu = int
      }
      credentials = {
        customRegistries = {
          {customized property} = {
            password = {
              type = "string"
              value = "string"
            }
            userName = {
              type = "string"
              value = "string"
            }
          }
        }
        sourceRegistry = {
          loginMode = "string"
        }
      }
      platform = {
        architecture = "string"
        os = "string"
        variant = "string"
      }
      status = "string"
      step = {
        contextAccessToken = "string"
        contextPath = "string"
        type = "string"
        // For remaining properties, see TaskStepProperties objects
      }
      timeout = int
      trigger = {
        baseImageTrigger = {
          baseImageTriggerType = "string"
          name = "string"
          status = "string"
        }
        sourceTriggers = [
          {
            name = "string"
            sourceRepository = {
              branch = "string"
              repositoryUrl = "string"
              sourceControlAuthProperties = {
                expiresIn = int
                refreshToken = "string"
                scope = "string"
                token = "string"
                tokenType = "string"
              }
              sourceControlType = "string"
            }
            sourceTriggerEvents = [
              "string"
            ]
            status = "string"
          }
        ]
      }
    }
  })
}

TaskStepProperties-Objekte

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

Verwenden Sie für Docker-:

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

Verwenden Sie für EncodedTask-:

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

Verwenden Sie für FileTask-:

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

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)

AuthInfo

Name Beschreibung Wert
expiresIn 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
Zeichen 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"

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
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-

DockerBuildStep

Name Beschreibung Wert
Argumente Die Auflistung der Außerkraftsetzungsargumente, die beim Ausführen dieses Buildschritts verwendet werden sollen. Argument[]
dockerFilePath Der Docker-Dateipfad relativ zum Quellkontext. 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
Ziel Der Name der Zielbuildstufe für den Docker-Build. Schnur
Art Der Typ des Schritts. "Docker" (erforderlich)

EncodedTaskStep

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

FileTaskStep

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

Microsoft.ContainerRegistry/registries/tasks

Name Beschreibung Wert
Ort Der Speicherort der Ressource. Dies kann nicht geändert werden, nachdem die Ressource erstellt wurde. Zeichenfolge (erforderlich)
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 eines Vorgangs. TaskProperties-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.ContainerRegistry/registries/tasks@2018-09-01"

PlatformProperties

Name Beschreibung Wert
Architektur Die Betriebssystemarchitektur. "amd64"
"Arm"
'x86'
Os Der betriebssystemtyp, der für die Ausführung erforderlich ist. "Linux"
"Windows" (erforderlich)
Variante Variante der CPU. 'v6'
'v7'
'v8'

ResourceTags

Name Beschreibung Wert

SecretObject

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

SourceProperties

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
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'

SourceTrigger

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

TaskProperties

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)
Status Der aktuelle Status der Aufgabe. "Deaktiviert"
"Aktiviert"
Schritt Die Eigenschaften eines Vorgangsschritts. TaskStepProperties- (erforderlich)
Zeitüberschreitung Laufzeittimeout in Sekunden. Int

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

TaskStepProperties

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 Die URL(absolut oder relativ) des Quellkontexts für den Vorgangsschritt. Schnur
Art Set to 'Docker' for type DockerBuildStep. Legen Sie für den Typ EncodedTaskStepauf "EncodedTaskStep" fest. Legen Sie für den Typ FileTaskStepauf "FileTaskStep" fest. "Docker"
"EncodedTask"
'FileTask' (erforderlich)

TriggerProperties

Name Beschreibung Wert
baseImageTrigger Der Trigger basierend auf Basisbildabhängigkeiten. BaseImageTrigger-
sourceTriggers Die Sammlung von Triggern basierend auf dem Quellcode-Repository. SourceTrigger-[]