Delen via


Microsoft.ContainerRegistry-registers/taken 2019-06-01-preview

Bicep-resourcedefinitie

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

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.ContainerRegistry/registers/taken wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@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: {
    agentConfiguration: {
      cpu: int
    }
    agentPoolName: 'string'
    credentials: {
      customRegistries: {
        {customized property}: {
          identity: 'string'
          password: {
            type: 'string'
            value: 'string'
          }
          userName: {
            type: 'string'
            value: 'string'
          }
        }
      }
      sourceRegistry: {
        loginMode: 'string'
      }
    }
    isSystemTask: bool
    logTemplate: 'string'
    platform: {
      architecture: 'string'
      os: 'string'
      variant: 'string'
    }
    status: 'string'
    step: {
      contextAccessToken: 'string'
      contextPath: 'string'
      type: 'string'
      // For remaining properties, see TaskStepProperties objects
    }
    timeout: int
    trigger: {
      baseImageTrigger: {
        baseImageTriggerType: 'string'
        name: 'string'
        status: 'string'
        updateTriggerEndpoint: 'string'
        updateTriggerPayloadType: 'string'
      }
      sourceTriggers: [
        {
          name: 'string'
          sourceRepository: {
            branch: 'string'
            repositoryUrl: 'string'
            sourceControlAuthProperties: {
              expiresIn: int
              refreshToken: 'string'
              scope: 'string'
              token: 'string'
              tokenType: 'string'
            }
            sourceControlType: 'string'
          }
          sourceTriggerEvents: [
            'string'
          ]
          status: 'string'
        }
      ]
      timerTriggers: [
        {
          name: 'string'
          schedule: 'string'
          status: 'string'
        }
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

TaskStepProperties-objecten

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

Gebruik voor Docker:

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

Gebruik voor EncodedTask:

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

Gebruik voor FileTask:

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

Eigenschapswaarden

Microsoft.ContainerRegistry/registries/tasks

Naam Beschrijving Waarde
identiteit Identiteit voor de resource. IdentityProperties-
locatie De locatie van de resource. Dit kan niet worden gewijzigd nadat de resource is gemaakt. tekenreeks (vereist)
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 van een taak. TaskProperties-
etiketten Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

AgentEigenschappen

Naam Beschrijving Waarde
CPU De CPU-configuratie in termen van het aantal kernen dat nodig is voor de uitvoering. int (integer)

Argumentatie

Naam Beschrijving Waarde
isGeheim 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)

AuthInfo

Naam Beschrijving Waarde
vervaltIn Tijd in seconden dat het token geldig blijft int (integer)
vernieuwen Token Het vernieuwingstoken dat wordt gebruikt om het toegangstoken te vernieuwen. touw
omvang Het bereik van het toegangstoken. touw
teken Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider. tekenreeks (vereist)
tokenType Het type verificatietoken. OAuth
'PAT' (vereist)

BaseImageTrigger

Naam Beschrijving Waarde
baseImageTriggerType Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën. 'Alles'
Runtime (vereist)
naam De naam van de trigger. tekenreeks (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'
updateTriggerEindpunt De eindpunt-URL voor het ontvangen van updatetriggers. touw
updateTriggerPayloadType Type nettoladingtekst voor updatetriggers voor basisinstallatiekopieën. 'Standaard'
Token

Inloggegevens

Naam Beschrijving Waarde
aangepaste registers 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
bronRegister Beschrijft de referentieparameters voor toegang tot het bronregister. BronRegistryCredentials

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, is systemde waarde . 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.
touw
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.
GeheimObject
gebruikersnaam De gebruikersnaam voor het aanmelden bij het aangepaste register. GeheimObject

DockerBuildStep

Naam Beschrijving Waarde
Argumenten De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van deze buildstap. Argumentatie
dockerFilePath Het Docker-bestandspad ten opzichte van de broncontext. tekenreeks (vereist)
imageNamen 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
geenCache De waarde van deze eigenschap geeft aan of de afbeeldingscache al dan niet is ingeschakeld. Bool
doel De naam van de doelbuildfase voor de docker-build. touw
soort Het type van de stap. Docker (vereist)

GecodeerdeTaakStap

Naam Beschrijving Waarde
gecodeerdeTaakInhoud Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. tekenreeks (vereist)
gecodeerdeWaardenInhoud Base64 gecodeerde waarde van de bestandsinhoud met parameters/waarden. touw
soort Het type van de stap. 'EncodedTask' (vereist)
waarden De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

FileTaskStep

Naam Beschrijving Waarde
taskFilePath Het pad naar het taaksjabloon/definitiebestand ten opzichte van de broncontext. tekenreeks (vereist)
soort Het type van de stap. FileTask (vereist)
waarden De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]
valuesFilePath Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext. touw

IdentiteitEigenschappen

Naam Beschrijving Waarde
principaalId De principal-id van de resource-id. touw
huurderId De tenant-id van de resource. touw
soort Het identiteitstype. 'Geen'
'Systeem toegewezen'
'Systeemtoegewezen, Gebruikertoegewezen'
UserAssigned
gebruikers-toegewezen identiteiten De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit
Verwijzingen naar woordenlijstsleutels zijn ARM-resource-id's in de vorm:
'/abonnementen/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Naam Beschrijving Waarde

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

Bron Tags

Naam Beschrijving Waarde

GeheimObject

Naam Beschrijving Waarde
soort Het type geheimobject dat bepaalt hoe de waarde van het geheime object moet zijn
Geïnterpreteerd.
'Ondoorzichtig'
'Kluisgeheim'
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.
touw

SetValue instellen

Naam Beschrijving Waarde
isGeheim 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)

BronEigenschappen

Naam Beschrijving Waarde
tak De naam van de vertakking van de broncode. touw
repositoryUrl De volledige URL naar de opslagplaats voor broncode tekenreeks (vereist)
sourceControlAuthProperties De autorisatie-eigenschappen voor toegang tot de broncodeopslagplaats en voor het instellen van
webhooks voor meldingen.
AuthInfo
bronControleType Het type broncodebeheerservice. Github
VisualStudioTeamService (vereist)

BronRegistryCredentials

Naam Beschrijving Waarde
inlogmodus 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'

BronTrigger

Naam Beschrijving Waarde
naam De naam van de trigger. tekenreeks (vereist)
bronRepository De eigenschappen die de broncode(code) voor de taak beschrijven. SourceProperties (vereist)
bronTriggerEvents De bron gebeurtenis die overeenkomt met de trigger. Tekenreeksmatrix met een van de volgende waarden:
'doorvoeren'
'pullrequest' (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'

TaakEigenschappen

Naam Beschrijving Waarde
agentConfiguratie De computerconfiguratie van de uitvoeringsagent. AgentEigenschappen
agentPoolNaam De toegewezen agentpool voor de taak. touw
inloggegevens De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
isSysteemTaak De waarde van deze eigenschap geeft aan of de taakresource een systeemtaak is of niet. Bool
logSjabloon De sjabloon die de opslagplaats en taggegevens beschrijft voor het uitvoeren van logboekartefacten. touw
perron De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen
stand van zaken De huidige status van de taak. 'Uitgeschakeld'
'Ingeschakeld'
stap De eigenschappen van een taakstap. Eigenschappen van TaskStep
tijdslimiet Time-out in seconden uitvoeren. Int

Beperkingen:
Minimumwaarde = 300
Maximumwaarde = 28800
prikkel De eigenschappen die alle triggers voor de taak beschrijven. TriggerProperties-

Eigenschappen van TaskStep

Naam Beschrijving Waarde
contextAccessToken Het token (git PAT of SAS-token van de blob van het opslagaccount) dat is gekoppeld aan de context voor een stap. touw
contextPad De URL (absoluut of relatief) van de broncontext voor de taakstap. touw
soort Ingesteld op Docker voor het type DockerBuildStep. Ingesteld op EncodedTask voor het type EncodedTaskStep. Ingesteld op FileTask voor het type FileTaskStep. 'Dokwerker'
'Gecodeerde taak'
FileTask (vereist)

Wekker

Naam Beschrijving Waarde
naam De naam van de trigger. tekenreeks (vereist)
rooster De CRON-expressie voor de taakplanning tekenreeks (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'

Eigenschappen van triggers

Naam Beschrijving Waarde
baseImageTrigger De trigger op basis van afhankelijkheden van basisinstallatiekopieën. BaseImageTrigger
bronTriggers De verzameling triggers op basis van broncodeopslagplaats. BronTrigger
timerTriggers De verzameling timertriggers. TimerTrigger

UserIdentityProperties

Naam Beschrijving Waarde
cliënt-ID De client-id van de door de gebruiker toegewezen identiteit. touw
principaalId De principal-id van de door de gebruiker toegewezen identiteit. touw

Resourcedefinitie van ARM-sjabloon

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

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

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

{
  "type": "Microsoft.ContainerRegistry/registries/tasks",
  "apiVersion": "2019-06-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "agentConfiguration": {
      "cpu": "int"
    },
    "agentPoolName": "string",
    "credentials": {
      "customRegistries": {
        "{customized property}": {
          "identity": "string",
          "password": {
            "type": "string",
            "value": "string"
          },
          "userName": {
            "type": "string",
            "value": "string"
          }
        }
      },
      "sourceRegistry": {
        "loginMode": "string"
      }
    },
    "isSystemTask": "bool",
    "logTemplate": "string",
    "platform": {
      "architecture": "string",
      "os": "string",
      "variant": "string"
    },
    "status": "string",
    "step": {
      "contextAccessToken": "string",
      "contextPath": "string",
      "type": "string"
      // For remaining properties, see TaskStepProperties objects
    },
    "timeout": "int",
    "trigger": {
      "baseImageTrigger": {
        "baseImageTriggerType": "string",
        "name": "string",
        "status": "string",
        "updateTriggerEndpoint": "string",
        "updateTriggerPayloadType": "string"
      },
      "sourceTriggers": [
        {
          "name": "string",
          "sourceRepository": {
            "branch": "string",
            "repositoryUrl": "string",
            "sourceControlAuthProperties": {
              "expiresIn": "int",
              "refreshToken": "string",
              "scope": "string",
              "token": "string",
              "tokenType": "string"
            },
            "sourceControlType": "string"
          },
          "sourceTriggerEvents": [ "string" ],
          "status": "string"
        }
      ],
      "timerTriggers": [
        {
          "name": "string",
          "schedule": "string",
          "status": "string"
        }
      ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

TaskStepProperties-objecten

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

Gebruik voor Docker:

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

Gebruik voor EncodedTask:

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

Gebruik voor FileTask:

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

Eigenschapswaarden

Microsoft.ContainerRegistry/registries/tasks

Naam Beschrijving Waarde
apiVersion De API-versie '2019-06-01-voorbeschouwing'
identiteit Identiteit voor de resource. IdentityProperties-
locatie De locatie van de resource. Dit kan niet worden gewijzigd nadat de resource is gemaakt. tekenreeks (vereist)
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 50
Patroon = ^[a-zA-Z0-9-_]*$ (vereist)
eigenschappen De eigenschappen van een taak. TaskProperties-
etiketten Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
soort Het brontype 'Microsoft.ContainerRegistry/registers/taken'

AgentEigenschappen

Naam Beschrijving Waarde
CPU De CPU-configuratie in termen van het aantal kernen dat nodig is voor de uitvoering. int (integer)

Argumentatie

Naam Beschrijving Waarde
isGeheim 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)

AuthInfo

Naam Beschrijving Waarde
vervaltIn Tijd in seconden dat het token geldig blijft int (integer)
vernieuwen Token Het vernieuwingstoken dat wordt gebruikt om het toegangstoken te vernieuwen. touw
omvang Het bereik van het toegangstoken. touw
teken Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider. tekenreeks (vereist)
tokenType Het type verificatietoken. OAuth
'PAT' (vereist)

BaseImageTrigger

Naam Beschrijving Waarde
baseImageTriggerType Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën. 'Alles'
Runtime (vereist)
naam De naam van de trigger. tekenreeks (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'
updateTriggerEindpunt De eindpunt-URL voor het ontvangen van updatetriggers. touw
updateTriggerPayloadType Type nettoladingtekst voor updatetriggers voor basisinstallatiekopieën. 'Standaard'
Token

Inloggegevens

Naam Beschrijving Waarde
aangepaste registers 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
bronRegister Beschrijft de referentieparameters voor toegang tot het bronregister. BronRegistryCredentials

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, is systemde waarde . 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.
touw
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.
GeheimObject
gebruikersnaam De gebruikersnaam voor het aanmelden bij het aangepaste register. GeheimObject

DockerBuildStep

Naam Beschrijving Waarde
Argumenten De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van deze buildstap. Argumentatie
dockerFilePath Het Docker-bestandspad ten opzichte van de broncontext. tekenreeks (vereist)
imageNamen 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
geenCache De waarde van deze eigenschap geeft aan of de afbeeldingscache al dan niet is ingeschakeld. Bool
doel De naam van de doelbuildfase voor de docker-build. touw
soort Het type van de stap. Docker (vereist)

GecodeerdeTaakStap

Naam Beschrijving Waarde
gecodeerdeTaakInhoud Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. tekenreeks (vereist)
gecodeerdeWaardenInhoud Base64 gecodeerde waarde van de bestandsinhoud met parameters/waarden. touw
soort Het type van de stap. 'EncodedTask' (vereist)
waarden De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

FileTaskStep

Naam Beschrijving Waarde
taskFilePath Het pad naar het taaksjabloon/definitiebestand ten opzichte van de broncontext. tekenreeks (vereist)
soort Het type van de stap. FileTask (vereist)
waarden De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]
valuesFilePath Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext. touw

IdentiteitEigenschappen

Naam Beschrijving Waarde
principaalId De principal-id van de resource-id. touw
huurderId De tenant-id van de resource. touw
soort Het identiteitstype. 'Geen'
'Systeem toegewezen'
'Systeemtoegewezen, Gebruikertoegewezen'
UserAssigned
gebruikers-toegewezen identiteiten De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit
Verwijzingen naar woordenlijstsleutels zijn ARM-resource-id's in de vorm:
'/abonnementen/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Naam Beschrijving Waarde

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

Bron Tags

Naam Beschrijving Waarde

GeheimObject

Naam Beschrijving Waarde
soort Het type geheimobject dat bepaalt hoe de waarde van het geheime object moet zijn
Geïnterpreteerd.
'Ondoorzichtig'
'Kluisgeheim'
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.
touw

SetValue instellen

Naam Beschrijving Waarde
isGeheim 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)

BronEigenschappen

Naam Beschrijving Waarde
tak De naam van de vertakking van de broncode. touw
repositoryUrl De volledige URL naar de opslagplaats voor broncode tekenreeks (vereist)
sourceControlAuthProperties De autorisatie-eigenschappen voor toegang tot de broncodeopslagplaats en voor het instellen van
webhooks voor meldingen.
AuthInfo
bronControleType Het type broncodebeheerservice. Github
VisualStudioTeamService (vereist)

BronRegistryCredentials

Naam Beschrijving Waarde
inlogmodus 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'

BronTrigger

Naam Beschrijving Waarde
naam De naam van de trigger. tekenreeks (vereist)
bronRepository De eigenschappen die de broncode(code) voor de taak beschrijven. SourceProperties (vereist)
bronTriggerEvents De bron gebeurtenis die overeenkomt met de trigger. Tekenreeksmatrix met een van de volgende waarden:
'doorvoeren'
'pullrequest' (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'

TaakEigenschappen

Naam Beschrijving Waarde
agentConfiguratie De computerconfiguratie van de uitvoeringsagent. AgentEigenschappen
agentPoolNaam De toegewezen agentpool voor de taak. touw
inloggegevens De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
isSysteemTaak De waarde van deze eigenschap geeft aan of de taakresource een systeemtaak is of niet. Bool
logSjabloon De sjabloon die de opslagplaats en taggegevens beschrijft voor het uitvoeren van logboekartefacten. touw
perron De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen
stand van zaken De huidige status van de taak. 'Uitgeschakeld'
'Ingeschakeld'
stap De eigenschappen van een taakstap. Eigenschappen van TaskStep
tijdslimiet Time-out in seconden uitvoeren. Int

Beperkingen:
Minimumwaarde = 300
Maximumwaarde = 28800
prikkel De eigenschappen die alle triggers voor de taak beschrijven. TriggerProperties-

Eigenschappen van TaskStep

Naam Beschrijving Waarde
contextAccessToken Het token (git PAT of SAS-token van de blob van het opslagaccount) dat is gekoppeld aan de context voor een stap. touw
contextPad De URL (absoluut of relatief) van de broncontext voor de taakstap. touw
soort Ingesteld op Docker voor het type DockerBuildStep. Ingesteld op EncodedTask voor het type EncodedTaskStep. Ingesteld op FileTask voor het type FileTaskStep. 'Dokwerker'
'Gecodeerde taak'
FileTask (vereist)

Wekker

Naam Beschrijving Waarde
naam De naam van de trigger. tekenreeks (vereist)
rooster De CRON-expressie voor de taakplanning tekenreeks (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'

Eigenschappen van triggers

Naam Beschrijving Waarde
baseImageTrigger De trigger op basis van afhankelijkheden van basisinstallatiekopieën. BaseImageTrigger
bronTriggers De verzameling triggers op basis van broncodeopslagplaats. BronTrigger
timerTriggers De verzameling timertriggers. TimerTrigger

UserIdentityProperties

Naam Beschrijving Waarde
cliënt-ID De client-id van de door de gebruiker toegewezen identiteit. touw
principaalId De principal-id van de door de gebruiker toegewezen identiteit. touw

Gebruiksvoorbeelden

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype registers/taken 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 voor Microsoft.ContainerRegistry/registries/taken wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      agentConfiguration = {
        cpu = int
      }
      agentPoolName = "string"
      credentials = {
        customRegistries = {
          {customized property} = {
            identity = "string"
            password = {
              type = "string"
              value = "string"
            }
            userName = {
              type = "string"
              value = "string"
            }
          }
        }
        sourceRegistry = {
          loginMode = "string"
        }
      }
      isSystemTask = bool
      logTemplate = "string"
      platform = {
        architecture = "string"
        os = "string"
        variant = "string"
      }
      status = "string"
      step = {
        contextAccessToken = "string"
        contextPath = "string"
        type = "string"
        // For remaining properties, see TaskStepProperties objects
      }
      timeout = int
      trigger = {
        baseImageTrigger = {
          baseImageTriggerType = "string"
          name = "string"
          status = "string"
          updateTriggerEndpoint = "string"
          updateTriggerPayloadType = "string"
        }
        sourceTriggers = [
          {
            name = "string"
            sourceRepository = {
              branch = "string"
              repositoryUrl = "string"
              sourceControlAuthProperties = {
                expiresIn = int
                refreshToken = "string"
                scope = "string"
                token = "string"
                tokenType = "string"
              }
              sourceControlType = "string"
            }
            sourceTriggerEvents = [
              "string"
            ]
            status = "string"
          }
        ]
        timerTriggers = [
          {
            name = "string"
            schedule = "string"
            status = "string"
          }
        ]
      }
    }
  }
}

TaskStepProperties-objecten

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

Gebruik voor Docker:

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

Gebruik voor EncodedTask:

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

Gebruik voor FileTask:

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

Eigenschapswaarden

Microsoft.ContainerRegistry/registries/tasks

Naam Beschrijving Waarde
identiteit Identiteit voor de resource. IdentityProperties-
locatie De locatie van de resource. Dit kan niet worden gewijzigd nadat de resource is gemaakt. tekenreeks (vereist)
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 50
Patroon = ^[a-zA-Z0-9-_]*$ (vereist)
ouder_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: registers
eigenschappen De eigenschappen van een taak. TaskProperties-
etiketten Resourcetags Woordenlijst met tagnamen en -waarden.
soort Het brontype "Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview"

AgentEigenschappen

Naam Beschrijving Waarde
CPU De CPU-configuratie in termen van het aantal kernen dat nodig is voor de uitvoering. int (integer)

Argumentatie

Naam Beschrijving Waarde
isGeheim 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)

AuthInfo

Naam Beschrijving Waarde
vervaltIn Tijd in seconden dat het token geldig blijft int (integer)
vernieuwen Token Het vernieuwingstoken dat wordt gebruikt om het toegangstoken te vernieuwen. touw
omvang Het bereik van het toegangstoken. touw
teken Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider. tekenreeks (vereist)
tokenType Het type verificatietoken. OAuth
'PAT' (vereist)

BaseImageTrigger

Naam Beschrijving Waarde
baseImageTriggerType Het type automatische trigger voor updates van afhankelijkheden van basisinstallatiekopieën. 'Alles'
Runtime (vereist)
naam De naam van de trigger. tekenreeks (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'
updateTriggerEindpunt De eindpunt-URL voor het ontvangen van updatetriggers. touw
updateTriggerPayloadType Type nettoladingtekst voor updatetriggers voor basisinstallatiekopieën. 'Standaard'
Token

Inloggegevens

Naam Beschrijving Waarde
aangepaste registers 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
bronRegister Beschrijft de referentieparameters voor toegang tot het bronregister. BronRegistryCredentials

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, is systemde waarde . 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.
touw
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.
GeheimObject
gebruikersnaam De gebruikersnaam voor het aanmelden bij het aangepaste register. GeheimObject

DockerBuildStep

Naam Beschrijving Waarde
Argumenten De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van deze buildstap. Argumentatie
dockerFilePath Het Docker-bestandspad ten opzichte van de broncontext. tekenreeks (vereist)
imageNamen 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
geenCache De waarde van deze eigenschap geeft aan of de afbeeldingscache al dan niet is ingeschakeld. Bool
doel De naam van de doelbuildfase voor de docker-build. touw
soort Het type van de stap. Docker (vereist)

GecodeerdeTaakStap

Naam Beschrijving Waarde
gecodeerdeTaakInhoud Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. tekenreeks (vereist)
gecodeerdeWaardenInhoud Base64 gecodeerde waarde van de bestandsinhoud met parameters/waarden. touw
soort Het type van de stap. 'EncodedTask' (vereist)
waarden De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]

FileTaskStep

Naam Beschrijving Waarde
taskFilePath Het pad naar het taaksjabloon/definitiebestand ten opzichte van de broncontext. tekenreeks (vereist)
soort Het type van de stap. FileTask (vereist)
waarden De verzameling van overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. SetValue[]
valuesFilePath Het bestandspad voor taakwaarden/parameters ten opzichte van de broncontext. touw

IdentiteitEigenschappen

Naam Beschrijving Waarde
principaalId De principal-id van de resource-id. touw
huurderId De tenant-id van de resource. touw
soort Het identiteitstype. 'Geen'
'Systeem toegewezen'
'Systeemtoegewezen, Gebruikertoegewezen'
UserAssigned
gebruikers-toegewezen identiteiten De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit
Verwijzingen naar woordenlijstsleutels zijn ARM-resource-id's in de vorm:
'/abonnementen/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Naam Beschrijving Waarde

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

Bron Tags

Naam Beschrijving Waarde

GeheimObject

Naam Beschrijving Waarde
soort Het type geheimobject dat bepaalt hoe de waarde van het geheime object moet zijn
Geïnterpreteerd.
'Ondoorzichtig'
'Kluisgeheim'
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.
touw

SetValue instellen

Naam Beschrijving Waarde
isGeheim 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)

BronEigenschappen

Naam Beschrijving Waarde
tak De naam van de vertakking van de broncode. touw
repositoryUrl De volledige URL naar de opslagplaats voor broncode tekenreeks (vereist)
sourceControlAuthProperties De autorisatie-eigenschappen voor toegang tot de broncodeopslagplaats en voor het instellen van
webhooks voor meldingen.
AuthInfo
bronControleType Het type broncodebeheerservice. Github
VisualStudioTeamService (vereist)

BronRegistryCredentials

Naam Beschrijving Waarde
inlogmodus 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'

BronTrigger

Naam Beschrijving Waarde
naam De naam van de trigger. tekenreeks (vereist)
bronRepository De eigenschappen die de broncode(code) voor de taak beschrijven. SourceProperties (vereist)
bronTriggerEvents De bron gebeurtenis die overeenkomt met de trigger. Tekenreeksmatrix met een van de volgende waarden:
'doorvoeren'
'pullrequest' (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'

TaakEigenschappen

Naam Beschrijving Waarde
agentConfiguratie De computerconfiguratie van de uitvoeringsagent. AgentEigenschappen
agentPoolNaam De toegewezen agentpool voor de taak. touw
inloggegevens De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. Referenties
isSysteemTaak De waarde van deze eigenschap geeft aan of de taakresource een systeemtaak is of niet. Bool
logSjabloon De sjabloon die de opslagplaats en taggegevens beschrijft voor het uitvoeren van logboekartefacten. touw
perron De platformeigenschappen waarop de uitvoering moet plaatsvinden. PlatformEigenschappen
stand van zaken De huidige status van de taak. 'Uitgeschakeld'
'Ingeschakeld'
stap De eigenschappen van een taakstap. Eigenschappen van TaskStep
tijdslimiet Time-out in seconden uitvoeren. Int

Beperkingen:
Minimumwaarde = 300
Maximumwaarde = 28800
prikkel De eigenschappen die alle triggers voor de taak beschrijven. TriggerProperties-

Eigenschappen van TaskStep

Naam Beschrijving Waarde
contextAccessToken Het token (git PAT of SAS-token van de blob van het opslagaccount) dat is gekoppeld aan de context voor een stap. touw
contextPad De URL (absoluut of relatief) van de broncontext voor de taakstap. touw
soort Ingesteld op Docker voor het type DockerBuildStep. Ingesteld op EncodedTask voor het type EncodedTaskStep. Ingesteld op FileTask voor het type FileTaskStep. 'Dokwerker'
'Gecodeerde taak'
FileTask (vereist)

Wekker

Naam Beschrijving Waarde
naam De naam van de trigger. tekenreeks (vereist)
rooster De CRON-expressie voor de taakplanning tekenreeks (vereist)
stand van zaken De huidige status van de trigger. 'Uitgeschakeld'
'Ingeschakeld'

Eigenschappen van triggers

Naam Beschrijving Waarde
baseImageTrigger De trigger op basis van afhankelijkheden van basisinstallatiekopieën. BaseImageTrigger
bronTriggers De verzameling triggers op basis van broncodeopslagplaats. BronTrigger
timerTriggers De verzameling timertriggers. TimerTrigger

UserIdentityProperties

Naam Beschrijving Waarde
cliënt-ID De client-id van de door de gebruiker toegewezen identiteit. touw
principaalId De principal-id van de door de gebruiker toegewezen identiteit. touw