Delen via


Microsoft.ContainerRegistry-registers/taskRuns

Bicep-resourcedefinitie

Het resourcetype registers/taskRuns kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource Microsoft.ContainerRegistry/registries/taskRuns wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview' = {
  name: 'string'
  location: 'string'
  parent: resourceSymbolicName
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    forceUpdateTag: 'string'
    runRequest: {
      agentPoolName: 'string'
      isArchiveEnabled: bool
      logTemplate: 'string'
      type: 'string'
      // For remaining properties, see RunRequest objects
    }
  }
}

RunRequest-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor DockerBuildRequest:

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

Voor EncodedTaskRunRequest gebruikt u:

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

Gebruik voor FileTaskRunRequest:

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

Gebruik voor TaskRunRequest:

  type: 'TaskRunRequest'
  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'

Eigenschapswaarden

registers/taakUitvoeren

Naam Beschrijving Waarde
naam De resourcenaam

Meer informatie over het instellen van namen en typen voor onderliggende resources in Bicep.
tekenreeks (vereist)
location De locatie van de resource tekenreeks
Bovenliggende In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie Onderliggende resource buiten bovenliggende resource voor meer informatie.
Symbolische naam voor resource van het type: registers
identity Identiteit voor de resource. IdentityProperties
properties De eigenschappen die zijn gekoppeld aan de taakuitvoering, d.w.w.v. aanvraag en resultaat van de uitvoering TaskRunProperties

IdentityProperties

Naam Beschrijving Waarde
principalId De principal-id van de resource-id. tekenreeks
tenantId De tenant-id van de resource. tekenreeks
type Het identiteitstype. 'Geen'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit
Sleutelverwijzingen in woordenlijst zijn ARM-resource-id's in de vorm:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
object

TaskRunProperties

Naam Beschrijving Waarde
forceUpdateTag Hoe de uitvoering moet worden gedwongen opnieuw uit te voeren, zelfs als de configuratie van de uitvoeringsaanvraag niet is gewijzigd tekenreeks
runRequest De aanvraag (parameters) voor de uitvoering RunRequest

RunRequest

Naam Beschrijving Waarde
agentPoolName De toegewezen agentpool voor de uitvoering. tekenreeks
isArchiveEnabled De waarde die aangeeft of archivering is ingeschakeld voor de uitvoering of niet. booleaans
logTemplate De sjabloon waarmee de opslagplaats en taggegevens voor het uitvoeren van logboekartefacten worden beschreven. tekenreeks
type Het objecttype instellen DockerBuildRequest
EncodedTaskRunRequest
FileTaskRunRequest
TaskRunRequest (vereist)

DockerBuildRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'DockerBuildRequest' (vereist)
agentConfiguration De computerconfiguratie van de run-agent. AgentEigenschappen
Argumenten De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van de uitvoering. Argument[]
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
dockerFilePath Het Pad van het Docker-bestand ten opzichte van de bronlocatie. tekenreeks (vereist)
imageNames De volledig gekwalificeerde installatiekopieën, inclusief de opslagplaats en tag. tekenreeks[]
isPushEnabled De waarde van deze eigenschap geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht of niet. booleaans
noCache De waarde van deze eigenschap geeft aan of de afbeeldingscache is ingeschakeld of niet. booleaans
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformProperties (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een tar- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden opgehaald uit het aanroepen van listBuildSourceUploadUrl API.
tekenreeks
Doel De naam van de doelbuildfase voor de Docker-build. tekenreeks
timeout Time-out in seconden uitvoeren. int

AgentEigenschappen

Naam Beschrijving Waarde
Cpu De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering. int

Argument

Naam Beschrijving Waarde
isSecret Vlag om aan te geven of het argument een geheim vertegenwoordigt en uit buildlogboeken wilt worden verwijderd. booleaans
naam De naam van het argument. tekenreeks (vereist)
waarde De waarde van het argument. tekenreeks (vereist)

Referenties

Naam Beschrijving Waarde
customRegistries Beschrijft de referentieparameters voor toegang tot andere aangepaste registers. De sleutel
voor het woordenlijstitem is de registeraanmeldingsserver (myregistry.azurecr.io) en
de waarde van het item is de registerreferenties voor toegang tot het register.
object
sourceRegistry Beschrijft de referentieparameters voor toegang tot het bronregister. SourceRegistryCredentials

SourceRegistryCredentials

Naam Beschrijving Waarde
loginMode De verificatiemodus die het aanmeldingsbereik van het bronregister bepaalt. De referenties voor het bronregister
wordt gegenereerd met behulp van het opgegeven bereik. Deze referenties worden gebruikt om u aan te melden bij
het bronregister tijdens de uitvoering.
'Standaard'
'Geen'

PlatformEigenschappen

Naam Beschrijving Waarde
architectuur De architectuur van het besturingssysteem. '386'
'amd64'
'arm'
'arm64'
'x86'
os Het type besturingssysteem dat is vereist voor de uitvoering. 'Linux'
'Windows' (vereist)
Variant Variant van de CPU. 'v6'
'v7'
'v8'

EncodedTaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'EncodedTaskRunRequest' (vereist)
agentConfiguration De computerconfiguratie van de run-agent. AgentEigenschappen
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
encodedTaskContent Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. tekenreeks (vereist)
encodedValuesContent Base64 gecodeerde waarde van de inhoud van het parameter-/waardenbestand. tekenreeks
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformProperties (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een tar- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden opgehaald uit het aanroepen van listBuildSourceUploadUrl API.
tekenreeks
timeout Time-out in seconden uitvoeren. int
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

Waardeinstellen

Naam Beschrijving Waarde
isSecret Vlag om aan te geven of de waarde een geheim vertegenwoordigt of niet. booleaans
naam De naam van de overschrijfbare waarde. tekenreeks (vereist)
waarde De overschrijfbare waarde. tekenreeks (vereist)

FileTaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'FileTaskRunRequest' (vereist)
agentConfiguration De computerconfiguratie van de run-agent. AgentEigenschappen
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformProperties (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een tar- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden opgehaald uit het aanroepen van listBuildSourceUploadUrl API.
tekenreeks
taskFilePath Het pad naar het sjabloon-/definitiebestand ten opzichte van de bron. tekenreeks (vereist)
timeout Time-out in seconden uitvoeren. int
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]
valuesFilePath Het bestandspad waarden/parameters ten opzichte van de bron. tekenreeks

TaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'TaskRunRequest' (vereist)
overrideTaskStepProperties Set van overschrijfbare parameters die kunnen worden doorgegeven bij het uitvoeren van een taak. OverrideTaskStepProperties
Taskid De resource-id van de taak waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks (vereist)

OverrideTaskStepProperties

Naam Beschrijving Waarde
Argumenten Hiermee wordt de verzameling onderdrukkingsargumenten opgehaald of ingesteld die moeten worden gebruikt wanneer
het uitvoeren van een build-stap.
Argument[]
contextPath De broncontext waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks
file Het bestand waarvoor wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks
Doel De naam van de doelbuildfase voor de Docker-build. tekenreeks
updateTriggerToken Met Base64 gecodeerde updatetriggertoken dat wordt gekoppeld aan de webhook van de basisinstallatiekopieëntrigger. tekenreeks
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

Resourcedefinitie van ARM-sjabloon

Het resourcetype registers/taskRuns kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource Microsoft.ContainerRegistry/registries/taskRuns wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

RunRequest-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor DockerBuildRequest:

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

Voor EncodedTaskRunRequest gebruikt u:

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

Gebruik voor FileTaskRunRequest:

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

Voor TaskRunRequest gebruikt u:

  "type": "TaskRunRequest",
  "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"

Eigenschapswaarden

registers/taskRuns

Naam Beschrijving Waarde
type Het resourcetype 'Microsoft.ContainerRegistry/registries/taskRuns'
apiVersion De resource-API-versie '2019-06-01-preview'
naam De resourcenaam

Meer informatie over het instellen van namen en typen voor onderliggende resources in JSON ARM-sjablonen.
tekenreeks (vereist)
location De locatie van de resource tekenreeks
identity Identiteit voor de resource. IdentityProperties
properties De eigenschappen die zijn gekoppeld aan de taakuitvoering, dat wil zeggen aanvraag en resultaat van de uitvoering TaskRunProperties

IdentityProperties

Naam Beschrijving Waarde
principalId De principal-id van resource-id. tekenreeks
tenantId De tenant-id van de resource. tekenreeks
type Het identiteitstype. 'Geen'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit
Sleutelverwijzingen in de woordenlijst zijn ARM-resource-id's in de vorm:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
object

TaskRunProperties

Naam Beschrijving Waarde
forceUpdateTag Hoe de uitvoering moet worden gedwongen opnieuw uit te voeren, zelfs als de configuratie van de uitvoeringsaanvraag niet is gewijzigd tekenreeks
runRequest De aanvraag (parameters) voor de uitvoering RunRequest

RunRequest

Naam Beschrijving Waarde
agentPoolName De toegewezen agentpool voor de uitvoering. tekenreeks
isArchiveEnabled De waarde die aangeeft of archivering is ingeschakeld voor de uitvoering of niet. booleaans
logTemplate De sjabloon waarmee de opslagplaats en taggegevens voor het uitvoeren van logboekartefacten worden beschreven. tekenreeks
type Het objecttype instellen DockerBuildRequest
EncodedTaskRunRequest
FileTaskRunRequest
TaskRunRequest (vereist)

DockerBuildRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. DockerBuildRequest (vereist)
agentConfiguration De computerconfiguratie van de run-agent. AgentEigenschappen
Argumenten De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van de uitvoering. Argument[]
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
dockerFilePath Het Pad van het Docker-bestand ten opzichte van de bronlocatie. tekenreeks (vereist)
imageNames De volledig gekwalificeerde installatiekopieën, inclusief de opslagplaats en tag. tekenreeks[]
isPushEnabled De waarde van deze eigenschap geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht of niet. booleaans
noCache De waarde van deze eigenschap geeft aan of de afbeeldingscache is ingeschakeld of niet. booleaans
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformProperties (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een tar- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden opgehaald uit het aanroepen van listBuildSourceUploadUrl API.
tekenreeks
Doel De naam van de doelbuildfase voor de Docker-build. tekenreeks
timeout Time-out in seconden uitvoeren. int

AgentEigenschappen

Naam Beschrijving Waarde
Cpu De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering. int

Argument

Naam Beschrijving Waarde
isSecret Vlag om aan te geven of het argument een geheim vertegenwoordigt en uit buildlogboeken wilt worden verwijderd. booleaans
naam De naam van het argument. tekenreeks (vereist)
waarde De waarde van het argument. tekenreeks (vereist)

Referenties

Naam Beschrijving Waarde
customRegistries Beschrijft de referentieparameters voor toegang tot andere aangepaste registers. De sleutel
voor het woordenlijstitem is de registeraanmeldingsserver (myregistry.azurecr.io) en
de waarde van het item is de registerreferenties voor toegang tot het register.
object
sourceRegistry Beschrijft de referentieparameters voor toegang tot het bronregister. SourceRegistryCredentials

SourceRegistryCredentials

Naam Beschrijving Waarde
loginMode De verificatiemodus die het aanmeldingsbereik van het bronregister bepaalt. De referenties voor het bronregister
wordt gegenereerd met behulp van het opgegeven bereik. Deze referenties worden gebruikt om u aan te melden bij
het bronregister tijdens de uitvoering.
'Standaard'
'Geen'

PlatformEigenschappen

Naam Beschrijving Waarde
architectuur De architectuur van het besturingssysteem. '386'
'amd64'
'arm'
'arm64'
'x86'
os Het type besturingssysteem dat is vereist voor de uitvoering. 'Linux'
'Windows' (vereist)
Variant Variant van de CPU. 'v6'
'v7'
'v8'

EncodedTaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'EncodedTaskRunRequest' (vereist)
agentConfiguration De computerconfiguratie van de uitvoeringsagent. Eigenschappen van agent
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
encodedTaskContent Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. tekenreeks (vereist)
encodedValuesContent Base64 gecodeerde waarde van de inhoud van het bestand parameters/waarden. tekenreeks
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een TAR- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden verkregen door listBuildSourceUploadUrl API aan te roepen.
tekenreeks
timeout Time-out voor uitvoering in seconden. int
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

Waardeinstellen

Naam Beschrijving Waarde
isSecret Vlag om aan te geven of de waarde een geheim vertegenwoordigt of niet. booleaans
naam De naam van de overschrijfbare waarde. tekenreeks (vereist)
waarde De overschrijfbare waarde. tekenreeks (vereist)

FileTaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'FileTaskRunRequest' (vereist)
agentConfiguration De computerconfiguratie van de uitvoeringsagent. Eigenschappen van agent
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een TAR- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden verkregen door listBuildSourceUploadUrl API aan te roepen.
tekenreeks
taskFilePath Het pad naar het sjabloon-/definitiebestand ten opzichte van de bron. tekenreeks (vereist)
timeout Time-out voor uitvoering in seconden. int
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]
valuesFilePath Het bestandspad voor waarden/parameters ten opzichte van de bron. tekenreeks

TaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. 'TaskRunRequest' (vereist)
overrideTaskStepProperties Set overschrijfbare parameters die kunnen worden doorgegeven bij het uitvoeren van een taak. OverrideTaskStepProperties
Taskid De resource-id van de taak waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks (vereist)

OverrideTaskStepProperties

Naam Beschrijving Waarde
Argumenten Hiermee wordt de verzameling onderdrukkingsargumenten opgehaald of ingesteld die moeten worden gebruikt wanneer
het uitvoeren van een build-stap.
Argument[]
contextPath De broncontext waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks
file Het bestand waarvoor wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks
Doel De naam van de doelbuildfase voor de Docker-build. tekenreeks
updateTriggerToken Met Base64 gecodeerde updatetriggertoken dat wordt gekoppeld aan de webhook van de basisinstallatiekopieëntrigger. tekenreeks
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype registers/taskRuns kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource Microsoft.ContainerRegistry/registries/taskRuns wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

RunRequest-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor DockerBuildRequest:

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

Voor EncodedTaskRunRequest gebruikt u:

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

Gebruik voor FileTaskRunRequest:

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

Voor TaskRunRequest gebruikt u:

  type = "TaskRunRequest"
  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"

Eigenschapswaarden

registers/taskRuns

Naam Beschrijving Waarde
type Het resourcetype "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"
naam De resourcenaam tekenreeks (vereist)
location De locatie van de resource tekenreeks
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: registers
identity Identiteit voor de resource. IdentityProperties
properties De eigenschappen die zijn gekoppeld aan de taakuitvoering, dat wil zeggen aanvraag en resultaat van de uitvoering TaskRunProperties

IdentityProperties

Naam Beschrijving Waarde
type Het identiteitstype. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit
Sleutelverwijzingen in de woordenlijst zijn ARM-resource-id's in de vorm:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Matrix met gebruikersidentiteits-id's.

TaskRunProperties

Naam Beschrijving Waarde
forceUpdateTag Hoe de uitvoering moet worden gedwongen opnieuw uit te voeren, zelfs als de configuratie van de uitvoeringsaanvraag niet is gewijzigd tekenreeks
runRequest De aanvraag (parameters) voor de uitvoering RunRequest

RunRequest

Naam Beschrijving Waarde
agentPoolName De toegewezen agentpool voor de uitvoering. tekenreeks
isArchiveEnabled De waarde die aangeeft of archivering is ingeschakeld voor de uitvoering of niet. booleaans
logTemplate De sjabloon waarmee de opslagplaats en taggegevens voor het uitvoeren van logboekartefacten worden beschreven. tekenreeks
type Het objecttype instellen DockerBuildRequest
EncodedTaskRunRequest
FileTaskRunRequest
TaskRunRequest (vereist)

DockerBuildRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. "DockerBuildRequest" (vereist)
agentConfiguration De computerconfiguratie van de run-agent. AgentEigenschappen
Argumenten De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van de uitvoering. Argument[]
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
dockerFilePath Het Pad van het Docker-bestand ten opzichte van de bronlocatie. tekenreeks (vereist)
imageNames De volledig gekwalificeerde installatiekopieën, inclusief de opslagplaats en tag. tekenreeks[]
isPushEnabled De waarde van deze eigenschap geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht of niet. booleaans
noCache De waarde van deze eigenschap geeft aan of de afbeeldingscache is ingeschakeld of niet. booleaans
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformProperties (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een tar- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden opgehaald uit het aanroepen van listBuildSourceUploadUrl API.
tekenreeks
Doel De naam van de doelbuildfase voor de Docker-build. tekenreeks
timeout Time-out in seconden uitvoeren. int

AgentEigenschappen

Naam Beschrijving Waarde
Cpu De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering. int

Argument

Naam Beschrijving Waarde
isSecret Vlag om aan te geven of het argument een geheim vertegenwoordigt en uit buildlogboeken wilt worden verwijderd. booleaans
naam De naam van het argument. tekenreeks (vereist)
waarde De waarde van het argument. tekenreeks (vereist)

Referenties

Naam Beschrijving Waarde
customRegistries Beschrijft de referentieparameters voor toegang tot andere aangepaste registers. De sleutel
voor het woordenlijstitem is de registeraanmeldingsserver (myregistry.azurecr.io) en
de waarde van het item is de registerreferenties voor toegang tot het register.
object
sourceRegistry Beschrijft de referentieparameters voor toegang tot het bronregister. SourceRegistryCredentials

SourceRegistryCredentials

Naam Beschrijving Waarde
loginMode De verificatiemodus die het aanmeldingsbereik van het bronregister bepaalt. De referenties voor het bronregister
wordt gegenereerd met behulp van het opgegeven bereik. Deze referenties worden gebruikt om u aan te melden bij
het bronregister tijdens de uitvoering.
"Standaard"
"Geen"

PlatformEigenschappen

Naam Beschrijving Waarde
architectuur De architectuur van het besturingssysteem. "386"
"amd64"
"arm"
"arm64"
"x86"
os Het type besturingssysteem dat is vereist voor de uitvoering. "Linux"
"Windows" (vereist)
Variant Variant van de CPU. "v6"
"v7"
"v8"

EncodedTaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. "EncodedTaskRunRequest" (vereist)
agentConfiguration De computerconfiguratie van de uitvoeringsagent. Eigenschappen van agent
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
encodedTaskContent Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. tekenreeks (vereist)
encodedValuesContent Base64 gecodeerde waarde van de inhoud van het bestand parameters/waarden. tekenreeks
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een TAR- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden verkregen door listBuildSourceUploadUrl API aan te roepen.
tekenreeks
timeout Time-out voor uitvoering in seconden. int
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

Waardeinstellen

Naam Beschrijving Waarde
isSecret Vlag om aan te geven of de waarde een geheim vertegenwoordigt of niet. booleaans
naam De naam van de overschrijfbare waarde. tekenreeks (vereist)
waarde De overschrijfbare waarde. tekenreeks (vereist)

FileTaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. "FileTaskRunRequest" (vereist)
agentConfiguration De computerconfiguratie van de uitvoeringsagent. Eigenschappen van agent
referenties De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
platform De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen (vereist)
sourceLocation De URL (absoluut of relatief) van de broncontext. Dit kan een URL zijn naar een TAR- of Git-opslagplaats.
Als het een relatieve URL is, moet het relatieve pad worden verkregen door listBuildSourceUploadUrl API aan te roepen.
tekenreeks
taskFilePath Het pad naar het sjabloon-/definitiebestand ten opzichte van de bron. tekenreeks (vereist)
timeout Time-out voor uitvoering in seconden. int
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]
valuesFilePath Het bestandspad voor waarden/parameters ten opzichte van de bron. tekenreeks

TaskRunRequest

Naam Beschrijving Waarde
type Het type van de uitvoeringsaanvraag. "TaskRunRequest" (vereist)
overrideTaskStepProperties Set overschrijfbare parameters die kunnen worden doorgegeven bij het uitvoeren van een taak. OverrideTaskStepProperties
Taskid De resource-id van de taak waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks (vereist)

OverrideTaskStepProperties

Naam Beschrijving Waarde
Argumenten Hiermee wordt de verzameling onderdrukkingsargumenten opgehaald of ingesteld die moeten worden gebruikt wanneer
het uitvoeren van een build-stap.
Argument[]
contextPath De broncontext waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks
file Het bestand waarvoor de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst. tekenreeks
Doel De naam van de doelbuildfase voor de docker-build. tekenreeks
updateTriggerToken Met Base64 gecodeerde updatetriggertoken dat wordt gekoppeld aan de webhook van de trigger van de basisinstallatiekopieën. tekenreeks
values De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]