在適用於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 訂用帳戶
輸入別名: ConnectedServiceName。
string。 必須的。
選取 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 或更高版本 |
| 工作類別 | 部署 |