AzureAppServiceSettings@1 — zadanie ustawienia Azure App Service w wersji 1

Aktualizacje lub dodaje ustawienia usługi App Service w aplikacji internetowej platformy Azure dla systemu Linux lub Windows.

Składnia

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

Dane wejściowe

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane.

Wybiera subskrypcję usługi Azure Resource Manager.

appName - nazwa App Service
string. Wymagane.

Wprowadza lub wybiera nazwę istniejącej Azure App Service.

resourceGroupName - Grupa zasobów
string. Wymagane.

Wprowadza lub wybiera grupę zasobów platformy Azure zawierającą Azure App Service określone powyżej.

slotName - Gniazdo
string. Wartość domyślna: production.

Wprowadza lub wybiera istniejące miejsce. Jeśli nie wybierzesz miejsca, zmiany zostaną wprowadzone w środowisku produkcyjnym.

appSettings - Ustawienia aplikacji
string.

Ustawienia aplikacji w składni JSON. Otaczaj wartości zawierające spacje w cudzysłowach podwójnych. Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień aplikacji.

Poniżej przedstawiono przykład składni JSON:

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

generalSettings - Ustawienia ogólne
string.

Ustawienia ogólne w składni JSON. Otaczaj wartości zawierające spacje w cudzysłowach podwójnych. Listę dostępnych właściwości można znaleźć w dokumentacji obiektu App Service SiteConfig. Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień ogólnych.

Poniżej przedstawiono przykład składni JSON:

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

connectionStrings - Parametry połączenia
string.

Parametry połączenia w składni JSON. Otaczaj wartości zawierające spacje w cudzysłowach podwójnych. Aby uzyskać więcej informacji, zobacz Konfigurowanie parametrów połączenia.

Poniżej przedstawiono przykład składni JSON:

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

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do konfigurowania ustawień aplikacji, parametrów połączenia i innych ogólnych ustawień zbiorczo przy użyciu składni JSON w aplikacji internetowej lub w dowolnym miejscu wdrożenia. Zadanie działa na międzyplatformowych agentach usługi Azure Pipelines z systemem Windows, Linux lub Mac. Zadanie działa w przypadku aplikacji internetowych opartych na ASP.NET, ASP.NET Core, PHP, Java, Python, Go i Node.js.

Przykłady

Poniższy przykładowy fragment kodu YAML wdraża aplikację internetową w usłudze Azure Web App Service uruchomionej w systemie 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
        }
      ]

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	2.104.1 lub nowsza
Kategoria zadania	Wdrażanie