AzureAppServiceSettings@1 - tarefa definições do Serviço de Aplicações do Azure v1

  • Artigo

Atualizações ou adiciona definições do serviço de aplicações numa Aplicação Web do Azure para Linux ou Windows.

Syntax

# 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 - Subscrição do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório.

Seleciona a subscrição do Azure Resource Manager.


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

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


resourceGroupName - Grupo de recursos
string. Obrigatório.

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


slotName - Ranhura
string. Valor predefinido: production.

Introduz ou seleciona um bloco existente. Se não selecionar um bloco, serão efetuadas alterações à produção.


appSettings - Definições da aplicação
string.

Definições da aplicação na sintaxe JSON. Coloque os valores entre espaços entre aspas duplas. Para obter mais informações, veja Configurar as definições da aplicação.

Segue-se um exemplo da sintaxe JSON:

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

generalSettings - Definições gerais
string.

Definições gerais na sintaxe JSON. Coloque os valores entre espaços entre aspas duplas. Para obter uma lista das propriedades disponíveis, veja a documentação do objeto Serviço de Aplicações SiteConfig. Para obter mais informações, veja Configurar definições gerais.

Segue-se um exemplo da sintaxe JSON:

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

connectionStrings - Cadeias de Ligação
string.

Cadeias de ligação na sintaxe JSON. Coloque os valores entre espaços entre aspas duplas. Para obter mais informações, veja Configurar cadeias de ligação.

Segue-se um exemplo da sintaxe JSON:

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

Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para configurar definições da aplicação, cadeias de ligação e outras definições gerais em massa com a sintaxe JSON na sua aplicação Web ou em qualquer um dos respetivos blocos de implementação. A tarefa funciona em agentes do Azure Pipelines em várias plataformas com Windows, Linux ou Mac. A tarefa funciona para aplicações Web baseadas em ASP.NET, ASP.NET Core, PHP, Java, Python, Go e Node.js.

Exemplos

O fragmento YAML de exemplo seguinte implementa uma aplicação Web num serviço de Aplicação 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 Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, 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 definição Qualquer
Versão do agente 2.104.1 ou superior
Categoria da tarefa Implementação