Microsoft.ContainerRegistry registries/tasks 2019-06-01-preview
Bicep 資源定義
登錄/工作資源類型可以使用目標作業進行部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/tasks 資源,請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {}
}
properties: {
agentConfiguration: {
cpu: int
}
agentPoolName: 'string'
credentials: {
customRegistries: {}
sourceRegistry: {
loginMode: 'string'
}
}
isSystemTask: bool
logTemplate: 'string'
platform: {
architecture: 'string'
os: 'string'
variant: 'string'
}
status: 'string'
step: {
contextAccessToken: 'string'
contextPath: 'string'
type: 'string'
// For remaining properties, see TaskStepProperties objects
}
timeout: int
trigger: {
baseImageTrigger: {
baseImageTriggerType: 'string'
name: 'string'
status: 'string'
updateTriggerEndpoint: 'string'
updateTriggerPayloadType: 'string'
}
sourceTriggers: [
{
name: 'string'
sourceRepository: {
branch: 'string'
repositoryUrl: 'string'
sourceControlAuthProperties: {
expiresIn: int
refreshToken: 'string'
scope: 'string'
token: 'string'
tokenType: 'string'
}
sourceControlType: 'string'
}
sourceTriggerEvents: [
'string'
]
status: 'string'
}
]
timerTriggers: [
{
name: 'string'
schedule: 'string'
status: 'string'
}
]
}
}
}
TaskStepProperties 物件
設定 type 屬性以指定物件的類型。
針對 Docker,請使用:
type: 'Docker'
arguments: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
dockerFilePath: 'string'
imageNames: [
'string'
]
isPushEnabled: bool
noCache: bool
target: 'string'
針對 EncodedTask,請使用:
type: 'EncodedTask'
encodedTaskContent: 'string'
encodedValuesContent: 'string'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
針對 FileTask,請使用:
type: 'FileTask'
taskFilePath: 'string'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
valuesFilePath: 'string'
屬性值
registries/tasks
名稱 | 描述 | 值 |
---|---|---|
NAME | 資源名稱 瞭解如何在 Bicep中設定子資源的名稱和類型。 |
需要字串 () 字元限制:5-50 有效字元: 英數字元、連字號和底線。 |
location | 資源的位置。 建立資源之後,就無法變更此專案。 | 需要字串 () |
tags | 資源的標記。 | 標記名稱和值的字典。 請參閱 範本中的標籤 |
父系 (parent) | 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源外部宣告子資源時,才需要新增此屬性。 如需詳細資訊,請參閱 父資源外部的子資源。 |
類型資源的符號名稱: registries |
身分識別 | 資源的身分識別。 | IdentityProperties |
properties | 工作的屬性。 | TaskProperties |
IdentityProperties
名稱 | 描述 | 值 |
---|---|---|
principalId | 資源識別的主要識別碼。 | 字串 |
tenantId | 資源的租使用者識別碼。 | 字串 |
type | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考的格式會是 ARM 資源識別碼: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
object |
TaskProperties
名稱 | 描述 | 值 |
---|---|---|
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
agentPoolName | 工作的專用代理程式組件區。 | 字串 |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
isSystemTask | 這個屬性的值表示工作資源是否為系統工作。 | bool |
logTemplate | 描述執行記錄成品之存放庫和標記資訊的範本。 | 字串 |
平台 | 執行所針對的平臺屬性。 | PlatformProperties |
status | 工作的目前狀態。 | 'Disabled' 'Enabled' |
步驟 | 工作步驟的屬性。 | TaskStepProperties |
timeout | 以秒為單位執行逾時。 | int |
觸發程序 (trigger) | 描述工作之所有觸發程式的屬性。 | TriggerProperties |
AgentProperties
名稱 | 描述 | 值 |
---|---|---|
cpu | CPU 組態,以執行所需的核心數目來表示。 | int |
認證
名稱 | 描述 | 值 |
---|---|---|
customRegistries | 描述用來存取其他自訂登錄的認證參數。 金鑰 字典專案的 會是登錄登入伺服器, (myregistry.azurecr.io) 和 專案的值將會是用來存取登錄的登錄認證。 |
object |
sourceRegistry | 描述用來存取來源登錄的認證參數。 | SourceRegistryCredentials |
SourceRegistryCredentials
名稱 | 描述 | 值 |
---|---|---|
loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
PlatformProperties
名稱 | 描述 | 值 |
---|---|---|
架構 | OS 架構。 | '386' 'amd64' 'arm' 'arm64' 'x86' |
os | 執行所需的作業系統類型。 | 'Linux' 需要 'Windows' () |
variant | CPU 的變體。 | 'v6' 'v7' 'v8' |
TaskStepProperties
名稱 | 描述 | 值 |
---|---|---|
coNtextAccessToken | 與步驟內容相關聯的儲存體帳戶 Blob 的權杖 (git PAT 或 SAS 權杖) 。 | 字串 |
coNtextPath | URL (工作步驟來源內容的絕對或相對) 。 | 字串 |
type | 設定物件類型 | Docker EncodedTask 需要 FileTask () |
DockerBuildStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 需要 'Docker' () |
引數 | 執行這個建置步驟時要使用的覆寫引數集合。 | Argument[] |
dockerFilePath | 相對於來源內容的 Docker 檔案路徑。 | 需要字串 () |
imageNames | 完整的映射名稱,包括存放庫和標記。 | string[] |
isPushEnabled | 這個屬性的值表示是否應該將建置的映射推送至登錄。 | bool |
noCache | 這個屬性的值表示是否啟用映射快取。 | bool |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
引數
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出引數是否代表秘密,而且想要從組建記錄中移除。 | bool |
NAME | 引數的名稱。 | 需要字串 () |
value | 引數的值。 | 需要字串 () |
EncodedTaskStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 'EncodedTask' (必要) |
encodedTaskContent | 範本/定義檔案內容的 Base64 編碼值。 | 需要字串 () |
encodedValuesContent | 參數/值檔案內容的 Base64 編碼值。 | 字串 |
值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
SetValue
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出值是否代表秘密。 | bool |
NAME | 可覆寫值的名稱。 | 需要字串 () |
value | 可覆寫的值。 | 需要字串 () |
FileTaskStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 'FileTask' (必要) |
taskFilePath | 相對於來源內容的工作範本/定義檔案路徑。 | 需要字串 () |
值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
valuesFilePath | 相對於來源內容的工作值/參數檔案路徑。 | 字串 |
TriggerProperties
名稱 | 描述 | 值 |
---|---|---|
baseImageTrigger | 根據基底映射相依性的觸發程式。 | BaseImageTrigger |
sourceTriggers | 根據原始程式碼存放庫的觸發程式集合。 | SourceTrigger[] |
timerTriggers | 計時器觸發程式的集合。 | TimerTrigger[] |
BaseImageTrigger
名稱 | 描述 | 值 |
---|---|---|
baseImageTriggerType | 基底映射相依性更新的自動觸發程式類型。 | 'All' 需要 'Runtime' () |
NAME | 觸發程序的名稱。 | 需要字串 () |
status | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
updateTriggerEndpoint | 接收更新觸發程式的端點 URL。 | 字串 |
updateTriggerPayloadType | 基底映射更新觸發程式的承載主體類型。 | 'Default' 'Token' |
SourceTrigger
名稱 | 描述 | 值 |
---|---|---|
NAME | 觸發程序的名稱。 | 需要字串 () |
sourceRepository | 描述工作來源 (程式碼) 的屬性。 | SourceProperties (必要) |
sourceTriggerEvents | 對應至觸發程式的來源事件。 | 包含任何專案的字串陣列: 'commit' 'pullrequest' (必要) |
status | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
SourceProperties
名稱 | 描述 | 值 |
---|---|---|
分支 | 原始程式碼的分支名稱。 | 字串 |
repositoryUrl | 原始程式碼存放庫的完整 URL | 字串 (必要) |
sourceControlAuthProperties | 用來存取原始程式碼存放庫和設定的授權屬性 通知的 Webhook。 |
AuthInfo |
sourceControlType | 原始檔控制服務的類型。 | 'Github' 'VisualStudioTeamService' (必要) |
AuthInfo
名稱 | 描述 | 值 |
---|---|---|
expiresIn | 權杖維持有效秒的時間 | int |
refreshToken | 用來重新整理存取權杖的重新整理權杖。 | 字串 |
scope | 存取權杖的範圍。 | 字串 |
token | 用來存取原始檔控制提供者的存取權杖。 | 字串 (必要) |
tokenType | 驗證權杖的類型。 | 'OAuth' 需要 'PAT' () |
TimerTrigger
名稱 | 描述 | 值 |
---|---|---|
NAME | 觸發程序的名稱。 | 字串 (必要) |
schedule | 工作排程的 CRON 運算式 | 字串 (必要) |
status | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
ARM 範本資源定義
登錄/工作資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/tasks 資源,請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.ContainerRegistry/registries/tasks",
"apiVersion": "2019-06-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"agentConfiguration": {
"cpu": "int"
},
"agentPoolName": "string",
"credentials": {
"customRegistries": {},
"sourceRegistry": {
"loginMode": "string"
}
},
"isSystemTask": "bool",
"logTemplate": "string",
"platform": {
"architecture": "string",
"os": "string",
"variant": "string"
},
"status": "string",
"step": {
"contextAccessToken": "string",
"contextPath": "string",
"type": "string"
// For remaining properties, see TaskStepProperties objects
},
"timeout": "int",
"trigger": {
"baseImageTrigger": {
"baseImageTriggerType": "string",
"name": "string",
"status": "string",
"updateTriggerEndpoint": "string",
"updateTriggerPayloadType": "string"
},
"sourceTriggers": [
{
"name": "string",
"sourceRepository": {
"branch": "string",
"repositoryUrl": "string",
"sourceControlAuthProperties": {
"expiresIn": "int",
"refreshToken": "string",
"scope": "string",
"token": "string",
"tokenType": "string"
},
"sourceControlType": "string"
},
"sourceTriggerEvents": [ "string" ],
"status": "string"
}
],
"timerTriggers": [
{
"name": "string",
"schedule": "string",
"status": "string"
}
]
}
}
}
TaskStepProperties 物件
設定 type 屬性以指定物件的類型。
針對 Docker,請使用:
"type": "Docker",
"arguments": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"dockerFilePath": "string",
"imageNames": [ "string" ],
"isPushEnabled": "bool",
"noCache": "bool",
"target": "string"
針對 EncodedTask,請使用:
"type": "EncodedTask",
"encodedTaskContent": "string",
"encodedValuesContent": "string",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
]
針對 FileTask,請使用:
"type": "FileTask",
"taskFilePath": "string",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"valuesFilePath": "string"
屬性值
registries/tasks
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 'Microsoft.ContainerRegistry/registries/tasks' |
apiVersion | 資源 API 版本 | '2019-06-01-preview' |
NAME | 資源名稱 請參閱如何在 JSON ARM 範本中設定子資源的名稱和類型。 |
字串 (必要) 字元限制:5-50 有效字元: 英數字元、連字號和底線。 |
location | 資源的位置。 建立資源之後,就無法變更此專案。 | 字串 (必要) |
tags | 資源的標記。 | 標記名稱和值的字典。 請參閱 範本中的標籤 |
身分識別 | 資源的身分識別。 | IdentityProperties |
properties | 工作的屬性。 | TaskProperties |
IdentityProperties
名稱 | 描述 | 值 |
---|---|---|
principalId | 資源識別的主要識別碼。 | 字串 |
tenantId | 資源的租使用者識別碼。 | 字串 |
type | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考的格式會是 ARM 資源識別碼: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
object |
TaskProperties
名稱 | 描述 | 值 |
---|---|---|
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
agentPoolName | 工作的專用代理程式組件區。 | 字串 |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
isSystemTask | 這個屬性的值表示工作資源是否為系統工作。 | bool |
logTemplate | 描述執行記錄成品之存放庫和標記資訊的範本。 | 字串 |
平台 | 執行所針對的平臺屬性。 | PlatformProperties |
status | 工作的目前狀態。 | 'Disabled' 'Enabled' |
步驟 | 工作步驟的屬性。 | TaskStepProperties |
timeout | 以秒為單位執行逾時。 | int |
觸發程序 (trigger) | 描述工作之所有觸發程式的屬性。 | TriggerProperties |
AgentProperties
名稱 | 描述 | 值 |
---|---|---|
cpu | CPU 組態,以執行所需的核心數目來表示。 | int |
認證
名稱 | 描述 | 值 |
---|---|---|
customRegistries | 描述用來存取其他自訂登錄的認證參數。 金鑰 字典專案的 會是登錄登入伺服器, (myregistry.azurecr.io) 和 專案的值將會是用來存取登錄的登錄認證。 |
object |
sourceRegistry | 描述用來存取來源登錄的認證參數。 | SourceRegistryCredentials |
SourceRegistryCredentials
名稱 | 描述 | 值 |
---|---|---|
loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
PlatformProperties
名稱 | 描述 | 值 |
---|---|---|
架構 | OS 架構。 | '386' 'amd64' 'arm' 'arm64' 'x86' |
os | 執行所需的作業系統類型。 | 'Linux' 需要 'Windows' () |
variant | CPU 的變體。 | 'v6' 'v7' 'v8' |
TaskStepProperties
名稱 | 描述 | 值 |
---|---|---|
coNtextAccessToken | 與步驟內容相關聯的儲存體帳戶 Blob 的權杖 (git PAT 或 SAS 權杖) 。 | 字串 |
coNtextPath | URL (工作步驟來源內容的絕對或相對) 。 | 字串 |
type | 設定物件類型 | Docker EncodedTask 需要 FileTask () |
DockerBuildStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 需要 'Docker' () |
引數 | 執行這個建置步驟時要使用的覆寫引數集合。 | Argument[] |
dockerFilePath | 相對於來源內容的 Docker 檔案路徑。 | 需要字串 () |
imageNames | 完整的映射名稱,包括存放庫和標記。 | string[] |
isPushEnabled | 這個屬性的值表示是否應該將建置的映射推送至登錄。 | bool |
noCache | 這個屬性的值表示是否啟用映射快取。 | bool |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
引數
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出引數是否代表秘密,而且想要從組建記錄中移除。 | bool |
NAME | 引數的名稱。 | 需要字串 () |
value | 引數的值。 | 需要字串 () |
EncodedTaskStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 'EncodedTask' (必要) |
encodedTaskContent | 範本/定義檔案內容的 Base64 編碼值。 | 需要字串 () |
encodedValuesContent | 參數/值檔案內容的 Base64 編碼值。 | 字串 |
值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
SetValue
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出值是否代表秘密。 | bool |
NAME | 可覆寫值的名稱。 | 需要字串 () |
value | 可覆寫的值。 | 需要字串 () |
FileTaskStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 'FileTask' (必要) |
taskFilePath | 相對於來源內容的工作範本/定義檔案路徑。 | 字串 (必要) |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
valuesFilePath | 相對於來源內容的工作值/參數檔案路徑。 | 字串 |
TriggerProperties
名稱 | 描述 | 值 |
---|---|---|
baseImageTrigger | 根據基底映射相依性的觸發程式。 | BaseImageTrigger |
sourceTriggers | 根據原始程式碼存放庫的觸發程式集合。 | SourceTrigger[] |
timerTriggers | 計時器觸發程式的集合。 | TimerTrigger[] |
BaseImageTrigger
名稱 | 描述 | 值 |
---|---|---|
baseImageTriggerType | 基底映射相依性更新的自動觸發程式類型。 | 'All' 需要 'Runtime' () |
NAME | 觸發程序的名稱。 | 字串 (必要) |
status | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
updateTriggerEndpoint | 接收更新觸發程式的端點 URL。 | 字串 |
updateTriggerPayloadType | 基底映射更新觸發程式的承載主體類型。 | 'Default' 'Token' |
SourceTrigger
名稱 | 描述 | 值 |
---|---|---|
NAME | 觸發程序的名稱。 | 字串 (必要) |
sourceRepository | 描述工作來源 (程式碼) 的屬性。 | SourceProperties (必要) |
sourceTriggerEvents | 對應至觸發程式的來源事件。 | 包含任何專案的字串陣列: 'commit' 'pullrequest' (必要) |
status | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
SourceProperties
名稱 | 描述 | 值 |
---|---|---|
分支 | 原始程式碼的分支名稱。 | 字串 |
repositoryUrl | 原始程式碼存放庫的完整 URL | 字串 (必要) |
sourceControlAuthProperties | 用來存取原始程式碼存放庫和設定的授權屬性 通知的 Webhook。 |
AuthInfo |
sourceControlType | 原始檔控制服務的類型。 | 'Github' 'VisualStudioTeamService' (必要) |
AuthInfo
名稱 | 描述 | 值 |
---|---|---|
expiresIn | 權杖維持有效秒的時間 | int |
refreshToken | 用來重新整理存取權杖的重新整理權杖。 | 字串 |
scope | 存取權杖的範圍。 | 字串 |
token | 用來存取原始檔控制提供者的存取權杖。 | 字串 (必要) |
tokenType | 驗證權杖的類型。 | 'OAuth' 需要 'PAT' () |
TimerTrigger
名稱 | 描述 | 值 |
---|---|---|
NAME | 觸發程序的名稱。 | 字串 (必要) |
schedule | 工作排程的 CRON 運算式 | 字串 (必要) |
status | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
Terraform (AzAPI 提供者) 資源定義
登錄/工作資源類型可以使用目標作業來部署:
- 資源群組
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/tasks 資源,請將下列 Terraform 新增至您的範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
agentConfiguration = {
cpu = int
}
agentPoolName = "string"
credentials = {
customRegistries = {}
sourceRegistry = {
loginMode = "string"
}
}
isSystemTask = bool
logTemplate = "string"
platform = {
architecture = "string"
os = "string"
variant = "string"
}
status = "string"
step = {
contextAccessToken = "string"
contextPath = "string"
type = "string"
// For remaining properties, see TaskStepProperties objects
}
timeout = int
trigger = {
baseImageTrigger = {
baseImageTriggerType = "string"
name = "string"
status = "string"
updateTriggerEndpoint = "string"
updateTriggerPayloadType = "string"
}
sourceTriggers = [
{
name = "string"
sourceRepository = {
branch = "string"
repositoryUrl = "string"
sourceControlAuthProperties = {
expiresIn = int
refreshToken = "string"
scope = "string"
token = "string"
tokenType = "string"
}
sourceControlType = "string"
}
sourceTriggerEvents = [
"string"
]
status = "string"
}
]
timerTriggers = [
{
name = "string"
schedule = "string"
status = "string"
}
]
}
}
})
}
TaskStepProperties 物件
設定 type 屬性以指定物件的類型。
針對 Docker,請使用:
type = "Docker"
arguments = [
{
isSecret = bool
name = "string"
value = "string"
}
]
dockerFilePath = "string"
imageNames = [
"string"
]
isPushEnabled = bool
noCache = bool
target = "string"
針對 EncodedTask,請使用:
type = "EncodedTask"
encodedTaskContent = "string"
encodedValuesContent = "string"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
針對 FileTask,請使用:
type = "FileTask"
taskFilePath = "string"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
valuesFilePath = "string"
屬性值
registries/tasks
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 「Microsoft.ContainerRegistry/registries/tasks@2019-06-01-preview」 |
NAME | 資源名稱 | 字串 (必要) 字元限制:5-50 有效字元: 英數字元、連字號和底線。 |
location | 資源的位置。 建立資源之後,就無法變更此專案。 | 字串 (必要) |
parent_id | 此資源之父系的資源識別碼。 | 類型資源的 識別碼:登錄 |
tags | 資源的標記。 | 標記名稱和值的字典。 |
身分識別 | 資源的身分識別。 | IdentityProperties |
properties | 工作的屬性。 | TaskProperties |
IdentityProperties
名稱 | 描述 | 值 |
---|---|---|
類型 | 識別類型。 | 「SystemAssigned」 「SystemAssigned, UserAssigned」 「UserAssigned」 |
identity_ids | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考將會是格式為 ARM 資源識別碼: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
使用者身分識別識別碼的陣列。 |
TaskProperties
名稱 | 描述 | 值 |
---|---|---|
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
agentPoolName | 工作的專用代理程式組件區。 | 字串 |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
isSystemTask | 這個屬性的值會指出工作資源是否為系統工作。 | bool |
logTemplate | 描述執行記錄成品之存放庫和標記資訊的範本。 | 字串 |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties |
status | 工作的目前狀態。 | 「Disabled」 「Enabled」 |
步驟 | 工作步驟的屬性。 | TaskStepProperties |
timeout | 以秒為單位執行逾時。 | int |
觸發程序 (trigger) | 描述工作所有觸發程式的屬性。 | TriggerProperties |
AgentProperties
名稱 | 描述 | 值 |
---|---|---|
cpu | 針對執行所需的核心數目,CPU 組態。 | int |
認證
名稱 | 描述 | 值 |
---|---|---|
customRegistries | 描述用來存取其他自訂登錄的認證參數。 金鑰 字典專案的登錄登入伺服器 (myregistry.azurecr.io) 和 專案的值將會是用來存取登錄的登錄認證。 |
object |
sourceRegistry | 描述用來存取來源登錄的認證參數。 | SourceRegistryCredentials |
SourceRegistryCredentials
名稱 | 描述 | 值 |
---|---|---|
loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
「Default」 "None" |
PlatformProperties
名稱 | 描述 | 值 |
---|---|---|
架構 | OS 架構。 | "386" 「amd64」 「arm」 「arm64」 「x86」 |
os | 執行所需的作業系統類型。 | "Linux" 「Windows」 (必要) |
variant | CPU 的變體。 | 「v6」 「v7」 「v8」 |
TaskStepProperties
名稱 | 描述 | 值 |
---|---|---|
coNtextAccessToken | 與步驟內容相關聯的權杖 (git PAT 或儲存體帳戶 Blob 的 SAS 權杖) 。 | 字串 |
coNtextPath | URL (工作步驟來源內容的絕對或相對) 。 | 字串 |
type | 設定物件類型 | Docker EncodedTask 需要 FileTask () |
DockerBuildStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 「Docker」 (必要) |
引數 | 執行這個建置步驟時要使用的覆寫引數集合。 | Argument[] |
dockerFilePath | 相對於來源內容的 Docker 檔案路徑。 | 字串 (必要) |
imageNames | 完整的映射名稱,包括存放庫和標記。 | string[] |
isPushEnabled | 這個屬性的值表示是否應該將建置的映射推送至登錄。 | bool |
noCache | 這個屬性的值會指出是否啟用映射快取。 | bool |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
引數
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出引數是否代表秘密,而且想要從組建記錄中移除。 | bool |
NAME | 引數的名稱。 | 字串 (必要) |
value | 引數的值。 | 字串 (必要) |
EncodedTaskStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 需要 「EncodedTask」 () |
encodedTaskContent | 範本/定義檔案內容的 Base64 編碼值。 | 字串 (必要) |
encodedValuesContent | 參數/值檔案內容的 Base64 編碼值。 | 字串 |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
SetValue
名稱 | 描述 | 值 |
---|---|---|
isSecret | 指出值是否代表秘密的旗標。 | bool |
NAME | 可覆寫值的名稱。 | 字串 (必要) |
value | 可覆寫的值。 | 字串 (必要) |
FileTaskStep
名稱 | 描述 | 值 |
---|---|---|
類型 | 步驟的類型。 | 「FileTask」 (必要) |
taskFilePath | 相對於來源內容的工作範本/定義檔案路徑。 | 字串 (必要) |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
valuesFilePath | 相對於來源內容的工作值/參數檔案路徑。 | 字串 |
TriggerProperties
名稱 | 描述 | 值 |
---|---|---|
baseImageTrigger | 根據基底映射相依性的觸發程式。 | BaseImageTrigger |
sourceTriggers | 根據原始程式碼存放庫的觸發程式集合。 | SourceTrigger[] |
timerTriggers | 計時器觸發程式的集合。 | TimerTrigger[] |
BaseImageTrigger
名稱 | 描述 | 值 |
---|---|---|
baseImageTriggerType | 基底映射相依性更新的自動觸發程式類型。 | "All" 「執行時間」 (必要) |
NAME | 觸發程序的名稱。 | 字串 (必要) |
status | 觸發程式的目前狀態。 | 「Disabled」 「Enabled」 |
updateTriggerEndpoint | 接收更新觸發程式的端點 URL。 | 字串 |
updateTriggerPayloadType | 基底映射更新觸發程式的承載主體類型。 | 「Default」 「Token」 |
SourceTrigger
名稱 | 描述 | 值 |
---|---|---|
NAME | 觸發程序的名稱。 | 字串 (必要) |
sourceRepository | 描述工作來源 (程式碼) 的屬性。 | SourceProperties (必要) |
sourceTriggerEvents | 對應至觸發程式的來源事件。 | 包含任何專案的字串陣列: 「commit」 「pullrequest」 (必要) |
status | 觸發程式的目前狀態。 | 「Disabled」 「Enabled」 |
SourceProperties
名稱 | 描述 | 值 |
---|---|---|
分支 | 原始程式碼的分支名稱。 | 字串 |
repositoryUrl | 原始程式碼存放庫的完整 URL | 字串 (必要) |
sourceControlAuthProperties | 用來存取原始程式碼存放庫和設定的授權屬性 通知的 Webhook。 |
AuthInfo |
sourceControlType | 原始檔控制服務的類型。 | 「Github」 「VisualStudioTeamService」 (必要) |
AuthInfo
名稱 | 描述 | 值 |
---|---|---|
expiresIn | 權杖維持有效秒的時間 | int |
refreshToken | 用來重新整理存取權杖的重新整理權杖。 | 字串 |
scope | 存取權杖的範圍。 | 字串 |
token | 用來存取原始檔控制提供者的存取權杖。 | 字串 (必要) |
tokenType | 驗證權杖的類型。 | 「OAuth」 必要) 「PAT」 ( |
TimerTrigger
名稱 | 描述 | 值 |
---|---|---|
NAME | 觸發程序的名稱。 | 字串 (必要) |
schedule | 工作排程的 CRON 運算式 | 字串 (必要) |
status | 觸發程式的目前狀態。 | 「Disabled」 「Enabled」 |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應