AzureResourceGroupDeployment@2 – Azure-resursgruppsdistribution v2-uppgift

  • Artikel

Distribuera en ARM-mall (Azure Resource Manager) till en resursgrupp och hantera virtuella datorer.

Distribuera en ARM-mall (Azure Resource Manager) till en resursgrupp. Du kan också starta, stoppa, ta bort och frigöra alla Virtual Machines (VM) i en resursgrupp.

Syntax

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group. Use individual output values without JSON.Stringify applied. Default: false.

# Azure resource group deployment v2
# Deploy an Azure Resource Manager (ARM) template to a resource group and manage virtual machines.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group. Access service principal details in override parameters. Default: false.

# Azure Resource Group Deployment v2
# Deploy an Azure resource manager (ARM) template to a resource group. You can also start, stop, delete, deallocate all Virtual Machines (VM) in a resource group.
- task: AzureResourceGroupDeployment@2
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'StopWithDeallocate' | 'Restart' | 'Delete' | 'DeleteRG'. Required. Action. Default: Create Or Update Resource Group.
    resourceGroupName: # string. Required. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when templateLocation = URL of the file && action = Create Or Update Resource Group. Template link. 
    #csmParametersFileLink: # string. Optional. Use when templateLocation = URL of the file && action = Create Or Update Resource Group. Template parameters link. 
    #csmFile: # string. Required when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when templateLocation = Linked artifact && action = Create Or Update Resource Group. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group. Deployment mode. Default: Incremental.
  # Advanced deployment options for virtual machines
    #enableDeploymentPrerequisites: 'None' # 'None' | 'ConfigureVMwithWinRM' | 'ConfigureVMWithDGAgent'. Optional. Use when action = Create Or Update Resource Group || action = Select Resource Group. Enable prerequisites. Default: None.
    #teamServicesConnection: # string. Alias: deploymentGroupEndpoint. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Azure Pipelines/TFS service connection. 
    #teamProject: # string. Alias: project. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Team project. 
    #deploymentGroupName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Deployment Group. 
    #copyAzureVMTags: true # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Copy Azure VM tags to agents. Default: true.
    #runAgentServiceAsUser: false # boolean. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Run agent service as a user. Default: false.
    #userName: # string. Required when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. User name. 
    #password: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group. Password. 
    #outputVariable: # string. Optional. Use when enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group. VM details for WinRM. 
  # Outputs
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group. Deployment outputs.

Indata

azureSubscription - Azure-prenumeration
Indataalias: ConnectedServiceName. string. Krävs.

Väljer den tjänstanslutning som innehåller en Azure-prenumeration för distributionen.


action - Åtgärder
string. Krävs. Tillåtna värden: Create Or Update Resource Group, Select Resource Group (Konfigurera distributionsalternativ för virtuella datorer), Start (Starta virtuella datorer), Stop (Stoppa virtuella datorer), StopWithDeallocate (Stoppa och frigöra virtuella datorer), Restart (Starta om virtuella datorer), Delete (Ta bort virtuella datorer) DeleteRG (Ta bort resursgrupp). Standardvärde: Create Or Update Resource Group.

Den åtgärd som ska utföras på Azure-resurserna eller resursgruppen.


resourceGroupName - Resursgrupp
string. Krävs.

Anger namnet på resursgruppen.


location - Plats
string. Krävs när action = Create Or Update Resource Group.

Platsen där resursgruppen ska distribueras. Om resursgruppen redan finns i prenumerationen ignoreras det här värdet.


templateLocation - Mallplats
string. Krävs när action = Create Or Update Resource Group. Tillåtna värden: Linked artifact, URL of the file. Standardvärde: Linked artifact.

Välj antingen Länkad artefakt eller URL för filen.


csmFileLink - Malllänk
string. Krävs när templateLocation = URL of the file && action = Create Or Update Resource Group.

Anger url:en för mallfilen. Ett exempel på en URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

Om du vill distribuera en mall som lagras i ett privat lagringskonto hämtar och inkluderar du sas-token (signatur för delad åtkomst) i mallens URL. Exempel: <blob_storage_url>/template.json?<SAStoken>

Om du vill ladda upp en mallfil (eller en länkad mall) till ett lagringskonto och generera en SAS-token använder du Azure-filkopieringsuppgiften eller följer stegen med Hjälp av PowerShell eller Azure CLI.

Om du vill visa mallparametrarna i ett rutnät klickar du på ... bredvid textrutan åsidosätt mallparametrar. Den här funktionen kräver att CORS-regler är aktiverade vid källan. Om mallarna finns i en Azure Storage-blob läser du Förstå CORS-begäranden för att aktivera CORS.


csmParametersFileLink - Länk för mallparametrar
string. Valfritt. Använd när templateLocation = URL of the file && action = Create Or Update Resource Group.

Anger URL:en för parameterfilen. Exempel: https://raw.githubusercontent.com/Azure/...

Om du vill använda en fil som lagras i ett privat lagringskonto hämtar och inkluderar du SAS-token (signatur för delad åtkomst) i mallens URL. Exempel: <blob_storage_url>/template.json?<SAStoken> Om du vill ladda upp en parameterfil till ett lagringskonto och generera en SAS-token kan du använda Azure-filkopieringsaktiviteten eller följa stegen med Hjälp av PowerShell eller Azure CLI.

Om du vill visa mallparametrarna i ett rutnät klickar du på ... bredvid textrutan åsidosätt mallparametrar. Den här funktionen kräver att CORS-regler är aktiverade vid källan. Om mallarna finns i en Azure Storage-blob läser du Förstå CORS-begäranden för att aktivera CORS.


csmFile - Mall
string. Krävs när templateLocation = Linked artifact && action = Create Or Update Resource Group.

Anger sökvägen eller ett mönster som pekar på Azure Resource Manager-mallen. Läs mer om Azure Resource Manager-mallar. Kom igång direkt med den här exempelmallen.


csmParametersFile - Mallparametrar
string. Valfritt. Använd när templateLocation = Linked artifact && action = Create Or Update Resource Group.

Anger URL:en för parameterfilen. Ett exempel på en URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Om du vill använda en fil som lagras i ett privat lagringskonto hämtar och inkluderar du SAS-token (signatur för delad åtkomst) i mallens URL. Exempel: <blob_storage_url>/template.json?<SAStoken> Om du vill ladda upp en parameterfil till ett lagringskonto och generera en SAS-token använder du Azure-filkopieringsaktiviteten eller följer stegen med PowerShell eller Azure CLI.

Om du vill visa mallparametrarna i ett rutnät klickar du på ... bredvid textrutan åsidosätt mallparametrar. Den här funktionen kräver att CORS-regler är aktiverade vid källan. Om mallarna finns i en Azure Storage-blob läser du Förstå CORS-begäranden för att aktivera CORS.


overrideParameters - Åsidosätta mallparametrar
string. Valfritt. Använd när action = Create Or Update Resource Group.

Anger de mallparametrar som ska åsidosättas.

Om du vill visa mallparametrarna i ett rutnät klickar du på ... bredvid textrutan åsidosättningsparametrar. Den här funktionen kräver att CORS-regler är aktiverade vid källan. Om mallarna finns i Azure Storage-bloben refererar du till den här strängen för att aktivera CORS eller skriver mallparametrarna som ska åsidosättas i textrutan.

Exempel: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

Om parametervärdet har flera ord omger du orden med citattecken, även om du skickar värdet med hjälp av variabler. Till exempel -name "parameter value" -name2 "$(var)". Om du vill åsidosätta objekttypsparametrar använder du strängifierade JSON-objekt. Till exempel -options ["option1"] -map {"key1": "value1" }.


deploymentMode - Distributionsläge
string. Krävs när action = Create Or Update Resource Group. Tillåtna värden: Incremental, Complete, Validation (endast validering). Standardvärde: Incremental.

Läget Incremental hanterar distributioner som inkrementella uppdateringar av resursgruppen. Den lämnar oförändrade resurser som finns i resursgruppen men som inte anges i mallen.

Complete -läget tar bort resurser som inte finns i mallen. Fullständigt läge tar relativt längre tid än inkrementellt läge. Om tidsgränsen uppnås för aktiviteten kan du överväga att öka tidsgränsen eller ändra till Incremental läget.

Varning

Fullständigt läge tar bort alla befintliga resurser i resursgruppen som inte har angetts i mallen. Granska om resursgruppen som du distribuerar till inte innehåller några nödvändiga resurser som inte anges i mallen.

Validate med läget kan du hitta problem med mallen innan du skapar faktiska resurser.

Anteckning

Läget Validate skapar alltid en resursgrupp, även om inga resurser distribueras.

Läs mer om distributionslägen.


enableDeploymentPrerequisites - Aktivera förutsättningar
string. Valfritt. Använd när action = Create Or Update Resource Group || action = Select Resource Group. Tillåtna värden: None, ConfigureVMwithWinRM (Konfigurera med WinRM-agenten) ConfigureVMWithDGAgent (Konfigurera med distributionsgruppsagenten). Standardvärde: None.

Gäller endast när resursgruppen innehåller virtuella datorer.

Om du väljer alternativet Distributionsgrupp konfigureras distributionsgruppsagenten på var och en av de virtuella datorerna.

Om du väljer alternativet WinRM konfigureras WinRM-lyssnaren (Windows Remote Management) via HTTPS-protokollet på port 5986 med hjälp av ett självsignerat certifikat. Den här konfigurationen krävs för att utföra distributionsåtgärden på Azure-datorer. Om de virtuella måldatorerna backas upp av en lastbalanserare kontrollerar du att de inkommande NAT-reglerna har konfigurerats för målporten (5986).


teamServicesConnection - Tjänstanslutning för Azure Pipelines
Indataalias: deploymentGroupEndpoint. string. Krävs när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Anger tjänstanslutningen för att ansluta till en Azure DevOps-organisation eller -samling för agentregistrering.

Du kan skapa en tjänstanslutning med +New och sedan välja Token-based authentication. Du behöver en personlig åtkomsttoken (PAT) för att konfigurera en tjänstanslutning. Klicka här om du Manage vill uppdatera anslutningsinformationen för tjänsten.


teamServicesConnection - Azure Pipelines/TFS-tjänstanslutning
Indataalias: deploymentGroupEndpoint. string. Krävs när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Anger tjänstanslutningen för att ansluta till en Azure DevOps-organisation eller -samling för agentregistrering.

Du kan skapa en tjänstanslutning med +New och sedan välja Token-based authentication. Du behöver en personlig åtkomsttoken (PAT) för att konfigurera en tjänstanslutning. Klicka här om du Manage vill uppdatera anslutningsinformationen för tjänsten.


teamProject - Teamprojekt
Indataalias: project. string. Krävs när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Anger det teamprojekt som definierar distributionsgruppen.


deploymentGroupName - Distributionsgrupp
string. Krävs när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Anger den distributionsgrupp som agenterna ska registreras mot. Läs mer om distributionsgrupper.


copyAzureVMTags - Kopiera taggar för virtuella Azure-datorer till agenter
boolean. Valfritt. Använd när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Standardvärde: true.

Väljer om de konfigurerade taggarna på den virtuella Azure-datorn måste kopieras till motsvarande distributionsgruppsagent.

Som standard kopieras alla Azure-taggar enligt formatet: Key: Value. Exempel: En Role : Web Azure-tagg kopieras som den är till agentdatorn.

Läs mer om hur du använder taggar för Azure-resurser.


runAgentServiceAsUser - Köra agenttjänsten som en användare
boolean. Valfritt. Använd när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Standardvärde: false.

Kör agenttjänsten som en annan användare än standardanvändaren om värdet är inställt på true.

Standardanvändaren finns NT AUTHORITY\\SYSTEM i Windows och root i Linux.


userName - Användarnamn
string. Krävs när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Användarnamnet för att köra agenttjänsten på de virtuella datorerna.

För domänanvändare anger du värden som domain\username eller username@domain.com. För lokala användare anger du username.

Det förutsätts att samma domänanvändare eller en lokal användare med samma namn finns på alla virtuella datorer i resursgruppen.


password - Lösenord
string. Valfritt. Använd när enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Lösenordet för användaren att köra agenttjänsten på de virtuella Windows-datorerna.

Det förutsätts att lösenordet är detsamma för den angivna användaren på alla virtuella datorer.

Den kan acceptera variabler som definierats i bygg- eller versionspipelines som $(passwordVariable). Du kan markera variabeln som secret för att skydda den.

För virtuella Linux-datorer krävs inget lösenord och ignoreras.


outputVariable - Vm-information för WinRM
string. Valfritt. Använd när enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

Krävs när en befintlig resursgrupp väljs. Anger ett namn för resursgruppsvariabeln. Variabeln kan användas för $(variableName) att referera till resursgruppen i efterföljande uppgifter, till exempel i PowerShell på måldatorer för distribution av program.

Endast giltig när den valda åtgärden är Create, Updateeller Select.


deploymentName - Distributionsnamn
string. Valfritt. Använd när action = Create Or Update Resource Group.

Anger namnet på den resursgruppsdistribution som ska skapas.


deploymentOutputs - Distributionsutdata
string. Valfritt. Använd när action = Create Or Update Resource Group.

Anger ett namn för utdatavariabeln som innehåller utdataavsnittet för det aktuella distributionsobjektet i strängformat. Använd PowerShell-cmdleten ConvertFrom-Json för att parsa JSON-objektet och komma åt de enskilda utdatavärdena.


addSpnToEnvironment - Få åtkomst till information om tjänstens huvudnamn i åsidosättningsparametrar
boolean. Valfritt. Använd när action = Create Or Update Resource Group. Standardvärde: false.

Lägger till tjänstens huvudnamns-ID och nyckel för den Azure-slutpunkt som valts som skriptets körningsmiljö. Variablerna och $servicePrincipalKey kan finnas i åsidosättningsparametrar$servicePrincipalId, till exempel -key $servicePrincipalKey.


useWithoutJSON - Använd enskilda utdatavärden utan JSON. Tillämpad sträng
boolean. Valfritt. Använd när action = Create Or Update Resource Group. Standardvärde: false.

Enskilda utdatavärden konverteras via JSON. Stringify som standard. Om du vill använda utdatavärdena som de är utan att konvertera dem via JSON. Stringify, aktivera det här alternativet. Mer information finns i detta.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Det finns en ny version av den här uppgiften tillgänglig på AzureResourceManagerTemplateDeployment@3 – ARM-malldistribution v3-uppgift.

Nyheter i aktivitetsversion 2

  • Fungerar med plattformsoberoende agenter (Linux, macOS eller Windows)
  • Stöder JSON-mallar som finns på alla offentligt tillgängliga HTTP/https-URL:er.
  • Förbättrat användargränssnitt för åsidosättningsparametrar som nu kan visas/redigeras i ett rutnät.
  • NAT-regelmappning för virtuella datorer som backas upp av en lastbalanserare.
  • Fältet "Resursgrupp" har nu bytt namn till "VM-information för WinRM" och ingår i avsnittet "Avancerade distributionsalternativ för virtuella datorer".
  • Begränsningar:
    • Inget stöd för klassiska prenumerationer. Endast ARM-prenumerationer stöds.
    • Inget stöd för PowerShell-syntax eftersom uppgiften nu är node.js baserad. Se till att skiftlägeskänsligheten för parameternamnen matchar när du åsidosätter mallparametrarna. Ta också bort PowerShell-cmdletar som "ConvertTo-SecureString" när du migrerar från version 1.0 till version 2.0.

Felsökning

Fel: Internt serverfel

De här problemen är till största delen tillfälliga. Det finns flera orsaker till varför det kan hända:

  • En av de Azure-tjänster som du försöker distribuera genomgå underhåll i den region som du försöker distribuera till. Håll utkik efter https://status.azure.com/ driftstopp för Azure-tjänster.
  • Själva Azure Pipelines-tjänsten genomgår underhåll. Håll utkik efter https://status.dev.azure.com/ stilleståndstider.

Vi har dock sett några instanser där detta beror på ett fel i ARM-mallen, till exempel att den Azure-tjänst som du försöker distribuera inte stöder den region som du har valt för resursen.

Fel: Tidsgräns

Tidsgränsproblem kan komma från två platser:

  • Azure Pipelines-agent
  • Portaldistribution

Du kan identifiera om tidsgränsen kommer från portalen genom att söka efter portalens distributionslänk som finns i aktivitetsloggarna. Om det inte finns någon länk beror det troligen på Azure Pipelines-agenten. Om det finns en länk följer du länken för att se om det finns en tidsgräns som har nåtts i portaldistributionen.

Fel: CORS-regler som ska aktiveras vid åsidosättande av parametrar

Om mallfilen refereras från en BLOB och parametrar åsidosätts i pipelinen kan följande varningsmeddelande visas:

Warning: Failed to download the file from template path.

Den här funktionen kräver att CORS-reglerna aktiveras vid källan. Om mallar finns i Azure Storage Blob läser du Stöd för resursdelning mellan ursprung för att aktivera CORS.

Förutom att aktivera CORS kontrollerar du att DEN SAS-token som anges i länken till mallen är "srt-sco". Denna token krävs för att du ska kunna ladda ned filen och fortsätta.

Azure Pipelines-agent

Om problemet kommer från Azure Pipelines-agenten kan du öka tidsgränsen genom att ange timeoutInMinutes som nyckel i YAML till 0. Mer information finns i Ange jobb i din pipeline.

Portaldistribution

Läs det här dokumentet om hur du identifierar om felet kom från Azure Portal: Visa distributionshistorik med Azure Resource Manager.

Vid portaldistribution kan du prova att ange "timeoutInMinutes" i ARM-mallen till "0". Om inget värde anges antas värdet vara 60 minuter. 0 ser till att distributionen körs så länge den kan lyckas.

Detta kan också inträffa på grund av tillfälliga problem i systemet. Håll ett öga på https://status.dev.azure.com/ för att kontrollera om det uppstår driftstopp i Azure Pipelines-tjänsten.

Fel: Verifieringen av ARM-mallen (Azure Resource Manager) misslyckades

Det här problemet beror främst på en ogiltig parameter i ARM-mallen, till exempel en SKU eller region som inte stöds. Om verifieringen misslyckas kontrollerar du felmeddelandet. Det bör leda dig till den resurs och parameter som är ogiltig.

Det här problemet kan också uppstå på grund av flerradssträngar. För närvarande stöder inte Azure-resursgruppsdistributionen flerradssträngar i en ARM-mall eller parameter-JSON-fil.

Läs även den här artikeln om strukturen och syntaxen för ARM-mallar: Förstå strukturen och syntaxen för ARM-mallar.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Ingen
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 2.119.1 eller senare
Uppgiftskategori Distribuera