Microsoft.ContainerRegistry 登錄/工作 2019-04-01
Bicep 資源定義
登錄/工作資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/tasks 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@2019-04-01' = {
parent: resourceSymbolicName
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {
{customized property}: {
clientId: 'string'
principalId: 'string'
}
}
}
location: 'string'
name: 'string'
properties: {
agentConfiguration: {
cpu: int
}
credentials: {
customRegistries: {
{customized property}: {
identity: 'string'
password: {
type: 'string'
value: 'string'
}
userName: {
type: 'string'
value: 'string'
}
}
}
sourceRegistry: {
loginMode: 'string'
}
}
platform: {
architecture: 'string'
os: 'string'
variant: 'string'
}
status: 'string'
step: {
contextAccessToken: 'string'
contextPath: 'string'
type: 'string'
// For remaining properties, see TaskStepProperties objects
}
timeout: int
trigger: {
baseImageTrigger: {
baseImageTriggerType: 'string'
name: 'string'
status: 'string'
}
sourceTriggers: [
{
name: 'string'
sourceRepository: {
branch: 'string'
repositoryUrl: 'string'
sourceControlAuthProperties: {
expiresIn: int
refreshToken: 'string'
scope: 'string'
token: 'string'
tokenType: 'string'
}
sourceControlType: 'string'
}
sourceTriggerEvents: [
'string'
]
status: 'string'
}
]
timerTriggers: [
{
name: 'string'
schedule: 'string'
status: 'string'
}
]
}
}
tags: {
{customized property}: 'string'
}
}
TaskStepProperties 物件
設定 類型 屬性，以指定物件的類型。
針對 Docker，請使用：
{
arguments: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
dockerFilePath: 'string'
imageNames: [
'string'
]
isPushEnabled: bool
noCache: bool
target: 'string'
type: 'Docker'
}
針對 EncodedTask，請使用：
{
encodedTaskContent: 'string'
encodedValuesContent: 'string'
type: 'EncodedTask'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
}
針對 FileTask，請使用：
{
taskFilePath: 'string'
type: 'FileTask'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
valuesFilePath: 'string'
}
屬性值
AgentProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 中央處理器 | 針對執行所需的核心數目，CPU 組態。 | int |
論點
| 名字 | 描述 | 價值 |
|---|---|---|
| isSecret | 旗標，指出自變數是否代表秘密，而且想要從組建記錄中移除。 | bool |
| 名字 | 自變數的名稱。 | 字串 （必要） |
| 價值 | 自變數的值。 | 字串 （必要） |
AuthInfo
| 名字 | 描述 | 價值 |
|---|---|---|
| expiresIn | 令牌維持有效秒的時間 | int |
| refreshToken | 用來重新整理存取令牌的重新整理令牌。 | 字串 |
| 範圍 | 存取令牌的範圍。 | 字串 |
| 令牌 | 用來存取原始檔控制提供者的存取令牌。 | 字串 （必要） |
| tokenType | 驗證令牌的類型。 | 'OAuth' 'PAT' （必要） |
BaseImageTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| baseImageTriggerType | 基底映像相依性更新的自動觸發程序類型。 | 'All' 'Runtime' （必要） |
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
憑據
| 名字 | 描述 | 價值 |
|---|---|---|
| customRegistries | 描述存取其他自定義登錄的認證參數。 機碼 字典專案的 是登錄登入伺服器 （myregistry.azurecr.io） 和 專案的值將會是用來存取登錄的登錄認證。 |
CredentialsCustomRegistries |
| sourceRegistry | 描述存取來源登錄的認證參數。 | SourceRegistryCredentials |
CredentialsCustomRegistries
| 名字 | 描述 | 價值 |
|---|
CustomRegistryCredentials
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 指出指派給自定義認證的受控識別。 如果使用者指派的身分識別 此值為用戶端識別碼。 如果系統指派的身分識別，此值將會 system。 在系統指派的身分識別案例，用戶端標識碼將由執行器決定。 這 身分識別可用來向金鑰保存庫進行驗證以擷取認證，或可能是唯一的 用於存取登錄的驗證來源。 |
字串 |
| 密碼 | 登入自定義登錄的密碼。 密碼是秘密 物件，可讓多種方式為其提供值。 |
SecretObject |
| userName | 登入自定義登錄的用戶名稱。 | SecretObject |
DockerBuildStep
| 名字 | 描述 | 價值 |
|---|---|---|
| 參數 | 執行此建置步驟時要使用的覆寫自變數集合。 | 自變數[] |
| dockerFilePath | 相對於來源內容的 Docker 檔案路徑。 | 字串 （必要） |
| imageNames | 完整的映像名稱，包括存放庫和標記。 | string[] |
| isPushEnabled | 這個屬性的值表示是否應該將建置的映像推送至登錄。 | bool |
| noCache | 這個屬性的值表示是否啟用映像快取。 | bool |
| 目標 | Docker 組建的目標建置階段名稱。 | 字串 |
| 類型 | 步驟的類型。 | 'Docker' （必要） |
EncodedTaskStep
| 名字 | 描述 | 價值 |
|---|---|---|
| encodedTaskContent | 範本/定義檔案內容的Base64編碼值。 | 字串 （必要） |
| encodedValuesContent | 參數/值檔案內容的Base64編碼值。 | 字串 |
| 類型 | 步驟的類型。 | 'EncodedTask' （必要） |
| 值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
FileTaskStep
| 名字 | 描述 | 價值 |
|---|---|---|
| taskFilePath | 相對於來源內容的工作範本/定義檔案路徑。 | 字串 （必要） |
| 類型 | 步驟的類型。 | 'FileTask' （必要） |
| 值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
| valuesFilePath | 相對於來源內容的工作值/參數檔案路徑。 | 字串 |
IdentityProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| principalId | 資源識別的主要標識碼。 | 字串 |
| tenantId | 資源的租用戶標識碼。 | 字串 |
| 類型 | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned， UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考的格式會是 ARM 資源識別碼： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
IdentityPropertiesUserAssignedIdentities |
IdentityPropertiesUserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
Microsoft.ContainerRegistry/registries/tasks
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 資源的身分識別。 | IdentityProperties |
| 位置 | 資源的位置。 建立資源之後，就無法變更此專案。 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 5 最大長度 = 5 模式 = ^[a-zA-Z0-9-_]*$ （必要） |
| 父母 | 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。 |
類型資源的符號名稱：登錄 |
| 性能 | 工作的屬性。 | TaskProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
PlatformProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 建築 | OS 架構。 | 'amd64' 'arm' 'x86' |
| 操作系統 | 執行所需的作業系統類型。 | 'Linux' 'Windows' （必要） |
| 變體 | CPU 的變體。 | 'v6' 'v7' 'v8' |
ResourceTags
| 名字 | 描述 | 價值 |
|---|
SecretObject
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 秘密物件的型別，決定秘密物件的值必須如何 解釋。 |
'不透明' 'Vaultsecret' |
| 價值 | 秘密的值。 將決定此值的格式 根據秘密物件的類型。 如果類型為不透明，則值會是 使用 為 ，而不需要任何修改。 |
字串 |
SetValue
| 名字 | 描述 | 價值 |
|---|---|---|
| isSecret | 指出值是否代表秘密的旗標。 | bool |
| 名字 | 可覆寫值的名稱。 | 字串 （必要） |
| 價值 | 可覆寫的值。 | 字串 （必要） |
SourceProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 分支 | 原始碼的分支名稱。 | 字串 |
| repositoryUrl | 原始程式碼存放庫的完整 URL | 字串 （必要） |
| sourceControlAuthProperties | 存取原始程式碼存放庫和設定的授權屬性 通知的 Webhook。 |
AuthInfo |
| sourceControlType | 原始檔控制服務的類型。 | 'Github' 'VisualStudioTeamService' （必要） |
SourceRegistryCredentials
| 名字 | 描述 | 價值 |
|---|---|---|
| loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
SourceTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| sourceRepository | 描述工作之原始程式碼的屬性。 | SourceProperties （必要） |
| sourceTriggerEvents | 對應至觸發程式的來源事件。 | 包含任何的字串數組： 'commit' 'pullrequest' （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
TaskProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
| 憑據 | 屬性，描述叫用此執行時將使用的一組認證。 | 認證 |
| 平臺 | 執行所針對的平台屬性。 | PlatformProperties （必要） |
| 地位 | 工作的目前狀態。 | 'Disabled' 'Enabled' |
| 步 | 工作步驟的屬性。 | TaskStepProperties （必要） |
| 超時 | 以秒為單位執行逾時。 | int 約束： 最小值 = 300 最大值 = 28800 |
| 觸發 | 描述工作所有觸發程序的屬性。 | TriggerProperties |
TaskStepProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| contextAccessToken | 與步驟內容相關聯的令牌（git PAT 或記憶體帳戶 Blob 的 SAS 令牌）。 | 字串 |
| contextPath | 工作步驟來源內容的 URL（絕對或相對）。 | 字串 |
| 類型 | 針對 DockerBuildStep 類型設定為 'Docker'，。 針對 type EncodedTaskStep設定為 'EncodedTask'。 針對 fileTaskStep 類型設定為 'FileTask'，。 | 'Docker' 'EncodedTask' 'FileTask' （必要） |
TimerTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| 附表 | 工作排程的CRON表達式 | 字串 （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
TriggerProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| baseImageTrigger | 以基底映像相依性為基礎的觸發程式。 | BaseImageTrigger |
| sourceTriggers | 以原始程式碼存放庫為基礎的觸發程式集合。 | SourceTrigger[] |
| timerTriggers | 定時器觸發程式的集合。 | TimerTrigger[] |
UserIdentityProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| clientId | 使用者指派身分識別的用戶端標識碼。 | 字串 |
| principalId | 使用者指派身分識別的主體標識碼。 | 字串 |
ARM 樣本資源定義
登錄/工作資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/tasks 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.ContainerRegistry/registries/tasks",
"apiVersion": "2019-04-01",
"name": "string",
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
"clientId": "string",
"principalId": "string"
}
}
},
"location": "string",
"properties": {
"agentConfiguration": {
"cpu": "int"
},
"credentials": {
"customRegistries": {
"{customized property}": {
"identity": "string",
"password": {
"type": "string",
"value": "string"
},
"userName": {
"type": "string",
"value": "string"
}
}
},
"sourceRegistry": {
"loginMode": "string"
}
},
"platform": {
"architecture": "string",
"os": "string",
"variant": "string"
},
"status": "string",
"step": {
"contextAccessToken": "string",
"contextPath": "string",
"type": "string"
// For remaining properties, see TaskStepProperties objects
},
"timeout": "int",
"trigger": {
"baseImageTrigger": {
"baseImageTriggerType": "string",
"name": "string",
"status": "string"
},
"sourceTriggers": [
{
"name": "string",
"sourceRepository": {
"branch": "string",
"repositoryUrl": "string",
"sourceControlAuthProperties": {
"expiresIn": "int",
"refreshToken": "string",
"scope": "string",
"token": "string",
"tokenType": "string"
},
"sourceControlType": "string"
},
"sourceTriggerEvents": [ "string" ],
"status": "string"
}
],
"timerTriggers": [
{
"name": "string",
"schedule": "string",
"status": "string"
}
]
}
},
"tags": {
"{customized property}": "string"
}
}
TaskStepProperties 物件
設定 類型 屬性，以指定物件的類型。
針對 Docker，請使用：
{
"arguments": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"dockerFilePath": "string",
"imageNames": [ "string" ],
"isPushEnabled": "bool",
"noCache": "bool",
"target": "string",
"type": "Docker"
}
針對 EncodedTask，請使用：
{
"encodedTaskContent": "string",
"encodedValuesContent": "string",
"type": "EncodedTask",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
]
}
針對 FileTask，請使用：
{
"taskFilePath": "string",
"type": "FileTask",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"valuesFilePath": "string"
}
屬性值
AgentProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 中央處理器 | 針對執行所需的核心數目，CPU 組態。 | int |
論點
| 名字 | 描述 | 價值 |
|---|---|---|
| isSecret | 旗標，指出自變數是否代表秘密，而且想要從組建記錄中移除。 | bool |
| 名字 | 自變數的名稱。 | 字串 （必要） |
| 價值 | 自變數的值。 | 字串 （必要） |
AuthInfo
| 名字 | 描述 | 價值 |
|---|---|---|
| expiresIn | 令牌維持有效秒的時間 | int |
| refreshToken | 用來重新整理存取令牌的重新整理令牌。 | 字串 |
| 範圍 | 存取令牌的範圍。 | 字串 |
| 令牌 | 用來存取原始檔控制提供者的存取令牌。 | 字串 （必要） |
| tokenType | 驗證令牌的類型。 | 'OAuth' 'PAT' （必要） |
BaseImageTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| baseImageTriggerType | 基底映像相依性更新的自動觸發程序類型。 | 'All' 'Runtime' （必要） |
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
憑據
| 名字 | 描述 | 價值 |
|---|---|---|
| customRegistries | 描述存取其他自定義登錄的認證參數。 機碼 字典專案的 是登錄登入伺服器 （myregistry.azurecr.io） 和 專案的值將會是用來存取登錄的登錄認證。 |
CredentialsCustomRegistries |
| sourceRegistry | 描述存取來源登錄的認證參數。 | SourceRegistryCredentials |
CredentialsCustomRegistries
| 名字 | 描述 | 價值 |
|---|
CustomRegistryCredentials
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 指出指派給自定義認證的受控識別。 如果使用者指派的身分識別 此值為用戶端識別碼。 如果系統指派的身分識別，此值將會 system。 在系統指派的身分識別案例，用戶端標識碼將由執行器決定。 這 身分識別可用來向金鑰保存庫進行驗證以擷取認證，或可能是唯一的 用於存取登錄的驗證來源。 |
字串 |
| 密碼 | 登入自定義登錄的密碼。 密碼是秘密 物件，可讓多種方式為其提供值。 |
SecretObject |
| userName | 登入自定義登錄的用戶名稱。 | SecretObject |
DockerBuildStep
| 名字 | 描述 | 價值 |
|---|---|---|
| 參數 | 執行此建置步驟時要使用的覆寫自變數集合。 | 自變數[] |
| dockerFilePath | 相對於來源內容的 Docker 檔案路徑。 | 字串 （必要） |
| imageNames | 完整的映像名稱，包括存放庫和標記。 | string[] |
| isPushEnabled | 這個屬性的值表示是否應該將建置的映像推送至登錄。 | bool |
| noCache | 這個屬性的值表示是否啟用映像快取。 | bool |
| 目標 | Docker 組建的目標建置階段名稱。 | 字串 |
| 類型 | 步驟的類型。 | 'Docker' （必要） |
EncodedTaskStep
| 名字 | 描述 | 價值 |
|---|---|---|
| encodedTaskContent | 範本/定義檔案內容的Base64編碼值。 | 字串 （必要） |
| encodedValuesContent | 參數/值檔案內容的Base64編碼值。 | 字串 |
| 類型 | 步驟的類型。 | 'EncodedTask' （必要） |
| 值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
FileTaskStep
| 名字 | 描述 | 價值 |
|---|---|---|
| taskFilePath | 相對於來源內容的工作範本/定義檔案路徑。 | 字串 （必要） |
| 類型 | 步驟的類型。 | 'FileTask' （必要） |
| 值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
| valuesFilePath | 相對於來源內容的工作值/參數檔案路徑。 | 字串 |
IdentityProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| principalId | 資源識別的主要標識碼。 | 字串 |
| tenantId | 資源的租用戶標識碼。 | 字串 |
| 類型 | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned， UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考的格式會是 ARM 資源識別碼： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
IdentityPropertiesUserAssignedIdentities |
IdentityPropertiesUserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
Microsoft.ContainerRegistry/registries/tasks
| 名字 | 描述 | 價值 |
|---|---|---|
| apiVersion | API 版本 | '2019-04-01' |
| 身份 | 資源的身分識別。 | IdentityProperties |
| 位置 | 資源的位置。 建立資源之後，就無法變更此專案。 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 5 最大長度 = 5 模式 = ^[a-zA-Z0-9-_]*$ （必要） |
| 性能 | 工作的屬性。 | TaskProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 類型 | 資源類型 | 'Microsoft.ContainerRegistry/registries/tasks' |
PlatformProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 建築 | OS 架構。 | 'amd64' 'arm' 'x86' |
| 操作系統 | 執行所需的作業系統類型。 | 'Linux' 'Windows' （必要） |
| 變體 | CPU 的變體。 | 'v6' 'v7' 'v8' |
ResourceTags
| 名字 | 描述 | 價值 |
|---|
SecretObject
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 秘密物件的型別，決定秘密物件的值必須如何 解釋。 |
'不透明' 'Vaultsecret' |
| 價值 | 秘密的值。 將決定此值的格式 根據秘密物件的類型。 如果類型為不透明，則值會是 使用 為 ，而不需要任何修改。 |
字串 |
SetValue
| 名字 | 描述 | 價值 |
|---|---|---|
| isSecret | 指出值是否代表秘密的旗標。 | bool |
| 名字 | 可覆寫值的名稱。 | 字串 （必要） |
| 價值 | 可覆寫的值。 | 字串 （必要） |
SourceProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 分支 | 原始碼的分支名稱。 | 字串 |
| repositoryUrl | 原始程式碼存放庫的完整 URL | 字串 （必要） |
| sourceControlAuthProperties | 存取原始程式碼存放庫和設定的授權屬性 通知的 Webhook。 |
AuthInfo |
| sourceControlType | 原始檔控制服務的類型。 | 'Github' 'VisualStudioTeamService' （必要） |
SourceRegistryCredentials
| 名字 | 描述 | 價值 |
|---|---|---|
| loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
SourceTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| sourceRepository | 描述工作之原始程式碼的屬性。 | SourceProperties （必要） |
| sourceTriggerEvents | 對應至觸發程式的來源事件。 | 包含任何的字串數組： 'commit' 'pullrequest' （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
TaskProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
| 憑據 | 屬性，描述叫用此執行時將使用的一組認證。 | 認證 |
| 平臺 | 執行所針對的平台屬性。 | PlatformProperties （必要） |
| 地位 | 工作的目前狀態。 | 'Disabled' 'Enabled' |
| 步 | 工作步驟的屬性。 | TaskStepProperties （必要） |
| 超時 | 以秒為單位執行逾時。 | int 約束： 最小值 = 300 最大值 = 28800 |
| 觸發 | 描述工作所有觸發程序的屬性。 | TriggerProperties |
TaskStepProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| contextAccessToken | 與步驟內容相關聯的令牌（git PAT 或記憶體帳戶 Blob 的 SAS 令牌）。 | 字串 |
| contextPath | 工作步驟來源內容的 URL（絕對或相對）。 | 字串 |
| 類型 | 針對 DockerBuildStep 類型設定為 'Docker'，。 針對 type EncodedTaskStep設定為 'EncodedTask'。 針對 fileTaskStep 類型設定為 'FileTask'，。 | 'Docker' 'EncodedTask' 'FileTask' （必要） |
TimerTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| 附表 | 工作排程的CRON表達式 | 字串 （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
TriggerProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| baseImageTrigger | 以基底映像相依性為基礎的觸發程式。 | BaseImageTrigger |
| sourceTriggers | 以原始程式碼存放庫為基礎的觸發程式集合。 | SourceTrigger[] |
| timerTriggers | 定時器觸發程式的集合。 | TimerTrigger[] |
UserIdentityProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| clientId | 使用者指派身分識別的用戶端標識碼。 | 字串 |
| principalId | 使用者指派身分識別的主體標識碼。 | 字串 |
Terraform （AzAPI 提供者） 資源定義
登錄/工作資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/tasks 資源，請將下列 Terraform 新增至範本。
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"
}
]
}
}
})
}
TaskStepProperties 物件
設定 類型 屬性，以指定物件的類型。
針對 Docker，請使用：
{
arguments = [
{
isSecret = bool
name = "string"
value = "string"
}
]
dockerFilePath = "string"
imageNames = [
"string"
]
isPushEnabled = bool
noCache = bool
target = "string"
type = "Docker"
}
針對 EncodedTask，請使用：
{
encodedTaskContent = "string"
encodedValuesContent = "string"
type = "EncodedTask"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
}
針對 FileTask，請使用：
{
taskFilePath = "string"
type = "FileTask"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
valuesFilePath = "string"
}
屬性值
AgentProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 中央處理器 | 針對執行所需的核心數目，CPU 組態。 | int |
論點
| 名字 | 描述 | 價值 |
|---|---|---|
| isSecret | 旗標，指出自變數是否代表秘密，而且想要從組建記錄中移除。 | bool |
| 名字 | 自變數的名稱。 | 字串 （必要） |
| 價值 | 自變數的值。 | 字串 （必要） |
AuthInfo
| 名字 | 描述 | 價值 |
|---|---|---|
| expiresIn | 令牌維持有效秒的時間 | int |
| refreshToken | 用來重新整理存取令牌的重新整理令牌。 | 字串 |
| 範圍 | 存取令牌的範圍。 | 字串 |
| 令牌 | 用來存取原始檔控制提供者的存取令牌。 | 字串 （必要） |
| tokenType | 驗證令牌的類型。 | 'OAuth' 'PAT' （必要） |
BaseImageTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| baseImageTriggerType | 基底映像相依性更新的自動觸發程序類型。 | 'All' 'Runtime' （必要） |
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
憑據
| 名字 | 描述 | 價值 |
|---|---|---|
| customRegistries | 描述存取其他自定義登錄的認證參數。 機碼 字典專案的 是登錄登入伺服器 （myregistry.azurecr.io） 和 專案的值將會是用來存取登錄的登錄認證。 |
CredentialsCustomRegistries |
| sourceRegistry | 描述存取來源登錄的認證參數。 | SourceRegistryCredentials |
CredentialsCustomRegistries
| 名字 | 描述 | 價值 |
|---|
CustomRegistryCredentials
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 指出指派給自定義認證的受控識別。 如果使用者指派的身分識別 此值為用戶端識別碼。 如果系統指派的身分識別，此值將會 system。 在系統指派的身分識別案例，用戶端標識碼將由執行器決定。 這 身分識別可用來向金鑰保存庫進行驗證以擷取認證，或可能是唯一的 用於存取登錄的驗證來源。 |
字串 |
| 密碼 | 登入自定義登錄的密碼。 密碼是秘密 物件，可讓多種方式為其提供值。 |
SecretObject |
| userName | 登入自定義登錄的用戶名稱。 | SecretObject |
DockerBuildStep
| 名字 | 描述 | 價值 |
|---|---|---|
| 參數 | 執行此建置步驟時要使用的覆寫自變數集合。 | 自變數[] |
| dockerFilePath | 相對於來源內容的 Docker 檔案路徑。 | 字串 （必要） |
| imageNames | 完整的映像名稱，包括存放庫和標記。 | string[] |
| isPushEnabled | 這個屬性的值表示是否應該將建置的映像推送至登錄。 | bool |
| noCache | 這個屬性的值表示是否啟用映像快取。 | bool |
| 目標 | Docker 組建的目標建置階段名稱。 | 字串 |
| 類型 | 步驟的類型。 | 'Docker' （必要） |
EncodedTaskStep
| 名字 | 描述 | 價值 |
|---|---|---|
| encodedTaskContent | 範本/定義檔案內容的Base64編碼值。 | 字串 （必要） |
| encodedValuesContent | 參數/值檔案內容的Base64編碼值。 | 字串 |
| 類型 | 步驟的類型。 | 'EncodedTask' （必要） |
| 值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
FileTaskStep
| 名字 | 描述 | 價值 |
|---|---|---|
| taskFilePath | 相對於來源內容的工作範本/定義檔案路徑。 | 字串 （必要） |
| 類型 | 步驟的類型。 | 'FileTask' （必要） |
| 值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
| valuesFilePath | 相對於來源內容的工作值/參數檔案路徑。 | 字串 |
IdentityProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| principalId | 資源識別的主要標識碼。 | 字串 |
| tenantId | 資源的租用戶標識碼。 | 字串 |
| 類型 | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned， UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考的格式會是 ARM 資源識別碼： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
IdentityPropertiesUserAssignedIdentities |
IdentityPropertiesUserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
Microsoft.ContainerRegistry/registries/tasks
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 資源的身分識別。 | IdentityProperties |
| 位置 | 資源的位置。 建立資源之後，就無法變更此專案。 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 5 最大長度 = 5 模式 = ^[a-zA-Z0-9-_]*$ （必要） |
| parent_id | 此資源為父系之資源的標識碼。 | 類型資源的標識碼：登錄 |
| 性能 | 工作的屬性。 | TaskProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 |
| 類型 | 資源類型 | “Microsoft.ContainerRegistry/registries/tasks@2019-04-01” |
PlatformProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 建築 | OS 架構。 | 'amd64' 'arm' 'x86' |
| 操作系統 | 執行所需的作業系統類型。 | 'Linux' 'Windows' （必要） |
| 變體 | CPU 的變體。 | 'v6' 'v7' 'v8' |
ResourceTags
| 名字 | 描述 | 價值 |
|---|
SecretObject
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 秘密物件的型別，決定秘密物件的值必須如何 解釋。 |
'不透明' 'Vaultsecret' |
| 價值 | 秘密的值。 將決定此值的格式 根據秘密物件的類型。 如果類型為不透明，則值會是 使用 為 ，而不需要任何修改。 |
字串 |
SetValue
| 名字 | 描述 | 價值 |
|---|---|---|
| isSecret | 指出值是否代表秘密的旗標。 | bool |
| 名字 | 可覆寫值的名稱。 | 字串 （必要） |
| 價值 | 可覆寫的值。 | 字串 （必要） |
SourceProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 分支 | 原始碼的分支名稱。 | 字串 |
| repositoryUrl | 原始程式碼存放庫的完整 URL | 字串 （必要） |
| sourceControlAuthProperties | 存取原始程式碼存放庫和設定的授權屬性 通知的 Webhook。 |
AuthInfo |
| sourceControlType | 原始檔控制服務的類型。 | 'Github' 'VisualStudioTeamService' （必要） |
SourceRegistryCredentials
| 名字 | 描述 | 價值 |
|---|---|---|
| loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
SourceTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| sourceRepository | 描述工作之原始程式碼的屬性。 | SourceProperties （必要） |
| sourceTriggerEvents | 對應至觸發程式的來源事件。 | 包含任何的字串數組： 'commit' 'pullrequest' （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
TaskProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
| 憑據 | 屬性，描述叫用此執行時將使用的一組認證。 | 認證 |
| 平臺 | 執行所針對的平台屬性。 | PlatformProperties （必要） |
| 地位 | 工作的目前狀態。 | 'Disabled' 'Enabled' |
| 步 | 工作步驟的屬性。 | TaskStepProperties （必要） |
| 超時 | 以秒為單位執行逾時。 | int 約束： 最小值 = 300 最大值 = 28800 |
| 觸發 | 描述工作所有觸發程序的屬性。 | TriggerProperties |
TaskStepProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| contextAccessToken | 與步驟內容相關聯的令牌（git PAT 或記憶體帳戶 Blob 的 SAS 令牌）。 | 字串 |
| contextPath | 工作步驟來源內容的 URL（絕對或相對）。 | 字串 |
| 類型 | 針對 DockerBuildStep 類型設定為 'Docker'，。 針對 type EncodedTaskStep設定為 'EncodedTask'。 針對 fileTaskStep 類型設定為 'FileTask'，。 | 'Docker' 'EncodedTask' 'FileTask' （必要） |
TimerTrigger
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 觸發程式的名稱。 | 字串 （必要） |
| 附表 | 工作排程的CRON表達式 | 字串 （必要） |
| 地位 | 觸發程式的目前狀態。 | 'Disabled' 'Enabled' |
TriggerProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| baseImageTrigger | 以基底映像相依性為基礎的觸發程式。 | BaseImageTrigger |
| sourceTriggers | 以原始程式碼存放庫為基礎的觸發程式集合。 | SourceTrigger[] |
| timerTriggers | 定時器觸發程式的集合。 | TimerTrigger[] |
UserIdentityProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| clientId | 使用者指派身分識別的用戶端標識碼。 | 字串 |
| principalId | 使用者指派身分識別的主體標識碼。 | 字串 |