AzureResourceGroupDeployment@1 — zadanie Wdrażanie grupy zasobów platformy Azure w wersji 1

Artykuł
2025-03-24

To zadanie służy do wdrażania, uruchamiania, zatrzymywania i usuwania grup zasobów platformy Azure.

To zadanie jest przestarzałe; użyj AzureResourceGroupDeployment@2.

Składnia

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

Dane wejściowe

ConnectedServiceNameSelector - typ połączenia platformy Azure
string. Dozwolone wartości: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (wersja klasyczna platformy Azure). Wartość domyślna: ConnectedServiceName.

To jest wymagane. Wybiera połączenie z usługą, które zawiera subskrypcję platformy Azure dla wdrożenia.

ConnectedServiceName - subskrypcji platformy Azure
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

To jest wymagane. Wybiera połączenie z usługą, które zawiera subskrypcję platformy Azure dla wdrożenia.

ConnectedServiceNameClassic - klasycznej subskrypcji platformy Azure
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Wybiera klasyczną subskrypcję platformy Azure dla wdrożenia.

action - akcja
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName. Dozwolone wartości: Create Or Update Resource Group, Select Resource Group, Start (Uruchamianie maszyn wirtualnych), Stop (zatrzymywanie maszyn wirtualnych), Restart (ponowne uruchamianie maszyn wirtualnych), Delete (usuwanie maszyn wirtualnych), DeleteRG (usuwanie grupy zasobów). Wartość domyślna: Create Or Update Resource Group.

Akcja do wykonania w zasobach platformy Azure lub grupie zasobów.

actionClassic - akcja
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameClassic. Dozwolone wartości: Select Resource Group (wybierz pozycję Usługa w chmurze). Wartość domyślna: Select Resource Group.

Akcja do wykonania w zasobach platformy Azure lub usłudze w chmurze.

resourceGroupName - grupy zasobów
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Zawiera nazwę grupy zasobów.

usługi w chmurze cloudService -
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Zawiera nazwę usługi w chmurze.

lokalizacji location -
string. Wymagane, gdy action = Create Or Update Resource Group. Dozwolone wartości: Australia East, Australia Southeast, Brazil South, Canada Central, Canada East, Central India, Central US, East Asia, East US, East US 2 , Japan East, Japan West, North Central US, North Europe, South Central US, South India, Southeast Asia, UK South, UK West, West Central US, West Europe, West India, West US, West US 2. Wartość domyślna: East US.

Lokalizacja do wdrożenia grupy zasobów. Jeśli grupa zasobów już istnieje w subskrypcji, ta wartość zostanie zignorowana.

szablonu csmFile -
string. Wymagane, gdy action = Create Or Update Resource Group.

Określa ścieżkę lub wzorzec wskazujący szablon usługi Azure Resource Manager. Dowiedz się więcej o szablonach usługi Azure Resource Manager . Aby natychmiast rozpocząć pracę, użyj tego przykładowego szablonu.

csmParametersFile - parametry szablonu
string. Opcjonalny. Użyj polecenia , gdy action = Create Or Update Resource Group.

Określa adres URL pliku parametrów. Przykładowy adres URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Aby użyć pliku przechowywanego na prywatnym koncie magazynu, pobierz i dołącz token sygnatury dostępu współdzielonego (SAS) w adresie URL szablonu. Przykład: <blob_storage_url>/template.json?<SAStoken> Aby przekazać plik parametrów na konto magazynu i wygenerować token SAS, użyj zadania kopiowania plików platformy Azure lub wykonaj kroki opisane w programie PowerShell lub interfejsie wiersza polecenia platformy Azure .

Aby wyświetlić parametry szablonu w siatce, kliknij … obok pola tekstowego zastąpić parametry szablonu. Ta funkcja wymaga włączenia reguł CORS w źródle. Jeśli szablony znajdują się w obiekcie blob usługi Azure Storage, zobacz udostępnianie zasobów między źródłami, aby włączyć mechanizm CORS.

overrideParameters - zastąpić parametry szablonu
string. Opcjonalny. Użyj polecenia , gdy action = Create Or Update Resource Group.

Określa parametry szablonu do zastąpienia.

Aby wyświetlić parametry szablonu w siatce, kliknij ... obok pola tekstowego Przesłoń parametry. Ta funkcja wymaga włączenia reguł CORS w źródle. Jeśli szablony znajdują się w obiekcie blob usługi Azure Storage, odwołaj się do tego ciągu, aby włączyć mechanizm CORS, lub wpisz parametry szablonu do zastąpienia w polu tekstowym.

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

Jeśli wartość parametru ma wiele wyrazów, należy ująć wyrazy w cudzysłowy, nawet jeśli przekazujesz wartość przy użyciu zmiennych. Na przykład -name "parameter value" -name2 "$(var)". Aby zastąpić parametry typu obiektu, użyj ciągyfikowanych obiektów JSON. Na przykład -options ["option1"] -map {"key1": "value1" }.

deploymentMode - tryb wdrażania
string. Wymagane, gdy action = Create Or Update Resource Group. Dozwolone wartości: Validation (tylko walidacja), Incremental, Complete. Wartość domyślna: Incremental.

Tryb Incremental obsługuje wdrożenia jako aktualizacje przyrostowe do grupy zasobów. Pozostawia niezmienione zasoby, które istnieją w grupie zasobów, ale nie zostały określone w szablonie.

Complete tryb usuwa zasoby, które nie znajdują się w szablonie. Tryb ukończenia zajmuje stosunkowo więcej czasu niż tryb przyrostowy. Jeśli limit czasu zadania zostanie przekroczony, rozważ zwiększenie limitu czasu lub zmianę na tryb Incremental.

Ostrzeżenie

Tryb ukończenia spowoduje usunięcie wszystkich istniejących zasobów w grupie zasobów, które nie zostały określone w szablonie. Sprawdź, czy wdrażana grupa zasobów nie zawiera żadnych niezbędnych zasobów, które nie zostały określone w szablonie.

Validate tryb umożliwia znalezienie problemów z szablonem przed utworzeniem rzeczywistych zasobów.

Uwaga

Tryb Validate zawsze tworzy grupę zasobów, nawet jeśli nie są wdrażane żadne zasoby.

Dowiedz się więcej o trybach wdrażania .

enableDeploymentPrerequisitesForCreate - włączanie wymagań wstępnych dotyczących wdrażania
boolean. Opcjonalny. Użyj polecenia , gdy action = Create Or Update Resource Group. Wartość domyślna: false.

Dotyczy tylko wtedy, gdy grupa zasobów zawiera maszyny wirtualne.

Wybranie opcji Grupa wdrożenia powoduje skonfigurowanie agenta grupy wdrożeń na każdej maszynie wirtualnej.

Wybranie opcji WinRM powoduje skonfigurowanie odbiornika Windows Remote Management (WinRM) za pośrednictwem protokołu HTTPS na porcie 5986 przy użyciu certyfikatu z podpisem własnym. Ta konfiguracja jest wymagana do wykonywania operacji wdrażania na maszynach platformy Azure. Jeśli docelowe maszyny wirtualne są wspierane przez moduł równoważenia obciążenia, upewnij się, że reguły NAT dla ruchu przychodzącego są skonfigurowane dla portu docelowego (5986).

enableDeploymentPrerequisitesForSelect - włączanie wymagań wstępnych dotyczących wdrażania
boolean. Opcjonalny. Użyj polecenia , gdy action = Select Resource Group. Wartość domyślna: false.

Dotyczy tylko wtedy, gdy grupa zasobów zawiera maszyny wirtualne.

Wybranie opcji Grupa wdrożenia powoduje skonfigurowanie agenta grupy wdrożeń na każdej maszynie wirtualnej.

outputVariable - grupy zasobów
string.

Wymagane po wybraniu istniejącej grupy zasobów. Zawiera nazwę zmiennej grupy zasobów. Zmienna może służyć jako $(variableName) do odwoływania się do grupy zasobów w kolejnych zadaniach, takich jak w programie PowerShell w usłudze Target Machines zadania wdrażania aplikacji.

Prawidłowe tylko wtedy, gdy wybrana akcja jest Create, Updatelub Select.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do uruchamiania zadań korzystających z tego zadania: azureps
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.103.0 lub nowsza
Kategoria zadań	Zastosuj

Udostępnij za pośrednictwem