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

Iniciar, parar, reiniciar, trocar slots, excluir slots, instalar extensões de site ou habilitar o monitoramento contínuo para um Serviço de Aplicativo do Azure.

Sintaxe

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

Insumos

azureSubscription - de assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório.

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 (Trocar Completo com Visualização), Cancel Swap (Cancelar Troca com Visualização), 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 com 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 - nome do Serviço de Aplicativo
string. Obrigatório.

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

SpecifySlotOrASE - Especificar o ambiente do Slot ou 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. Necessário quando Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap.

Entra 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. Necessá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 permuta direciona o tráfego do slot de destino para o slot de origem.

SwapWithProduction - Swap com Production
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 pela produção. Se você não selecionar essa opção, precisará fornecer os nomes dos slots de origem e destino.

TargetSlot - Slot de destino
string. Necessário quando SwapWithProduction = false.

Use como 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. Necessário quando Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Valor padrão: production.

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

As extensões de site são executadas no Serviço de Aplicativo do Microsoft Azure. Você pode instalar um conjunto de ferramentas como uma extensão de site e gerenciar melhor seu 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.

Este campo foi preterido e será removido. Use a variável LocalPathsForInstalledExtensions da seção Variáveis de saída nas tarefas subsequentes.

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

Entra 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 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. Introduz o nome do teste Web do Application Insights que pretende 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 controlo de tarefas

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

Variáveis de saída

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

LocalPathsForInstalledExtensions
Esta entrada são os caminhos de instalação local 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.

Observações

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), certifique-se de que o slot de produção seja sempre o slot de destino. Dessa forma, a operação de permuta não afeta seu aplicativo de produção.

Além disso, em qualquer ponto da operação de swap (ou swap com visualização), todo o trabalho de inicialização dos aplicativos trocados acontece no slot de origem. O slot de destino permanece on-line enquanto o slot de origem está sendo preparado e aquecido, independentemente de onde a troca seja bem-sucedida ou falhe.

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

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências 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 de tarefa	Desplegar