Dela via

Microsoft.ContainerRegistry-register/uppgifter 2019-04-01

Bicep-resursdefinition

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

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

Resursformat

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

resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@2019-04-01' = {
  parent: resourceSymbolicName
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    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'
    }
    status: 'string'
    step: {
      contextAccessToken: 'string'
      contextPath: 'string'
      type: 'string'
      // For remaining properties, see TaskStepProperties objects
    }
    timeout: int
    trigger: {
      baseImageTrigger: {
        baseImageTriggerType: 'string'
        name: 'string'
        status: 'string'
      }
      sourceTriggers: [
        {
          name: 'string'
          sourceRepository: {
            branch: 'string'
            repositoryUrl: 'string'
            sourceControlAuthProperties: {
              expiresIn: int
              refreshToken: 'string'
              scope: 'string'
              token: 'string'
              tokenType: 'string'
            }
            sourceControlType: 'string'
          }
          sourceTriggerEvents: [
            'string'
          ]
          status: 'string'
        }
      ]
      timerTriggers: [
        {
          name: 'string'
          schedule: 'string'
          status: 'string'
        }
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

TaskStepProperties-objekt

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

För Docker använder du:

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

För EncodedTask använder du:

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

För FileTask använder du:

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

Egenskapsvärden

Microsoft.ContainerRegistry/registries/tasks

Namn Beskrivning Värde
identitet Identitet för resursen. IdentityProperties (Identitet) Egenskaper
läge Platsen för resursen. Detta kan inte ändras när resursen har skapats. sträng (krävs)
namn Resursnamnet sträng

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

Mer information finns i Underordnad resurs utanför den överordnade resursen.		 Symboliskt namn för resurs av typen: register
egenskaper Egenskaperna för en aktivitet. TaskProperties (Uppgift) Egenskaper
Taggar Resursetiketter Ordlista med taggnamn och värden. Se taggar i mallar

AgentEgenskaper

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

Argumentation

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

AuthInfo

Namn Beskrivning Värde
expiresIn Tid i sekunder som token förblir giltig Int
refreshToken (på engelska) Uppdateringstoken som används för att uppdatera åtkomsttoken. snöre
omfattning Omfånget för åtkomsttoken. snöre
tecken Åtkomsttoken som används för att komma åt källkontrollprovidern. sträng (krävs)
tokentyp Typ av autentiseringstoken. "OAuth"
"PAT" (krävs)

BaseImageTrigger (på engelska)

Namn Beskrivning Värde
baseImageTriggerType Typ av automatisk utlösare för uppdateringar av basavbildningsberoende. "Alla"
"Runtime" (krävs)
namn Namnet på utlösaren. sträng (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

Behörigheter

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

AutentiseringsuppgifterCustomRegistries

Namn Beskrivning Värde

CustomRegistryCredentials (på engelska)

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

DockerBuildStep (på engelska)

Namn Beskrivning Värde
Argumenten Samlingen med åsidosättningsargument som ska användas när du kör det här byggsteget. Argument[]
dockerFilePath Docker-filsökvägen i förhållande till källkontexten. sträng (krävs)
imageNames (på engelska) De fullständigt kvalificerade avbildningsnamnen, inklusive lagringsplatsen och taggen. sträng[]
isPushEnabled Värdet för den här egenskapen anger om avbildningen som skapats ska push-överföras till registret eller inte. Bool
noCache Värdet för den här egenskapen anger om avbildningscachen är aktiverad eller inte. Bool
mål Namnet på målversionssteget för docker-versionen. snöre
typ Typ av steg. "Docker" (krävs)

KodaTaskSteg

Namn Beskrivning Värde
kodat TaskContent Base64-kodat värde för mall-/definitionsfilinnehållet. sträng (krävs)
encodedValuesContent Base64-kodat värde för filinnehållet parametrar/värden. snöre
typ Typ av steg. "EncodedTask" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]

FileTaskStep (FileTaskStep)

Namn Beskrivning Värde
taskFilePath (på engelska) Sökvägen för aktivitetsmallen/definitionsfilen i förhållande till källkontexten. sträng (krävs)
typ Typ av steg. "FileTask" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]
valuesFilePath Filsökvägen för aktivitetsvärden/parametrar i förhållande till källkontexten. snöre

IdentityProperties (Identitet) Egenskaper

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

IdentityPropertiesUserAssignedIdentiteter

Namn Beskrivning Värde

PlatformProperties (PlattformEgenskaper)

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

Resurstaggar

Namn Beskrivning Värde

Hemligt objekt

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

Sätt värde

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

Källegenskaper

Namn Beskrivning Värde
gren Källkodens grennamn. snöre
repositoryUrl Den fullständiga URL:en till källkodslagringsplatsen sträng (krävs)
sourceControlAuthProperties Auktoriseringsegenskaperna för åtkomst till källkodslagringsplatsen och för att konfigurera
webhooks för meddelanden.		 AuthInfo
sourceControlType Typ av källkontrolltjänst. "Github"
"VisualStudioTeamService" (krävs)

SourceRegistryCredentials (på engelska)

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

KällaUtlösare

Namn Beskrivning Värde
namn Namnet på utlösaren. sträng (krävs)
källaRepository (på engelska) De egenskaper som beskriver källan (koden) för uppgiften. SourceProperties (krävs)
sourceTriggerEvents Källhändelsen som motsvarar utlösaren. Strängmatris som innehåller något av:
"checka in"
"pullrequest" (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

TaskProperties (Uppgift) Egenskaper

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. Autentiseringsuppgifter
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
tillstånd Aktivitetens aktuella status. "Inaktiverad"
"Aktiverad"
steg Egenskaperna för ett aktivitetssteg. TaskStepProperties (krävs)
vilopaus Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
utlösare De egenskaper som beskriver alla utlösare för aktiviteten. TriggerProperties (Utlösare)

TaskStepProperties (på engelska)

Namn Beskrivning Värde
contextAccessToken Token (git PAT eller SAS-token för lagringskontoblob) som är associerad med kontexten för ett steg. snöre
contextPath (på engelska) URL:en (absolut eller relativ) för källkontexten för aktivitetssteget. snöre
typ Ange till Docker för typen DockerBuildStep. Ange till "EncodedTask" för typen EncodedTaskStep. Ange till "FileTask" för typen FileTaskStep. "Docker"
"KodadTask"
"FileTask" (krävs)

TimerTrigger (på engelska)

Namn Beskrivning Värde
namn Namnet på utlösaren. sträng (krävs)
schema CRON-uttrycket för aktivitetsschemat sträng (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

TriggerProperties (Utlösare)

Namn Beskrivning Värde
baseImageTrigger Utlösaren baserat på basavbildningsberoenden. BaseImageTrigger (på engelska)
sourceTriggers (källa) Insamlingen av utlösare baserat på källkodslagringsplatsen. KällaUtlösare[]
timerTriggers Samlingen med timerutlösare. TimerTrigger[]

UserIdentityProperties (på engelska)

Namn Beskrivning Värde
clientId Klient-ID för användartilldelad identitet. snöre
huvudId Huvud-ID för användartilldelad identitet. snöre

Resursdefinition för ARM-mall

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

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

Resursformat

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

{
  "type": "Microsoft.ContainerRegistry/registries/tasks",
  "apiVersion": "2019-04-01",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "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"
    },
    "status": "string",
    "step": {
      "contextAccessToken": "string",
      "contextPath": "string",
      "type": "string"
      // For remaining properties, see TaskStepProperties objects
    },
    "timeout": "int",
    "trigger": {
      "baseImageTrigger": {
        "baseImageTriggerType": "string",
        "name": "string",
        "status": "string"
      },
      "sourceTriggers": [
        {
          "name": "string",
          "sourceRepository": {
            "branch": "string",
            "repositoryUrl": "string",
            "sourceControlAuthProperties": {
              "expiresIn": "int",
              "refreshToken": "string",
              "scope": "string",
              "token": "string",
              "tokenType": "string"
            },
            "sourceControlType": "string"
          },
          "sourceTriggerEvents": [ "string" ],
          "status": "string"
        }
      ],
      "timerTriggers": [
        {
          "name": "string",
          "schedule": "string",
          "status": "string"
        }
      ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

TaskStepProperties-objekt

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

För Docker använder du:

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

För EncodedTask använder du:

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

För FileTask använder du:

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

Egenskapsvärden

Microsoft.ContainerRegistry/registries/tasks

Namn Beskrivning Värde
apiVersion API-versionen '2019-04-01'
identitet Identitet för resursen. IdentityProperties (Identitet) Egenskaper
läge Platsen för resursen. Detta kan inte ändras när resursen har skapats. sträng (krävs)
namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Maximal längd = 50
Mönster = ^[a-zA-Z0-9-_]*$ (krävs)
egenskaper Egenskaperna för en aktivitet. TaskProperties (Uppgift) Egenskaper
Taggar Resursetiketter Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.ContainerRegistry/registries/tasks"

AgentEgenskaper

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

Argumentation

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

AuthInfo

Namn Beskrivning Värde
expiresIn Tid i sekunder som token förblir giltig Int
refreshToken (på engelska) Uppdateringstoken som används för att uppdatera åtkomsttoken. snöre
omfattning Omfånget för åtkomsttoken. snöre
tecken Åtkomsttoken som används för att komma åt källkontrollprovidern. sträng (krävs)
tokentyp Typ av autentiseringstoken. "OAuth"
"PAT" (krävs)

BaseImageTrigger (på engelska)

Namn Beskrivning Värde
baseImageTriggerType Typ av automatisk utlösare för uppdateringar av basavbildningsberoende. "Alla"
"Runtime" (krävs)
namn Namnet på utlösaren. sträng (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

Behörigheter

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

AutentiseringsuppgifterCustomRegistries

Namn Beskrivning Värde

CustomRegistryCredentials (på engelska)

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

DockerBuildStep (på engelska)

Namn Beskrivning Värde
Argumenten Samlingen med åsidosättningsargument som ska användas när du kör det här byggsteget. Argument[]
dockerFilePath Docker-filsökvägen i förhållande till källkontexten. sträng (krävs)
imageNames (på engelska) De fullständigt kvalificerade avbildningsnamnen, inklusive lagringsplatsen och taggen. sträng[]
isPushEnabled Värdet för den här egenskapen anger om avbildningen som skapats ska push-överföras till registret eller inte. Bool
noCache Värdet för den här egenskapen anger om avbildningscachen är aktiverad eller inte. Bool
mål Namnet på målversionssteget för docker-versionen. snöre
typ Typ av steg. "Docker" (krävs)

KodaTaskSteg

Namn Beskrivning Värde
kodat TaskContent Base64-kodat värde för mall-/definitionsfilinnehållet. sträng (krävs)
encodedValuesContent Base64-kodat värde för filinnehållet parametrar/värden. snöre
typ Typ av steg. "EncodedTask" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]

FileTaskStep (FileTaskStep)

Namn Beskrivning Värde
taskFilePath (på engelska) Sökvägen för aktivitetsmallen/definitionsfilen i förhållande till källkontexten. sträng (krävs)
typ Typ av steg. "FileTask" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]
valuesFilePath Filsökvägen för aktivitetsvärden/parametrar i förhållande till källkontexten. snöre

IdentityProperties (Identitet) Egenskaper

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

IdentityPropertiesUserAssignedIdentiteter

Namn Beskrivning Värde

PlatformProperties (PlattformEgenskaper)

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

Resurstaggar

Namn Beskrivning Värde

Hemligt objekt

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

Sätt värde

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

Källegenskaper

Namn Beskrivning Värde
gren Källkodens grennamn. snöre
repositoryUrl Den fullständiga URL:en till källkodslagringsplatsen sträng (krävs)
sourceControlAuthProperties Auktoriseringsegenskaperna för åtkomst till källkodslagringsplatsen och för att konfigurera
webhooks för meddelanden.		 AuthInfo
sourceControlType Typ av källkontrolltjänst. "Github"
"VisualStudioTeamService" (krävs)

SourceRegistryCredentials (på engelska)

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

KällaUtlösare

Namn Beskrivning Värde
namn Namnet på utlösaren. sträng (krävs)
källaRepository (på engelska) De egenskaper som beskriver källan (koden) för uppgiften. SourceProperties (krävs)
sourceTriggerEvents Källhändelsen som motsvarar utlösaren. Strängmatris som innehåller något av:
"checka in"
"pullrequest" (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

TaskProperties (Uppgift) Egenskaper

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. Autentiseringsuppgifter
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
tillstånd Aktivitetens aktuella status. "Inaktiverad"
"Aktiverad"
steg Egenskaperna för ett aktivitetssteg. TaskStepProperties (krävs)
vilopaus Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
utlösare De egenskaper som beskriver alla utlösare för aktiviteten. TriggerProperties (Utlösare)

TaskStepProperties (på engelska)

Namn Beskrivning Värde
contextAccessToken Token (git PAT eller SAS-token för lagringskontoblob) som är associerad med kontexten för ett steg. snöre
contextPath (på engelska) URL:en (absolut eller relativ) för källkontexten för aktivitetssteget. snöre
typ Ange till Docker för typen DockerBuildStep. Ange till "EncodedTask" för typen EncodedTaskStep. Ange till "FileTask" för typen FileTaskStep. "Docker"
"KodadTask"
"FileTask" (krävs)

TimerTrigger (på engelska)

Namn Beskrivning Värde
namn Namnet på utlösaren. sträng (krävs)
schema CRON-uttrycket för aktivitetsschemat sträng (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

TriggerProperties (Utlösare)

Namn Beskrivning Värde
baseImageTrigger Utlösaren baserat på basavbildningsberoenden. BaseImageTrigger (på engelska)
sourceTriggers (källa) Insamlingen av utlösare baserat på källkodslagringsplatsen. KällaUtlösare[]
timerTriggers Samlingen med timerutlösare. TimerTrigger[]

UserIdentityProperties (på engelska)

Namn Beskrivning Värde
clientId Klient-ID för användartilldelad identitet. snöre
huvudId Huvud-ID för användartilldelad identitet. snöre

Användningsexempel

Resursdefinition för Terraform (AzAPI-provider)

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

  • Resursgrupper

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

Resursformat

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/tasks@2019-04-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      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"
      }
      status = "string"
      step = {
        contextAccessToken = "string"
        contextPath = "string"
        type = "string"
        // For remaining properties, see TaskStepProperties objects
      }
      timeout = int
      trigger = {
        baseImageTrigger = {
          baseImageTriggerType = "string"
          name = "string"
          status = "string"
        }
        sourceTriggers = [
          {
            name = "string"
            sourceRepository = {
              branch = "string"
              repositoryUrl = "string"
              sourceControlAuthProperties = {
                expiresIn = int
                refreshToken = "string"
                scope = "string"
                token = "string"
                tokenType = "string"
              }
              sourceControlType = "string"
            }
            sourceTriggerEvents = [
              "string"
            ]
            status = "string"
          }
        ]
        timerTriggers = [
          {
            name = "string"
            schedule = "string"
            status = "string"
          }
        ]
      }
    }
  }
}

TaskStepProperties-objekt

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

För Docker använder du:

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

För EncodedTask använder du:

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

För FileTask använder du:

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

Egenskapsvärden

Microsoft.ContainerRegistry/registries/tasks

Namn Beskrivning Värde
identitet Identitet för resursen. IdentityProperties (Identitet) Egenskaper
läge Platsen för resursen. Detta kan inte ändras när resursen har skapats. sträng (krävs)
namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Maximal längd = 50
Mönster = ^[a-zA-Z0-9-_]*$ (krävs)
föräldra_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: register
egenskaper Egenskaperna för en aktivitet. TaskProperties (Uppgift) Egenskaper
Taggar Resursetiketter Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.ContainerRegistry/registries/tasks@2019-04-01"

AgentEgenskaper

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

Argumentation

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

AuthInfo

Namn Beskrivning Värde
expiresIn Tid i sekunder som token förblir giltig Int
refreshToken (på engelska) Uppdateringstoken som används för att uppdatera åtkomsttoken. snöre
omfattning Omfånget för åtkomsttoken. snöre
tecken Åtkomsttoken som används för att komma åt källkontrollprovidern. sträng (krävs)
tokentyp Typ av autentiseringstoken. "OAuth"
"PAT" (krävs)

BaseImageTrigger (på engelska)

Namn Beskrivning Värde
baseImageTriggerType Typ av automatisk utlösare för uppdateringar av basavbildningsberoende. "Alla"
"Runtime" (krävs)
namn Namnet på utlösaren. sträng (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

Behörigheter

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

AutentiseringsuppgifterCustomRegistries

Namn Beskrivning Värde

CustomRegistryCredentials (på engelska)

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

DockerBuildStep (på engelska)

Namn Beskrivning Värde
Argumenten Samlingen med åsidosättningsargument som ska användas när du kör det här byggsteget. Argument[]
dockerFilePath Docker-filsökvägen i förhållande till källkontexten. sträng (krävs)
imageNames (på engelska) De fullständigt kvalificerade avbildningsnamnen, inklusive lagringsplatsen och taggen. sträng[]
isPushEnabled Värdet för den här egenskapen anger om avbildningen som skapats ska push-överföras till registret eller inte. Bool
noCache Värdet för den här egenskapen anger om avbildningscachen är aktiverad eller inte. Bool
mål Namnet på målversionssteget för docker-versionen. snöre
typ Typ av steg. "Docker" (krävs)

KodaTaskSteg

Namn Beskrivning Värde
kodat TaskContent Base64-kodat värde för mall-/definitionsfilinnehållet. sträng (krävs)
encodedValuesContent Base64-kodat värde för filinnehållet parametrar/värden. snöre
typ Typ av steg. "EncodedTask" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]

FileTaskStep (FileTaskStep)

Namn Beskrivning Värde
taskFilePath (på engelska) Sökvägen för aktivitetsmallen/definitionsfilen i förhållande till källkontexten. sträng (krävs)
typ Typ av steg. "FileTask" (krävs)
värden Samlingen med åsidosättbara värden som kan skickas när en uppgift körs. SetValue[]
valuesFilePath Filsökvägen för aktivitetsvärden/parametrar i förhållande till källkontexten. snöre

IdentityProperties (Identitet) Egenskaper

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

IdentityPropertiesUserAssignedIdentiteter

Namn Beskrivning Värde

PlatformProperties (PlattformEgenskaper)

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

Resurstaggar

Namn Beskrivning Värde

Hemligt objekt

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

Sätt värde

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

Källegenskaper

Namn Beskrivning Värde
gren Källkodens grennamn. snöre
repositoryUrl Den fullständiga URL:en till källkodslagringsplatsen sträng (krävs)
sourceControlAuthProperties Auktoriseringsegenskaperna för åtkomst till källkodslagringsplatsen och för att konfigurera
webhooks för meddelanden.		 AuthInfo
sourceControlType Typ av källkontrolltjänst. "Github"
"VisualStudioTeamService" (krävs)

SourceRegistryCredentials (på engelska)

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

KällaUtlösare

Namn Beskrivning Värde
namn Namnet på utlösaren. sträng (krävs)
källaRepository (på engelska) De egenskaper som beskriver källan (koden) för uppgiften. SourceProperties (krävs)
sourceTriggerEvents Källhändelsen som motsvarar utlösaren. Strängmatris som innehåller något av:
"checka in"
"pullrequest" (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

TaskProperties (Uppgift) Egenskaper

Namn Beskrivning Värde
agentConfiguration Datorkonfigurationen för körningsagenten. AgentEgenskaper
Autentiseringsuppgifter De egenskaper som beskriver en uppsättning autentiseringsuppgifter som ska användas när den här körningen anropas. Autentiseringsuppgifter
plattform De plattformsegenskaper som körningen måste ske mot. PlatformProperties (krävs)
tillstånd Aktivitetens aktuella status. "Inaktiverad"
"Aktiverad"
steg Egenskaperna för ett aktivitetssteg. TaskStepProperties (krävs)
vilopaus Tidsgräns för körning i sekunder. Int

Begränsningar:
Minsta värde = 300
Maxvärde = 28800
utlösare De egenskaper som beskriver alla utlösare för aktiviteten. TriggerProperties (Utlösare)

TaskStepProperties (på engelska)

Namn Beskrivning Värde
contextAccessToken Token (git PAT eller SAS-token för lagringskontoblob) som är associerad med kontexten för ett steg. snöre
contextPath (på engelska) URL:en (absolut eller relativ) för källkontexten för aktivitetssteget. snöre
typ Ange till Docker för typen DockerBuildStep. Ange till "EncodedTask" för typen EncodedTaskStep. Ange till "FileTask" för typen FileTaskStep. "Docker"
"KodadTask"
"FileTask" (krävs)

TimerTrigger (på engelska)

Namn Beskrivning Värde
namn Namnet på utlösaren. sträng (krävs)
schema CRON-uttrycket för aktivitetsschemat sträng (krävs)
tillstånd Utlösarens aktuella status. "Inaktiverad"
"Aktiverad"

TriggerProperties (Utlösare)

Namn Beskrivning Värde
baseImageTrigger Utlösaren baserat på basavbildningsberoenden. BaseImageTrigger (på engelska)
sourceTriggers (källa) Insamlingen av utlösare baserat på källkodslagringsplatsen. KällaUtlösare[]
timerTriggers Samlingen med timerutlösare. TimerTrigger[]

UserIdentityProperties (på engelska)

Namn Beskrivning Värde
clientId Klient-ID för användartilldelad identitet. snöre
huvudId Huvud-ID för användartilldelad identitet. snöre