共用方式為


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 Resource Manager 訂用帳戶。


appName - App Service 名稱
string。 必須的。

輸入或選取現有 Azure App Service 的名稱。


resourceGroupName - 資源群組
string。 必須的。

輸入或選取包含上面指定之 Azure App Service 的 Azure 資源群組。


slotName - 位置
string。 預設值: production

輸入或選擇現有槽口。 如果未選擇槽,則會對 production 進行更改。


appSettings - 應用程式設定
string

JSON 語法中的應用程式設置。 將包含空格的值括在雙引號中。 如需詳細資訊,請參閱設定應用程式設定

以下是 JSON 語法的範例:

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

generalSettings - 常規設置
string

JSON 語法中的常規設置。 將包含空格的值括在雙引號中。 有關可用屬性的清單,請參閱 應用服務 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)
    appType: 'webApp'
    appName: $(WebApp_Name)
    package: $(System.DefaultWorkingDirectory)/**/*.zip

- task: AzureAppServiceSettings@1
  displayName: Azure App Service Settings
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(WebApp_Name)
    resourceGroupName: 'contoso-rg'
   # 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
要求 沒有
能力 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 2.104.1 或更高版本
工作類別 部署