Partilhar via

Registros/tarefas Microsoft.ContainerRegistry 2019-04-01

  • Artigo

Definição de recursos do bíceps

O tipo de recurso registros/tarefas pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ContainerRegistry/registries/tasks, adicione o seguinte Bicep ao seu modelo.

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

Objetos TaskStepProperties

Defina a propriedade type para especificar o tipo de objeto.

Para Docker, use:

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

Para EncodedTask, use:

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

Para FileTask, use:

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

Valores de propriedade

AgentProperties

Designação Descrição Valor
CPU A configuração da CPU em termos de número de núcleos necessários para a execução. Int

Argumento

Designação Descrição Valor
isSecret Sinalizador para indicar se o argumento representa um segredo e deseja ser removido dos logs de compilação. Bool
Designação O nome do argumento. string (obrigatório)
valor O valor do argumento. string (obrigatório)

AuthInfo

Designação Descrição Valor
expira Tempo em segundos em que o token permanece válido Int
refreshToken O token de atualização usado para atualizar o token de acesso. string
Âmbito de aplicação O escopo do token de acesso. string
ficha O token de acesso usado para acessar o provedor de controle do código-fonte. string (obrigatório)
tokenType O tipo de token de autenticação. 'OAuth'
'PAT' (obrigatório)

BaseImageTrigger

Designação Descrição Valor
baseImageTriggerType O tipo do gatilho automático para atualizações de dependência de imagem base. 'Todos'
'Tempo de execução' (obrigatório)
Designação O nome do gatilho. string (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

Credenciais

Designação Descrição Valor
customRegistries Descreve os parâmetros de credencial para acessar outros registros personalizados. A chave
para o item de dicionário será o servidor de login do registro (myregistry.azurecr.io) e
O valor do item serão as credenciais do Registro para acessar o Registro.		 CredenciaisAlfândegaRegistos
sourceRegistry Descreve os parâmetros de credencial para acessar o registro de origem. SourceRegistryCredentials

CredenciaisAlfândegaRegistos

Designação Descrição Valor

CustomRegistryCredentials

Designação Descrição Valor
identidade Indica a identidade gerenciada atribuída à credencial personalizada. Se uma identidade atribuída pelo usuário
esse valor é a ID do cliente. Se uma identidade atribuída ao sistema, o valor será system. Em
no caso de uma identidade atribuída pelo sistema, o ID do Cliente será determinado pelo corredor. Isto
A identidade pode ser usada para autenticar no Cofre de Chaves para recuperar credenciais ou pode ser a única
fonte de autenticação utilizada para aceder ao registo.		 string
palavra-passe A palavra-passe para iniciar sessão no registo personalizado. A palavra-passe é um segredo
objeto que permite várias maneiras de fornecer o valor para ele.		 SecretObject
nome de utilizador O nome de utilizador para iniciar sessão no registo personalizado. SecretObject

DockerBuildStep

Designação Descrição Valor
Argumentos A coleção de argumentos de substituição a serem usados ao executar esta etapa de compilação. Argumento[]
dockerFilePath O caminho do arquivo do Docker relativo ao contexto de origem. string (obrigatório)
imageNames Os nomes de imagem totalmente qualificados, incluindo o repositório e a tag. string[]
isPushEnabled O valor dessa propriedade indica se a imagem construída deve ser enviada por push para o registro ou não. Bool
noCache O valor dessa propriedade indica se o cache de imagem está habilitado ou não. Bool
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
tipo O tipo de etapa. 'Docker' (obrigatório)

EncodedTaskStep

Designação Descrição Valor
encodedTaskContent Valor codificado em Base64 do conteúdo do arquivo de modelo/definição. string (obrigatório)
encodedValuesContent Base64 valor codificado do conteúdo do arquivo de parâmetros/valores. string
tipo O tipo de etapa. 'EncodedTask' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]

FileTaskStep

Designação Descrição Valor
taskFilePath O caminho do arquivo de modelo/definição de tarefa relativo ao contexto de origem. string (obrigatório)
tipo O tipo de etapa. 'FileTask' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]
valoresFilePath O caminho do arquivo de valores/parâmetros da tarefa relativo ao contexto de origem. string

IdentityProperties

Designação Descrição Valor
principalId A ID principal da identidade do recurso. string
inquilinoId A ID do locatário do recurso. string
tipo O tipo de identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities A lista de identidades de usuário associadas ao recurso. A identidade do usuário
as referências de chave de dicionário serão ids de recurso ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.		 IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Designação Descrição Valor

Microsoft.ContainerRegistry/registros/tarefas

Designação Descrição Valor
identidade Identidade do recurso. IdentityProperties
Localização A localização do recurso. Isso não pode ser alterado depois que o recurso é criado. string (obrigatório)
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 50
Padrão = ^[a-zA-Z0-9-_]*$ (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para recurso do tipo: registros
propriedades As propriedades de uma tarefa. TaskProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Propriedades da plataforma

Designação Descrição Valor
Arquitetura A arquitetura do sistema operacional. «AMD64»
'braço'
'x86'
o O tipo de sistema operacional necessário para a execução. 'Linux'
'Windows' (obrigatório)
variante Variante da CPU. «V6»
«V7»
«V8»

Tags de Recursos

Designação Descrição Valor

Objeto SecretObject

Designação Descrição Valor
tipo O tipo do objeto secreto que determina como o valor do objeto secreto deve ser
interpretado.		 'Opaco'
'Vaultsecret'
valor O valor do segredo. O formato deste valor será determinado
com base no tipo do objeto secreto. Se o tipo for Opaco, o valor será
usado como está, sem qualquer modificação.		 string

SetValue

Designação Descrição Valor
isSecret Sinalizador para indicar se o valor representa um segredo ou não. Bool
Designação O nome do valor substituível. string (obrigatório)
valor O valor substituível. string (obrigatório)

SourceProperties

Designação Descrição Valor
sucursal O nome da ramificação do código-fonte. string
repositoryUrl O URL completo para o repositório de código-fonte string (obrigatório)
sourceControlAuthProperties As propriedades de autorização para acessar o repositório de código-fonte e configurar
Webhooks para notificações.		 AuthInfo
sourceControlType O tipo de serviço de controle do código-fonte. 'Github'
'VisualStudioTeamService' (obrigatório)

SourceRegistryCredentials

Designação Descrição Valor
loginMode O modo de autenticação que determina o escopo de login do Registro de origem. As credenciais para o registro de origem
serão gerados utilizando o âmbito determinado. Estas credenciais serão utilizadas para iniciar sessão em
O registro de origem durante a execução.		 'Inadimplência'
'Nenhuma'

SourceTrigger

Designação Descrição Valor
Designação O nome do gatilho. string (obrigatório)
sourceRepository As propriedades que descrevem o código-fonte (código) da tarefa. SourceProperties (obrigatório)
sourceTriggerEvents O evento de origem correspondente ao gatilho. Matriz de cadeia de caracteres contendo qualquer uma das:
'Comprometer'
'pullrequest' (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

TaskProperties

Designação Descrição Valor
agentConfiguration A configuração da máquina do agente de execução. AgentProperties
Credenciais As propriedades que descrevem um conjunto de credenciais que serão usadas quando essa execução for invocada. Credenciais
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
Situação O status atual da tarefa. 'Desativado'
'Habilitado'
passo a passo As propriedades de uma etapa de tarefa. TaskStepProperties (obrigatório)
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
gatilho As propriedades que descrevem todos os gatilhos para a tarefa. TriggerProperties

TaskStepProperties

Designação Descrição Valor
contextAccessToken O token (git PAT ou token SAS do blob da conta de armazenamento) associado ao contexto de uma etapa. string
contextPath A URL (absoluta ou relativa) do contexto de origem para a etapa da tarefa. string
tipo Defina como 'Docker' para o tipo DockerBuildStep. Defina como 'EncodedTask' para o tipo EncodedTaskStep. Defina como 'FileTask' para o tipo FileTaskStep. 'Portuário'
'EncodedTask'
'FileTask' (obrigatório)

TimerTrigger

Designação Descrição Valor
Designação O nome do gatilho. string (obrigatório)
Horário A expressão CRON para o agendamento de tarefas string (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

TriggerProperties

Designação Descrição Valor
baseImageTrigger O gatilho baseado em dependências de imagem base. BaseImageTrigger
sourceTriggers A coleção de triggers com base no repositório de código-fonte. SourceTrigger[]
timerTriggers A coleção de gatilhos de temporizador. TimerTrigger[]

UserIdentityProperties

Designação Descrição Valor
ID do cliente O ID do cliente da identidade atribuída ao usuário. string
principalId O id principal da identidade atribuída ao usuário. string

Definição de recurso de modelo ARM

O tipo de recurso registros/tarefas pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ContainerRegistry/registries/tasks, adicione o seguinte JSON ao seu modelo.

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

Objetos TaskStepProperties

Defina a propriedade type para especificar o tipo de objeto.

Para Docker, use:

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

Para EncodedTask, use:

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

Para FileTask, use:

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

Valores de propriedade

AgentProperties

Designação Descrição Valor
CPU A configuração da CPU em termos de número de núcleos necessários para a execução. Int

Argumento

Designação Descrição Valor
isSecret Sinalizador para indicar se o argumento representa um segredo e deseja ser removido dos logs de compilação. Bool
Designação O nome do argumento. string (obrigatório)
valor O valor do argumento. string (obrigatório)

AuthInfo

Designação Descrição Valor
expira Tempo em segundos em que o token permanece válido Int
refreshToken O token de atualização usado para atualizar o token de acesso. string
Âmbito de aplicação O escopo do token de acesso. string
ficha O token de acesso usado para acessar o provedor de controle do código-fonte. string (obrigatório)
tokenType O tipo de token de autenticação. 'OAuth'
'PAT' (obrigatório)

BaseImageTrigger

Designação Descrição Valor
baseImageTriggerType O tipo do gatilho automático para atualizações de dependência de imagem base. 'Todos'
'Tempo de execução' (obrigatório)
Designação O nome do gatilho. string (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

Credenciais

Designação Descrição Valor
customRegistries Descreve os parâmetros de credencial para acessar outros registros personalizados. A chave
para o item de dicionário será o servidor de login do registro (myregistry.azurecr.io) e
O valor do item serão as credenciais do Registro para acessar o Registro.		 CredenciaisAlfândegaRegistos
sourceRegistry Descreve os parâmetros de credencial para acessar o registro de origem. SourceRegistryCredentials

CredenciaisAlfândegaRegistos

Designação Descrição Valor

CustomRegistryCredentials

Designação Descrição Valor
identidade Indica a identidade gerenciada atribuída à credencial personalizada. Se uma identidade atribuída pelo usuário
esse valor é a ID do cliente. Se uma identidade atribuída ao sistema, o valor será system. Em
no caso de uma identidade atribuída pelo sistema, o ID do Cliente será determinado pelo corredor. Isto
A identidade pode ser usada para autenticar no Cofre de Chaves para recuperar credenciais ou pode ser a única
fonte de autenticação utilizada para aceder ao registo.		 string
palavra-passe A palavra-passe para iniciar sessão no registo personalizado. A palavra-passe é um segredo
objeto que permite várias maneiras de fornecer o valor para ele.		 SecretObject
nome de utilizador O nome de utilizador para iniciar sessão no registo personalizado. SecretObject

DockerBuildStep

Designação Descrição Valor
Argumentos A coleção de argumentos de substituição a serem usados ao executar esta etapa de compilação. Argumento[]
dockerFilePath O caminho do arquivo do Docker relativo ao contexto de origem. string (obrigatório)
imageNames Os nomes de imagem totalmente qualificados, incluindo o repositório e a tag. string[]
isPushEnabled O valor dessa propriedade indica se a imagem construída deve ser enviada por push para o registro ou não. Bool
noCache O valor dessa propriedade indica se o cache de imagem está habilitado ou não. Bool
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
tipo O tipo de etapa. 'Docker' (obrigatório)

EncodedTaskStep

Designação Descrição Valor
encodedTaskContent Valor codificado em Base64 do conteúdo do arquivo de modelo/definição. string (obrigatório)
encodedValuesContent Base64 valor codificado do conteúdo do arquivo de parâmetros/valores. string
tipo O tipo de etapa. 'EncodedTask' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]

FileTaskStep

Designação Descrição Valor
taskFilePath O caminho do arquivo de modelo/definição de tarefa relativo ao contexto de origem. string (obrigatório)
tipo O tipo de etapa. 'FileTask' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]
valoresFilePath O caminho do arquivo de valores/parâmetros da tarefa relativo ao contexto de origem. string

IdentityProperties

Designação Descrição Valor
principalId A ID principal da identidade do recurso. string
inquilinoId A ID do locatário do recurso. string
tipo O tipo de identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities A lista de identidades de usuário associadas ao recurso. A identidade do usuário
as referências de chave de dicionário serão ids de recurso ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.		 IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Designação Descrição Valor

Microsoft.ContainerRegistry/registros/tarefas

Designação Descrição Valor
apiVersion A versão api '2019-04-01'
identidade Identidade do recurso. IdentityProperties
Localização A localização do recurso. Isso não pode ser alterado depois que o recurso é criado. string (obrigatório)
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 50
Padrão = ^[a-zA-Z0-9-_]*$ (obrigatório)
propriedades As propriedades de uma tarefa. TaskProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.ContainerRegistry/registros/tarefas'

Propriedades da plataforma

Designação Descrição Valor
Arquitetura A arquitetura do sistema operacional. «AMD64»
'braço'
'x86'
o O tipo de sistema operacional necessário para a execução. 'Linux'
'Windows' (obrigatório)
variante Variante da CPU. «V6»
«V7»
«V8»

Tags de Recursos

Designação Descrição Valor

Objeto SecretObject

Designação Descrição Valor
tipo O tipo do objeto secreto que determina como o valor do objeto secreto deve ser
interpretado.		 'Opaco'
'Vaultsecret'
valor O valor do segredo. O formato deste valor será determinado
com base no tipo do objeto secreto. Se o tipo for Opaco, o valor será
usado como está, sem qualquer modificação.		 string

SetValue

Designação Descrição Valor
isSecret Sinalizador para indicar se o valor representa um segredo ou não. Bool
Designação O nome do valor substituível. string (obrigatório)
valor O valor substituível. string (obrigatório)

SourceProperties

Designação Descrição Valor
sucursal O nome da ramificação do código-fonte. string
repositoryUrl O URL completo para o repositório de código-fonte string (obrigatório)
sourceControlAuthProperties As propriedades de autorização para acessar o repositório de código-fonte e configurar
Webhooks para notificações.		 AuthInfo
sourceControlType O tipo de serviço de controle do código-fonte. 'Github'
'VisualStudioTeamService' (obrigatório)

SourceRegistryCredentials

Designação Descrição Valor
loginMode O modo de autenticação que determina o escopo de login do Registro de origem. As credenciais para o registro de origem
serão gerados utilizando o âmbito determinado. Estas credenciais serão utilizadas para iniciar sessão em
O registro de origem durante a execução.		 'Inadimplência'
'Nenhuma'

SourceTrigger

Designação Descrição Valor
Designação O nome do gatilho. string (obrigatório)
sourceRepository As propriedades que descrevem o código-fonte (código) da tarefa. SourceProperties (obrigatório)
sourceTriggerEvents O evento de origem correspondente ao gatilho. Matriz de cadeia de caracteres contendo qualquer uma das:
'Comprometer'
'pullrequest' (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

TaskProperties

Designação Descrição Valor
agentConfiguration A configuração da máquina do agente de execução. AgentProperties
Credenciais As propriedades que descrevem um conjunto de credenciais que serão usadas quando essa execução for invocada. Credenciais
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
Situação O status atual da tarefa. 'Desativado'
'Habilitado'
passo a passo As propriedades de uma etapa de tarefa. TaskStepProperties (obrigatório)
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
gatilho As propriedades que descrevem todos os gatilhos para a tarefa. TriggerProperties

TaskStepProperties

Designação Descrição Valor
contextAccessToken O token (git PAT ou token SAS do blob da conta de armazenamento) associado ao contexto de uma etapa. string
contextPath A URL (absoluta ou relativa) do contexto de origem para a etapa da tarefa. string
tipo Defina como 'Docker' para o tipo DockerBuildStep. Defina como 'EncodedTask' para o tipo EncodedTaskStep. Defina como 'FileTask' para o tipo FileTaskStep. 'Portuário'
'EncodedTask'
'FileTask' (obrigatório)

TimerTrigger

Designação Descrição Valor
Designação O nome do gatilho. string (obrigatório)
Horário A expressão CRON para o agendamento de tarefas string (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

TriggerProperties

Designação Descrição Valor
baseImageTrigger O gatilho baseado em dependências de imagem base. BaseImageTrigger
sourceTriggers A coleção de triggers com base no repositório de código-fonte. SourceTrigger[]
timerTriggers A coleção de gatilhos de temporizador. TimerTrigger[]

UserIdentityProperties

Designação Descrição Valor
ID do cliente O ID do cliente da identidade atribuída ao usuário. string
principalId O id principal da identidade atribuída ao usuário. string

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso registros/tarefas pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ContainerRegistry/registries/tasks, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/tasks@2019-04-01"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
          }
        ]
      }
    }
  })
}

Objetos TaskStepProperties

Defina a propriedade type para especificar o tipo de objeto.

Para Docker, use:

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

Para EncodedTask, use:

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

Para FileTask, use:

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

Valores de propriedade

AgentProperties

Designação Descrição Valor
CPU A configuração da CPU em termos de número de núcleos necessários para a execução. Int

Argumento

Designação Descrição Valor
isSecret Sinalizador para indicar se o argumento representa um segredo e deseja ser removido dos logs de compilação. Bool
Designação O nome do argumento. string (obrigatório)
valor O valor do argumento. string (obrigatório)

AuthInfo

Designação Descrição Valor
expira Tempo em segundos em que o token permanece válido Int
refreshToken O token de atualização usado para atualizar o token de acesso. string
Âmbito de aplicação O escopo do token de acesso. string
ficha O token de acesso usado para acessar o provedor de controle do código-fonte. string (obrigatório)
tokenType O tipo de token de autenticação. 'OAuth'
'PAT' (obrigatório)

BaseImageTrigger

Designação Descrição Valor
baseImageTriggerType O tipo do gatilho automático para atualizações de dependência de imagem base. 'Todos'
'Tempo de execução' (obrigatório)
Designação O nome do gatilho. string (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

Credenciais

Designação Descrição Valor
customRegistries Descreve os parâmetros de credencial para acessar outros registros personalizados. A chave
para o item de dicionário será o servidor de login do registro (myregistry.azurecr.io) e
O valor do item serão as credenciais do Registro para acessar o Registro.		 CredenciaisAlfândegaRegistos
sourceRegistry Descreve os parâmetros de credencial para acessar o registro de origem. SourceRegistryCredentials

CredenciaisAlfândegaRegistos

Designação Descrição Valor

CustomRegistryCredentials

Designação Descrição Valor
identidade Indica a identidade gerenciada atribuída à credencial personalizada. Se uma identidade atribuída pelo usuário
esse valor é a ID do cliente. Se uma identidade atribuída ao sistema, o valor será system. Em
no caso de uma identidade atribuída pelo sistema, o ID do Cliente será determinado pelo corredor. Isto
A identidade pode ser usada para autenticar no Cofre de Chaves para recuperar credenciais ou pode ser a única
fonte de autenticação utilizada para aceder ao registo.		 string
palavra-passe A palavra-passe para iniciar sessão no registo personalizado. A palavra-passe é um segredo
objeto que permite várias maneiras de fornecer o valor para ele.		 SecretObject
nome de utilizador O nome de utilizador para iniciar sessão no registo personalizado. SecretObject

DockerBuildStep

Designação Descrição Valor
Argumentos A coleção de argumentos de substituição a serem usados ao executar esta etapa de compilação. Argumento[]
dockerFilePath O caminho do arquivo do Docker relativo ao contexto de origem. string (obrigatório)
imageNames Os nomes de imagem totalmente qualificados, incluindo o repositório e a tag. string[]
isPushEnabled O valor dessa propriedade indica se a imagem construída deve ser enviada por push para o registro ou não. Bool
noCache O valor dessa propriedade indica se o cache de imagem está habilitado ou não. Bool
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
tipo O tipo de etapa. 'Docker' (obrigatório)

EncodedTaskStep

Designação Descrição Valor
encodedTaskContent Valor codificado em Base64 do conteúdo do arquivo de modelo/definição. string (obrigatório)
encodedValuesContent Base64 valor codificado do conteúdo do arquivo de parâmetros/valores. string
tipo O tipo de etapa. 'EncodedTask' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]

FileTaskStep

Designação Descrição Valor
taskFilePath O caminho do arquivo de modelo/definição de tarefa relativo ao contexto de origem. string (obrigatório)
tipo O tipo de etapa. 'FileTask' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]
valoresFilePath O caminho do arquivo de valores/parâmetros da tarefa relativo ao contexto de origem. string

IdentityProperties

Designação Descrição Valor
principalId A ID principal da identidade do recurso. string
inquilinoId A ID do locatário do recurso. string
tipo O tipo de identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities A lista de identidades de usuário associadas ao recurso. A identidade do usuário
as referências de chave de dicionário serão ids de recurso ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.		 IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Designação Descrição Valor

Microsoft.ContainerRegistry/registros/tarefas

Designação Descrição Valor
identidade Identidade do recurso. IdentityProperties
Localização A localização do recurso. Isso não pode ser alterado depois que o recurso é criado. string (obrigatório)
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 50
Padrão = ^[a-zA-Z0-9-_]*$ (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: registos
propriedades As propriedades de uma tarefa. TaskProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.ContainerRegistry/registries/tasks@2019-04-01"

Propriedades da plataforma

Designação Descrição Valor
Arquitetura A arquitetura do sistema operacional. «AMD64»
'braço'
'x86'
o O tipo de sistema operacional necessário para a execução. 'Linux'
'Windows' (obrigatório)
variante Variante da CPU. «V6»
«V7»
«V8»

Tags de Recursos

Designação Descrição Valor

Objeto SecretObject

Designação Descrição Valor
tipo O tipo do objeto secreto que determina como o valor do objeto secreto deve ser
interpretado.		 'Opaco'
'Vaultsecret'
valor O valor do segredo. O formato deste valor será determinado
com base no tipo do objeto secreto. Se o tipo for Opaco, o valor será
usado como está, sem qualquer modificação.		 string

SetValue

Designação Descrição Valor
isSecret Sinalizador para indicar se o valor representa um segredo ou não. Bool
Designação O nome do valor substituível. string (obrigatório)
valor O valor substituível. string (obrigatório)

SourceProperties

Designação Descrição Valor
sucursal O nome da ramificação do código-fonte. string
repositoryUrl O URL completo para o repositório de código-fonte string (obrigatório)
sourceControlAuthProperties As propriedades de autorização para acessar o repositório de código-fonte e configurar
Webhooks para notificações.		 AuthInfo
sourceControlType O tipo de serviço de controle do código-fonte. 'Github'
'VisualStudioTeamService' (obrigatório)

SourceRegistryCredentials

Designação Descrição Valor
loginMode O modo de autenticação que determina o escopo de login do Registro de origem. As credenciais para o registro de origem
serão gerados utilizando o âmbito determinado. Estas credenciais serão utilizadas para iniciar sessão em
O registro de origem durante a execução.		 'Inadimplência'
'Nenhuma'

SourceTrigger

Designação Descrição Valor
Designação O nome do gatilho. string (obrigatório)
sourceRepository As propriedades que descrevem o código-fonte (código) da tarefa. SourceProperties (obrigatório)
sourceTriggerEvents O evento de origem correspondente ao gatilho. Matriz de cadeia de caracteres contendo qualquer uma das:
'Comprometer'
'pullrequest' (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

TaskProperties

Designação Descrição Valor
agentConfiguration A configuração da máquina do agente de execução. AgentProperties
Credenciais As propriedades que descrevem um conjunto de credenciais que serão usadas quando essa execução for invocada. Credenciais
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
Situação O status atual da tarefa. 'Desativado'
'Habilitado'
passo a passo As propriedades de uma etapa de tarefa. TaskStepProperties (obrigatório)
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
gatilho As propriedades que descrevem todos os gatilhos para a tarefa. TriggerProperties

TaskStepProperties

Designação Descrição Valor
contextAccessToken O token (git PAT ou token SAS do blob da conta de armazenamento) associado ao contexto de uma etapa. string
contextPath A URL (absoluta ou relativa) do contexto de origem para a etapa da tarefa. string
tipo Defina como 'Docker' para o tipo DockerBuildStep. Defina como 'EncodedTask' para o tipo EncodedTaskStep. Defina como 'FileTask' para o tipo FileTaskStep. 'Portuário'
'EncodedTask'
'FileTask' (obrigatório)

TimerTrigger

Designação Descrição Valor
Designação O nome do gatilho. string (obrigatório)
Horário A expressão CRON para o agendamento de tarefas string (obrigatório)
Situação O status atual do gatilho. 'Desativado'
'Habilitado'

TriggerProperties

Designação Descrição Valor
baseImageTrigger O gatilho baseado em dependências de imagem base. BaseImageTrigger
sourceTriggers A coleção de triggers com base no repositório de código-fonte. SourceTrigger[]
timerTriggers A coleção de gatilhos de temporizador. TimerTrigger[]

UserIdentityProperties

Designação Descrição Valor
ID do cliente O ID do cliente da identidade atribuída ao usuário. string
principalId O id principal da identidade atribuída ao usuário. string