Sdílet prostřednictvím

Vytvoření prostředku služby App Service pomocí Azure CLI

  • Článek

PLATÍ PRO: SDK v4

Tento článek popisuje, jak vytvořit prostředek služby App Service pomocí Azure CLI a šablony Azure Resource Manageru (šablona ARM) v rámci procesu zřizování a publikování robota. App Service se někdy označuje jako webová aplikace.

Důležité

Roboti Pythonu se nedají nasadit do skupiny prostředků, která obsahuje služby nebo roboty Windows. Do stejné skupiny prostředků je možné nasadit několik robotů Pythonu. V jiné skupině prostředků ale musíte vytvořit další služby (například služby Azure AI).

Poznámka:

Sady SDK služby Bot Framework JavaScript, C# a Python budou nadále podporovány, ale sada Java SDK se vyřazuje s konečnou dlouhodobou podporou končící v listopadu 2023.

Stávající roboti sestavení pomocí sady Java SDK budou i nadále fungovat.

Při vytváření nových robotů zvažte použití aplikace Microsoft Copilot Studio a přečtěte si o výběru správného řešení copilotu.

Další informace najdete v tématu Budoucnost vytváření robotů.

Požadavky

Pokud chcete ke zřizování a publikování robotů používat Azure CLI, potřebujete:

  • Účet Azure, který má aktivní předplatné. Vytvořte si bezplatný účet.

  • Instalace Azure CLI.

    Pro váš programovací jazyk použijte následující verzi Azure CLI. Některé kroky nebudou fungovat s novějšími verzemi rozhraní příkazového řádku.

    Jazyk Verze rozhraní příkazového řádku
    C# a JavaScript 2.39.0 nebo novější
    Python 2.55.0 nebo novější
    Java 2.29.2

  • Tento proces používá šablonu Azure Resource Manageru (šablonu ARM) k vytvoření prostředku služby App Service pro robota.

    Pokud nemáte aktuální šablony, vytvořte ve svém projektu robota kopii složky deploymentTemplates : C#, JavaScript, Python nebo Java.

Tip

Jedná se o součást rozsáhlejšího procesu zřizování a publikování robota. Podívejte se, jak zřídit a publikovat robota , kde najdete úplný seznam požadavků.

Úprava souboru parametrů

Upravte soubor parametrů šablony ARM tak, aby obsahoval hodnoty, které chcete použít.

Důležité

Pro prostředky App Service a Azure Bot musíte použít stejnou appType hodnotu.

Pokud váš projekt ještě neobsahuje nejnovější soubory šablony a parametrů ARM, můžete je zkopírovat z úložiště sady BOT Framework SDK pro váš jazyk: C#, JavaScript, Python nebo Java.

Tato tabulka popisuje parametry nasazení v souboru parametrů pro použití s parameters možností příkazu. Ve výchozím nastavení je název souboru parametrů parameters-for-template-BotApp-with-rg.json.

Parametr Typ Description
appServiceName String Povinný: Globálně jedinečný název služby App Service.
existingAppServicePlanName String Nepovinné. Název existujícího plánu služby App Service, se kterým se vytvoří služba App Service pro robota.
existingAppServicePlanLocation String Nepovinné. Umístění existujícího plánu služby App Service.
newAppServicePlanName String Nepovinné. Název nového plánu služby App Service.
newAppServicePlanLocation String Nepovinné. Umístění nového plánu služby App Service
newAppServicePlanSku Objekt Nepovinné. Skladová položka nového plánu služby App Service. Výchozí hodnota je plán služby S1 (Standard).
appType String Povinný: Jak se spravují identity vašich prostředků robota. Povolené hodnoty: "MultiTenant", "SingleTenant" a "UserAssignedMSI". Výchozí hodnota je MultiTenant.
appId String Povinný: ID klienta nebo ID aplikace z prostředku identity, který jste vytvořili dříve. Používá se jako ID aplikace Microsoftu služby App Service.
appSecret String Nepovinné. Pro typy aplikací s jedním tenantem a více tenanty heslo prostředku identity.
UMSIName String Nepovinné. U typů aplikací spravovaných identit přiřazených uživatelem je název prostředku identity.
UMSIResourceGroupName String Nepovinné. U typů aplikací spravovaných identit přiřazených uživatelem je skupina prostředků prostředku identity.
tenantId String Nepovinné. Pro spravované identity přiřazené uživatelem a typy aplikací s jedním tenantem je ID tenanta Microsoft Entra ID prostředku identity.

Ne všechny parametry platí pro všechny typy aplikací.

  • Zadejte hodnoty pro UMSIName, UMSIResourceGroupNamea tenantId.
  • Nechte appSecret prázdné.

Některé parametry jsou specifické pro použití existujícího nebo nového plánu služby App Service.

  • Zadejte hodnoty pro existingAppServicePlanName a existingAppServicePlanLocation.
  • Nechte pole , newAppServicePlanLocationa newAppServicePlanSku nechejte newAppServicePlanNameprázdné.

Vytvoření služby App Service

Vytvořte pro robota službu App Service.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Možnost Popis
resource-group Název skupiny prostředků Azure, ve které se má služba App Service vytvořit.
template-file Cesta k šabloně ARM pro službu App Service. Cesta může být relativní nebo absolutní.
parametry Cesta k souboru parametrů, který se má použít se šablonou ARM. Cesta může být relativní nebo absolutní.

U projektů vytvořených s nejnovějšími generátory se šablona ARM a soubory parametrů nacházejí ve složce DeploymentTemplates\DeployUseExistResourceGroup v rámci projektu. Výchozí názvy souborů jsou template-BotApp-with-rg.json a parameters-for-template-BotApp-with-rg.json.

Tip

  • Základní adresa URL vaší služby App Service je založená na názvu služby App Service: https:<app-service-name>.azurewebsites.net.
  • Koncový bod zasílání zpráv pro vašeho robota bude základní adresou URL plus /api/messages, například https:<app-service-name>.azurewebsites.net/api/messages.

Další informace

Další informace o šablonách ARM najdete v tématu Co jsou šablony ARM? a jak používat šablony nasazení Azure Resource Manageru (ARM) s Azure CLI.

Další kroky

Pokud jste službu App Service vytvořili jako součást nasazení robota, přečtěte si téma Vytvoření prostředků pomocí šablon ARM a pokračujte v procesu.