AzureAppServiceSettings@1 - Azure 应用服务设置 v1 任务

在适用于 Linux 或 Windows 的 Azure Web 应用中汇报或添加应用服务设置。

语法

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

输入

azureSubscription - Azure 订阅
输入别名: ConnectedServiceNamestring. 必需。

选择 Azure 资源管理器 订阅。


appName - App 服务名称
string. 必需。

输入或选择现有Azure 应用服务的名称。


resourceGroupName - 资源组
string. 必需。

输入或选择包含上面指定的Azure 应用服务的 Azure 资源组。


slotName -
string. 默认值:production

输入或选择现有槽。 如果未选择槽,则会对生产环境进行更改。


appSettings - 应用设置
string.

JSON 语法中的应用程序设置。 将包含空格的值括在双引号中。 有关详细信息,请参阅配置应用设置

下面是 JSON 语法的示例:

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

generalSettings - 常规设置
string.

JSON 语法中的常规设置。 将包含空格的值括在双引号中。 有关可用属性的列表,请参阅 App 服务 SiteConfig 对象文档。 有关详细信息,请参阅 配置常规设置

下面是 JSON 语法的示例:

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

connectionStrings - 连接字符串
string.

JSON 语法中的连接字符串。 将包含空格的值括在双引号中。 有关详细信息,请参阅配置连接字符串

下面是 JSON 语法的示例:

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

任务控件选项

除任务输入外,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

备注

使用此任务在 Web 应用或其任何部署槽位上使用 JSON 语法批量配置应用设置、连接字符串和其他常规设置。 该任务适用于运行 Windows、Linux 或 Mac 的跨平台 Azure Pipelines 代理。 该任务适用于基于 ASP.NET、ASP.NET Core、PHP、Java、Python、Go 和基于 Node.js 的 Web 应用程序。

示例

以下示例 YAML 代码片段将 Web 应用程序部署到在 Windows 上运行的 Azure Web 应用服务。


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
        }
      ]

要求

要求 说明
管道类型 YAML,经典内部版本,经典发布
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 2.104.1 或更高版本
任务类别 部署