Azure CLI gebruiken om een App Service-resource te maken

  • Artikel

VAN TOEPASSING OP: SDK v4

In dit artikel wordt beschreven hoe u een App Service-resource maakt met de Azure CLI en een Azure Resource Manager-sjabloon (ARM-sjabloon) als onderdeel van het proces voor het inrichten en publiceren van een bot. De app-service wordt ook wel een web-app genoemd.

Belangrijk

Python-bots kunnen niet worden geïmplementeerd in een resourcegroep die Windows-services of -bots bevat. Meerdere Python-bots kunnen worden geïmplementeerd in dezelfde resourcegroep; U moet echter andere services (zoals Azure AI-services) maken in een andere resourcegroep.

Notitie

De Sdk's voor Bot Framework JavaScript, C# en Python blijven ondersteund, maar de Java SDK wordt buiten gebruik gesteld met definitieve langetermijnondersteuning die eindigt op november 2023.

Bestaande bots die zijn gebouwd met de Java SDK blijven functioneren.

Voor het bouwen van nieuwe bots kunt u Power Virtual Agents gebruiken en lezen over het kiezen van de juiste chatbotoplossing.

Zie De toekomst van botbouw voor meer informatie.

Vereisten

Als u de Azure CLI wilt gebruiken om bots in te richten en te publiceren, hebt u het volgende nodig:

  • Een Azure-account met een actief abonnement. Maak een gratis account.

  • Een installatie van de Azure CLI.

    Gebruik voor uw programmeertaal de volgende versie van de Azure CLI. Sommige stappen werken niet met latere versies van de CLI.

    Taal CLI-versie
    C# en JavaScript 2.39.0 of hoger
    Python 2.55.0 of hoger
    Java 2.29.2

  • In dit proces wordt een ARM-sjabloon (Azure Resource Manager) gebruikt om een App Service-resource voor uw bot te maken.

    Als u de huidige sjablonen niet hebt, maakt u een kopie in uw botproject van de map deploymentTemplates : C#, JavaScript, Python of Java.

Tip

Dit maakt deel uit van het grotere proces voor het inrichten en publiceren van een bot. Zie hoe u een bot inricht en publiceert voor een volledige lijst met vereisten.

Parametersbestand bewerken

Bewerk het parameterbestand voor de ARM-sjabloon om de waarden te bevatten die u wilt gebruiken.

Belangrijk

U moet dezelfde appType waarde gebruiken voor uw App Service- en Azure Bot-resources.

Als uw project nog niet de meest recente ARM-sjabloon- en parameterbestanden bevat, kunt u deze kopiëren vanuit de Bot Framework SDK-opslagplaats voor uw taal: C#, JavaScript, Python of Java.

In deze tabel worden de implementatieparameters in het parameterbestand beschreven voor gebruik met de parameters opdrachtoptie. De naam van het parameterbestand is standaard parameters-for-template-BotApp-with-rg.json.

Parameter Type Omschrijving
appServiceName String Vereist. De wereldwijd unieke naam van de app-service.
existingAppServicePlanName String Optioneel. De naam van een bestaand App Service-plan waarmee de App Service voor de bot moet worden gemaakt.
existingAppServicePlanLocation String Optioneel. De locatie van het bestaande App Service-plan.
newAppServicePlanName String Optioneel. De naam van het nieuwe App Service-plan.
newAppServicePlanLocation String Optioneel. De locatie van het nieuwe App Service-plan.
newAppServicePlanSku Object Optioneel. De SKU voor het nieuwe App Service-plan. Standaard is het S1-serviceplan (Standard).
appType String Vereist. Hoe de identiteiten van uw bot-resources worden beheerd. Toegestane waarden: 'MultiTenant', 'SingleTenant' en 'UserAssignedMSI'. De standaardwaarde is 'MultiTenant'.
appId String Vereist. De client-id of app-id van de identiteitsresource die u eerder hebt gemaakt. Dit wordt gebruikt als de Microsoft-app-id van de app-service.
appSecret String Optioneel. Voor app-typen met één tenant en meerdere tenants geldt het wachtwoord voor de identiteitsresource.
UMSIName String Optioneel. Voor door de gebruiker toegewezen typen beheerde identiteit-apps, de naam van de identiteitsresource.
UMSIResourceGroupName String Optioneel. Voor door de gebruiker toegewezen beheerde identiteit-app-typen, de resourcegroep voor de identiteitsresource.
tenantId String Optioneel. Voor door de gebruiker toegewezen beheerde identiteit en app-typen met één tenant, de tenant-id van Microsoft Entra ID voor de identiteitsresource.

Niet alle parameters zijn van toepassing op alle app-typen.

  • Geef waarden op voor UMSIName, UMSIResourceGroupNameen tenantId.
  • Laat leeg appSecret .

Sommige parameters zijn specifiek voor het gebruik van een bestaand of nieuw App Service-plan.

  • Geef waarden op voor existingAppServicePlanName en existingAppServicePlanLocation.
  • Laat newAppServicePlanName, newAppServicePlanLocationen newAppServicePlanSku leeg.

De app-service maken

Maak de app-service voor uw bot.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Optie Omschrijving
resource-group Naam van de Azure-resourcegroep waarin de app-service moet worden gemaakt.
template-file Het pad naar de ARM-sjabloon voor de app-service. Het pad kan relatief of absoluut zijn.
parameters Het pad naar het parameterbestand dat moet worden gebruikt met de ARM-sjabloon. Het pad kan relatief of absoluut zijn.

Voor projecten die zijn gemaakt met de nieuwste generatoren, bevinden de ARM-sjabloon- en parameterbestanden zich in de map DeploymentTemplates\DeployUseExistResourceGroup binnen het project. De standaardbestandsnamen zijn template-BotApp-with-rg.json en parameters-for-template-BotApp-with-rg.json.

Tip

  • De basis-URL voor uw app-service is gebaseerd op de naam van de app-service: https:<app-service-name>.azurewebsites.net.
  • Het berichteindpunt voor uw bot is de basis-URL plus /api/messages, zoals https:<app-service-name>.azurewebsites.net/api/messages.

Aanvullende informatie

Zie Wat zijn ARM-sjablonen? en Azure Resource Manager-implementatiesjablonen (ARM) gebruiken met Azure CLI voor meer informatie over ARM-sjablonen.

Volgende stappen

Als u de App Service hebt gemaakt als onderdeel van een botimplementatie, raadpleegt u Resources maken met ARM-sjablonen om door te gaan met het proces.