AzureAppServiceSettings@1 – tarefa Configurações de Serviço de Aplicativo do Azure v1

  • Artigo

Atualizações ou adiciona configurações do serviço de aplicativo em um Aplicativo Web do Azure para Linux ou Windows.

Sintaxe

# Azure App Service Settings v1
# Update/Add App settings an Azure Web App for Linux or Windows.
- task: AzureAppServiceSettings@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appName: # string. Required. App Service name. 
    resourceGroupName: # string. Required. Resource group. 
    #slotName: 'production' # string. Slot. Default: production.
  # Application and Configuration Settings
    #appSettings: # string. App settings. 
    #generalSettings: # string. General settings. 
    #connectionStrings: # string. Connection Strings.

Entradas

azureSubscription - Assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatórios.

Seleciona a assinatura do Azure Resource Manager.


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

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


resourceGroupName - Grupo de recursos
string. Obrigatórios.

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


slotName - Slot
string. Valor padrão: production.

Insere ou seleciona um slot existente. Se você não selecionar um slot, serão feitas alterações na produção.


appSettings - Configurações do aplicativo
string.

Configurações de aplicativo na sintaxe JSON. Coloque os valores que contêm espaços entre aspas duplas. Para saber mais, confira Definir configurações de aplicativo.

Veja a seguir um exemplo da sintaxe JSON:

[
   {
    "name": "key1",
    "value": "valueabcd",
    "slotSetting": false
   },
   {
    "name": "key2",
    "value": "valueefgh",
    "slotSetting": true
   }
]

generalSettings - Configurações gerais
string.

Configurações gerais na sintaxe JSON. Coloque os valores que contêm espaços entre aspas duplas. Para obter uma lista das propriedades disponíveis, consulte a documentação do objeto Serviço de Aplicativo SiteConfig. Para obter mais informações, consulte Definir configurações gerais.

Veja a seguir um exemplo da sintaxe JSON:

[
   {
    "alwaysOn": true,
    "webSocketsEnabled": false
   }
]

connectionStrings - Cadeias de conexão
string.

Cadeias de conexão na sintaxe JSON. Coloque os valores que contêm espaços entre aspas duplas. Para obter mais informações, confira Configurar cadeias de conexão.

Veja a seguir um exemplo da sintaxe JSON:

[
   {
    "name": "key1",
    "value": "valueabcd",
    "type": "MySql",
    "slotSetting": false
   },
   {
    "name": "key2",
    "value": "valueefgh",
    "type": "Custom",
    "slotSetting": true
   }
]

Opções de controle de 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

Nenhum.

Comentários

Use essa tarefa para definir configurações de aplicativo, cadeias de conexão e outras configurações gerais em massa usando a sintaxe JSON em seu aplicativo Web ou qualquer um de seus slots de implantação. A tarefa funciona em agentes do Azure Pipelines multiplataforma que executam Windows, Linux ou Mac. A tarefa funciona para aplicativos Web baseados em ASP.NET, ASP.NET Core, PHP, Java, Python, Go e Node.js.

Exemplos

O snippet YAML de exemplo a seguir implanta um aplicativo Web em um serviço de Aplicativo Web do Azure em execução no Windows.


variables:
  azureSubscription: Contoso
  WebApp_Name: sampleWebApp
  # To ignore SSL error uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:

- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(WebApp_Name)
    package: $(System.DefaultWorkingDirectory)/**/*.zip

- task: AzureAppServiceSettings@1
  displayName: Azure App Service Settings
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(WebApp_Name)
   # To deploy the settings on a slot, provide slot name as below. By default, the settings would be applied to the actual Web App (Production slot)
   # slotName: staging
    appSettings: |
      [
        {
          "name": "APPINSIGHTS_INSTRUMENTATIONKEY",
          "value": "$(Key)",
          "slotSetting": false
        },
        {
          "name": "MYSQL_DATABASE_NAME",
          "value": "$(DB_Name)", 
          "slotSetting": false
        }
      ]
    generalSettings: |
      [
        {
          "alwaysOn": true,
          "webSocketsEnabled": false
        }
      ]
    connectionStrings: |
      [
        {
          "name": "MysqlCredentials",
          "value": "$(MySQl_ConnectionString)",
          "type": "MySql",
          "slotSetting": false
        }
      ]

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 2.104.1 ou superior
Categoria da tarefa Implantar