Microsoft.ContainerRegistry-registers/taskRuns

Artikel
12/21/2024

Bicep-resourcedefinitie

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

Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

Zie logboek wijzigenvoor 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' = {
  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-objecten

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

Gebruik voor DockerBuildRequest:

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

Gebruik voor EncodedTaskRunRequest:

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

Gebruik voor FileTaskRunRequest:

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

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

Eigenschapswaarden

AgentProperties

Naam	Beschrijving	Waarde
CPU	De CPU-configuratie in termen van het aantal kernen dat nodig is 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.	Bool
naam	De naam van het argument.	tekenreeks (vereist)
waarde	De waarde van het argument.	tekenreeks (vereist)

Geloofsbrief

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.	CredentialsCustomRegistries
sourceRegistry	Beschrijft de referentieparameters voor toegang tot het bronregister.	SourceRegistryCredentials

CredentialsCustomRegistries

Naam	Beschrijving	Waarde

CustomRegistryCredentials

Naam	Beschrijving	Waarde
identiteit	Geeft de beheerde identiteit aan die is toegewezen aan de aangepaste referentie. Als een door de gebruiker toegewezen identiteit deze waarde is de client-id. Als een door het systeem toegewezen identiteit, wordt de waarde `system`. In in het geval van een door het systeem toegewezen identiteit wordt de client-id bepaald door de runner. Dit identiteit kan worden gebruikt om te verifiëren bij de sleutelkluis om referenties op te halen of het is mogelijk de enige bron van verificatie die wordt gebruikt voor toegang tot het register.	snaar
wachtwoord	Het wachtwoord voor het aanmelden bij het aangepaste register. Het wachtwoord is een geheim object dat meerdere manieren biedt om de waarde voor het object op te geven.	SecretObject-
userName	De gebruikersnaam voor het aanmelden bij het aangepaste register.	SecretObject-

DockerBuildRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
Argumenten	De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van de uitvoering.	argument[]
geloofsbrief	De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen.	referenties
dockerFilePath	Het Pad naar het Docker-bestand ten opzichte van de bronlocatie.	tekenreeks (vereist)
imageNames	De volledig gekwalificeerde namen van 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.	Bool
noCache	De waarde van deze eigenschap geeft aan of de afbeeldingscache al dan niet is ingeschakeld.	Bool
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
doel	De naam van de doelbuildfase voor de docker-build.	snaar
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	'DockerBuildRequest' (vereist)

EncodedTaskRunRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
geloofsbrief	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 bestandsinhoud met parameters/waarden.	snaar
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	'EncodedTaskRunRequest' (vereist)
waarden	De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]

FileTaskRunRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
geloofsbrief	De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen.	referenties
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
taskFilePath	Het pad naar het sjabloon-/definitiebestand ten opzichte van de bron.	tekenreeks (vereist)
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	FileTaskRunRequest (vereist)
waarden	De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]
valuesFilePath	Het bestandspad waarden/parameters ten opzichte van de bron.	snaar

IdentityProperties

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

IdentityPropertiesUserAssignedIdentities

Naam	Beschrijving	Waarde

Microsoft.ContainerRegistry/registries/taskRuns

Naam	Beschrijving	Waarde
identiteit	Identiteit voor de resource.	IdentityProperties-
plaats	De locatie van de resource	snaar
naam	De resourcenaam	snaar Beperkingen: Minimale lengte = 5 Maximale lengte = 50 Patroon = `^[a-zA-Z0-9-]*$` (vereist)
ouder	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 de bovenliggende resourcevoor meer informatie.	Symbolische naam voor resource van het type: registers
Eigenschappen	De eigenschappen die zijn gekoppeld aan de taakuitvoering, bijvoorbeeld aanvraag en resultaat van de uitvoering	TaskRunProperties-

OverrideTaskStepProperties

Naam	Beschrijving	Waarde
Argumenten	Hiermee wordt de verzameling onderdrukkingsargumenten opgevraagd of ingesteld die moeten worden gebruikt wanneer een buildstap uitvoeren.	argument[]
contextPath	De broncontext waarmee de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst.	snaar
bestand	Het bestand waarop de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst.	snaar
doel	De naam van de doelbuildfase voor de docker-build.	snaar
updateTriggerToken	Met Base64 gecodeerde updatetriggertoken dat wordt gekoppeld aan de webhook van de basisinstallatiekopieëntrigger.	snaar
waarden	De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]

PlatformProperties

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

RunRequest

Naam	Beschrijving	Waarde
agentPoolName	De toegewezen agentpool voor de uitvoering.	snaar
isArchiveEnabled	De waarde die aangeeft of archivering is ingeschakeld voor de uitvoering of niet.	Bool
logTemplate	De sjabloon die de opslagplaats en taggegevens beschrijft voor het uitvoeren van logboekartefacten.	snaar
type	Ingesteld op 'DockerBuildRequest' voor het type DockerBuildRequest. Ingesteld op 'EncodedTaskRunRequest' voor het type EncodedTaskRunRequest. Ingesteld op FileTaskRunRequest voor het type FileTaskRunRequest. Ingesteld op TaskRunRequest voor het type TaskRunRequest.	'DockerBuildRequest' 'EncodedTaskRunRequest' 'FileTaskRunRequest' TaskRunRequest (vereist)

SecretObject

Naam	Beschrijving	Waarde
type	Het type geheimobject dat bepaalt hoe de waarde van het geheime object moet zijn Geïnterpreteerd.	'Ondoorzichtig' 'Vaultsecret'
waarde	De waarde van het geheim. De notatie van deze waarde wordt bepaald gebaseerd op het type geheimobject. Als het type ondoorzichtig is, is de waarde gebruikt als zonder enige wijziging.	snaar

SetValue

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

SourceRegistryCredentials

Naam	Beschrijving	Waarde
loginMode	De verificatiemodus waarmee het aanmeldingsbereik van het bronregister wordt bepaald. 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'

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	snaar
runRequest	De aanvraag (parameters) voor de uitvoering	RunRequest-

TaskRunRequest

Naam	Beschrijving	Waarde
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 moet worden uitgevoerd, moet in de wachtrij worden geplaatst.	tekenreeks (vereist)
type	Het type van de uitvoeringsaanvraag.	TaskRunRequest (vereist)

UserIdentityProperties

Naam	Beschrijving	Waarde
clientId	De client-id van de door de gebruiker toegewezen identiteit.	snaar
principalId	De principal-id van de door de gebruiker toegewezen identiteit.	snaar

Resourcedefinitie van ARM-sjabloon

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

Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

Zie logboek wijzigenvoor 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",
  "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-objecten

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

Gebruik voor DockerBuildRequest:

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

Gebruik voor EncodedTaskRunRequest:

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

Gebruik voor FileTaskRunRequest:

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

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

Eigenschapswaarden

AgentProperties

Naam	Beschrijving	Waarde
CPU	De CPU-configuratie in termen van het aantal kernen dat nodig is 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.	Bool
naam	De naam van het argument.	tekenreeks (vereist)
waarde	De waarde van het argument.	tekenreeks (vereist)

Geloofsbrief

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.	CredentialsCustomRegistries
sourceRegistry	Beschrijft de referentieparameters voor toegang tot het bronregister.	SourceRegistryCredentials

CredentialsCustomRegistries

Naam	Beschrijving	Waarde

CustomRegistryCredentials

Naam	Beschrijving	Waarde
identiteit	Geeft de beheerde identiteit aan die is toegewezen aan de aangepaste referentie. Als een door de gebruiker toegewezen identiteit deze waarde is de client-id. Als een door het systeem toegewezen identiteit, wordt de waarde `system`. In in het geval van een door het systeem toegewezen identiteit wordt de client-id bepaald door de runner. Dit identiteit kan worden gebruikt om te verifiëren bij de sleutelkluis om referenties op te halen of het is mogelijk de enige bron van verificatie die wordt gebruikt voor toegang tot het register.	snaar
wachtwoord	Het wachtwoord voor het aanmelden bij het aangepaste register. Het wachtwoord is een geheim object dat meerdere manieren biedt om de waarde voor het object op te geven.	SecretObject-
userName	De gebruikersnaam voor het aanmelden bij het aangepaste register.	SecretObject-

DockerBuildRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
Argumenten	De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van de uitvoering.	argument[]
geloofsbrief	De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen.	referenties
dockerFilePath	Het Pad naar het Docker-bestand ten opzichte van de bronlocatie.	tekenreeks (vereist)
imageNames	De volledig gekwalificeerde namen van 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.	Bool
noCache	De waarde van deze eigenschap geeft aan of de afbeeldingscache al dan niet is ingeschakeld.	Bool
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
doel	De naam van de doelbuildfase voor de docker-build.	snaar
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	'DockerBuildRequest' (vereist)

EncodedTaskRunRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
geloofsbrief	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 bestandsinhoud met parameters/waarden.	snaar
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	'EncodedTaskRunRequest' (vereist)
waarden	De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]

FileTaskRunRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
geloofsbrief	De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen.	referenties
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
taskFilePath	Het pad naar het sjabloon-/definitiebestand ten opzichte van de bron.	tekenreeks (vereist)
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	FileTaskRunRequest (vereist)
waarden	De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]
valuesFilePath	Het bestandspad waarden/parameters ten opzichte van de bron.	snaar

IdentityProperties

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

IdentityPropertiesUserAssignedIdentities

Naam	Beschrijving	Waarde

Microsoft.ContainerRegistry/registries/taskRuns

Naam	Beschrijving	Waarde
apiVersion	De API-versie	'2019-06-01-preview'
identiteit	Identiteit voor de resource.	IdentityProperties-
plaats	De locatie van de resource	snaar
naam	De resourcenaam	snaar Beperkingen: Minimale lengte = 5 Maximale lengte = 50 Patroon = `^[a-zA-Z0-9-]*$` (vereist)
Eigenschappen	De eigenschappen die zijn gekoppeld aan de taakuitvoering, bijvoorbeeld aanvraag en resultaat van de uitvoering	TaskRunProperties-
type	Het resourcetype	'Microsoft.ContainerRegistry/registries/taskRuns'

OverrideTaskStepProperties

Naam	Beschrijving	Waarde
Argumenten	Hiermee wordt de verzameling onderdrukkingsargumenten opgevraagd of ingesteld die moeten worden gebruikt wanneer een buildstap uitvoeren.	argument[]
contextPath	De broncontext waarmee de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst.	snaar
bestand	Het bestand waarop de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst.	snaar
doel	De naam van de doelbuildfase voor de docker-build.	snaar
updateTriggerToken	Met Base64 gecodeerde updatetriggertoken dat wordt gekoppeld aan de webhook van de basisinstallatiekopieëntrigger.	snaar
waarden	De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]

PlatformProperties

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

RunRequest

Naam	Beschrijving	Waarde
agentPoolName	De toegewezen agentpool voor de uitvoering.	snaar
isArchiveEnabled	De waarde die aangeeft of archivering is ingeschakeld voor de uitvoering of niet.	Bool
logTemplate	De sjabloon die de opslagplaats en taggegevens beschrijft voor het uitvoeren van logboekartefacten.	snaar
type	Ingesteld op 'DockerBuildRequest' voor het type DockerBuildRequest. Ingesteld op 'EncodedTaskRunRequest' voor het type EncodedTaskRunRequest. Ingesteld op FileTaskRunRequest voor het type FileTaskRunRequest. Ingesteld op TaskRunRequest voor het type TaskRunRequest.	'DockerBuildRequest' 'EncodedTaskRunRequest' 'FileTaskRunRequest' TaskRunRequest (vereist)

SecretObject

Naam	Beschrijving	Waarde
type	Het type geheimobject dat bepaalt hoe de waarde van het geheime object moet zijn Geïnterpreteerd.	'Ondoorzichtig' 'Vaultsecret'
waarde	De waarde van het geheim. De notatie van deze waarde wordt bepaald gebaseerd op het type geheimobject. Als het type ondoorzichtig is, is de waarde gebruikt als zonder enige wijziging.	snaar

SetValue

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

SourceRegistryCredentials

Naam	Beschrijving	Waarde
loginMode	De verificatiemodus waarmee het aanmeldingsbereik van het bronregister wordt bepaald. 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'

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	snaar
runRequest	De aanvraag (parameters) voor de uitvoering	RunRequest-

TaskRunRequest

Naam	Beschrijving	Waarde
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 moet worden uitgevoerd, moet in de wachtrij worden geplaatst.	tekenreeks (vereist)
type	Het type van de uitvoeringsaanvraag.	TaskRunRequest (vereist)

UserIdentityProperties

Naam	Beschrijving	Waarde
clientId	De client-id van de door de gebruiker toegewezen identiteit.	snaar
principalId	De principal-id van de door de gebruiker toegewezen identiteit.	snaar

Gebruiksvoorbeelden

Resourcedefinitie van Terraform (AzAPI-provider)

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

resourcegroepen

Zie logboek wijzigenvoor 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"
  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-objecten

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

Gebruik voor DockerBuildRequest:

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

Gebruik voor EncodedTaskRunRequest:

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

Gebruik voor FileTaskRunRequest:

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

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

Eigenschapswaarden

AgentProperties

Naam	Beschrijving	Waarde
CPU	De CPU-configuratie in termen van het aantal kernen dat nodig is 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.	Bool
naam	De naam van het argument.	tekenreeks (vereist)
waarde	De waarde van het argument.	tekenreeks (vereist)

Geloofsbrief

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.	CredentialsCustomRegistries
sourceRegistry	Beschrijft de referentieparameters voor toegang tot het bronregister.	SourceRegistryCredentials

CredentialsCustomRegistries

Naam	Beschrijving	Waarde

CustomRegistryCredentials

Naam	Beschrijving	Waarde
identiteit	Geeft de beheerde identiteit aan die is toegewezen aan de aangepaste referentie. Als een door de gebruiker toegewezen identiteit deze waarde is de client-id. Als een door het systeem toegewezen identiteit, wordt de waarde `system`. In in het geval van een door het systeem toegewezen identiteit wordt de client-id bepaald door de runner. Dit identiteit kan worden gebruikt om te verifiëren bij de sleutelkluis om referenties op te halen of het is mogelijk de enige bron van verificatie die wordt gebruikt voor toegang tot het register.	snaar
wachtwoord	Het wachtwoord voor het aanmelden bij het aangepaste register. Het wachtwoord is een geheim object dat meerdere manieren biedt om de waarde voor het object op te geven.	SecretObject-
userName	De gebruikersnaam voor het aanmelden bij het aangepaste register.	SecretObject-

DockerBuildRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
Argumenten	De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van de uitvoering.	argument[]
geloofsbrief	De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen.	referenties
dockerFilePath	Het Pad naar het Docker-bestand ten opzichte van de bronlocatie.	tekenreeks (vereist)
imageNames	De volledig gekwalificeerde namen van 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.	Bool
noCache	De waarde van deze eigenschap geeft aan of de afbeeldingscache al dan niet is ingeschakeld.	Bool
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
doel	De naam van de doelbuildfase voor de docker-build.	snaar
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	'DockerBuildRequest' (vereist)

EncodedTaskRunRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
geloofsbrief	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 bestandsinhoud met parameters/waarden.	snaar
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	'EncodedTaskRunRequest' (vereist)
waarden	De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]

FileTaskRunRequest

Naam	Beschrijving	Waarde
agentConfiguration	De computerconfiguratie van de uitvoeringsagent.	AgentProperties-
geloofsbrief	De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen.	referenties
perron	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 verkregen bij het aanroepen van listBuildSourceUploadUrl-API.	snaar
taskFilePath	Het pad naar het sjabloon-/definitiebestand ten opzichte van de bron.	tekenreeks (vereist)
Timeout	Time-out in seconden uitvoeren.	Int Beperkingen: Minimumwaarde = 300 Maximumwaarde = 28800
type	Het type van de uitvoeringsaanvraag.	FileTaskRunRequest (vereist)
waarden	De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]
valuesFilePath	Het bestandspad waarden/parameters ten opzichte van de bron.	snaar

IdentityProperties

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

IdentityPropertiesUserAssignedIdentities

Naam	Beschrijving	Waarde

Microsoft.ContainerRegistry/registries/taskRuns

Naam	Beschrijving	Waarde
identiteit	Identiteit voor de resource.	IdentityProperties-
plaats	De locatie van de resource	snaar
naam	De resourcenaam	snaar Beperkingen: Minimale lengte = 5 Maximale lengte = 50 Patroon = `^[a-zA-Z0-9-]*$` (vereist)
parent_id	De id van de resource die het bovenliggende item voor deze resource is.	Id voor resource van het type: registers
Eigenschappen	De eigenschappen die zijn gekoppeld aan de taakuitvoering, bijvoorbeeld aanvraag en resultaat van de uitvoering	TaskRunProperties-
type	Het resourcetype	"Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"

OverrideTaskStepProperties

Naam	Beschrijving	Waarde
Argumenten	Hiermee wordt de verzameling onderdrukkingsargumenten opgevraagd of ingesteld die moeten worden gebruikt wanneer een buildstap uitvoeren.	argument[]
contextPath	De broncontext waarmee de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst.	snaar
bestand	Het bestand waarop de uitvoering wordt uitgevoerd, moet in de wachtrij worden geplaatst.	snaar
doel	De naam van de doelbuildfase voor de docker-build.	snaar
updateTriggerToken	Met Base64 gecodeerde updatetriggertoken dat wordt gekoppeld aan de webhook van de basisinstallatiekopieëntrigger.	snaar
waarden	De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak.	SetValue[]

PlatformProperties

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

RunRequest

Naam	Beschrijving	Waarde
agentPoolName	De toegewezen agentpool voor de uitvoering.	snaar
isArchiveEnabled	De waarde die aangeeft of archivering is ingeschakeld voor de uitvoering of niet.	Bool
logTemplate	De sjabloon die de opslagplaats en taggegevens beschrijft voor het uitvoeren van logboekartefacten.	snaar
type	Ingesteld op 'DockerBuildRequest' voor het type DockerBuildRequest. Ingesteld op 'EncodedTaskRunRequest' voor het type EncodedTaskRunRequest. Ingesteld op FileTaskRunRequest voor het type FileTaskRunRequest. Ingesteld op TaskRunRequest voor het type TaskRunRequest.	'DockerBuildRequest' 'EncodedTaskRunRequest' 'FileTaskRunRequest' TaskRunRequest (vereist)

SecretObject

Naam	Beschrijving	Waarde
type	Het type geheimobject dat bepaalt hoe de waarde van het geheime object moet zijn Geïnterpreteerd.	'Ondoorzichtig' 'Vaultsecret'
waarde	De waarde van het geheim. De notatie van deze waarde wordt bepaald gebaseerd op het type geheimobject. Als het type ondoorzichtig is, is de waarde gebruikt als zonder enige wijziging.	snaar

SetValue

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

SourceRegistryCredentials

Naam	Beschrijving	Waarde
loginMode	De verificatiemodus waarmee het aanmeldingsbereik van het bronregister wordt bepaald. 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'

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	snaar
runRequest	De aanvraag (parameters) voor de uitvoering	RunRequest-

TaskRunRequest

Naam	Beschrijving	Waarde
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 moet worden uitgevoerd, moet in de wachtrij worden geplaatst.	tekenreeks (vereist)
type	Het type van de uitvoeringsaanvraag.	TaskRunRequest (vereist)

UserIdentityProperties

Naam	Beschrijving	Waarde
clientId	De client-id van de door de gebruiker toegewezen identiteit.	snaar
principalId	De principal-id van de door de gebruiker toegewezen identiteit.	snaar

Delen via

Microsoft.ContainerRegistry-registers/taskRuns

Bicep-resourcedefinitie

Resource-indeling

RunRequest-objecten

Eigenschapswaarden

AgentProperties

Argument

Geloofsbrief

CredentialsCustomRegistries

CustomRegistryCredentials

DockerBuildRequest

EncodedTaskRunRequest

FileTaskRunRequest

IdentityProperties

IdentityPropertiesUserAssignedIdentities

Microsoft.ContainerRegistry/registries/taskRuns

OverrideTaskStepProperties

PlatformProperties

RunRequest

SecretObject

SetValue

SourceRegistryCredentials

TaskRunProperties

TaskRunRequest

UserIdentityProperties

Resourcedefinitie van ARM-sjabloon

Resource-indeling

RunRequest-objecten

Eigenschapswaarden

AgentProperties

Argument

Geloofsbrief

CredentialsCustomRegistries

CustomRegistryCredentials

DockerBuildRequest

EncodedTaskRunRequest

FileTaskRunRequest

IdentityProperties

IdentityPropertiesUserAssignedIdentities

Microsoft.ContainerRegistry/registries/taskRuns

OverrideTaskStepProperties

PlatformProperties

RunRequest

SecretObject

SetValue

SourceRegistryCredentials

TaskRunProperties

TaskRunRequest

UserIdentityProperties

Gebruiksvoorbeelden

Resourcedefinitie van Terraform (AzAPI-provider)

Resource-indeling

RunRequest-objecten

Eigenschapswaarden

AgentProperties

Argument

Geloofsbrief

CredentialsCustomRegistries

CustomRegistryCredentials

DockerBuildRequest

EncodedTaskRunRequest

FileTaskRunRequest

IdentityProperties

IdentityPropertiesUserAssignedIdentities

Microsoft.ContainerRegistry/registries/taskRuns

OverrideTaskStepProperties

PlatformProperties

RunRequest

SecretObject

SetValue

SourceRegistryCredentials

TaskRunProperties

TaskRunRequest

UserIdentityProperties

Feedback

Aanvullende resources