AzureAppServiceManage@0 - Serviço de Aplicações do Azure gerir tarefa v0

Inicie, pare, reinicie, troca de blocos, eliminação de blocos, instale extensões de site ou ative a monitorização contínua para uma Serviço de Aplicações do Azure.

Syntax

# Azure App Service manage v0
# Start, stop, restart, slot swap, slot delete, install site extensions or enable continuous monitoring for an Azure App Service.
- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    #Action: 'Swap Slots' # 'Swap Slots' | 'Start Azure App Service' | 'Stop Azure App Service' | 'Restart Azure App Service' | 'Start Swap With Preview' | 'Complete Swap' | 'Cancel Swap' | 'Delete Slot' | 'Install Extensions' | 'Enable Continuous Monitoring' | 'Start all continuous webjobs' | 'Stop all continuous webjobs'. Action. Default: Swap Slots.
    WebAppName: # string. Required. App Service name. 
    #SpecifySlotOrASE: false # boolean. Alias: SpecifySlot. Optional. Use when Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Specify Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap. Resource group. 
    #SourceSlot: # string. Required when Action = Swap Slots || Action = Start Swap With Preview  || Action = Complete Swap. Source Slot. 
    #SwapWithProduction: true # boolean. Optional. Use when Action = Swap Slots || Action = Start Swap With Preview  || Action = Complete Swap. Swap with Production. Default: true.
    #TargetSlot: # string. Required when SwapWithProduction = false. Target Slot. 
    #PreserveVnet: false # boolean. Optional. Use when Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Preserve Vnet. Default: false.
    #Slot: 'production' # string. Required when Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Slot. Default: production.
    #ExtensionsList: # string. Required when Action = Install Extensions. Install Extensions. 
    #OutputVariable: # string. Optional. Use when Action = Install Extensions. Output variable. 
    #AppInsightsResourceGroupName: # string. Required when Action == Enable Continuous Monitoring. Resource Group name for Application Insights. 
    #ApplicationInsightsResourceName: # string. Required when Action == Enable Continuous Monitoring. Application Insights resource name. 
  # Advanced Settings
    #ApplicationInsightsWebTestName: # string. Optional. Use when Action == Enable Continuous Monitoring. Application Insights web test name.

Entradas

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório.

Seleciona a subscrição do Azure Resource Manager.

Action - Ação
string. Valores permitidos: Swap Slots, Start Azure App Service (Iniciar Serviço de Aplicações), Stop Azure App Service (Parar Serviço de Aplicações), Restart Azure App Service (Reiniciar Serviço de Aplicações), Start Swap With Preview, Complete Swap (Concluir Troca com Pré-visualização), Cancel Swap (Cancelar Troca com Pré-visualização), Delete Slot, Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Valor predefinido: Swap Slots.

Opcional. Define a ação a executar no Serviço de Aplicações. Pode iniciar, parar, reiniciar, trocar blocos, iniciar a troca com uma pré-visualização, concluir a troca com uma pré-visualização, cancelar a troca com uma pré-visualização, instalar extensões de site ou ativar a monitorização contínua para uma Serviço de Aplicações do Azure.

WebAppName - Serviço de Aplicações nome
string. Obrigatório.

Introduz ou seleciona o nome de uma Serviço de Aplicações do Azure existente.

SpecifySlotOrASE - Especificar Bloco ou Ambiente do Serviço de Aplicações
Alias de entrada: SpecifySlot. boolean. Opcional. Utilize quando Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Valor predefinido: false.

ResourceGroupName - Grupo de recursos
string. Necessário quando Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap.

Introduz ou seleciona o Grupo de Recursos do Azure que contém o Serviço de Aplicações do Azure especificado acima.

SourceSlot - Bloco de Origem
string. Necessário quando Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap.

Utilizado como bloco de origem quando action == Swap Slots. A ação de troca direciona o tráfego do bloco de destino para o bloco de origem.

SwapWithProduction - Trocar por Produção
boolean. Opcional. Utilize quando Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Valor predefinido: true.

Troca o tráfego do bloco de origem pela produção. Se não selecionar esta opção, terá de fornecer os nomes dos blocos de origem e de destino.

TargetSlot - Bloco de Destino
string. Necessário quando SwapWithProduction = false.

Utilize como o bloco de destino quando action == Swap Slots. A ação de troca direciona o tráfego do bloco de destino para o bloco de origem.

PreserveVnet - Preservar vnet
boolean. Opcional. Utilize quando Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Valor predefinido: false.

Preserva as definições de rede virtual.

Slot - Ranhura
string. Necessário quando Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Valor predefinido: production.

ExtensionsList - Instalar Extensões
string. Necessário quando Action = Install Extensions.

As extensões de site são executadas no Microsoft Serviço de Aplicações do Azure. Pode instalar um conjunto de ferramentas como uma extensão de site e gerir melhor os seus Serviço de Aplicações do Azure. Reinicie o Serviço de Aplicações para que as alterações mais recentes entrem em vigor.

OutputVariable - Variável de saída
string. Opcional. Utilize quando Action = Install Extensions.

Fornece o nome da variável para o caminho de instalação local da extensão selecionada.

Este campo foi preterido e será removido. Utilize a LocalPathsForInstalledExtensions variável da secção Variáveis de Saída em tarefas subsequentes.

AppInsightsResourceGroupName - Nome do Grupo de Recursos para o Application Insights
string. Necessário quando Action == Enable Continuous Monitoring.

Introduz ou seleciona o grupo de recursos onde o recurso do Application Insights está disponível.

ApplicationInsightsResourceName - Nome do recurso do Application Insights
string. Necessário quando Action == Enable Continuous Monitoring.

Seleciona o recurso do Application Insights onde são registados dados de monitorização contínua.

Se o recurso do Application Insights não estiver listado aqui e quiser criar um novo recurso, selecione +Novo. Depois de criar o recurso no portal do Azure, volte aqui e selecione Atualizar.

ApplicationInsightsWebTestName - Nome do teste Web do Application Insights
string. Opcional. Utilize quando Action == Enable Continuous Monitoring.

Opcional. Introduz o nome do teste Web do Application Insights que pretende criar ou atualizar.

Se não fornecer um nome de teste Web, é utilizado o nome de teste predefinido.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

LocalPathsForInstalledExtensions
Esta entrada são os caminhos de instalação local para as extensões que selecionar.

Se selecionar várias extensões, a saída é uma lista separada por vírgulas de caminhos locais para cada uma das extensões que selecionar. O resultado lista os caminhos pela ordem em que aparecem no campo Instalar Extensões.

Observações

Utilize esta tarefa para iniciar, parar, reiniciar, trocar blocos, Trocar por Pré-visualização, instalar extensões de site ou ativar a monitorização contínua para um Serviço de Aplicações do Azure.

O que acontece durante uma troca

Quando troca dois blocos (normalmente de um bloco de teste para o bloco de produção), certifique-se de que o bloco de produção é sempre o bloco de destino. Desta forma, a operação de troca não afeta a sua aplicação de produção.

Também em qualquer ponto da operação de troca (ou troca por pré-visualização), todo o trabalho de inicialização das aplicações trocadas ocorre no bloco de origem. O bloco de destino permanece online enquanto o bloco de origem está a ser preparado e aquecido, independentemente de onde a troca tiver êxito ou falhar.

Para obter mais informações, veja Configurar ambientes de teste no Serviço de Aplicações do Azure.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	1.102.0 ou superior
Categoria da tarefa	Implementação