Megosztás a következőn keresztül:


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 Groupeseté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 Groupeseté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 Groupesetén kötelező.

Megadja egy erőforráscsoport nevét.


location - Hely
string. action = Create Or Update Resource Group || deploymentScope != Resource Groupeseté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 Groupeseté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 fileeseté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 artifacteseté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 Groupeseté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