Bagikan melalui

Menggunakan Azure CLI untuk membuat sumber daya App Service

  • Artikel

BERLAKU UNTUK: SDK v4

Artikel ini menjelaskan cara membuat sumber daya App Service dengan Azure CLI dan templat Azure Resource Manager (templat ARM) sebagai bagian dari proses untuk memprovisikan dan menerbitkan bot. Layanan aplikasi terkadang disebut sebagai aplikasi web.

Penting

Bot Python tidak dapat disebarkan ke grup sumber daya yang berisi layanan atau bot Windows. Beberapa bot Python dapat disebarkan ke grup sumber daya yang sama; namun, Anda perlu membuat layanan lain (seperti layanan Azure AI) di grup sumber daya lain.

Catatan

Bot Framework JavaScript, C#, dan Python SDK akan terus didukung, namun, Java SDK dihentikan dengan dukungan jangka panjang akhir yang berakhir pada November 2023.

Bot yang ada yang dibangun dengan Java SDK akan terus berfungsi.

Untuk pembuatan bot baru, pertimbangkan untuk menggunakan Microsoft Copilot Studio dan baca tentang memilih solusi salinan yang tepat.

Untuk informasi selengkapnya, lihat Masa depan pembuatan bot.

Prasyarat

Untuk menggunakan Azure CLI untuk memprovisikan dan menerbitkan bot, Anda memerlukan:

  • Akun Azure yang memiliki langganan aktif. Buat akun gratis.

  • Penginstalan Azure CLI.

    Untuk bahasa pemrograman Anda, gunakan versi Azure CLI berikut. Beberapa langkah tidak akan berfungsi dengan versi CLI yang lebih baru.

    Bahasa Versi CLI
    C# dan JavaScript 2.39.0 atau yang lebih baru
    Python 2.55.0 atau yang lebih baru
    Java 2.29.2

  • Proses ini menggunakan templat Azure Resource Manager (templat ARM) untuk membuat sumber daya App Service untuk bot Anda.

    Jika Anda tidak memiliki templat saat ini, buat salinan di proyek bot Anda dari folder deploymentTemplates : C#, JavaScript, Python, atau Java.

Tip

Ini adalah bagian dari proses yang lebih besar untuk menyediakan dan menerbitkan bot. Lihat cara Memprovisikan dan menerbitkan bot untuk daftar lengkap prasyarat.

Mengedit file parameter

Edit file parameter untuk templat ARM agar berisi nilai yang ingin Anda gunakan.

Penting

Anda harus menggunakan nilai yang sama appType untuk sumber daya App Service dan Azure Bot Anda.

Jika proyek Anda belum berisi file templat dan parameter ARM terbaru, Anda dapat menyalinnya dari repositori SDK Kerangka Kerja Bot untuk bahasa Anda: C#, JavaScript, Python, atau Java.

Tabel ini menjelaskan parameter penyebaran dalam file parameter, untuk digunakan dengan parameters opsi perintah. Secara default, nama file parameter parameters-for-template-BotApp-with-rg.json.

Parameter Jenis Deskripsi
appServiceName String Harus diisi. Nama layanan aplikasi yang unik secara global.
existingAppServicePlanName String Opsional. Nama paket layanan aplikasi yang ada untuk membuat layanan aplikasi untuk bot.
existingAppServicePlanLocation String Opsional. Lokasi paket layanan aplikasi yang ada.
newAppServicePlanName String Opsional. Nama paket layanan aplikasi baru .
newAppServicePlanLocation String Opsional. Lokasi paket layanan aplikasi baru .
newAppServicePlanSku Objek Opsional. SKU untuk paket layanan aplikasi baru . Defaultnya adalah paket layanan S1 (Standar).
appType String Harus diisi. Bagaimana identitas sumber daya bot Anda dikelola. Nilai yang diizinkan: "MultiTenant", "SingleTenant", dan "UserAssignedMSI". Defaultnya adalah "MultiTenant".
appId String Harus diisi. ID klien atau ID aplikasi dari sumber daya identitas yang Anda buat sebelumnya. Ini digunakan sebagai ID aplikasi Microsoft dari layanan aplikasi.
appSecret String Opsional. Untuk jenis aplikasi penyewa tunggal dan multi-penyewa, kata sandi untuk sumber daya identitas.
UMSIName String Opsional. Untuk jenis aplikasi identitas terkelola yang ditetapkan pengguna, nama sumber daya identitas.
UMSIResourceGroupName String Opsional. Untuk jenis aplikasi identitas terkelola yang ditetapkan pengguna, grup sumber daya untuk sumber daya identitas.
tenantId String Opsional. Untuk identitas terkelola yang ditetapkan pengguna dan jenis aplikasi penyewa tunggal, ID penyewa ID Microsoft Entra untuk sumber daya identitas.

Tidak semua parameter berlaku untuk semua jenis aplikasi.

  • Berikan nilai untuk UMSIName, UMSIResourceGroupName, dan tenantId.
  • Biarkan appSecret kosong.

Beberapa parameter khusus untuk menggunakan paket layanan aplikasi yang sudah ada atau baru.

  • Berikan nilai untuk existingAppServicePlanName dan existingAppServicePlanLocation.
  • Biarkan newAppServicePlanName, newAppServicePlanLocation, dan newAppServicePlanSku kosong.

Membuat layanan aplikasi

Buat layanan aplikasi untuk bot Anda.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Opsi Deskripsi
grup sumber daya Nama grup sumber daya Azure untuk membuat layanan aplikasi.
file templat Jalur ke templat ARM untuk layanan aplikasi. Jalurnya bisa relatif atau absolut.
parameter Jalur ke file parameter yang akan digunakan dengan templat ARM. Jalurnya bisa relatif atau absolut.

Untuk proyek yang dibuat dengan generator terbaru, templat ARM dan file parameter terletak di folder DeploymentTemplates\DeployUseExistResourceGroup dalam proyek. Nama file default template-BotApp-with-rg.json dan parameters-for-template-BotApp-with-rg.json.

Tip

  • URL dasar untuk layanan aplikasi Anda didasarkan pada nama layanan aplikasi: https:<app-service-name>.azurewebsites.net.
  • Titik akhir olahpesan untuk bot Anda akan menjadi URL dasar ditambah /api/messages, seperti https:<app-service-name>.azurewebsites.net/api/messages.

Informasi Tambahan

Untuk informasi selengkapnya tentang templat ARM, lihat Apa itu templat ARM? dan Cara menggunakan templat penyebaran Azure Resource Manager (ARM) dengan Azure CLI.

Langkah berikutnya

Jika Anda membuat App Service sebagai bagian dari penyebaran bot, lihat Membuat sumber daya dengan templat ARM untuk melanjutkan proses.