Microsoft.ContainerRegistry-registers/tasks 2019-04-01
Bicep-resourcedefinitie
Het resourcetype registers/taken kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie
Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een resource Microsoft.ContainerRegistry/registries/tasks wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.
resource symbolicname 'Microsoft.ContainerRegistry/registries/tasks@2019-04-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {}
}
properties: {
agentConfiguration: {
cpu: int
}
credentials: {
customRegistries: {}
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-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Docker:
type: 'Docker'
arguments: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
dockerFilePath: 'string'
imageNames: [
'string'
]
isPushEnabled: bool
noCache: bool
target: 'string'
Voor EncodedTask gebruikt u:
type: 'EncodedTask'
encodedTaskContent: 'string'
encodedValuesContent: 'string'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
Gebruik voor FileTask:
type: 'FileTask'
taskFilePath: 'string'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
valuesFilePath: 'string'
Eigenschapswaarden
registers/taken
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De resourcenaam Meer informatie over het instellen van namen en typen voor onderliggende resources in Bicep. |
tekenreeks (vereist) Tekenlimiet: 5-50 Geldige tekens: Alfanumerieken, afbreekstreepjes en onderstrepingstekens. |
| location | De locatie van de resource. Dit kan niet worden gewijzigd nadat de resource is gemaakt. | tekenreeks (vereist) |
| tags | De tags van de resource. | Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken |
| Bovenliggende | In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd. Zie Onderliggende resource buiten bovenliggende resource voor meer informatie. |
Symbolische naam voor resource van het type: registers |
| identity | Identiteit voor de resource. | IdentityProperties |
| properties | De eigenschappen van een taak. | TaskProperties |
IdentityProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| principalId | De principal-id van resource-id. | tekenreeks |
| tenantId | De tenant-id van de resource. | tekenreeks |
| type | Het identiteitstype. | 'Geen' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit Sleutelverwijzingen in de woordenlijst zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
object |
TaskProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| agentConfiguration | De computerconfiguratie van de run-agent. | AgentEigenschappen |
| referenties | De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. | Referenties |
| platform | De platformeigenschappen waarop de uitvoering moet plaatsvinden. | PlatformProperties (vereist) |
| status | De huidige status van de taak. | 'Uitgeschakeld' Ingeschakeld |
| stap | De eigenschappen van een taakstap. | TaskStepProperties (vereist) |
| timeout | Time-out in seconden uitvoeren. | int |
| activeren | De eigenschappen die alle triggers voor de taak beschrijven. | TriggerEigenschappen |
AgentEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| Cpu | De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering. | int |
Referenties
| Naam | Beschrijving | Waarde |
|---|---|---|
| customRegistries | Beschrijft de referentieparameters voor toegang tot andere aangepaste registers. De sleutel voor het woordenlijstitem is de registeraanmeldingsserver (myregistry.azurecr.io) en de waarde van het item is de registerreferenties voor toegang tot het register. |
object |
| sourceRegistry | Beschrijft de referentieparameters voor toegang tot het bronregister. | SourceRegistryCredentials |
SourceRegistryCredentials
| Naam | Beschrijving | Waarde |
|---|---|---|
| loginMode | De verificatiemodus die het aanmeldingsbereik van het bronregister bepaalt. De referenties voor het bronregister wordt gegenereerd met behulp van het opgegeven bereik. Deze referenties worden gebruikt om u aan te melden bij het bronregister tijdens de uitvoering. |
'Standaard' 'Geen' |
PlatformEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| architectuur | De architectuur van het besturingssysteem. | 'amd64' 'arm' 'x86' |
| os | Het type besturingssysteem dat is vereist voor de uitvoering. | 'Linux' 'Windows' (vereist) |
| Variant | Variant van de CPU. | 'v6' 'v7' 'v8' |
TaskStepProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| contextAccessToken | Het token (git PAT- of SAS-token van de blob van het opslagaccount) dat is gekoppeld aan de context voor een stap. | tekenreeks |
| contextPath | De URL (absoluut of relatief) van de broncontext voor de taakstap. | tekenreeks |
| type | Het objecttype instellen | Docker EncodedTask FileTask (vereist) |
DockerBuildStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type stap. | Docker (vereist) |
| Argumenten | De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van deze buildstap. | Argument[] |
| dockerFilePath | Het Pad van het Docker-bestand ten opzichte van de broncontext. | tekenreeks (vereist) |
| imageNames | De volledig gekwalificeerde installatiekopieën, inclusief de opslagplaats en tag. | tekenreeks[] |
| isPushEnabled | De waarde van deze eigenschap geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht of niet. | booleaans |
| noCache | De waarde van deze eigenschap geeft aan of de afbeeldingscache is ingeschakeld of niet. | booleaans |
| Doel | De naam van de doelbuildfase voor de Docker-build. | tekenreeks |
Argument
| Naam | Beschrijving | Waarde |
|---|---|---|
| isSecret | Vlag om aan te geven of het argument een geheim vertegenwoordigt en uit buildlogboeken wilt worden verwijderd. | booleaans |
| naam | De naam van het argument. | tekenreeks (vereist) |
| waarde | De waarde van het argument. | tekenreeks (vereist) |
EncodedTaskStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type van de stap. | 'EncodedTask' (vereist) |
| encodedTaskContent | Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. | tekenreeks (vereist) |
| encodedValuesContent | Base64 gecodeerde waarde van de inhoud van het bestand parameters/waarden. | tekenreeks |
| values | De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. | SetValue[] |
Waardeinstellen
| Naam | Beschrijving | Waarde |
|---|---|---|
| isSecret | Vlag om aan te geven of de waarde een geheim vertegenwoordigt of niet. | booleaans |
| naam | De naam van de overschrijfbare waarde. | tekenreeks (vereist) |
| waarde | De overschrijfbare waarde. | tekenreeks (vereist) |
FileTaskStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type van de stap. | 'FileTask' (vereist) |
| taskFilePath | Het bestandspad van de taaksjabloon/definitie ten opzichte van de broncontext. | tekenreeks (vereist) |
| values | De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. | SetValue[] |
| valuesFilePath | Het bestandspad voor taakwaarden/-parameters ten opzichte van de broncontext. | tekenreeks |
TriggerEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| baseImageTrigger | De trigger op basis van afhankelijkheden van de basisinstallatiekopieën. | BaseImageTrigger |
| sourceTriggers | De verzameling triggers op basis van de opslagplaats voor broncode. | SourceTrigger[] |
| timerTriggers | De verzameling timertriggers. | TimerTrigger[] |
BaseImageTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| baseImageTriggerType | Het type automatische trigger voor afhankelijkheidsupdates van basisinstallatiekopieën. | 'Alle' 'Runtime' (vereist) |
| naam | De naam van de trigger. | tekenreeks (vereist) |
| status | De huidige status van de trigger. | 'Uitgeschakeld' Ingeschakeld |
SourceTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De naam van de trigger. | tekenreeks (vereist) |
| sourceRepository | De eigenschappen die de broncode(code) voor de taak beschrijven. | SourceProperties (vereist) |
| sourceTriggerEvents | De bron gebeurtenis die overeenkomt met de trigger. | Tekenreeksmatrix met een van de volgende: 'doorvoeren' 'pullrequest' (vereist) |
| status | De huidige status van de trigger. | 'Uitgeschakeld' Ingeschakeld |
SourceProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| vertakking | De naam van de vertakking van de broncode. | tekenreeks |
| repositoryUrl | De volledige URL naar de broncodeopslagplaats | tekenreeks (vereist) |
| sourceControlAuthProperties | De autorisatie-eigenschappen voor toegang tot de broncodeopslagplaats en voor het instellen webhooks voor meldingen. |
AuthInfo |
| sourceControlType | Het type broncodebeheerservice. | 'Github' 'VisualStudioTeamService' (vereist) |
AuthInfo
| Naam | Beschrijving | Waarde |
|---|---|---|
| expiresIn | Tijd in seconden dat het token geldig blijft | int |
| refreshToken | Het vernieuwingstoken dat wordt gebruikt om het toegangstoken te vernieuwen. | tekenreeks |
| scope | Het bereik van het toegangstoken. | tekenreeks |
| token | Het toegangstoken dat wordt gebruikt voor toegang tot de bronbeheerprovider. | tekenreeks (vereist) |
| tokenType | Het type verificatietoken. | 'OAuth' 'PAT' (vereist) |
TimerTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De naam van de trigger. | tekenreeks (vereist) |
| schedule | De CRON-expressie voor de taakplanning | tekenreeks (vereist) |
| status | De huidige status van de trigger. | 'Uitgeschakeld' Ingeschakeld |
Resourcedefinitie van ARM-sjabloon
Het resourcetype registers/taken kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie
Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een resource Microsoft.ContainerRegistry/registries/tasks wilt maken, voegt u de volgende JSON toe aan uw sjabloon.
{
"type": "Microsoft.ContainerRegistry/registries/tasks",
"apiVersion": "2019-04-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"agentConfiguration": {
"cpu": "int"
},
"credentials": {
"customRegistries": {},
"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-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Docker:
"type": "Docker",
"arguments": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"dockerFilePath": "string",
"imageNames": [ "string" ],
"isPushEnabled": "bool",
"noCache": "bool",
"target": "string"
Voor EncodedTask gebruikt u:
"type": "EncodedTask",
"encodedTaskContent": "string",
"encodedValuesContent": "string",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
]
Gebruik voor FileTask:
"type": "FileTask",
"taskFilePath": "string",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"valuesFilePath": "string"
Eigenschapswaarden
registers/taken
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het resourcetype | 'Microsoft.ContainerRegistry/registries/tasks' |
| apiVersion | De resource-API-versie | '2019-04-01' |
| naam | De resourcenaam Meer informatie over het instellen van namen en typen voor onderliggende resources in JSON ARM-sjablonen. |
tekenreeks (vereist) Tekenlimiet: 5-50 Geldige tekens: Alfanumerieken, afbreekstreepjes en onderstrepingstekens. |
| location | De locatie van de resource. Dit kan niet worden gewijzigd nadat de resource is gemaakt. | tekenreeks (vereist) |
| tags | De tags van de resource. | Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken |
| identity | Identiteit voor de resource. | IdentityProperties |
| properties | De eigenschappen van een taak. | TaskProperties |
IdentityProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| principalId | De principal-id van resource-id. | tekenreeks |
| tenantId | De tenant-id van de resource. | tekenreeks |
| type | Het identiteitstype. | 'Geen' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit Sleutelverwijzingen in woordenlijst zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
object |
TaskProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| agentConfiguration | De computerconfiguratie van de uitvoeringsagent. | Eigenschappen van agent |
| referenties | De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. | Referenties |
| platform | De platformeigenschappen waarop de uitvoering moet plaatsvinden. | PlatformEigenschappen (vereist) |
| status | De huidige status van de taak. | 'Uitgeschakeld' Ingeschakeld |
| stap | De eigenschappen van een taakstap. | TaskStepProperties (vereist) |
| timeout | Time-out voor uitvoering in seconden. | int |
| activeren | De eigenschappen waarmee alle triggers voor de taak worden beschreven. | TriggerEigenschappen |
Eigenschappen van agent
| Naam | Beschrijving | Waarde |
|---|---|---|
| Cpu | De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering. | int |
Referenties
| Naam | Beschrijving | Waarde |
|---|---|---|
| customRegistries | Beschrijft de referentieparameters voor toegang tot andere aangepaste registers. De sleutel voor het woordenlijstitem is de aanmeldingsserver van het register (myregistry.azurecr.io) en de waarde van het item is de registerreferenties voor toegang tot het register. |
object |
| sourceRegistry | Beschrijft de referentieparameters voor toegang tot het bronregister. | SourceRegistryCredentials |
SourceRegistryCredentials
| Naam | Beschrijving | Waarde |
|---|---|---|
| loginMode | De verificatiemodus die het aanmeldingsbereik van het bronregister bepaalt. De referenties voor het bronregister worden gegenereerd met behulp van het opgegeven bereik. Deze referenties worden gebruikt om u aan te melden bij het bronregister tijdens de uitvoering. |
'Standaard' 'Geen' |
PlatformEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| architectuur | De architectuur van het besturingssysteem. | 'amd64' 'arm' 'x86' |
| os | Het type besturingssysteem dat is vereist voor de uitvoering. | 'Linux' 'Windows' (vereist) |
| Variant | Variant van de CPU. | 'v6' 'v7' 'v8' |
TaskStepProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| contextAccessToken | Het token (git PAT- of SAS-token van de blob van het opslagaccount) dat is gekoppeld aan de context voor een stap. | tekenreeks |
| contextPath | De URL (absoluut of relatief) van de broncontext voor de taakstap. | tekenreeks |
| type | Het objecttype instellen | Docker EncodedTask FileTask (vereist) |
DockerBuildStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type stap. | Docker (vereist) |
| Argumenten | De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van deze buildstap. | Argument[] |
| dockerFilePath | Het Pad van het Docker-bestand ten opzichte van de broncontext. | tekenreeks (vereist) |
| imageNames | De volledig gekwalificeerde installatiekopieën, inclusief de opslagplaats en tag. | tekenreeks[] |
| isPushEnabled | De waarde van deze eigenschap geeft aan of de gemaakte installatiekopie naar het register moet worden gepusht of niet. | booleaans |
| noCache | De waarde van deze eigenschap geeft aan of de afbeeldingscache is ingeschakeld of niet. | booleaans |
| Doel | De naam van de doelbuildfase voor de Docker-build. | tekenreeks |
Argument
| Naam | Beschrijving | Waarde |
|---|---|---|
| isSecret | Vlag om aan te geven of het argument een geheim vertegenwoordigt en uit buildlogboeken wilt worden verwijderd. | booleaans |
| naam | De naam van het argument. | tekenreeks (vereist) |
| waarde | De waarde van het argument. | tekenreeks (vereist) |
EncodedTaskStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type stap. | 'EncodedTask' (vereist) |
| encodedTaskContent | Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. | tekenreeks (vereist) |
| encodedValuesContent | Base64 gecodeerde waarde van de inhoud van het parameter-/waardenbestand. | tekenreeks |
| values | De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. | SetValue[] |
Waardeinstellen
| Naam | Beschrijving | Waarde |
|---|---|---|
| isSecret | Vlag om aan te geven of de waarde een geheim vertegenwoordigt of niet. | booleaans |
| naam | De naam van de overschrijfbare waarde. | tekenreeks (vereist) |
| waarde | De overschrijfbare waarde. | tekenreeks (vereist) |
FileTaskStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type stap. | 'FileTask' (vereist) |
| taskFilePath | Het taaksjabloon-/definitiebestandspad ten opzichte van de broncontext. | tekenreeks (vereist) |
| values | De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. | SetValue[] |
| valuesFilePath | Het bestandspad voor taakwaarden/-parameters ten opzichte van de broncontext. | tekenreeks |
TriggerEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| baseImageTrigger | De trigger op basis van afhankelijkheden van de basisinstallatiekopieën. | BaseImageTrigger |
| sourceTriggers | De verzameling triggers op basis van de opslagplaats voor broncode. | SourceTrigger[] |
| timerTriggers | De verzameling timertriggers. | TimerTrigger[] |
BaseImageTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| baseImageTriggerType | Het type automatische trigger voor afhankelijkheidsupdates van basisinstallatiekopieën. | 'Alle' 'Runtime' (vereist) |
| naam | De naam van de trigger. | tekenreeks (vereist) |
| status | De huidige status van de trigger. | 'Uitgeschakeld' Ingeschakeld |
SourceTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De naam van de trigger. | tekenreeks (vereist) |
| sourceRepository | De eigenschappen die de broncode(code) voor de taak beschrijven. | SourceProperties (vereist) |
| sourceTriggerEvents | De bron gebeurtenis die overeenkomt met de trigger. | Tekenreeksmatrix met een van de volgende: 'doorvoeren' 'pullrequest' (vereist) |
| status | De huidige status van de trigger. | 'Uitgeschakeld' Ingeschakeld |
SourceProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| vertakking | De naam van de vertakking van de broncode. | tekenreeks |
| repositoryUrl | De volledige URL naar de broncodeopslagplaats | tekenreeks (vereist) |
| sourceControlAuthProperties | De autorisatie-eigenschappen voor toegang tot de broncodeopslagplaats en voor het instellen webhooks voor meldingen. |
AuthInfo |
| sourceControlType | Het type broncodebeheerservice. | 'Github' 'VisualStudioTeamService' (vereist) |
AuthInfo
| Naam | Beschrijving | Waarde |
|---|---|---|
| expiresIn | Tijd in seconden dat het token geldig blijft | int |
| refreshToken | Het vernieuwingstoken dat wordt gebruikt om het toegangstoken te vernieuwen. | tekenreeks |
| scope | Het bereik van het toegangstoken. | tekenreeks |
| token | Het toegangstoken dat wordt gebruikt voor toegang tot de broncodebeheerprovider. | tekenreeks (vereist) |
| tokenType | Het type verificatietoken. | 'OAuth' 'PAT' (vereist) |
TimerTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De naam van de trigger. | tekenreeks (vereist) |
| schedule | De CRON-expressie voor de taakplanning | tekenreeks (vereist) |
| status | De huidige status van de trigger. | 'Uitgeschakeld' Ingeschakeld |
Terraform-resourcedefinitie (AzAPI-provider)
Het resourcetype registers/taken kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen
Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Resource Microsoft.ContainerRegistry/registries/tasks wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerRegistry/registries/tasks@2019-04-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
agentConfiguration = {
cpu = int
}
credentials = {
customRegistries = {}
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-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Docker:
type = "Docker"
arguments = [
{
isSecret = bool
name = "string"
value = "string"
}
]
dockerFilePath = "string"
imageNames = [
"string"
]
isPushEnabled = bool
noCache = bool
target = "string"
Gebruik voor EncodedTask:
type = "EncodedTask"
encodedTaskContent = "string"
encodedValuesContent = "string"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
Gebruik voor FileTask:
type = "FileTask"
taskFilePath = "string"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
valuesFilePath = "string"
Eigenschapswaarden
registers/taken
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het resourcetype | "Microsoft.ContainerRegistry/registries/tasks@2019-04-01" |
| naam | De resourcenaam | tekenreeks (vereist) Tekenlimiet: 5-50 Geldige tekens: Alfanumerieken, afbreekstreepjes en onderstrepingstekens. |
| location | De locatie van de resource. Dit kan niet worden gewijzigd nadat de resource is gemaakt. | tekenreeks (vereist) |
| parent_id | De id van de resource die het bovenliggende item voor deze resource is. | Id voor resource van het type: registers |
| tags | De tags van de resource. | Woordenlijst met tagnamen en -waarden. |
| identity | Identiteit voor de resource. | IdentityProperties |
| properties | De eigenschappen van een taak. | TaskProperties |
IdentityProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het identiteitstype. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
| identity_ids | De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De gebruikersidentiteit Sleutelverwijzingen in woordenlijst zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
Matrix met gebruikersidentiteits-id's. |
TaskProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| agentConfiguration | De computerconfiguratie van de uitvoeringsagent. | Eigenschappen van agent |
| referenties | De eigenschappen die een set referenties beschrijven die worden gebruikt wanneer deze uitvoering wordt aangeroepen. | Referenties |
| platform | De platformeigenschappen waarop de uitvoering moet plaatsvinden. | PlatformEigenschappen (vereist) |
| status | De huidige status van de taak. | "Uitgeschakeld" "Ingeschakeld" |
| stap | De eigenschappen van een taakstap. | TaskStepProperties (vereist) |
| timeout | Time-out voor uitvoering in seconden. | int |
| activeren | De eigenschappen waarmee alle triggers voor de taak worden beschreven. | TriggerEigenschappen |
Eigenschappen van agent
| Naam | Beschrijving | Waarde |
|---|---|---|
| Cpu | De CPU-configuratie in termen van het aantal kernen dat is vereist voor de uitvoering. | int |
Referenties
| Naam | Beschrijving | Waarde |
|---|---|---|
| customRegistries | Beschrijft de referentieparameters voor toegang tot andere aangepaste registers. De sleutel voor het woordenlijstitem is de aanmeldingsserver van het register (myregistry.azurecr.io) en de waarde van het item is de registerreferenties voor toegang tot het register. |
object |
| sourceRegistry | Beschrijft de referentieparameters voor toegang tot het bronregister. | SourceRegistryCredentials |
SourceRegistryCredentials
| Naam | Beschrijving | Waarde |
|---|---|---|
| loginMode | De verificatiemodus die het aanmeldingsbereik van het bronregister bepaalt. De referenties voor het bronregister worden gegenereerd met behulp van het opgegeven bereik. Deze referenties worden gebruikt om u aan te melden bij het bronregister tijdens de uitvoering. |
"Standaard" "Geen" |
PlatformEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| architectuur | De architectuur van het besturingssysteem. | "amd64" "arm" "x86" |
| os | Het type besturingssysteem dat is vereist voor de uitvoering. | "Linux" "Windows" (vereist) |
| Variant | Variant van de CPU. | "v6" "v7" "v8" |
TaskStepProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| contextAccessToken | Het token (git PAT- of SAS-token van de blob van het opslagaccount) dat is gekoppeld aan de context voor een stap. | tekenreeks |
| contextPath | De URL (absoluut of relatief) van de broncontext voor de taakstap. | tekenreeks |
| type | Het objecttype instellen | Docker EncodedTask FileTask (vereist) |
DockerBuildStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type van de stap. | "Docker" (vereist) |
| Argumenten | De verzameling onderdrukkingsargumenten die moeten worden gebruikt bij het uitvoeren van deze buildstap. | Argument[] |
| dockerFilePath | Het Pad naar het Docker-bestand ten opzichte van de broncontext. | tekenreeks (vereist) |
| imageNames | De volledig gekwalificeerde namen van installatiekopieën, inclusief de opslagplaats en tag. | tekenreeks[] |
| isPushEnabled | De waarde van deze eigenschap geeft aan of de gemaakte installatiekopieën naar het register moeten worden gepusht. | booleaans |
| noCache | De waarde van deze eigenschap geeft aan of de afbeeldingscache is ingeschakeld of niet. | booleaans |
| Doel | De naam van de doelbuildfase voor de docker-build. | tekenreeks |
Argument
| Naam | Beschrijving | Waarde |
|---|---|---|
| isSecret | Vlag om aan te geven of het argument een geheim vertegenwoordigt en uit buildlogboeken wilt worden verwijderd. | booleaans |
| naam | De naam van het argument. | tekenreeks (vereist) |
| waarde | De waarde van het argument. | tekenreeks (vereist) |
EncodedTaskStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type van de stap. | "EncodedTask" (vereist) |
| encodedTaskContent | Base64 gecodeerde waarde van de inhoud van het sjabloon-/definitiebestand. | tekenreeks (vereist) |
| encodedValuesContent | Base64 gecodeerde waarde van de inhoud van het bestand parameters/waarden. | tekenreeks |
| values | De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. | SetValue[] |
Waardeinstellen
| Naam | Beschrijving | Waarde |
|---|---|---|
| isSecret | Vlag om aan te geven of de waarde een geheim vertegenwoordigt of niet. | booleaans |
| naam | De naam van de overschrijfbare waarde. | tekenreeks (vereist) |
| waarde | De overschrijfbare waarde. | tekenreeks (vereist) |
FileTaskStep
| Naam | Beschrijving | Waarde |
|---|---|---|
| type | Het type van de stap. | "FileTask" (vereist) |
| taskFilePath | Het bestandspad van de taaksjabloon/definitie ten opzichte van de broncontext. | tekenreeks (vereist) |
| values | De verzameling overschrijfbare waarden die kunnen worden doorgegeven bij het uitvoeren van een taak. | SetValue[] |
| valuesFilePath | Het bestandspad voor taakwaarden/-parameters ten opzichte van de broncontext. | tekenreeks |
TriggerEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| baseImageTrigger | De trigger op basis van afhankelijkheden van de basisinstallatiekopieën. | BaseImageTrigger |
| sourceTriggers | De verzameling triggers op basis van de opslagplaats voor broncode. | SourceTrigger[] |
| timerTriggers | De verzameling timertriggers. | TimerTrigger[] |
BaseImageTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| baseImageTriggerType | Het type automatische trigger voor afhankelijkheidsupdates van basisinstallatiekopieën. | "Alle" 'Runtime' (vereist) |
| naam | De naam van de trigger. | tekenreeks (vereist) |
| status | De huidige status van de trigger. | "Uitgeschakeld" "Ingeschakeld" |
SourceTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De naam van de trigger. | tekenreeks (vereist) |
| sourceRepository | De eigenschappen die de broncode(code) voor de taak beschrijven. | SourceProperties (vereist) |
| sourceTriggerEvents | De bron gebeurtenis die overeenkomt met de trigger. | Tekenreeksmatrix met een van de volgende: "doorvoeren" "pullrequest" (vereist) |
| status | De huidige status van de trigger. | "Uitgeschakeld" "Ingeschakeld" |
SourceProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| vertakking | De naam van de vertakking van de broncode. | tekenreeks |
| repositoryUrl | De volledige URL naar de broncodeopslagplaats | tekenreeks (vereist) |
| sourceControlAuthProperties | De autorisatie-eigenschappen voor toegang tot de broncodeopslagplaats en voor het instellen webhooks voor meldingen. |
AuthInfo |
| sourceControlType | Het type broncodebeheerservice. | "Github" "VisualStudioTeamService" (vereist) |
AuthInfo
| Naam | Beschrijving | Waarde |
|---|---|---|
| expiresIn | Tijd in seconden dat het token geldig blijft | int |
| refreshToken | Het vernieuwingstoken dat wordt gebruikt om het toegangstoken te vernieuwen. | tekenreeks |
| scope | Het bereik van het toegangstoken. | tekenreeks |
| token | Het toegangstoken dat wordt gebruikt voor toegang tot de broncodebeheerprovider. | tekenreeks (vereist) |
| tokenType | Het type verificatietoken. | "OAuth" "PAT" (vereist) |
TimerTrigger
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De naam van de trigger. | tekenreeks (vereist) |
| schedule | De CRON-expressie voor de taakplanning | tekenreeks (vereist) |
| status | De huidige status van de trigger. | "Uitgeschakeld" "Ingeschakeld" |
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor