AzureResourceManagerTemplateDeployment@3 – ARM-sablon üzembe helyezési v3 feladat
Ezzel a feladatsal üzembe helyezhet egy Azure Resource Manager-sablont (ARM) az összes üzembehelyezési hatókörben.
Szintaxis
# ARM template deployment v3
# Deploy an Azure Resource Manager (ARM) template to all the deployment scopes.
- task: AzureResourceManagerTemplateDeployment@3
inputs:
# Azure Details
deploymentScope: 'Resource Group' # 'Management Group' | 'Subscription' | 'Resource Group'. Required. Deployment scope. Default: Resource Group.
azureResourceManagerConnection: # string. Alias: ConnectedServiceName. Required. Azure Resource Manager connection.
#subscriptionId: # string. Alias: subscriptionName. Required when deploymentScope != Management Group. Subscription.
#action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'DeleteRG'. Required when deploymentScope = Resource Group. Action. Default: Create Or Update Resource Group.
#resourceGroupName: # string. Required when deploymentScope = Resource Group. Resource group.
#location: # string. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Location.
# Template
#templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Template location. Default: Linked artifact.
#csmFileLink: # string. Required when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file. Template link.
#csmParametersFileLink: # string. Optional. Use when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file. Template parameters link.
#csmFile: # string. Required when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact. Template.
#csmParametersFile: # string. Optional. Use when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact. Template parameters.
#overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Override template parameters.
#deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment mode. Default: Incremental.
# Advanced
#deploymentName: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment name.
#deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment outputs.
#addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Access service principal details in override parameters. Default: false.
#useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Use individual output values without JSON.Stringify applied. Default: false.
# ARM template deployment v3
# Deploy an Azure Resource Manager (ARM) template to all the deployment scopes.
- task: AzureResourceManagerTemplateDeployment@3
inputs:
# Azure Details
deploymentScope: 'Resource Group' # 'Management Group' | 'Subscription' | 'Resource Group'. Required. Deployment scope. Default: Resource Group.
azureResourceManagerConnection: # string. Alias: ConnectedServiceName. Required. Azure Resource Manager connection.
#subscriptionId: # string. Alias: subscriptionName. Required when deploymentScope != Management Group. Subscription.
#action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'DeleteRG'. Required when deploymentScope = Resource Group. Action. Default: Create Or Update Resource Group.
#resourceGroupName: # string. Required when deploymentScope = Resource Group. Resource group.
#location: # string. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Location.
# Template
#templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Template location. Default: Linked artifact.
#csmFileLink: # string. Required when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file. Template link.
#csmParametersFileLink: # string. Optional. Use when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file. Template parameters link.
#csmFile: # string. Required when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact. Template.
#csmParametersFile: # string. Optional. Use when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact. Template parameters.
#overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Override template parameters.
#deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment mode. Default: Incremental.
# Advanced
#deploymentName: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment name.
#deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment outputs.
#addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Access service principal details in override parameters. Default: false.
Bemenetek
deploymentScope
-
üzembehelyezési hatókör
string
. Szükséges. Engedélyezett értékek: Management Group
, Subscription
, Resource Group
. Alapértelmezett érték: Resource Group
.
Az üzembe helyezés hatóköre. További információ üzembehelyezési hatókörökről.
azureResourceManagerConnection
-
Azure Resource Manager-kapcsolat
Bemeneti alias: ConnectedServiceName
.
string
. Szükséges.
Megadja az Azure Resource Manager szolgáltatáskapcsolatot a kiválasztott üzembehelyezési hatókörhöz való hozzáféréssel.
subscriptionId
-
előfizetési
Bemeneti alias: subscriptionName
.
string
.
deploymentScope != Management Group
esetén kötelező.
Az Azure-előfizetést adja meg.
Fontos
A megadott értéknek az előfizetés azonosítójának kell lennie, nem pedig az előfizetés nevének.
action
-
művelet
string
.
deploymentScope = Resource Group
esetén kötelező. Engedélyezett értékek: Create Or Update Resource Group
, DeleteRG
(Erőforráscsoport törlése). Alapértelmezett érték: Create Or Update Resource Group
.
Az Azure-erőforrásokon vagy erőforráscsoporton végrehajtandó művelet.
resourceGroupName
-
erőforráscsoport
string
.
deploymentScope = Resource Group
esetén kötelező.
Megadja egy erőforráscsoport nevét.
location
-
Hely
string
.
action = Create Or Update Resource Group || deploymentScope != Resource Group
esetén kötelező.
Erőforráscsoport üzembehelyezési hatókörei: Az erőforráscsoport üzembe helyezésének helye. Ha az erőforráscsoport már létezik az Azure-előfizetésben, a rendszer figyelmen kívül hagyja ezt az értéket. Egyéb üzembehelyezési hatókörök: Az üzembehelyezési metaadatok tárolásának helye.
templateLocation
-
sablon helye
string
.
action = Create Or Update Resource Group || deploymentScope != Resource Group
esetén kötelező. Engedélyezett értékek: Linked artifact
, URL of the file
. Alapértelmezett érték: Linked artifact
.
A sablon és a paraméterek JSON-fájljainak helye. Válassza csatolt összetevőt, ha a fájlok a csatolt kód/buildösszetevők részét képezik. Csatolt összetevők esetén megadhatja a Bicep-fájlok elérési útját is. Válassza fájl URL-címét, ha a JSON-fájlok nyilvánosan elérhető http/https URL-címeken találhatók. Privát tárfiókban tárolt fájl használatához kérje le és adja meg a közös hozzáférésű jogosultságkód (SAS) jogkivonatot a sablon URL-címében. Példa: <blob_storage_url>/template.json?
. Ha paraméterfájlt szeretne feltölteni egy tárfiókba, és SAS-jogkivonatot szeretne létrehozni, használhatja Azure-fájlmásolási feladatot, vagy kövesse a lépéseket PowerShell- vagy Azure CLI-.
csmFileLink
-
sablonhivatkozás
string
.
(action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file
esetén kötelező.
Megadja a sablonfájl URL-címét. Példa URL-címe: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json
Privát tárfiókban tárolt sablon üzembe helyezéséhez kérje le és vegye fel a közös hozzáférésű jogosultságkód (SAS) jogkivonatot a sablon URL-címére. Példa: <blob_storage_url>/template.json?<SAStoken>
. Ha sablonfájlt (vagy csatolt sablont) szeretne feltölteni egy tárfiókba, és SAS-jogkivonatot szeretne létrehozni, használja a Azure-fájlmásolási feladatot, vagy kövesse a lépéseket PowerShell- vagy Azure CLI-.
A sablonparaméterek rácsban való megtekintéséhez kattintson a felülbírálási sablonparaméterek szövegmezője melletti ...
. Ehhez a funkcióhoz engedélyezni kell a CORS-szabályokat a forrásnál. Ha a sablonok egy Azure Storage-blobban találhatók, a CORS engedélyezéséhez tekintse meg forrásközi erőforrás-megosztási.
csmParametersFileLink
-
sablonparaméterek hivatkozása
string
. Szabadon választható. Használja a (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file
.
Megadja a paraméterfájl URL-címét. Példa URL-címe: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json
Privát tárfiókban tárolt fájl használatához kérje le és adja meg a közös hozzáférésű jogosultságkód (SAS) jogkivonatot a sablon URL-címében. Példa: <blob_storage_url>/template.json?<SAStoken>
. Ha sablonfájlt (vagy csatolt sablont) szeretne feltölteni egy tárfiókba, és SAS-jogkivonatot szeretne létrehozni, használja a Azure-fájlmásolási feladatot, vagy kövesse a lépéseket PowerShell- vagy Azure CLI-.
A sablonparaméterek rácsban való megtekintéséhez kattintson a sablonparaméterek felülírása szövegmező melletti ...
elemre. Ehhez a funkcióhoz engedélyezni kell a CORS-szabályokat a forrásnál. Ha a sablonok egy Azure Storage-blobban találhatók, a CORS engedélyezéséhez tekintse meg forrásközi erőforrás-megosztási.
csmFile
-
sablon
string
.
(action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact
esetén kötelező.
Megadja az Azure Resource Manager-sablonra mutató útvonalat vagy mintát. További információ Azure Resource Manager-sablonokról. Ha azonnal hozzá szeretne kezdeni, használja ezt a mintasablont. Támogatja a Bicep-fájlokat, ha az Azure CLI 2.20.0-s verzióját >.
csmParametersFile
-
sablonparaméterek
string
. Szabadon választható. Használja a (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact
.
Adja meg az Azure Resource Manager-sablon paraméterfájljának elérési útját vagy mintáját. Támogatja Bicep Param fájlokat, ha az Azure CLI 2.47.0-s verziója >.
overrideParameters
-
sablonparaméterek felülbírálása
string
. Szabadon választható. Használja a action = Create Or Update Resource Group || deploymentScope != Resource Group
.
Megadja a felülbírálandó sablonparamétereket.
A sablonparaméterek rácsban való megtekintéséhez kattintson a ...
a Paraméterek felülbírálása szövegmező mellett. Ehhez a funkcióhoz engedélyezni kell a CORS-szabályokat a forrásnál. Ha a sablonok az Azure Storage-blobban találhatók, hivatkozzon erre a sztringre a CORS engedélyezéséhez, vagy írja be a sablonparamétereket a felülbíráláshoz a szövegmezőbe.
Példa: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre)
.
Ha a paraméter értéke több szóból áll, akkor is idézőjelekbe foglalja a szavakat, még akkor is, ha változók használatával adja át az értéket.
Például -name "parameter value" -name2 "$(var)"
.
Az objektumtípus paramétereinek felülbírálásához sztringezett JSON-objektumokat használjon.
Például -options ["option1"] -map {"key1": "value1" }
.
deploymentMode
-
üzembehelyezési mód
string
.
action = Create Or Update Resource Group || deploymentScope != Resource Group
esetén kötelező. Engedélyezett értékek: Incremental
, Complete
, Validation
(csak érvényesítés). Alapértelmezett érték: Incremental
.
A Incremental
mód az erőforráscsoport növekményes frissítéseként kezeli az üzemelő példányokat. Változatlan erőforrások maradnak az erőforráscsoportban, de nincsenek megadva a sablonban.
Complete
mód törli a sablonban nem szereplő erőforrásokat. A teljes mód viszonylag több időt vesz igénybe, mint a növekményes mód. Ha a tevékenység túllépi az időkorlátot, fontolja meg az időtúllépés növelését vagy a Incremental
módra való váltást.
Figyelmeztetés
A kész mód törli a sablonban nem megadott erőforráscsoport összes meglévő erőforrását. Ellenőrizze, hogy az üzembe helyezendő erőforráscsoport nem tartalmaz-e olyan szükséges erőforrásokat, amelyek nincsenek megadva a sablonban.
Validate
mód lehetővé teszi, hogy a tényleges erőforrások létrehozása előtt problémákat találjon a sablonnal kapcsolatban.
Jegyzet
A Validate
mód mindig létrehoz egy erőforráscsoportot, még akkor is, ha nincsenek üzembe helyezve erőforrások.
További információ üzembe helyezési módokról.
deploymentName
-
központi telepítés neve
string
. Szabadon választható. Használja a action = Create Or Update Resource Group || deploymentScope != Resource Group
.
Megadja a létrehozni kívánt erőforráscsoport-telepítés nevét.
deploymentOutputs
-
központi telepítési kimenetek
string
. Szabadon választható. Használja a action = Create Or Update Resource Group || deploymentScope != Resource Group
.
A kimeneti változó változójának nevét adja meg, amely az aktuális üzembehelyezési objektum kimeneti szakaszát tartalmazza sztringformátumban. A ConvertFrom-Json
PowerShell-parancsmaggal elemezheti a JSON-objektumot, és hozzáférhet az egyes kimeneti értékekhez. További információ üzembehelyezési kimenetekről.
addSpnToEnvironment
-
Hozzáférési szolgáltatás egyszerű adatai a felülbírálási paraméterekben
boolean
. Szabadon választható. Használja a action = Create Or Update Resource Group || deploymentScope != Resource Group
. Alapértelmezett érték: false
.
Hozzáadja a parancsprogram végrehajtási környezetének választott Azure-végpont szolgáltatásnév-azonosítóját és kulcsát. A $servicePrincipalId
és $servicePrincipalKey
változók felülbírálási paraméterekben lehetnek, például -key $servicePrincipalKey
.
useWithoutJSON
-
Egyéni kimeneti értékek használata JSON nélkül. Stringify alkalmazott
boolean
. Szabadon választható. Használja a action = Create Or Update Resource Group || deploymentScope != Resource Group
. Alapértelmezett érték: false
.
Az egyes kimeneti értékek JSON-on keresztül lesznek konvertálva. Sztringesítés alapértelmezés szerint. Ha úgy szeretné használni a kimeneti értékeket, ahogy van, anélkül, hogy JSON-ra konvertálja őket. Sztringesítés, engedélyezze ezt a beállítást. További részletekért tekintse meg a .
Tevékenységvezérlési beállítások
Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.
Kimeneti változók
Egyik sem.
Megjegyzések
Jegyzet
Ez a feladat támogatja a Bicep-fájlokat, amikor az Azure CLI 2.20.0-s verzióját >.
- Az üzembe helyezés támogatása az összes üzembe helyezési hatókörhöz hozzáadva.
- A virtuális géppel kapcsolatos összes művelet el lett távolítva.
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás bekapcsolva | Ügynök, DeploymentGroup |
Követelmények | Egyik sem |
képességek | Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
parancskorlátozások | Bármely |
Változók beállítása | Bármely |
Ügynök verziója | 2.119.1 vagy újabb |
Tevékenységkategória | Felfejlődik |