Поделиться через

Краткое руководство: Создание приложения App Service с помощью шаблона ARM

Начало работы со службой приложений Azure путем развертывания приложения в облаке с помощью шаблона Azure Resource Manager (шаблона ARM) и Azure CLI в Cloud Shell. Шаблон Resource Manager — это файл нотации объектов JavaScript (JSON), который определяет инфраструктуру и конфигурацию проекта. Для выполнения этого краткого руководства вы не понесете никаких затрат, так как используете бесплатный уровень App Service.

Для работы с этим кратким руководством вам потребуется учетная запись Azure с действующей подпиской. Если у вас нет учетной записи Azure, ее можно создать бесплатно.

Перейти к концу

Если вы знакомы с использованием шаблонов ARM, вы можете перейти к концу, нажав эту кнопку, чтобы развернуть шаблон Resource Manager в Azure. Эта кнопка открывает шаблон ARM на портале Azure.

На портале Azure нажмите кнопку "Создать" , чтобы создать новую группу ресурсов, а затем нажмите кнопку "Проверить и создать ", чтобы развернуть приложение.

Начало работы со службой приложений Azure путем развертывания приложения в облаке с помощью шаблона Azure Resource Manager (шаблона ARM) и Azure CLI в Cloud Shell. Шаблон Resource Manager — это файл нотации объектов JavaScript (JSON), который определяет инфраструктуру и конфигурацию проекта. Вы не понесете никаких затрат на выполнение этого краткого руководства, так как используете бесплатный уровень App Service.

Для работы с этим кратким руководством вам потребуется учетная запись Azure с действующей подпиской. Если у вас нет учетной записи Azure, ее можно создать бесплатно.

Перейти к концу

Если вы знакомы с использованием шаблонов ARM, вы можете перейти к концу, нажав эту кнопку, чтобы развернуть шаблон Resource Manager в Azure. Эта кнопка открывает шаблон ARM на портале Azure.

На портале Azure нажмите кнопку "Создать" , чтобы создать новую группу ресурсов, а затем нажмите кнопку "Проверить и создать ", чтобы развернуть приложение.

Начало работы со службой приложений Azure путем развертывания приложения в облаке с помощью шаблона Azure Resource Manager (шаблона ARM) и Azure CLI в Cloud Shell. Шаблон Resource Manager — это файл нотации объектов JavaScript (JSON), который определяет инфраструктуру и конфигурацию проекта. План уровня "Премиум" необходим для развертывания приложения контейнера Windows. См. страницу цен службы приложений для получения сведений о ценах.

Перейти к концу

Если вы знакомы с использованием шаблонов ARM, вы можете перейти к концу инструкции, нажав эту кнопку, чтобы развернуть шаблон Resource Manager в Azure. Эта кнопка открывает шаблон ARM на портале Azure.

На портале Azure нажмите кнопку "Создать" , чтобы создать новую группу ресурсов, а затем нажмите кнопку "Проверить и создать ", чтобы развернуть приложение.

Проверьте шаблон

Шаблон, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска Azure. Он развертывает план и приложение Azure App Service на Windows. Он совместим с .NET Core, .NET Framework, PHP, Node.jsи статическими HTML-приложениями. Сведения о Java см. в статье "Создание приложения Java".

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.25.53.49325",
      "templateHash": "16144177164140676603"
    }
  },
  "parameters": {
    "webAppName": {
      "type": "string",
      "defaultValue": "[format('webApp-{0}', uniqueString(resourceGroup().id))]",
      "minLength": 2,
      "metadata": {
        "description": "Web app name."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "F1",
      "metadata": {
        "description": "The SKU of App Service Plan."
      }
    },
    "language": {
      "type": "string",
      "defaultValue": ".net",
      "allowedValues": [
        ".net",
        "html"
      ],
      "metadata": {
        "description": "The language stack of the app."
      }
    },
    "helloWorld": {
      "type": "bool",
      "defaultValue": false,
      "metadata": {
        "description": "true = deploy a sample Hello World app."
      }
    },
    "repoUrl": {
      "type": "string",
      "defaultValue": "",
      "metadata": {
        "description": "Optional Git Repo URL"
      }
    }
  },
  "variables": {
    "appServicePlanPortalName": "[format('AppServicePlan-{0}', parameters('webAppName'))]",
    "gitRepoReference": {
      ".net": "https://github.com/Azure-Samples/app-service-web-dotnet-get-started",
      "html": "https://github.com/Azure-Samples/html-docs-hello-world"
    },
    "gitRepoUrl": "[if(bool(parameters('helloWorld')), variables('gitRepoReference')[toLower(parameters('language'))], parameters('repoUrl'))]",
    "configReference": {
      ".net": {
        "comments": ".Net app. No additional configuration needed."
      },
      "html": {
        "comments": "HTML app. No additional configuration needed."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2023-01-01",
      "name": "[variables('appServicePlanPortalName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('sku')]"
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2023-01-01",
      "name": "[parameters('webAppName')]",
      "location": "[parameters('location')]",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "siteConfig": "[variables('configReference')[parameters('language')]]",
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanPortalName'))]",
        "httpsOnly": true
      },
      "dependsOn": [
        "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanPortalName'))]"
      ]
    },
    {
      "condition": "[contains(variables('gitRepoUrl'), 'http')]",
      "type": "Microsoft.Web/sites/sourcecontrols",
      "apiVersion": "2023-01-01",
      "name": "[format('{0}/{1}', parameters('webAppName'), 'web')]",
      "properties": {
        "repoUrl": "[variables('gitRepoUrl')]",
        "branch": "master",
        "isManualIntegration": true
      },
      "dependsOn": [
        "[resourceId('Microsoft.Web/sites', parameters('webAppName'))]"
      ]
    }
  ]
}

В шаблоне определено два ресурса Azure:

Этот шаблон содержит несколько параметров, которые предопределяются для удобства. См. таблицу по умолчанию параметров и их описания:

Параметры Тип Значение по умолчанию Описание
webAppName струна webApp-<uniqueString> Имя приложения на основе уникального строкового значения
appServicePlanName струна webAppPlan-<uniqueString> Имя плана службы приложений на основе уникального строкового значения
расположение струна [resourceGroup().location] Регион приложения
SKU (Единица учета запасов) струна F1 Размер экземпляра (F1 = бесплатный уровень)
язык струна .NET Стек языка программирования (.NET, php, node, html)
helloWorld булевый False True = развертывание приложения Hello World
repoUrl струна Внешний репозиторий Git (необязательно)

Шаблон, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска Azure. Он развертывает план App Service и приложение App Service на Linux. Он совместим со всеми поддерживаемыми языками программирования в службе приложений.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "10602523904429381366"
    }
  },
  "parameters": {
    "webAppName": {
      "type": "string",
      "defaultValue": "[format('webApp-{0}', uniqueString(resourceGroup().id))]",
      "minLength": 2,
      "metadata": {
        "description": "Web app name."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "F1",
      "metadata": {
        "description": "The SKU of App Service Plan."
      }
    },
    "linuxFxVersion": {
      "type": "string",
      "defaultValue": "DOTNETCORE|8.0",
      "metadata": {
        "description": "The Runtime stack of current web app"
      }
    },
    "repoUrl": {
      "type": "string",
      "defaultValue": " ",
      "metadata": {
        "description": "Optional Git Repo URL"
      }
    }
  },
  "variables": {
    "appServicePlanPortalName": "[format('AppServicePlan-{0}', parameters('webAppName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2021-02-01",
      "name": "[variables('appServicePlanPortalName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('sku')]"
      },
      "kind": "linux",
      "properties": {
        "reserved": true
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2021-02-01",
      "name": "[parameters('webAppName')]",
      "location": "[parameters('location')]",
      "properties": {
        "httpsOnly": true,
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanPortalName'))]",
        "siteConfig": {
          "linuxFxVersion": "[parameters('linuxFxVersion')]",
          "minTlsVersion": "1.2",
          "ftpsState": "FtpsOnly"
        }
      },
      "identity": {
        "type": "SystemAssigned"
      },
      "dependsOn": [
        "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanPortalName'))]"
      ]
    },
    {
      "condition": "[contains(parameters('repoUrl'), 'http')]",
      "type": "Microsoft.Web/sites/sourcecontrols",
      "apiVersion": "2021-02-01",
      "name": "[format('{0}/{1}', parameters('webAppName'), 'web')]",
      "properties": {
        "repoUrl": "[parameters('repoUrl')]",
        "branch": "master",
        "isManualIntegration": true
      },
      "dependsOn": [
        "[resourceId('Microsoft.Web/sites', parameters('webAppName'))]"
      ]
    }
  ]
}

В шаблоне определено два ресурса Azure:

Этот шаблон содержит несколько параметров, которые предопределяются для удобства. См. таблицу по умолчанию параметров и их описания:

Параметры Тип Значение по умолчанию Описание
название веб-приложения струна webApp-<uniqueString> Имя приложения на основе уникального строкового значения
appServicePlanName струна webAppPlan-<uniqueString> Имя плана службы приложений на основе уникального строкового значения
расположение струна [resourceGroup().location] Регион приложения
SKU (Единица учета запасов) струна F1 Размер экземпляра (F1 = бесплатный уровень)
linuxFxVersion струна DOTNETCORE|9.0 "Стек языка программирования | Версия"
repoUrl струна Внешний репозиторий Git (необязательно)

Шаблон, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска Azure. Он развертывает план службы приложений и приложение службы приложений в контейнере Windows.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.25.53.49325",
      "templateHash": "10193476814580854111"
    }
  },
  "parameters": {
    "appServiceWebAppName": {
      "type": "string",
      "defaultValue": "[format('webApp-{0}', uniqueString(resourceGroup().id))]",
      "minLength": 2,
      "metadata": {
        "description": "Web App name."
      }
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "[format('webApp-{0}', uniqueString(resourceGroup().id))]",
      "minLength": 2,
      "metadata": {
        "description": "App Service Plan name."
      }
    },
    "skuTier": {
      "type": "string",
      "defaultValue": "P1v3"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2023-01-01",
      "name": "[parameters('appServiceWebAppName')]",
      "location": "[parameters('location')]",
      "tags": {
        "[format('hidden-related:{0}', resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName')))]": "empty"
      },
      "properties": {
        "siteConfig": {
          "appSettings": [
            {
              "name": "PORT",
              "value": "8080"
            }
          ],
          "appCommandLine": "",
          "windowsFxVersion": "DOCKER|mcr.microsoft.com/dotnet/samples:aspnetapp"
        },
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]"
      },
      "dependsOn": [
        "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]"
      ]
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2023-01-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('skuTier')]"
      },
      "kind": "windows",
      "properties": {
        "hyperV": true
      }
    }
  ]
}

В шаблоне определено два ресурса Azure:

Этот шаблон содержит несколько параметров, которые предопределяются для удобства. См. таблицу по умолчанию параметров и их описания:

Параметры Тип Значение по умолчанию Описание
webAppName струна webApp-<uniqueString> Имя приложения на основе уникального строкового значения
appServicePlanName струна webAppPlan-<uniqueString> Имя плана службы приложений на основе уникального строкового значения
расположение струна [resourceGroup().location] Регион приложения
skuTier струна P1v3 Размер экземпляра (просмотр доступных номеров SKU)
appНастройки струна [{"name": "PORT","value": "8080"}] Порт прослушивания службы приложений. Должно быть 8080.
добрый струна windows Операционная система
Hyper-V струна true Режим изоляции
Версия windowsFx струна DOCKER|mcr.microsoft.com/dotnet/samples:aspnetapp Образ контейнера

Развертывание шаблона

Azure CLI используется здесь для развертывания шаблона. Вы также можете использовать портал Azure, Azure PowerShell и REST API. Дополнительные сведения о других методах развертывания см. в статье о развертывании с использованием шаблонов.

При помощи этого кода создается группа ресурсов, план службы приложений и веб-приложение. Для вас задана группа ресурсов по умолчанию, план службы приложений и расположение. Замените <app-name> глобально уникальным именем приложения (допустимыми символами являются a-z, 0-9и -).

Выполните следующие команды, чтобы развернуть приложение платформы .NET в Windows.

az group create --name myResourceGroup --location "southcentralus"

az deployment group create --resource-group myResourceGroup \
--parameters language=".NET" helloWorld="true" webAppName="<app-name>" \
--template-uri "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.web/app-service-docs-windows/azuredeploy.json"

Выполните следующие команды, чтобы создать приложение Python в Linux:

az group create --name myResourceGroup --location "southcentralus"

az deployment group create --resource-group myResourceGroup --parameters webAppName="<app-name>" linuxFxVersion="PYTHON|3.9" \
--template-uri "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.web/app-service-docs-linux/azuredeploy.json"

Чтобы развернуть другой стек языка, обновите соответствующие значения linuxFxVersion. Примеры показаны в таблице. Чтобы отобразить текущие версии, выполните следующую команду в Cloud Shell:

az webapp config show --resource-group myResourceGroup --name <app-name> --query linuxFxVersion
Язык Пример
.СЕТЬ linuxFxVersion="DOTNETCORE|9.0"
Java linuxFxVersion="JAVA|21-java21 TOMCAT|11.0-java21 JBOSSEAP|8-java17"
Node.js linuxFxVersion="NODE|22-lts
Питон linuxFxVersion="PYTHON|3.13"
PHP linuxFxVersion="PHP|8.4"

Выполните следующие команды, чтобы развернуть приложение .NET в контейнере Windows.

az group create --name myResourceGroup --location "southcentralus"

az deployment group create --resource-group myResourceGroup \
--parameters webAppName="<app-name>" \
--template-uri "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.web/app-service-docs-windows-container/azuredeploy.json"

Замечание

Дополнительные примеры шаблонов службы приложений Azure см. здесь.

Проверка развертывания

Перейдите к файлу http://<app_name>.azurewebsites.net/ и убедитесь, что оно создано.

Снимок экрана: интерфейс кода Windows.

Снимок экрана: интерфейс Linux.

Снимок экрана: интерфейс контейнера Windows.

Очистите ресурсы

При отсутствии необходимости удалите группу ресурсов.

Дальнейшие шаги

  Развертывание из локального Git

  ASP.NET Core с базой данных SQL

  Python с Postgres

  Использование PHP и MySQL

  Подключение к базе данных SQL Azure с помощью Java

  Обеспечьте безопасность с помощью пользовательского домена и сертификата