Tworzenie zasobu usługi App Service przy użyciu interfejsu wiersza polecenia platformy Azure

Artykuł
05/02/2024

DOTYCZY: ZESTAW SDK w wersji 4

W tym artykule opisano sposób tworzenia zasobu usługi App Service przy użyciu interfejsu wiersza polecenia platformy Azure i szablonu usługi Azure Resource Manager (szablonu arm) w ramach procesu aprowizowania i publikowania bota. Usługa App Service jest czasami nazywana aplikacją internetową.

Ważne

Nie można wdrożyć botów języka Python w grupie zasobów zawierającej usługi lub boty systemu Windows. Wiele botów języka Python można wdrożyć w tej samej grupie zasobów; należy jednak utworzyć inne usługi (takie jak usługi Azure AI) w innej grupie zasobów.

Aby uzyskać informacje na temat kompletnego procesu, zobacz jak aprowizować i publikować bota.
Aby uzyskać informacje na temat tworzenia zasobu usługi Azure Bot, zobacz Tworzenie zasobu usługi Azure Bot przy użyciu interfejsu wiersza polecenia platformy Azure.

Uwaga

Zestawy SDK języka JavaScript, C# i Python platformy Bot Framework będą nadal obsługiwane, jednak zestaw SDK języka Java jest wycofywany z ostatecznym długoterminowym wsparciem kończącym się w listopadzie 2023 r.

Istniejące boty utworzone za pomocą zestawu JAVA SDK będą nadal działać.

W przypadku tworzenia nowego bota rozważ użycie agentów usługi Power Virtual Agents i przeczytaj o wyborze odpowiedniego rozwiązania czatbota.

Aby uzyskać więcej informacji, zobacz Przyszłość tworzenia botów.

Wymagania wstępne

Aby aprowizować i publikować boty przy użyciu interfejsu wiersza polecenia platformy Azure, potrzebne są następujące elementy:

Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
Instalacja interfejsu wiersza polecenia platformy Azure.

W przypadku języka programowania użyj następującej wersji interfejsu wiersza polecenia platformy Azure. Niektóre kroki nie będą działać z nowszymi wersjami interfejsu wiersza polecenia.

Język Wersja interfejsu wiersza polecenia

C# i JavaScript 2.39.0 lub nowsza

Python 2.55.0 lub nowszy

Java 2.29.2

Język	Wersja interfejsu wiersza polecenia
C# i JavaScript	2.39.0 lub nowsza
Python	2.55.0 lub nowszy
Java	2.29.2

Ten proces używa szablonu usługi Azure Resource Manager (szablonu arm) do utworzenia zasobu usługi App Service dla bota.

Jeśli nie masz bieżących szablonów, utwórz kopię w projekcie bota folderu deploymentTemplates : C#, JavaScript, Python lub Java.

Napiwek

Jest to część większego procesu aprowizacji i publikowania bota. Zobacz, jak aprowizować i publikować bota , aby uzyskać pełną listę wymagań wstępnych.

Edytowanie pliku parametrów

Edytuj plik parametrów szablonu usługi ARM, aby zawierał wartości, których chcesz użyć.

Ważne

Musisz użyć tej samej appType wartości dla zasobów usługi App Service i usługi Azure Bot.

Jeśli projekt nie zawiera jeszcze najnowszych plików szablonów i parametrów usługi ARM, możesz skopiować je z repozytorium zestawu SDK platformy Bot Framework dla swojego języka: C#, JavaScript, Python lub Java.

W tej tabeli opisano parametry wdrożenia w pliku parametrów do użycia z opcją parameters polecenia. Domyślnie nazwa pliku parametrów jest parameters-for-template-BotApp-with-rg.json.

Parametr	Type	opis
`appServiceName`	String	Wymagany. Globalnie unikatowa nazwa usługi App Service.
`existingAppServicePlanName`	String	Opcjonalny. Nazwa istniejącego planu usługi App Service, za pomocą którego ma zostać utworzona usługa app service dla bota.
`existingAppServicePlanLocation`	String	Opcjonalny. Lokalizacja istniejącego planu usługi App Service.
`newAppServicePlanName`	String	Opcjonalny. Nazwa nowego planu usługi App Service.
`newAppServicePlanLocation`	String	Opcjonalny. Lokalizacja nowego planu usługi App Service.
`newAppServicePlanSku`	Objekt	Opcjonalny. Jednostka SKU dla nowego planu usługi App Service. Wartość domyślna to plan usługi S1 (Standardowa).
`appType`	String	Wymagany. Sposób zarządzania tożsamościami zasobów bota. Dozwolone wartości: "MultiTenant", "SingleTenant" i "UserAssignedMSI". Wartość domyślna to "MultiTenant".
`appId`	String	Wymagany. Identyfikator klienta lub identyfikator aplikacji z utworzonego wcześniej zasobu tożsamości. Jest to używane jako identyfikator aplikacji firmy Microsoft usługi app Service.
`appSecret`	String	Opcjonalny. W przypadku typów aplikacji z jedną dzierżawą i wieloma dzierżawami hasło zasobu tożsamości.
`UMSIName`	String	Opcjonalny. W przypadku typów aplikacji tożsamości zarządzanej przypisanej przez użytkownika nazwa zasobu tożsamości.
`UMSIResourceGroupName`	String	Opcjonalny. W przypadku typów aplikacji tożsamości zarządzanej przypisanej przez użytkownika grupa zasobów dla zasobu tożsamości.
`tenantId`	String	Opcjonalny. W przypadku tożsamości zarządzanej przypisanej przez użytkownika i typów aplikacji z jedną dzierżawą identyfikator dzierżawy Firmy Microsoft dla zasobu tożsamości.

Nie wszystkie parametry mają zastosowanie do wszystkich typów aplikacji.

Podaj wartości dla UMSIName, UMSIResourceGroupNamei tenantId.
Pozostaw appSecret wartość pustą.

Niektóre parametry są specyficzne dla używania istniejącego lub nowego planu usługi App Service.

Istniejący plan
Nowy plan

Podaj wartości dla existingAppServicePlanName i existingAppServicePlanLocation.
Pozostaw wartości newAppServicePlanName, newAppServicePlanLocationi newAppServicePlanSku puste.

Tworzenie usługi App Service

Utwórz usługę app service dla bota.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"

Opcja	Opis
resource-group	Nazwa grupy zasobów platformy Azure, w której ma zostać utworzona usługa App Service.
plik-szablonu	Ścieżka do szablonu usługi ARM dla usługi App Service. Ścieżka może być względna lub bezwzględna.
parameters	Ścieżka do pliku parametrów do użycia z szablonem usługi ARM. Ścieżka może być względna lub bezwzględna.

W przypadku projektów utworzonych przy użyciu najnowszych generatorów pliki szablonu i parametrów usługi ARM znajdują się w folderze DeploymentTemplates\DeployUseExistResourceGroup w projekcie. Domyślne nazwy plików to template-BotApp-with-rg.json i parameters-for-template-BotApp-with-rg.json.

Napiwek

Podstawowy adres URL usługi App Service jest oparty na nazwie usługi app Service: https:<app-service-name>.azurewebsites.net.
Punkt końcowy obsługi komunikatów dla bota będzie podstawowym adresem URL plus /api/messages, takim jak https:<app-service-name>.azurewebsites.net/api/messages.

Dodatkowe informacje

Aby uzyskać więcej informacji na temat szablonów usługi ARM, zobacz Co to są szablony usługi ARM? i Jak używać szablonów wdrażania usługi Azure Resource Manager (ARM) za pomocą interfejsu wiersza polecenia platformy Azure.

Następne kroki

Jeśli usługa App Service została utworzona w ramach wdrożenia bota, zobacz Tworzenie zasobów przy użyciu szablonów usługi ARM, aby kontynuować proces.

Share via