Partilhar via


Registros Microsoft.ContainerRegistry/taskRuns

Definição de recursos do bíceps

O tipo de recurso registros/taskRuns pode ser implantado com operações direcionadas:

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/taskRuns, adicione o seguinte Bíceps ao seu modelo.

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

Objetos RunRequest

Defina a propriedade type para especificar o tipo de objeto.

Para DockerBuildRequest , use:

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

Para EncodedTaskRunRequest, use:

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

Para FileTaskRunRequest , use:

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

Para TaskRunRequest , use:

{
  overrideTaskStepProperties: {
    arguments: [
      {
        isSecret: bool
        name: 'string'
        value: 'string'
      }
    ]
    contextPath: 'string'
    file: 'string'
    target: 'string'
    updateTriggerToken: 'string'
    values: [
      {
        isSecret: bool
        name: 'string'
        value: 'string'
      }
    ]
  }
  taskId: 'string'
  type: 'TaskRunRequest'
}

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)

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

DockerBuildRequest

Designação Descrição Valor
agentConfiguration A configuração da máquina do agente de execução. AgentProperties
Argumentos A coleção de argumentos de substituição a serem usados ao executar a execução. Argumento[]
Credenciais As propriedades que descrevem um conjunto de credenciais que serão usadas quando essa execução for invocada. Credenciais
dockerFilePath O caminho do arquivo do Docker relativo ao local 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
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'DockerBuildRequest' (obrigatório)

EncodedTaskRunRequest

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
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
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'EncodedTaskRunRequest' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]

FileTaskRunRequest

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)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
taskFilePath O caminho do arquivo de modelo/definição relativo à origem. string (obrigatório)
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'FileTaskRunRequest' (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 em relação à 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/registries/taskRuns

Designação Descrição Valor
identidade Identidade do recurso. IdentityProperties
Localização A localização do recurso string
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 associadas à execução da tarefa, ou seja, solicitação e resultado da execução TaskRunProperties

OverrideTaskStepProperties

Designação Descrição Valor
Argumentos Obtém ou define a coleção de argumentos de substituição a serem usados quando
executando uma etapa de compilação.
Argumento[]
contextPath O contexto de origem no qual a execução deve ser enfileirada. string
arquivo O arquivo contra o qual a execução deve ser enfileirada. string
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
updateTriggerToken Token de gatilho de atualização codificado em Base64 que será anexado com o webhook de gatilho de imagem base. string
valores A coleção de valores substituíveis que podem ser passados ao executar uma Tarefa. SetValue[]

Propriedades da plataforma

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

RunRequest

Designação Descrição Valor
agentPoolName O pool de agentes dedicado para a execução. string
isArchiveEnabled O valor que indica se o arquivamento está habilitado para a execução ou não. Bool
logTemplate O modelo que descreve as informações do repositório e da marca para o artefato de log de execução. string
tipo Defina como 'DockerBuildRequest' para o tipo DockerBuildRequest. Defina como 'EncodedTaskRunRequest' para o tipo EncodedTaskRunRequest. Defina como 'FileTaskRunRequest' para o tipo FileTaskRunRequest. Defina como 'TaskRunRequest' para o tipo TaskRunRequest. 'DockerBuildRequest'
'EncodedTaskRunRequest'
'FileTaskRunRequest'
'TaskRunRequest' (obrigatório)

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)

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'

TaskRunProperties

Designação Descrição Valor
forceUpdateTag Como a execução deve ser forçada a ser executada novamente, mesmo que a configuração da solicitação de execução não tenha sido alterada string
runRequest A solicitação (parâmetros) para a execução RunRequest

TaskRunRequest

Designação Descrição Valor
overrideTaskStepProperties Conjunto de parâmetros substituíveis que podem ser passados ao executar uma tarefa. OverrideTaskStepProperties
taskId A ID do recurso da tarefa em relação à qual a execução deve ser enfileirada. string (obrigatório)
tipo O tipo da solicitação de execução. 'TaskRunRequest' (obrigatório)

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/taskRuns pode ser implantado com operações direcionadas:

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/taskRuns, adicione o seguinte JSON ao seu modelo.

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

Objetos RunRequest

Defina a propriedade type para especificar o tipo de objeto.

Para DockerBuildRequest , use:

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

Para EncodedTaskRunRequest, use:

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

Para FileTaskRunRequest , use:

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

Para TaskRunRequest , use:

{
  "overrideTaskStepProperties": {
    "arguments": [
      {
        "isSecret": "bool",
        "name": "string",
        "value": "string"
      }
    ],
    "contextPath": "string",
    "file": "string",
    "target": "string",
    "updateTriggerToken": "string",
    "values": [
      {
        "isSecret": "bool",
        "name": "string",
        "value": "string"
      }
    ]
  },
  "taskId": "string",
  "type": "TaskRunRequest"
}

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)

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

DockerBuildRequest

Designação Descrição Valor
agentConfiguration A configuração da máquina do agente de execução. AgentProperties
Argumentos A coleção de argumentos de substituição a serem usados ao executar a execução. Argumento[]
Credenciais As propriedades que descrevem um conjunto de credenciais que serão usadas quando essa execução for invocada. Credenciais
dockerFilePath O caminho do arquivo do Docker relativo ao local 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
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'DockerBuildRequest' (obrigatório)

EncodedTaskRunRequest

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
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
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'EncodedTaskRunRequest' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]

FileTaskRunRequest

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)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
taskFilePath O caminho do arquivo de modelo/definição relativo à origem. string (obrigatório)
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'FileTaskRunRequest' (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 em relação à 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/registries/taskRuns

Designação Descrição Valor
apiVersion A versão api '2019-06-01-pré-visualização'
identidade Identidade do recurso. IdentityProperties
Localização A localização do recurso string
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 associadas à execução da tarefa, ou seja, solicitação e resultado da execução TaskRunProperties
tipo O tipo de recurso 'Microsoft.ContainerRegistry/registries/taskRuns'

OverrideTaskStepProperties

Designação Descrição Valor
Argumentos Obtém ou define a coleção de argumentos de substituição a serem usados quando
executando uma etapa de compilação.
Argumento[]
contextPath O contexto de origem no qual a execução deve ser enfileirada. string
arquivo O arquivo contra o qual a execução deve ser enfileirada. string
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
updateTriggerToken Token de gatilho de atualização codificado em Base64 que será anexado com o webhook de gatilho de imagem base. string
valores A coleção de valores substituíveis que podem ser passados ao executar uma Tarefa. SetValue[]

Propriedades da plataforma

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

RunRequest

Designação Descrição Valor
agentPoolName O pool de agentes dedicado para a execução. string
isArchiveEnabled O valor que indica se o arquivamento está habilitado para a execução ou não. Bool
logTemplate O modelo que descreve as informações do repositório e da marca para o artefato de log de execução. string
tipo Defina como 'DockerBuildRequest' para o tipo DockerBuildRequest. Defina como 'EncodedTaskRunRequest' para o tipo EncodedTaskRunRequest. Defina como 'FileTaskRunRequest' para o tipo FileTaskRunRequest. Defina como 'TaskRunRequest' para o tipo TaskRunRequest. 'DockerBuildRequest'
'EncodedTaskRunRequest'
'FileTaskRunRequest'
'TaskRunRequest' (obrigatório)

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)

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'

TaskRunProperties

Designação Descrição Valor
forceUpdateTag Como a execução deve ser forçada a ser executada novamente, mesmo que a configuração da solicitação de execução não tenha sido alterada string
runRequest A solicitação (parâmetros) para a execução RunRequest

TaskRunRequest

Designação Descrição Valor
overrideTaskStepProperties Conjunto de parâmetros substituíveis que podem ser passados ao executar uma tarefa. OverrideTaskStepProperties
taskId A ID do recurso da tarefa em relação à qual a execução deve ser enfileirada. string (obrigatório)
tipo O tipo da solicitação de execução. 'TaskRunRequest' (obrigatório)

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/taskRuns pode ser implantado com operações direcionadas:

  • 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/taskRuns, adicione o seguinte Terraform ao seu modelo.

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

Objetos RunRequest

Defina a propriedade type para especificar o tipo de objeto.

Para DockerBuildRequest , use:

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

Para EncodedTaskRunRequest, use:

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

Para FileTaskRunRequest , use:

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

Para TaskRunRequest , use:

{
  overrideTaskStepProperties = {
    arguments = [
      {
        isSecret = bool
        name = "string"
        value = "string"
      }
    ]
    contextPath = "string"
    file = "string"
    target = "string"
    updateTriggerToken = "string"
    values = [
      {
        isSecret = bool
        name = "string"
        value = "string"
      }
    ]
  }
  taskId = "string"
  type = "TaskRunRequest"
}

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)

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

DockerBuildRequest

Designação Descrição Valor
agentConfiguration A configuração da máquina do agente de execução. AgentProperties
Argumentos A coleção de argumentos de substituição a serem usados ao executar a execução. Argumento[]
Credenciais As propriedades que descrevem um conjunto de credenciais que serão usadas quando essa execução for invocada. Credenciais
dockerFilePath O caminho do arquivo do Docker relativo ao local 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
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'DockerBuildRequest' (obrigatório)

EncodedTaskRunRequest

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
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
plataforma As propriedades da plataforma contra as quais a execução tem que acontecer. PlatformProperties (obrigatório)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'EncodedTaskRunRequest' (obrigatório)
valores A coleção de valores substituíveis que podem ser passados ao executar uma tarefa. SetValue[]

FileTaskRunRequest

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)
fonteLocalização O URL (absoluto ou relativo) do contexto de origem. Pode ser uma URL para um repositório tar ou git.
Se for URL relativa, o caminho relativo deve ser obtido chamando listBuildSourceUploadUrl API.
string
taskFilePath O caminho do arquivo de modelo/definição relativo à origem. string (obrigatório)
tempo limite Execute o tempo limite em segundos. Int

Restrições:
Valor mínimo = 300
Valor máximo = 28800
tipo O tipo da solicitação de execução. 'FileTaskRunRequest' (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 em relação à 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/registries/taskRuns

Designação Descrição Valor
identidade Identidade do recurso. IdentityProperties
Localização A localização do recurso string
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 associadas à execução da tarefa, ou seja, solicitação e resultado da execução TaskRunProperties
tipo O tipo de recurso "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"

OverrideTaskStepProperties

Designação Descrição Valor
Argumentos Obtém ou define a coleção de argumentos de substituição a serem usados quando
executando uma etapa de compilação.
Argumento[]
contextPath O contexto de origem no qual a execução deve ser enfileirada. string
arquivo O arquivo contra o qual a execução deve ser enfileirada. string
público-alvo O nome do estágio de compilação de destino para a compilação do docker. string
updateTriggerToken Token de gatilho de atualização codificado em Base64 que será anexado com o webhook de gatilho de imagem base. string
valores A coleção de valores substituíveis que podem ser passados ao executar uma Tarefa. SetValue[]

Propriedades da plataforma

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

RunRequest

Designação Descrição Valor
agentPoolName O pool de agentes dedicado para a execução. string
isArchiveEnabled O valor que indica se o arquivamento está habilitado para a execução ou não. Bool
logTemplate O modelo que descreve as informações do repositório e da marca para o artefato de log de execução. string
tipo Defina como 'DockerBuildRequest' para o tipo DockerBuildRequest. Defina como 'EncodedTaskRunRequest' para o tipo EncodedTaskRunRequest. Defina como 'FileTaskRunRequest' para o tipo FileTaskRunRequest. Defina como 'TaskRunRequest' para o tipo TaskRunRequest. 'DockerBuildRequest'
'EncodedTaskRunRequest'
'FileTaskRunRequest'
'TaskRunRequest' (obrigatório)

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)

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'

TaskRunProperties

Designação Descrição Valor
forceUpdateTag Como a execução deve ser forçada a ser executada novamente, mesmo que a configuração da solicitação de execução não tenha sido alterada string
runRequest A solicitação (parâmetros) para a execução RunRequest

TaskRunRequest

Designação Descrição Valor
overrideTaskStepProperties Conjunto de parâmetros substituíveis que podem ser passados ao executar uma tarefa. OverrideTaskStepProperties
taskId A ID do recurso da tarefa em relação à qual a execução deve ser enfileirada. string (obrigatório)
tipo O tipo da solicitação de execução. 'TaskRunRequest' (obrigatório)

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