AzureAppServiceManage@0 – Serviço de Aplicativo do Azure gerenciar tarefa v0

Iniciar, parar, reiniciar, troca de slot, exclusão de slot, instalar extensões de site ou habilitar o monitoramento contínuo para um Serviço de Aplicativo 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 - Assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatórios.

Seleciona a assinatura do Azure Resource Manager.

Action - Ação
string. Valores permitidos: Swap Slots, Start Azure App Service (Iniciar Serviço de Aplicativo), Stop Azure App Service (Parar Serviço de Aplicativo), Restart Azure App Service (Reiniciar Serviço de Aplicativo), Start Swap With Preview, ( Complete Swap Troca Completa com Visualização), Cancel Swap (Cancelar Troca com Versão Prévia), Delete Slot, Install Extensions, Enable Continuous Monitoring, , Start all continuous webjobs, Stop all continuous webjobs. Valor padrão: Swap Slots.

Opcional. Define a ação a ser executada no Serviço de Aplicativo. Você pode iniciar, parar, reiniciar, trocar de slot, iniciar a troca por uma visualização, concluir a troca com uma visualização, cancelar a troca com uma visualização, instalar extensões de site ou habilitar o monitoramento contínuo para um Serviço de Aplicativo do Azure.

WebAppName - Serviço de Aplicativo nome
string. Obrigatórios.

Insere ou seleciona o nome de um Serviço de Aplicativo do Azure existente.

SpecifySlotOrASE - Especificar slot ou Ambiente do Serviço de Aplicativo
Alias de entrada: SpecifySlot. boolean. Opcional. Use quando Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Valor padrão: false.

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

Insere ou seleciona o Grupo de Recursos do Azure que contém o Serviço de Aplicativo do Azure especificado acima.

SourceSlot - Slot de origem
string. Obrigatório quando Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap.

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

SwapWithProduction - Alternar com Produção
boolean. Opcional. Use quando Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Valor padrão: true.

Troca o tráfego do slot de origem por produção. Se você não selecionar essa opção, precisará fornecer os nomes de slot de origem e de destino.

TargetSlot - Slot de destino
string. Obrigatório quando SwapWithProduction = false.

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

PreserveVnet - Preservar Vnet
boolean. Opcional. Use quando Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Valor padrão: false.

Preserva as configurações de rede virtual.

Slot - Slot
string. Obrigatório quando Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Valor padrão: production.

ExtensionsList - Instalar extensões
string. Obrigatório quando Action = Install Extensions.

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

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

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

Esse campo agora foi preterido e será removido. Use a LocalPathsForInstalledExtensions variável da seção Variáveis de Saída em tarefas subsequentes.

AppInsightsResourceGroupName - Nome do Grupo de Recursos para Application Insights
string. Obrigatório quando Action == Enable Continuous Monitoring.

Insere ou seleciona o grupo de recursos em que o recurso do Application Insights está disponível.

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

Seleciona o recurso application insights em que os dados de monitoramento contínuo são registrados.

Se o recurso do Application Insights não estiver listado aqui e você 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 da Web do Application Insights
string. Opcional. Use quando Action == Enable Continuous Monitoring.

Opcional. Insere o nome de teste da Web do Application Insights que você deseja criar ou atualizar.

Se você não fornecer um nome de teste da Web, o nome de teste padrão será usado.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Essa tarefa define as variáveis de saída a seguir, que você pode consumir em etapas downstream, trabalhos e estágios.

LocalPathsForInstalledExtensions
Essa entrada são os caminhos de instalação locais para as extensões selecionadas.

Se você selecionar várias extensões, a saída será uma lista separada por vírgulas de caminhos locais para cada uma das extensões selecionadas. A saída lista os caminhos na ordem em que aparecem no campo Instalar Extensões.

Comentários

Use esta tarefa para iniciar, parar, reiniciar, trocar slot, Trocar com Visualização, instalar extensões de site ou habilitar o monitoramento contínuo para um Serviço de Aplicativo do Azure.

O que acontece durante uma troca

Ao trocar dois slots (geralmente de um slot de preparo para o slot de produção), verifique se o slot de produção é sempre o slot de destino. Dessa forma, a operação de troca não afeta seu aplicativo de produção.

Em algum ponto da operação de troca, todo o trabalho de reinicialização dos aplicativos trocados acontece no slot de origem. O slot de destino permanece online enquanto o slot de origem está sendo preparado e ativado, independentemente de onde a troca seja bem sucedida ou falhe.

Para obter mais informações, consulte Configurar ambientes de preparo no Serviço de Aplicativo do Azure.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	1.102.0 ou superior
Categoria da tarefa	Implantar