Dela via


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

Bicep-resursdefinition

Resurstypen register/taskRuns kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ContainerRegistry/registries/taskRuns-resurs lägger du till följande Bicep i mallen.

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

Ange egenskapen typ för att ange typ av objekt.

För DockerBuildRequest-använder du:

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

För EncodedTaskRunRequestanvänder du:

{
  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'
    }
  ]
}

För FileTaskRunRequest-använder du:

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

För TaskRunRequest-använder du:

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

Egenskapsvärden

AgentEgenskaper

Namn Beskrivning Värde
processor Cpu-konfigurationen när det gäller antalet kärnor som krävs för körningen. Int

Argument

Namn Beskrivning Värde
isSecret Flagga för att ange om argumentet representerar en hemlighet och vill tas bort från byggloggarna. Bool
Namn Namnet på argumentet. sträng (krävs)
värde Argumentets värde. sträng (krävs)

Autentiseringsuppgifter

Namn Beskrivning Värde
customRegistries Beskriver parametrarna för autentiseringsuppgifter för åtkomst till andra anpassade register. Nyckeln
för ordlisteobjektet är registerinloggningsservern (myregistry.azurecr.io) och
värdet för objektet är registerautentiseringsuppgifterna för åtkomst till registret.
CredentialsCustomRegistries
sourceRegistry Beskriver parametrarna för autentiseringsuppgifter för åtkomst till källregistret. SourceRegistryCredentials

CredentialsCustomRegistries

Namn Beskrivning Värde

CustomRegistryCredentials

Namn Beskrivning Värde
identitet Anger den hanterade identitet som tilldelats till den anpassade autentiseringsuppgiften. Om en användartilldelad identitet
det här värdet är klient-ID:t. Om en systemtilldelad identitet blir värdet system. I
när det gäller en systemtilldelad identitet bestäms klient-ID:t av löparen. Denna
identitet kan användas för att autentisera till nyckelvalvet för att hämta autentiseringsuppgifter eller det kan vara den enda
källa för autentisering som används för att komma åt registret.
sträng
lösenord Lösenordet för att logga in i det anpassade registret. Lösenordet är en hemlighet
objekt som tillåter flera sätt att ange värdet för det.
SecretObject
userName Användarnamnet för att logga in i det anpassade registret. SecretObject

DockerBuildRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Argument Samlingen med åsidosättningsargument som ska användas när körningen körs. Argument[]
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
dockerFilePath Docker-filsökvägen i förhållande till källplatsen. sträng (krävs)
imageNames De fullständigt kvalificerade avbildningsnamnen, inklusive lagringsplatsen och taggen. string[]
isPushEnabled Värdet för den här egenskapen anger om avbildningen som skapats ska push-överföras till registret eller inte. Bool
noCache Värdet för den här egenskapen anger om avbildningscachen är aktiverad eller inte. Bool
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
mål Namnet på målversionssteget för docker-versionen. sträng
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "DockerBuildRequest" (krävs)

EncodedTaskRunRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
encodedTaskContent Base64-kodat värde för mall-/definitionsfilinnehållet. sträng (krävs)
encodedValuesContent Base64-kodat värde för filinnehållet parametrar/värden. sträng
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "EncodedTaskRunRequest" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]

FileTaskRunRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
taskFilePath Sökvägen till mallen/definitionsfilen i förhållande till källan. sträng (krävs)
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "FileTaskRunRequest" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]
valuesFilePath Filsökvägen för värden/parametrar i förhållande till källan. sträng

IdentityProperties

Namn Beskrivning Värde
principalId Huvud-ID för resursidentitet. sträng
tenantId Resursens klientorganisations-ID. sträng
typ Identitetstypen. "Ingen"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Listan över användaridentiteter som är associerade med resursen. Användaridentiteten
ordlistenyckelreferenser är ARM-resurs-ID:t i formuläret:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentiteter

IdentityPropertiesUserAssignedIdentiteter

Namn Beskrivning Värde

Microsoft.ContainerRegistry/registries/taskRuns

Namn Beskrivning Värde
identitet Identitet för resursen. IdentityProperties
plats Platsen för resursen sträng
Namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Max längd = 5
Mönster = ^[a-zA-Z0-9-]*$ (krävs)
förälder I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.
Symboliskt namn för resurs av typen: register
Egenskaper Egenskaperna som är associerade med aktivitetskörningen, d.v.s. begäran och resultatet av körningen TaskRunProperties

OverrideTaskStepProperties

Namn Beskrivning Värde
Argument Hämtar eller ställer in samlingen med åsidosättningsargument som ska användas när
utföra ett byggsteg.
Argument[]
contextPath Källkontexten mot vilken körningen måste placeras i kö. sträng
fil Filen som körningen ska köras mot måste placeras i kö. sträng
mål Namnet på målversionssteget för docker-versionen. sträng
updateTriggerToken Base64-kodad uppdateringsutlösartoken som ska kopplas till webhooken för basavbildningsutlösaren. sträng
värden Samlingen med åsidosättbara värden som kan skickas när en aktivitet körs. SetValue[]

PlatformProperties

Namn Beskrivning Värde
arkitektur OS-arkitekturen. '386'
"amd64"
"arm"
"arm64"
"x86"
ås Den operativsystemtyp som krävs för körningen. "Linux"
"Windows" (krävs)
variant Variant av processorn. "v6"
"v7"
"v8"

RunRequest

Namn Beskrivning Värde
agentPoolName Den dedikerade agentpoolen för körningen. sträng
isArchiveEnabled Värdet som anger om arkivering är aktiverat för körningen eller inte. Bool
logTemplate Mallen som beskriver lagringsplatsen och tagginformationen för körningsloggartefakt. sträng
typ Ange till DockerBuildRequest för typen DockerBuildRequest. Ange till "EncodedTaskRunRequest" för typen EncodedTaskRunRequest. Ange till "FileTaskRunRequest" för typen FileTaskRunRequest. Ange till TaskRunRequest för typen TaskRunRequest. "DockerBuildRequest"
"EncodedTaskRunRequest"
"FileTaskRunRequest"
"TaskRunRequest" (krävs)

SecretObject

Namn Beskrivning Värde
typ Typen av det hemliga objektet som avgör hur värdet för det hemliga objektet måste vara
Tolkas.
"Ogenomskinlig"
"Vaultsecret"
värde Hemlighetens värde. Formatet för det här värdet bestäms
baserat på typen av det hemliga objektet. Om typen är Ogenomskinlig blir värdet
används som den är utan någon ändring.
sträng

SetValue

Namn Beskrivning Värde
isSecret Flagga för att ange om värdet representerar en hemlighet eller inte. Bool
Namn Namnet på det åsidosättande värdet. sträng (krävs)
värde Det övergripande värdet. sträng (krävs)

SourceRegistryCredentials

Namn Beskrivning Värde
loginMode Autentiseringsläget som avgör källregistrets inloggningsomfång. Autentiseringsuppgifterna för källregistret
genereras med det angivna omfånget. Dessa autentiseringsuppgifter används för att logga in på
källregistret under körningen.
"Standard"
"Ingen"

TaskRunProperties

Namn Beskrivning Värde
forceUpdateTag Hur körningen ska tvingas köras igen även om konfigurationen för körningsbegäran inte har ändrats sträng
runRequest Begäran (parametrar) för körningen RunRequest

TaskRunRequest

Namn Beskrivning Värde
overrideTaskStepProperties Uppsättning åsidosättbara parametrar som kan skickas när en aktivitet körs. OverrideTaskStepProperties
taskId Resurs-ID:t för den aktivitet som körningen ska placeras i kö mot. sträng (krävs)
typ Typ av körningsbegäran. "TaskRunRequest" (krävs)

UserIdentityProperties

Namn Beskrivning Värde
clientId Klient-ID för användartilldelad identitet. sträng
principalId Huvud-ID för användartilldelad identitet. sträng

Resursdefinition för ARM-mall

Resurstypen register/taskRuns kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ContainerRegistry/registries/taskRuns-resurs lägger du till följande JSON i mallen.

{
  "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-objekt

Ange egenskapen typ för att ange typ av objekt.

För DockerBuildRequest-använder du:

{
  "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"
}

För EncodedTaskRunRequestanvänder du:

{
  "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"
    }
  ]
}

För FileTaskRunRequest-använder du:

{
  "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"
}

För TaskRunRequest-använder du:

{
  "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"
}

Egenskapsvärden

AgentEgenskaper

Namn Beskrivning Värde
processor Cpu-konfigurationen när det gäller antalet kärnor som krävs för körningen. Int

Argument

Namn Beskrivning Värde
isSecret Flagga för att ange om argumentet representerar en hemlighet och vill tas bort från byggloggarna. Bool
Namn Namnet på argumentet. sträng (krävs)
värde Argumentets värde. sträng (krävs)

Autentiseringsuppgifter

Namn Beskrivning Värde
customRegistries Beskriver parametrarna för autentiseringsuppgifter för åtkomst till andra anpassade register. Nyckeln
för ordlisteobjektet är registerinloggningsservern (myregistry.azurecr.io) och
värdet för objektet är registerautentiseringsuppgifterna för åtkomst till registret.
CredentialsCustomRegistries
sourceRegistry Beskriver parametrarna för autentiseringsuppgifter för åtkomst till källregistret. SourceRegistryCredentials

CredentialsCustomRegistries

Namn Beskrivning Värde

CustomRegistryCredentials

Namn Beskrivning Värde
identitet Anger den hanterade identitet som tilldelats till den anpassade autentiseringsuppgiften. Om en användartilldelad identitet
det här värdet är klient-ID:t. Om en systemtilldelad identitet blir värdet system. I
när det gäller en systemtilldelad identitet bestäms klient-ID:t av löparen. Denna
identitet kan användas för att autentisera till nyckelvalvet för att hämta autentiseringsuppgifter eller det kan vara den enda
källa för autentisering som används för att komma åt registret.
sträng
lösenord Lösenordet för att logga in i det anpassade registret. Lösenordet är en hemlighet
objekt som tillåter flera sätt att ange värdet för det.
SecretObject
userName Användarnamnet för att logga in i det anpassade registret. SecretObject

DockerBuildRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Argument Samlingen med åsidosättningsargument som ska användas när körningen körs. Argument[]
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
dockerFilePath Docker-filsökvägen i förhållande till källplatsen. sträng (krävs)
imageNames De fullständigt kvalificerade avbildningsnamnen, inklusive lagringsplatsen och taggen. string[]
isPushEnabled Värdet för den här egenskapen anger om avbildningen som skapats ska push-överföras till registret eller inte. Bool
noCache Värdet för den här egenskapen anger om avbildningscachen är aktiverad eller inte. Bool
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
mål Namnet på målversionssteget för docker-versionen. sträng
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "DockerBuildRequest" (krävs)

EncodedTaskRunRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
encodedTaskContent Base64-kodat värde för mall-/definitionsfilinnehållet. sträng (krävs)
encodedValuesContent Base64-kodat värde för filinnehållet parametrar/värden. sträng
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "EncodedTaskRunRequest" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]

FileTaskRunRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
taskFilePath Sökvägen till mallen/definitionsfilen i förhållande till källan. sträng (krävs)
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "FileTaskRunRequest" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]
valuesFilePath Filsökvägen för värden/parametrar i förhållande till källan. sträng

IdentityProperties

Namn Beskrivning Värde
principalId Huvud-ID för resursidentitet. sträng
tenantId Resursens klientorganisations-ID. sträng
typ Identitetstypen. "Ingen"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Listan över användaridentiteter som är associerade med resursen. Användaridentiteten
ordlistenyckelreferenser är ARM-resurs-ID:t i formuläret:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentiteter

IdentityPropertiesUserAssignedIdentiteter

Namn Beskrivning Värde

Microsoft.ContainerRegistry/registries/taskRuns

Namn Beskrivning Värde
apiVersion API-versionen "2019-06-01-preview"
identitet Identitet för resursen. IdentityProperties
plats Platsen för resursen sträng
Namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Max längd = 5
Mönster = ^[a-zA-Z0-9-]*$ (krävs)
Egenskaper Egenskaperna som är associerade med aktivitetskörningen, d.v.s. begäran och resultatet av körningen TaskRunProperties
typ Resurstypen "Microsoft.ContainerRegistry/registries/taskRuns"

OverrideTaskStepProperties

Namn Beskrivning Värde
Argument Hämtar eller ställer in samlingen med åsidosättningsargument som ska användas när
utföra ett byggsteg.
Argument[]
contextPath Källkontexten mot vilken körningen måste placeras i kö. sträng
fil Filen som körningen ska köras mot måste placeras i kö. sträng
mål Namnet på målversionssteget för docker-versionen. sträng
updateTriggerToken Base64-kodad uppdateringsutlösartoken som ska kopplas till webhooken för basavbildningsutlösaren. sträng
värden Samlingen med åsidosättbara värden som kan skickas när en aktivitet körs. SetValue[]

PlatformProperties

Namn Beskrivning Värde
arkitektur OS-arkitekturen. '386'
"amd64"
"arm"
"arm64"
"x86"
ås Den operativsystemtyp som krävs för körningen. "Linux"
"Windows" (krävs)
variant Variant av processorn. "v6"
"v7"
"v8"

RunRequest

Namn Beskrivning Värde
agentPoolName Den dedikerade agentpoolen för körningen. sträng
isArchiveEnabled Värdet som anger om arkivering är aktiverat för körningen eller inte. Bool
logTemplate Mallen som beskriver lagringsplatsen och tagginformationen för körningsloggartefakt. sträng
typ Ange till DockerBuildRequest för typen DockerBuildRequest. Ange till "EncodedTaskRunRequest" för typen EncodedTaskRunRequest. Ange till "FileTaskRunRequest" för typen FileTaskRunRequest. Ange till TaskRunRequest för typen TaskRunRequest. "DockerBuildRequest"
"EncodedTaskRunRequest"
"FileTaskRunRequest"
"TaskRunRequest" (krävs)

SecretObject

Namn Beskrivning Värde
typ Typen av det hemliga objektet som avgör hur värdet för det hemliga objektet måste vara
Tolkas.
"Ogenomskinlig"
"Vaultsecret"
värde Hemlighetens värde. Formatet för det här värdet bestäms
baserat på typen av det hemliga objektet. Om typen är Ogenomskinlig blir värdet
används som den är utan någon ändring.
sträng

SetValue

Namn Beskrivning Värde
isSecret Flagga för att ange om värdet representerar en hemlighet eller inte. Bool
Namn Namnet på det åsidosättande värdet. sträng (krävs)
värde Det övergripande värdet. sträng (krävs)

SourceRegistryCredentials

Namn Beskrivning Värde
loginMode Autentiseringsläget som avgör källregistrets inloggningsomfång. Autentiseringsuppgifterna för källregistret
genereras med det angivna omfånget. Dessa autentiseringsuppgifter används för att logga in på
källregistret under körningen.
"Standard"
"Ingen"

TaskRunProperties

Namn Beskrivning Värde
forceUpdateTag Hur körningen ska tvingas köras igen även om konfigurationen för körningsbegäran inte har ändrats sträng
runRequest Begäran (parametrar) för körningen RunRequest

TaskRunRequest

Namn Beskrivning Värde
overrideTaskStepProperties Uppsättning åsidosättbara parametrar som kan skickas när en aktivitet körs. OverrideTaskStepProperties
taskId Resurs-ID:t för den aktivitet som körningen ska placeras i kö mot. sträng (krävs)
typ Typ av körningsbegäran. "TaskRunRequest" (krävs)

UserIdentityProperties

Namn Beskrivning Värde
clientId Klient-ID för användartilldelad identitet. sträng
principalId Huvud-ID för användartilldelad identitet. sträng

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen register/taskRuns kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ContainerRegistry/registries/taskRuns-resurs lägger du till följande Terraform i mallen.

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

Ange egenskapen typ för att ange typ av objekt.

För DockerBuildRequest-använder du:

{
  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"
}

För EncodedTaskRunRequestanvänder du:

{
  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"
    }
  ]
}

För FileTaskRunRequest-använder du:

{
  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"
}

För TaskRunRequest-använder du:

{
  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"
}

Egenskapsvärden

AgentEgenskaper

Namn Beskrivning Värde
processor Cpu-konfigurationen när det gäller antalet kärnor som krävs för körningen. Int

Argument

Namn Beskrivning Värde
isSecret Flagga för att ange om argumentet representerar en hemlighet och vill tas bort från byggloggarna. Bool
Namn Namnet på argumentet. sträng (krävs)
värde Argumentets värde. sträng (krävs)

Autentiseringsuppgifter

Namn Beskrivning Värde
customRegistries Beskriver parametrarna för autentiseringsuppgifter för åtkomst till andra anpassade register. Nyckeln
för ordlisteobjektet är registerinloggningsservern (myregistry.azurecr.io) och
värdet för objektet är registerautentiseringsuppgifterna för åtkomst till registret.
CredentialsCustomRegistries
sourceRegistry Beskriver parametrarna för autentiseringsuppgifter för åtkomst till källregistret. SourceRegistryCredentials

CredentialsCustomRegistries

Namn Beskrivning Värde

CustomRegistryCredentials

Namn Beskrivning Värde
identitet Anger den hanterade identitet som tilldelats till den anpassade autentiseringsuppgiften. Om en användartilldelad identitet
det här värdet är klient-ID:t. Om en systemtilldelad identitet blir värdet system. I
när det gäller en systemtilldelad identitet bestäms klient-ID:t av löparen. Denna
identitet kan användas för att autentisera till nyckelvalvet för att hämta autentiseringsuppgifter eller det kan vara den enda
källa för autentisering som används för att komma åt registret.
sträng
lösenord Lösenordet för att logga in i det anpassade registret. Lösenordet är en hemlighet
objekt som tillåter flera sätt att ange värdet för det.
SecretObject
userName Användarnamnet för att logga in i det anpassade registret. SecretObject

DockerBuildRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Argument Samlingen med åsidosättningsargument som ska användas när körningen körs. Argument[]
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
dockerFilePath Docker-filsökvägen i förhållande till källplatsen. sträng (krävs)
imageNames De fullständigt kvalificerade avbildningsnamnen, inklusive lagringsplatsen och taggen. string[]
isPushEnabled Värdet för den här egenskapen anger om avbildningen som skapats ska push-överföras till registret eller inte. Bool
noCache Värdet för den här egenskapen anger om avbildningscachen är aktiverad eller inte. Bool
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
mål Namnet på målversionssteget för docker-versionen. sträng
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "DockerBuildRequest" (krävs)

EncodedTaskRunRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
encodedTaskContent Base64-kodat värde för mall-/definitionsfilinnehållet. sträng (krävs)
encodedValuesContent Base64-kodat värde för filinnehållet parametrar/värden. sträng
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "EncodedTaskRunRequest" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]

FileTaskRunRequest

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. autentiseringsuppgifter
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
sourceLocation URL:en (absolut eller relativ) för källkontexten. Det kan vara en URL till en tjära eller git-lagringsplats.
Om det är relativ URL ska den relativa sökvägen hämtas från anropande LISTBuildSourceUploadUrl API.
sträng
taskFilePath Sökvägen till mallen/definitionsfilen i förhållande till källan. sträng (krävs)
Timeout Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
typ Typ av körningsbegäran. "FileTaskRunRequest" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]
valuesFilePath Filsökvägen för värden/parametrar i förhållande till källan. sträng

IdentityProperties

Namn Beskrivning Värde
principalId Huvud-ID för resursidentitet. sträng
tenantId Resursens klientorganisations-ID. sträng
typ Identitetstypen. "Ingen"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Listan över användaridentiteter som är associerade med resursen. Användaridentiteten
ordlistenyckelreferenser är ARM-resurs-ID:t i formuläret:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentiteter

IdentityPropertiesUserAssignedIdentiteter

Namn Beskrivning Värde

Microsoft.ContainerRegistry/registries/taskRuns

Namn Beskrivning Värde
identitet Identitet för resursen. IdentityProperties
plats Platsen för resursen sträng
Namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Max längd = 5
Mönster = ^[a-zA-Z0-9-]*$ (krävs)
parent_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: register
Egenskaper Egenskaperna som är associerade med aktivitetskörningen, d.v.s. begäran och resultatet av körningen TaskRunProperties
typ Resurstypen "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"

OverrideTaskStepProperties

Namn Beskrivning Värde
Argument Hämtar eller ställer in samlingen med åsidosättningsargument som ska användas när
utföra ett byggsteg.
Argument[]
contextPath Källkontexten mot vilken körningen måste placeras i kö. sträng
fil Filen som körningen ska köras mot måste placeras i kö. sträng
mål Namnet på målversionssteget för docker-versionen. sträng
updateTriggerToken Base64-kodad uppdateringsutlösartoken som ska kopplas till webhooken för basavbildningsutlösaren. sträng
värden Samlingen med åsidosättbara värden som kan skickas när en aktivitet körs. SetValue[]

PlatformProperties

Namn Beskrivning Värde
arkitektur OS-arkitekturen. '386'
"amd64"
"arm"
"arm64"
"x86"
ås Den operativsystemtyp som krävs för körningen. "Linux"
"Windows" (krävs)
variant Variant av processorn. "v6"
"v7"
"v8"

RunRequest

Namn Beskrivning Värde
agentPoolName Den dedikerade agentpoolen för körningen. sträng
isArchiveEnabled Värdet som anger om arkivering är aktiverat för körningen eller inte. Bool
logTemplate Mallen som beskriver lagringsplatsen och tagginformationen för körningsloggartefakt. sträng
typ Ange till DockerBuildRequest för typen DockerBuildRequest. Ange till "EncodedTaskRunRequest" för typen EncodedTaskRunRequest. Ange till "FileTaskRunRequest" för typen FileTaskRunRequest. Ange till TaskRunRequest för typen TaskRunRequest. "DockerBuildRequest"
"EncodedTaskRunRequest"
"FileTaskRunRequest"
"TaskRunRequest" (krävs)

SecretObject

Namn Beskrivning Värde
typ Typen av det hemliga objektet som avgör hur värdet för det hemliga objektet måste vara
Tolkas.
"Ogenomskinlig"
"Vaultsecret"
värde Hemlighetens värde. Formatet för det här värdet bestäms
baserat på typen av det hemliga objektet. Om typen är Ogenomskinlig blir värdet
används som den är utan någon ändring.
sträng

SetValue

Namn Beskrivning Värde
isSecret Flagga för att ange om värdet representerar en hemlighet eller inte. Bool
Namn Namnet på det åsidosättande värdet. sträng (krävs)
värde Det övergripande värdet. sträng (krävs)

SourceRegistryCredentials

Namn Beskrivning Värde
loginMode Autentiseringsläget som avgör källregistrets inloggningsomfång. Autentiseringsuppgifterna för källregistret
genereras med det angivna omfånget. Dessa autentiseringsuppgifter används för att logga in på
källregistret under körningen.
"Standard"
"Ingen"

TaskRunProperties

Namn Beskrivning Värde
forceUpdateTag Hur körningen ska tvingas köras igen även om konfigurationen för körningsbegäran inte har ändrats sträng
runRequest Begäran (parametrar) för körningen RunRequest

TaskRunRequest

Namn Beskrivning Värde
overrideTaskStepProperties Uppsättning åsidosättbara parametrar som kan skickas när en aktivitet körs. OverrideTaskStepProperties
taskId Resurs-ID:t för den aktivitet som körningen ska placeras i kö mot. sträng (krävs)
typ Typ av körningsbegäran. "TaskRunRequest" (krävs)

UserIdentityProperties

Namn Beskrivning Värde
clientId Klient-ID för användartilldelad identitet. sträng
principalId Huvud-ID för användartilldelad identitet. sträng