AzureResourceGroupDeployment@1 - Attività Distribuzione gruppo di risorse di Azure v1

Articolo
08/19/2024

Usare questa attività per distribuire, avviare, arrestare ed eliminare gruppi di risorse di Azure.

Questa attività è deprecata; usare AzureResourceGroupDeployment@2.

Sintassi

# 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.

Input

ConnectedServiceNameSelector - Tipo di connessione di Azure
string. Valori consentiti: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (versione classica di Azure). Valore predefinito: ConnectedServiceName.

Obbligatorio. Seleziona la connessione al servizio che contiene una sottoscrizione di Azure per la distribuzione.

ConnectedServiceName - Sottoscrizione di Azure
string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Obbligatorio. Seleziona la connessione al servizio che contiene una sottoscrizione di Azure per la distribuzione.

ConnectedServiceNameClassic - Sottoscrizione classica di Azure
string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Seleziona una sottoscrizione classica di Azure per la distribuzione.

action - Azione
string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName. Valori consentiti: Create Or Update Resource Group, StartSelect Resource Group(Start Macchine virtuali), Stop (Arresta Macchine virtuali), Restart (Riavvia Macchine virtuali), Delete (Elimina Macchine virtuali), DeleteRG (Elimina gruppo di risorse). Valore predefinito: Create Or Update Resource Group.

Azione da eseguire sulle risorse di Azure o sul gruppo di risorse.

actionClassic - Azione
string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameClassic. Valori consentiti: Select Resource Group (selezionare Servizio cloud). Valore predefinito: Select Resource Group.

Azione da eseguire sulle risorse di Azure o sul servizio cloud.

resourceGroupName - Gruppo di risorse
string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Fornisce il nome del gruppo di risorse.

cloudService - Servizio cloud
string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Fornisce il nome del servizio cloud.

location - Posizione
string. Obbligatorio quando action = Create Or Update Resource Group. Valori consentiti: Australia East, Australia Southeast, Canada CentralBrazil South, Canada East, Central India, Central US, , East USEast US 2 North Central USJapan WestNorth EuropeSouth IndiaEast AsiaJapan EastSouth Central US, . West US 2Southeast AsiaUK SouthUK WestWest Central USWest EuropeWest IndiaWest US Valore predefinito: East US.

Percorso in cui distribuire il gruppo di risorse. Se il gruppo di risorse esiste già nella sottoscrizione, questo valore verrà ignorato.

csmFile - Modello
string. Obbligatorio quando action = Create Or Update Resource Group.

Specifica il percorso o un modello che punta al modello di Resource Manager di Azure. Altre informazioni sui modelli di Resource Manager di Azure. Per iniziare immediatamente, usare questo modello di esempio.

csmParametersFile - Parametri del modello
string. facoltativo. Usare quando action = Create Or Update Resource Group.

Specifica l'URL del file di parametri. URL di esempio: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Per usare un file archiviato in un account di archiviazione privato, recuperare e includere il token di firma di accesso condiviso nell'URL del modello. Esempio: <blob_storage_url>/template.json?<SAStoken> per caricare un file di parametri in un account di archiviazione e generare un token di firma di accesso condiviso, usare l'attività di copia file di Azure o seguire i passaggi usando PowerShell o l'interfaccia della riga di comando di Azure.

Per visualizzare i parametri del modello in una griglia, fare clic su … accanto alla casella di testo Override template parameters (Parametri del modello di override). Questa funzionalità richiede che per l'origine le regole CORS siano abilitate. Se i modelli si trovano nel BLOB di archiviazione di Azure, fare riferimento a Condivisione risorse tra le origini per abilitare CORS.

overrideParameters - Eseguire l'override dei parametri del modello
string. facoltativo. Usare quando action = Create Or Update Resource Group.

Specifica i parametri del modello di cui eseguire l'override.

Per visualizzare i parametri del modello in una griglia, fare clic su accanto alla casella di testo Override Parameters .To view the template parameters in a grid, click on ... next to the Override Parameters (Sostituisci parametri). Questa funzionalità richiede che per l'origine le regole CORS siano abilitate. Se i modelli si trovano nel BLOB di archiviazione di Azure, fare riferimento a questa stringa per abilitare CORS o digitare i parametri del modello da sostituire nella casella di testo.

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

Se il valore del parametro contiene più parole, racchiudere le parole tra virgolette, anche se si passa il valore usando le variabili. Ad esempio: -name "parameter value" -name2 "$(var)". Per eseguire l'override dei parametri del tipo di oggetto, usare oggetti JSON stringati. Ad esempio: -options ["option1"] -map {"key1": "value1" }.

deploymentMode - Modalità di distribuzione
string. Obbligatorio quando action = Create Or Update Resource Group. Valori consentiti: Validation (solo convalida), Incremental, Complete. Valore predefinito: Incremental.

La Incremental modalità gestisce le distribuzioni come aggiornamenti incrementali al gruppo di risorse. Lascia invariate le risorse presenti nel gruppo di risorse, ma non sono specificate nel modello.

Complete mode elimina le risorse che non sono presenti nel modello. La modalità completa richiede relativamente più tempo rispetto alla modalità incrementale. Se si verifica il timeout dell'attività, prendere in considerazione l'aumento del timeout o la modifica alla Incremental modalità .

Avviso

La modalità completa eliminerà tutte le risorse esistenti nel gruppo di risorse non specificate nel modello. Verificare se il gruppo di risorse in cui si esegue la distribuzione non contiene risorse necessarie non specificate nel modello.

Validate la modalità consente di trovare problemi con il modello prima di creare risorse effettive.

Nota

La Validate modalità crea sempre un gruppo di risorse, anche se non vengono distribuite risorse.

Altre informazioni sulle modalità di distribuzione.

enableDeploymentPrerequisitesForCreate - Abilitare i prerequisiti di distribuzione
boolean. facoltativo. Usare quando action = Create Or Update Resource Group. Valore predefinito: false.

Applicabile solo quando il gruppo di risorse contiene macchine virtuali.

Se si sceglie l'opzione Gruppo di distribuzione, l'agente del gruppo di distribuzione viene configurato in ognuna delle macchine virtuali.

Se si seleziona l'opzione WinRM, il listener di Gestione remota Windows (WinRM) viene configurato sul protocollo HTTPS sulla porta 5986 usando un certificato autofirmato. Questa configurazione è necessaria per eseguire l'operazione di distribuzione nei computer di Azure. Se le macchine virtuali di destinazione sono supportate da un servizio di bilanciamento del carico, assicurarsi che le regole NAT in ingresso siano configurate per la porta di destinazione (5986).

enableDeploymentPrerequisitesForSelect - Abilitare i prerequisiti di distribuzione
boolean. facoltativo. Usare quando action = Select Resource Group. Valore predefinito: false.

Applicabile solo quando il gruppo di risorse contiene macchine virtuali.

Se si sceglie l'opzione Gruppo di distribuzione, l'agente del gruppo di distribuzione viene configurato in ognuna delle macchine virtuali.

outputVariable - Gruppo di risorse
string.

Obbligatorio quando viene selezionato un gruppo di risorse esistente. Fornisce un nome per la variabile del gruppo di risorse. La variabile può essere usata come riferimento $(variableName) al gruppo di risorse nelle attività successive, ad esempio in PowerShell nelle macchine di destinazione per la distribuzione di applicazioni.

Valido solo quando l'azione selezionata è Create, Updateo Select.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per l'esecuzione di processi che usano questa attività: azureps
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.103.0 o versione successiva
Categoria attività	Distribuire

Condividi tramite