Använda Azure CLI för att skapa en App Service-resurs

  • Artikel

GÄLLER FÖR: SDK v4

Den här artikeln beskriver hur du skapar en App Service-resurs med Azure CLI och en Azure Resource Manager-mall (ARM-mall) som en del av processen för att etablera och publicera en robot. Apptjänsten kallas ibland för en webbapp.

Viktigt!

Python-robotar kan inte distribueras till en resursgrupp som innehåller Windows-tjänster eller -robotar. Flera Python-robotar kan distribueras till samma resursgrupp. Du måste dock skapa andra tjänster (till exempel Azure AI-tjänster) i en annan resursgrupp.

Kommentar

Bot Framework JavaScript-, C#- och Python-SDK:erna fortsätter att stödjas, men Java SDK dras tillbaka med slutligt långsiktigt stöd som slutar i november 2023.

Befintliga robotar som skapats med Java SDK fortsätter att fungera.

Om du vill skapa en ny robot bör du överväga att använda Power Virtual Agents och läsa om hur du väljer rätt chattrobotlösning.

Mer information finns i Framtiden för robotbygge.

Förutsättningar

Om du vill använda Azure CLI för att etablera och publicera robotar behöver du:

  • Ett Azure-konto som har en aktiv prenumeration. Skapa ett kostnadsfritt konto.

  • En installation av Azure CLI.

    För programmeringsspråket använder du följande version av Azure CLI. Vissa steg fungerar inte med senare versioner av CLI.

    Språk CLI-version
    C# och JavaScript 2.39.0 eller senare
    Python 2.55.0 eller senare
    Java 2.29.2

  • Den här processen använder en Azure Resource Manager-mall (ARM-mall) för att skapa en App Service-resurs för din robot.

    Om du inte har de aktuella mallarna skapar du en kopia i robotprojektet för mappen deploymentTemplates : C#, JavaScript, Python eller Java.

Dricks

Detta är en del av den större processen för att etablera och publicera en robot. Se hur du etablerar och publicerar en robot för en fullständig lista över krav.

Redigera parameterfil

Redigera parameterfilen för ARM-mallen så att den innehåller de värden som du vill använda.

Viktigt!

Du måste använda samma appType värde för dina App Service- och Azure Bot-resurser.

Om projektet ännu inte innehåller de senaste ARM-mall- och parameterfilerna kan du kopiera dem från Bot Framework SDK-lagringsplatsen för ditt språk: C#, JavaScript, Python eller Java.

Den här tabellen beskriver distributionsparametrarna i parameterfilen för användning med kommandoalternativet parameters . Som standard är namnet på parameterfilen parameters-for-template-BotApp-with-rg.json.

Parameter Typ Description
appServiceName String Obligatoriskt. Det globalt unika namnet på apptjänsten.
existingAppServicePlanName String Valfritt. Namnet på en befintlig App Service-plan som robotens apptjänst ska skapas med.
existingAppServicePlanLocation String Valfritt. Platsen för den befintliga App Service-planen.
newAppServicePlanName String Valfritt. Namnet på den nya App Service-planen.
newAppServicePlanLocation String Valfritt. Platsen för den nya App Service-planen.
newAppServicePlanSku Objekt Valfritt. SKU:n för den nya App Service-planen. Standard är tjänstplanen S1 (Standard).
appType String Obligatoriskt. Hur identiteterna för dina robotresurser hanteras. Tillåtna värden: "MultiTenant", "SingleTenant" och "UserAssignedMSI". Standardvärdet är "MultiTenant".
appId String Obligatoriskt. Klient-ID eller app-ID från den identitetsresurs som du skapade tidigare. Detta används som Microsoft-app-ID för apptjänsten.
appSecret String Valfritt. För apptyper med en klientorganisation och flera klientorganisationer är lösenordet för identitetsresursen.
UMSIName String Valfritt. För användartilldelade typer av hanterade identitetsappar, namnet på identitetsresursen.
UMSIResourceGroupName String Valfritt. För användartilldelade typer av hanterade identitetsappar är resursgruppen för identitetsresursen.
tenantId String Valfritt. För användartilldelade hanterade identiteter och apptyper med en enda klientorganisation, Microsoft Entra-ID:t för identitetsresursen.

Alla parametrar gäller inte för alla apptyper.

  • Ange värden för UMSIName, UMSIResourceGroupNameoch tenantId.
  • Lämna appSecret tomt.

Vissa parametrar är specifika för användning av en befintlig eller ny App Service-plan.

  • Ange värden för existingAppServicePlanName och existingAppServicePlanLocation.
  • Lämna newAppServicePlanName, newAppServicePlanLocationoch newAppServicePlanSku tom.

Skapa apptjänsten

Skapa apptjänsten för din robot.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Alternativ Description
resource-group Namnet på den Azure-resursgrupp som apptjänsten ska skapas i.
template-file Sökvägen till ARM-mallen för apptjänsten. Sökvägen kan vara relativ eller absolut.
parametrar Sökvägen till parameterfilen som ska användas med ARM-mallen. Sökvägen kan vara relativ eller absolut.

För projekt som skapats med de senaste generatorerna finns ARM-mallen och parameterfilerna i mappen DeploymentTemplates\DeployUseExistResourceGroup i projektet. Standardfilnamnen är template-BotApp-with-rg.json och parameters-for-template-BotApp-with-rg.json.

Dricks

  • Bas-URL:en för apptjänsten baseras på apptjänstens namn: https:<app-service-name>.azurewebsites.net.
  • Meddelandeslutpunkten för din robot är bas-URL:en plus /api/messages, till exempel https:<app-service-name>.azurewebsites.net/api/messages.

Ytterligare information

Mer information om ARM-mallar finns i Vad är ARM-mallar? och Hur använder du Distributionsmallar för Azure Resource Manager (ARM) med Azure CLI.

Nästa steg

Om du har skapat App Service som en del av en robotdistribution kan du läsa Skapa resurser med ARM-mallar för att fortsätta processen.