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

AzureResourceGroupDeployment@2 – Azure-erőforráscsoport üzembe helyezési v2-feladata

  • Cikk

Azure Resource Manager (ARM) sablon üzembe helyezése erőforráscsoportban és virtuális gépek kezelése.

Azure Resource Manager- (ARM-) sablon üzembe helyezése egy erőforráscsoportban. Az erőforráscsoportban lévő összes Virtual Machines (VM) elindíthatja, leállíthatja, törölheti és felszabadíthatja.

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.

Bevitelek

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceName. string. Kötelező.

Kiválasztja azt a szolgáltatáskapcsolatot, amely azure-előfizetést tartalmaz az üzembe helyezéshez.


action - Akció
string. Kötelező. Engedélyezett értékek: Create Or Update Resource Group, Select Resource Group (Virtuális gépek üzembehelyezési beállításainak konfigurálása), Start (Virtuális gépek indítása), Stop (Virtuális gépek leállítása), StopWithDeallocate (Virtuális gépek leállítása és felszabadítása), Restart (Virtuális gépek újraindítása), Delete (Virtuális gépek törlése) 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. Kötelező.

Megadja az erőforráscsoport nevét.


location - Helyen
string. Akkor szükséges, ha action = Create Or Update Resource Group.

Az erőforráscsoport üzembe helyezésének helye. Ha az erőforráscsoport már létezik az előfizetésben, a rendszer figyelmen kívül hagyja ezt az értéket.


templateLocation - Sablon helye
string. Akkor szükséges, ha action = Create Or Update Resource Group. Engedélyezett értékek: Linked artifact, URL of the file. Alapértelmezett érték: Linked artifact.

Válassza a Csatolt összetevő vagy a fájl URL-címe lehetőséget.


csmFileLink - Sablonhivatkozás
string. Akkor szükséges, ha templateLocation = URL of the file && action = Create Or Update Resource Group.

Megadja a sablonfájl URL-címét. Példa URL-cím: 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 foglalja bele a közös hozzáférésű jogosultságkód (SAS) tokent a sablon URL-címében. Például: <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 az Azure-fájlmásolási feladatot, vagy kövesse a lépéseket a PowerShell vagy az Azure CLI használatával.

A sablonparaméterek rácsban való megtekintéséhez kattintson a ... sablonparamé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 egy Azure Storage-blobban találhatók, tekintse meg a CORS engedélyezésére vonatkozó CORS-kérelmek ismertetését .


csmParametersFileLink - Sablonparaméterek hivatkozása
string. Választható. Használja a következőt: templateLocation = URL of the file && action = Create Or Update Resource Group.

A paraméterfájl URL-címét adja meg. Például: https://raw.githubusercontent.com/Azure/...

Ha privát tárfiókban tárolt fájlt szeretne használni, kérje le és adja meg a közös hozzáférésű jogosultságkód (SAS) tokent a sablon URL-címében. Példa: <blob_storage_url>/template.json?<SAStoken> Ha paraméterfájlt szeretne feltölteni egy tárfiókba, és SAS-jogkivonatot szeretne létrehozni, használhatja az Azure-fájlmásolási feladatot, vagy kövesse a lépéseket a PowerShell vagy az Azure CLI használatával.

A sablonparaméterek rácsban való megtekintéséhez kattintson a ... sablonparamé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 egy Azure Storage-blobban találhatók, tekintse meg a CORS engedélyezésére vonatkozó CORS-kérelmek ismertetését .


csmFile - Sablon
string. Akkor szükséges, ha templateLocation = Linked artifact && action = Create Or Update Resource Group.

Megadja az Azure Resource Manager-sablonra mutató útvonalat vagy mintát. További információ az Azure Resource Manager-sablonokról. Az első lépésekhez használja ezt a mintasablont.


csmParametersFile - Sablonparaméterek
string. Választható. Használja a következőt: templateLocation = Linked artifact && action = Create Or Update Resource Group.

A paraméterfájl URL-címét adja meg. Példa URL-cím: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Ha privát tárfiókban tárolt fájlt szeretne használni, kérje le és adja meg a közös hozzáférésű jogosultságkód (SAS) tokent a sablon URL-címében. Példa: <blob_storage_url>/template.json?<SAStoken> Paraméterfájl tárfiókba való feltöltéséhez és SAS-jogkivonat létrehozásához használja az Azure-fájlmásolási feladatot, vagy kövesse a lépéseket a PowerShell vagy az Azure CLI használatával.

A sablonparaméterek rácsban való megtekintéséhez kattintson a ... sablonparamé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 egy Azure Storage-blobban találhatók, tekintse meg a CORS engedélyezésére vonatkozó CORS-kérelmek ismertetését .


overrideParameters - Sablonparaméterek felülbírálása
string. Választható. Használja a következőt: action = Create Or Update Resource Group.

Megadja a felülbírálandó sablonparamétereket.

A sablonparaméterek rácsban való megtekintéséhez kattintson a ... felülbírálási paraméterek 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 felülbírálandó sablonparamétereket 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óval is rendelkezik, akkor is foglalja idézőjelekbe a szavakat, 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. Akkor szükséges, ha action = Create Or Update Resource Group. Engedélyezett értékek: Incremental, Complete, Validation (csak érvényesítés). Alapértelmezett érték: Incremental.

A Incremental mód az üzemelő példányokat az erőforráscsoport növekményes frissítéseként kezeli. Változatlan erőforrásokat hagy az erőforráscsoportban, de nincsenek megadva a sablonban.

Complete A 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 feladat túllépi az időkorlátot, érdemes lehet növelni az időtúllépést, vagy átváltani a Incremental módra.

Figyelmeztetés

A teljes mód törli az erőforráscsoportban lévő összes olyan erőforrást, amely nincs megadva a sablonban. Ellenőrizze, hogy a központilag telepített erőforráscsoport nem tartalmaz-e olyan szükséges erőforrásokat, amelyek nincsenek megadva a sablonban.

Validate A mód lehetővé teszi, hogy problémákat keressen a sablonnal, mielőtt tényleges erőforrásokat hoz létre.

Megjegyzés

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ó az üzembehelyezési módokról.


enableDeploymentPrerequisites - Előfeltételek engedélyezése
string. Választható. Használja a következőt: action = Create Or Update Resource Group || action = Select Resource Group. Engedélyezett értékek: None, ConfigureVMwithWinRM (Konfigurálás WinRM-ügynökkel) ConfigureVMWithDGAgent (Konfigurálás üzembehelyezési csoport ügynökkel). Alapértelmezett érték: None.

Csak akkor alkalmazható, ha az erőforráscsoport virtuális gépeket tartalmaz.

Az Üzembehelyezési csoport beállítás választása konfigurálja az üzembehelyezési csoport ügynökét az egyes virtuális gépeken.

A WinRM beállítás kiválasztásával a Windows Remote Management (WinRM) figyelője HTTPS protokollon keresztül konfigurálható az 5986-os porton egy önaláírt tanúsítvány használatával. Ez a konfiguráció az Üzembe helyezési művelet Azure-gépeken való végrehajtásához szükséges. Ha a cél virtuális gépeket terheléselosztó biztosítja, győződjön meg arról, hogy a bejövő NAT-szabályok konfigurálva vannak a célporthoz (5986).


teamServicesConnection - Azure Pipelines-szolgáltatáskapcsolat
Bemeneti alias: deploymentGroupEndpoint. string. Akkor szükséges, ha enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Megadja az Azure DevOps-szervezethez vagy -gyűjteményhez az ügynökregisztrációhoz való csatlakozáshoz szükséges szolgáltatáskapcsolatot.

Létrehozhat egy szolgáltatáskapcsolatot a használatával +New , majd kiválaszthatja a lehetőséget Token-based authentication. A szolgáltatáskapcsolat beállításához személyes hozzáférési jogkivonatra (PAT) van szükség. Kattintson ide Manage a szolgáltatáskapcsolat részleteinek frissítéséhez.


teamServicesConnection - Azure Pipelines/TFS-szolgáltatáskapcsolat
Bemeneti alias: deploymentGroupEndpoint. string. Akkor szükséges, ha enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Megadja az Azure DevOps-szervezethez vagy -gyűjteményhez az ügynökregisztrációhoz való csatlakozáshoz szükséges szolgáltatáskapcsolatot.

Létrehozhat egy szolgáltatáskapcsolatot a használatával +New , majd kiválaszthatja a lehetőséget Token-based authentication. A szolgáltatáskapcsolat beállításához személyes hozzáférési jogkivonatra (PAT) van szükség. Kattintson ide Manage a szolgáltatáskapcsolat részleteinek frissítéséhez.


teamProject - Csapatprojekt
Bemeneti alias: project. string. Akkor szükséges, ha enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Az üzembe helyezési csoportot meghatározó csapatprojektet adja meg.


deploymentGroupName - Üzembehelyezési csoport
string. Akkor szükséges, ha enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group.

Azt az üzembehelyezési csoportot adja meg, amelyhez az ügynök(ek) regisztrálva lesznek. További információ az üzembehelyezési csoportokról.


copyAzureVMTags - Azure-beli virtuálisgép-címkék másolása ügynökökbe
boolean. Választható. Használja a következőt: enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Alapértelmezett érték: true.

Azt választja, hogy az Azure-beli virtuális gépen lévő konfigurált címkéket át kell-e másolni a megfelelő üzembehelyezési csoportügynökbe.

Alapértelmezés szerint az összes Azure-címke a következő formátumot követi: Key: Value. Példa: Az Role : Web Azure-címkét az ügynökgépre másolná.

További információ az Azure-erőforrások címkéinek használatáról.


runAgentServiceAsUser - Ügynökszolgáltatás futtatása felhasználóként
boolean. Választható. Használja a következőt: enableDeploymentPrerequisites = ConfigureVMWithDGAgent && action = Create Or Update Resource Group || action = Select Resource Group. Alapértelmezett érték: false.

Az ügynökszolgáltatást az alapértelmezett felhasználótól eltérő felhasználóként futtatja, ha az érték trueértéke .

Az alapértelmezett felhasználó Windows NT AUTHORITY\\SYSTEM és root Linux rendszeren van.


userName - Felhasználónév
string. Akkor szükséges, ha enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

Az ügynökszolgáltatás virtuális gépeken való futtatásához használt felhasználónév.

Tartományfelhasználók esetén adja meg a vagy username@domain.comértékeketdomain\username. Helyi felhasználók esetén adja meg a következőt username: .

Feltételezzük, hogy ugyanaz a tartományi felhasználó vagy egy azonos nevű helyi felhasználó jelen van az erőforráscsoport összes virtuális gépén.


password - Jelszó
string. Választható. Használja a következőt: enableDeploymentPrerequisites = ConfigureVMWithDGAgent && runAgentServiceAsUser = true && action = Create Or Update Resource Group || action = Select Resource Group.

A felhasználó jelszava az ügynökszolgáltatás Windows rendszerű virtuális gépeken való futtatásához.

A rendszer feltételezi, hogy a jelszó ugyanaz a megadott felhasználóhoz az összes virtuális gépen.

A buildelési vagy kiadási folyamatokban definiált változókat a következőként fogadhatja el: $(passwordVariable). A változót biztonságosként secret jelölheti meg.

Linux rendszerű virtuális gépek esetén nincs szükség jelszóra, és a rendszer figyelmen kívül hagyja.


outputVariable - Virtuális gép részletei a WinRM-hez
string. Választható. Használja a következőt: enableDeploymentPrerequisites = ConfigureVMwithWinRM || enableDeploymentPrerequisites = None && action = Create Or Update Resource Group || action = Select Resource Group.

Meglévő erőforráscsoport kijelölésekor kötelező. Az erőforráscsoport változójának nevét adja meg. A változó használatával $(variableName) hivatkozhat az erőforráscsoportra a későbbi feladatokban, például a Célgépeken futó PowerShell-feladatban az alkalmazások üzembe helyezéséhez.

Csak akkor érvényes, ha a kijelölt művelet , CreateUpdatevagy Select.


deploymentName - Üzembe helyezés neve
string. Választható. Használja a következőt: action = Create Or Update Resource Group.

Megadja a létrehozandó erőforráscsoport-telepítés nevét.


deploymentOutputs - Üzembehelyezési kimenetek
string. Választható. Használja a következőt: action = Create Or Update Resource Group.

A kimeneti változó nevét adja meg, amely az aktuális üzembehelyezési objektum kimenetek szakaszát tartalmazza sztringformátumban. ConvertFrom-Json A PowerShell-parancsmaggal elemezhet JSON-objektumot, és hozzáférhet az egyes kimeneti értékekhez.


addSpnToEnvironment - A szolgáltatásnév részleteinek elérése a felülbírálási paraméterekben
boolean. Választható. Használja a következőt: action = Create Or Update Resource Group. Alapértelmezett érték: false.

Hozzáadja a szkript végrehajtási környezetének választott Azure-végpont egyszerű szolgáltatásazonosítóját és kulcsát. A változók $servicePrincipalId és $servicePrincipalKey lehetnek felülbírálási paraméterek, például -key $servicePrincipalKey.


useWithoutJSON - Egyéni kimeneti értékek használata JSON nélkül. Sztringesítés alkalmazva
boolean. Választható. Használja a következőt: action = Create Or Update Resource Group. Alapértelmezett érték: false.

Az egyes kimeneti értékek JSON-kapcsolaton 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-kapcsolaton keresztül konvertálja őket. Sztringbefűz, engedélyezze ezt a beállítást. További részletekért tekintse meg ezt a témakört.


Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ennek a feladatnak egy új verziója érhető el a AzureResourceManagerTemplateDeployment@3 – ARM-sablon üzembe helyezési v3 feladatában.

A 2. feladatverzió újdonságai

  • Platformfüggetlen ügynökökkel (Linux, macOS vagy Windows) működik
  • Támogatja a sablon JSON-jait, amelyek bármely nyilvánosan elérhető http/https URL-címen találhatók.
  • Továbbfejlesztett felhasználói felület felülbírálási paraméterekhez, amelyek mostantól megtekinthetők/szerkeszthetők egy rácson.
  • NAT-szabályleképezés terheléselosztó által támogatott virtuális gépekhez.
  • Az "Erőforráscsoport" mező mostantól "Virtuálisgép-részletek a WinRM-hez" néven lett átnevezve, és a "Speciális üzembehelyezési lehetőségek virtuális gépekhez" című szakasz tartalmazza.
  • Korlátozások:
    • A klasszikus előfizetések nem támogatottak. Csak ARM-előfizetések támogatottak.
    • A PowerShell-szintaxis nem támogatott, mivel a feladat mostantól node.js alapul. Ha felülbírálja a sablon paramétereit, győződjön meg arról, hogy a paraméternevek kis- és nagybetűk bizalmassága megegyezik. Az 1.0-s verzióról a 2.0-s verzióra való migráláskor távolítsa el a PowerShell-parancsmagokat is, például a "ConvertTo-SecureString" parancsmagokat.

Hibaelhárítás

Hiba: Belső kiszolgálóhiba

Ezek a problémák általában átmenetiek. A problémának több oka is lehet:

  • Az egyik üzembe helyezni kívánt Azure-szolgáltatás karbantartás alatt áll abban a régióban, amelyben üzembe szeretne helyezni. Figyelje meg az https://status.azure.com/ Azure-szolgáltatások állásidejét.
  • Maga az Azure Pipelines szolgáltatás áll karbantartás alatt. Tartsa szem előtt az https://status.dev.azure.com/ állásidőket.

Láttunk azonban olyan példákat, ahol a probléma az ARM-sablon hibája miatt következett be, például ha az üzembe helyezni kívánt Azure-szolgáltatás nem támogatja az erőforráshoz kiválasztott régiót.

Hiba: Időtúllépés

Az időtúllépési problémák két helyről származhatnak:

  • Azure Pipelines-ügynök
  • Portál üzemelő példánya

A feladatnaplókban található üzembehelyezési hivatkozás keresésével megállapíthatja, hogy az időtúllépés a portálról származik-e. Ha nincs ilyen hivatkozás, a forrás valószínűleg az Azure Pipelines-ügynök. Ha van hivatkozás, kövesse, és ellenőrizze, hogy történt-e időtúllépés a portál üzemelő példányán.

Hiba: A CORS-szabályok engedélyezve lesznek a paraméterek felülírásakor

Ha a sablonfájl egy BLOB-ból van átirányítva, miközben felülírja a paramétereket a folyamatban, a következő figyelmeztető üzenet jelenhet meg:

Warning: Failed to download the file from template path.

Ehhez a funkcióhoz engedélyezve kell lennie a CORS-szabályoknak a forrásnál. Ha a sablonok az Azure Storage-blobban vannak, a CORS engedélyezéséhez lásd: Eltérő eredetű erőforrások megosztásának támogatása.

A CORS engedélyezése mellett győződjön meg arról, hogy a sablon hivatkozásában megadott SAS-jogkivonat "srt-sco". Erre a tokenre van szüksége a fájl letöltéséhez és a folytatáshoz.

Azure Pipelines-ügynök

Ha a probléma az Azure Pipelines-ügynöktől származik, növelheti az időtúllépést, ha a YAML-ben kulcsként a timeoutInMinutes értéket 0-ra állítja. További információért lásd: Feladatok meghatározása a folyamatban.

Portál üzemelő példánya

Ebből a dokumentumból megtudhatja, hogyan állapíthatja meg, hogy a hiba a Azure Portal: Üzembehelyezési előzmények megtekintése az Azure Resource Manager.

Portál üzembe helyezése esetén próbálja meg "timeoutInMinutes" értékre állítani az ARM-sablonban a "0" értéket. Ha nincs megadva, a feltételezett érték 60 perc. A 0 gondoskodik arról, hogy az üzembe helyezés addig fusson, amíg sikeres lehet.

Ez a rendszer átmeneti problémái miatt is előfordulhat. https://status.dev.azure.com/ Figyelje meg, hogy van-e állásidő az Azure Pipelines szolgáltatásban.

Hiba: Az Azure Resource Manager (ARM) sablon érvényesítése sikertelen volt

Ez a probléma főleg az ARM-sablonban lévő érvénytelen paraméter, például nem támogatott termékváltozat vagy régió miatt következik be. Ha az ellenőrzés meghiúsul, ellenőrizze a hibaüzenetet. Elvileg elárulja, melyik az érvénytelen erőforrás és paraméter.

Ez a probléma többsoros sztringek miatt is előfordulhat. Jelenleg az Azure-erőforráscsoport üzembehelyezési feladata nem támogatja a többsoros sztringeket az ARM-sablonokban vagy paraméter JSON-fájlokban.

Emellett tekintse meg ezt a cikket az ARM-sablonok szerkezetéről és szintaxisáról: Az ARM-sablonok szerkezetének és szintaxisának ismertetése.

Követelmények

Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás: Ügynök, DeploymentGroup
Igények None
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ármelyik
Változók beállítása Bármelyik
Ügynök verziója 2.119.1 vagy újabb
Feladatkategória Üzembe helyezés