Udostępnij za pośrednictwem

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

  • Artykuł

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.

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


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

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


ConnectedServiceNameClassic - Klasyczna subskrypcja platformy Azure
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameClassic.

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


action - Działania
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName. Dozwolone wartości: Create Or Update Resource Group, , StartSelect Resource Group(Start Virtual Machines), Stop (Zatrzymaj Virtual Machines), (Uruchom ponownie Virtual Machines), RestartDelete (Usuń Virtual Machines), DeleteRG (Usuń grupę zasobów). Wartość domyślna: Create Or Update Resource Group.

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


actionClassic - Działania
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 - Grupa zasobów
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Zawiera nazwę grupy zasobów.


cloudService - Usługa w chmurze
string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Zawiera nazwę usługi w chmurze.


location - Lokalizacji
string. Wymagane, gdy action = Create Or Update Resource Group. Dozwolone wartości: Australia East, Australia SoutheastBrazil SouthWest USSoutheast AsiaCentral IndiaUK SouthCentral USUK WestWest IndiaSouth IndiaWest US 2West EuropeWest Central USSouth Central USNorth EuropeNorth Central USJapan WestEast US 2 East AsiaJapan EastCanada CentralCanada EastEast US. 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.


csmFile - Szablonu
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 do konta 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 przesłonięć parametry szablonu. Ta funkcja wymaga włączenia reguł CORS w miejscu źródłowym. Jeśli szablony znajdują się w obiekcie blob usługi Azure Storage, zapoznaj się z artykułem Udostępnianie zasobów między źródłami , aby włączyć mechanizm CORS.


overrideParameters - Zastępowanie parametrów 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 miejscu źródłowym. 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 zawiera wiele wyrazów, należy ująć wyrazy w cudzysłów, 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 przyrostowe aktualizacje grupy zasobów. Pozostawia on 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 przekroczono limit czasu zadania, rozważ zwiększenie limitu czasu lub zmianę w trybie 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 wdrożenia
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 wdrażania powoduje skonfigurowanie agenta grupy wdrożeń na każdej maszynie wirtualnej.

Wybranie opcji WinRM powoduje skonfigurowanie odbiornika zdalnego zarządzania systemem Windows (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 wdrożenia
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 wdrażania powoduje skonfigurowanie agenta grupy wdrożeń na każdej maszynie wirtualnej.

Wybranie opcji WinRM powoduje skonfigurowanie odbiornika zdalnego zarządzania systemem Windows (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).


outputVariable - Grupa zasobów
string.

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

Prawidłowa tylko wtedy, gdy wybrana akcja to Create, Updatelub Select.


Opcje sterowania zadania

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

Zmienne wyjściowe

Brak.

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa w Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi 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ń Dowolne
Zmienne ustawialne Dowolne
Wersja agenta 1.103.0 lub nowsza
Kategoria zadania Wdrażanie