Megosztás a következőn keresztül:

App Service-erőforrás létrehozása az Azure CLI használatával

  • Cikk

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Ez a cikk azt ismerteti, hogyan hozhat létre App Service-erőforrást az Azure CLI-vel és egy Azure Resource Manager-sablonnal (ARM-sablonnal) a robot kiépítésének és közzétételének folyamata részeként. Az App Service-t néha webalkalmazásnak is nevezik.

Fontos

A Python-robotok nem helyezhetők üzembe windowsos szolgáltatásokat vagy robotokat tartalmazó erőforráscsoportban. Több Python-robot is üzembe helyezhető ugyanahhoz az erőforráscsoporthoz; azonban más szolgáltatásokat (például Azure AI-szolgáltatásokat) kell létrehoznia egy másik erőforráscsoportban.

Feljegyzés

A Bot Framework JavaScript, C# és Python SDK-k továbbra is támogatottak lesznek, a Java SDK-t azonban 2023 novemberében végső hosszú távú támogatással kivonják.

A Java SDK-val létrehozott meglévő robotok továbbra is működni fognak.

Az új robotépítéshez fontolja meg a Microsoft Copilot Studio használatát, és olvassa el a megfelelő copilot-megoldás kiválasztását.

További információ: A robotépítés jövője.

Előfeltételek

A robotok üzembe helyezéséhez és közzétételéhez az Azure CLI-vel a következőkre van szükség:

  • Aktív előfizetéssel rendelkező Azure-fiók. Hozzon létre egy ingyenes fiókot.

  • Az Azure CLI telepítése.

    A programozási nyelvhez használja az Azure CLI alábbi verzióját. Egyes lépések nem működnek a parancssori felület későbbi verzióival.

    Nyelv Parancssori felület verziója
    C# és JavaScript 2.39.0 vagy újabb
    Python 2.55.0 vagy újabb
    Java 2.29.2

  • Ez a folyamat egy Azure Resource Manager-sablont (ARM-sablont) használ egy App Service-erőforrás létrehozásához a robot számára.

    Ha nem rendelkezik az aktuális sablonokkal, hozzon létre egy másolatot a deploymentTemplates mappa robotprojektjében: C#, JavaScript, Python vagy Java.

Tipp.

Ez a robot kiépítésének és közzétételének nagyobb folyamatának része. Megtudhatja, hogyan építhet ki és tehet közzé egy robotot az előfeltételek teljes listájához.

Paraméterfájl szerkesztése

Szerkessze az ARM-sablon paraméterfájlját, hogy tartalmazza a használni kívánt értékeket.

Fontos

Ugyanazt appType az értéket kell használnia az App Service-hez és az Azure Bot-erőforrásokhoz.

Ha a projekt még nem tartalmazza a legújabb ARM-sablon- és paraméterfájlokat, a Robot Framework SDK adattárából másolhatja őket a következő nyelvhez: C#, JavaScript, Python vagy Java.

Ez a táblázat a paraméterfájl üzembehelyezési paramétereit ismerteti a parancsbeállítással való parameters használathoz. Alapértelmezés szerint a paraméterfájl neve parameters-for-template-BotApp-with-rg.json.

Paraméter Típus Leírás
appServiceName Sztring Szükséges. Az app service globálisan egyedi neve.
existingAppServicePlanName Sztring Opcionális. Annak a meglévő App Service-csomagnak a neve, amellyel létre kívánja hozni az app service-t a robot számára.
existingAppServicePlanLocation Sztring Opcionális. A meglévő App Service-csomag helye.
newAppServicePlanName Sztring Opcionális. Az új App Service-csomag neve.
newAppServicePlanLocation Sztring Opcionális. Az új App Service-csomag helye.
newAppServicePlanSku Objektum Opcionális. Az új App Service-csomag termékváltozata. Az alapértelmezett az S1 (Standard) szolgáltatáscsomag.
appType Sztring Szükséges. A roboterőforrások identitásainak kezelése. Engedélyezett értékek: "MultiTenant", "SingleTenant" és "UserAssignedMSI". Az alapértelmezett érték a "MultiTenant".
appId Sztring Szükséges. A korábban létrehozott identitáserőforrás ügyfél-azonosítója vagy alkalmazásazonosítója. Ez az app service Microsoft-alkalmazásazonosítójaként használatos.
appSecret Sztring Opcionális. Egy-bérlős és több-bérlős alkalmazástípusok esetén az identitáserőforrás jelszava.
UMSIName Sztring Opcionális. A felhasználó által hozzárendelt felügyelt identitásalkalmazás-típusok esetében az identitáserőforrás neve.
UMSIResourceGroupName Sztring Opcionális. A felhasználó által hozzárendelt felügyelt identitásalkalmazás-típusok esetében az identitáserőforrás erőforráscsoportja.
tenantId Sztring Opcionális. A felhasználó által hozzárendelt felügyelt identitások és az egybérlős alkalmazástípusok esetében az identitáserőforrás Microsoft Entra ID-bérlőazonosítója.

Nem minden paraméter vonatkozik minden alkalmazástípusra.

  • Adjon meg értékeket a UMSIName, UMSIResourceGroupNameés tenantId.
  • Hagyja appSecret üresen.

Egyes paraméterek egy meglévő vagy új App Service-csomag használatára vonatkoznak.

  • Adjon meg értékeket az és existingAppServicePlanLocationa existingAppServicePlanName .
  • Hagyja meg newAppServicePlanName, newAppServicePlanLocationmajd newAppServicePlanSku üresen.

Az app service létrehozása

Hozza létre az app service-t a robothoz.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Lehetőség Leírás
resource-group Annak az Azure-erőforráscsoportnak a neve, amelyben létre kívánja hozni az app service-t.
sablonfájl Az app service ARM-sablonjának elérési útja. Az elérési út lehet relatív vagy abszolút.
parameters Az ARM-sablonnal használandó paraméterfájl elérési útja. Az elérési út lehet relatív vagy abszolút.

A legújabb generátorokkal létrehozott projektek esetében az ARM-sablon és a paraméterfájlok a projekt DeploymentTemplates\DeployUseExistResourceGroup mappájában találhatók. Az alapértelmezett fájlnevek template-BotApp-with-rg.json és parameters-for-template-BotApp-with-rg.json.

Tipp.

  • Az app service alap URL-címe az app service neve alapján történik: https:<app-service-name>.azurewebsites.net.
  • A robot üzenetkezelési végpontja lesz az alap URL-cím plusz /api/messages, például https:<app-service-name>.azurewebsites.net/api/messages.

További információk

További információ az ARM-sablonokról: Mik azok az ARM-sablonok? és Az Azure Resource Manager (ARM) üzembehelyezési sablonjainak használata az Azure CLI-vel.

Következő lépések

Ha az App Service-t robottelepítés részeként hozta létre, a folyamat folytatásához tekintse meg az Erőforrások létrehozása ARM-sablonokkal című témakört.