Bagikan melalui

Menggunakan templat Azure Resource Manager untuk membuat hub Azure AI Studio

  • Artikel

Penting

Item yang ditandai (pratinjau) dalam artikel ini sedang dalam pratinjau publik. Pratinjau ini disediakan tanpa perjanjian tingkat layanan, dan kami tidak merekomendasikannya untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Gunakan templat Microsoft Bicep untuk membuat hub untuk Azure AI Studio. Templat memudahkan untuk membuat sumber daya sebagai operasi terkoordinasi tunggal. Templat Bicep adalah dokumen teks yang menentukan sumber daya yang diperlukan untuk penyebaran. Ini mungkin juga menentukan parameter penyebaran. Parameter digunakan untuk menyediakan nilai input saat menggunakan templat.

Templat yang digunakan dalam artikel ini dapat ditemukan di https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics. File sumber main.bicep dan file templat Azure Resource Manager (main.json) yang dikompilasi tersedia. Templat ini membuat sumber daya berikut:

  • Grup sumber daya Azure (jika belum ada)
  • Hub Azure AI Studio
  • Akun Azure Storage
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Layanan Azure AI (dibuat oleh templat)

Prasyarat

  • Langganan Azure. Jika Anda tidak memilikinya, buat akun gratis.

  • Salinan file templat dari repositori GitHub. Untuk mengkloning repositori GitHub ke komputer lokal Anda, Anda dapat menggunakan Git. Gunakan perintah berikut untuk mengkloning repositori mulai cepat ke komputer lokal Anda dan navigasikan ke aistudio-basics direktori.

    git clone https://github.com/Azure/azure-quickstart-templates
cd azure-quickstart-templates/quickstarts/microsoft.machinelearningservices/aistudio-basics

  • Alat baris perintah Bicep. Untuk menginstal alat baris perintah Bicep, gunakan artikel Instal CLI Bicep.

Memahami templat

Templat Bicep terdiri dari file berikut:

File Deskripsi
main.bicep File Bicep utama yang menentukan parameter dan variabel. Meneruskan parameter & variabel ke modul lain di subdirektori modules .
ai-hub.bicep Menentukan hub.
dependent-resources.bicep Menentukan sumber daya dependen untuk hub seperti Akun Azure Storage, Container Registry, Key Vault, dan Application Insights.

Penting

Contoh templat mungkin tidak selalu menggunakan versi API terbaru untuk sumber daya Azure yang dibuatnya. Sebelum menggunakan templat, sebaiknya ubah untuk menggunakan versi API terbaru. Setiap layanan Azure memiliki sekumpulan versi API sendiri. Untuk informasi tentang API untuk layanan tertentu, periksa informasi layanan di referensi Azure REST API.

Hub didasarkan pada Azure Pembelajaran Mesin. Untuk informasi tentang versi API terbaru untuk Azure Pembelajaran Mesin, lihat referensi Azure Pembelajaran Mesin REST API. Untuk memperbarui versi API ini, temukan Microsoft.MachineLearningServices/<resource> entri untuk jenis sumber daya dan perbarui ke versi terbaru. Contoh berikut adalah entri untuk hub yang menggunakan versi API dari 2023-08-01-preview:

resource aiResource 'Microsoft.MachineLearningServices/workspaces@2023-08-01-preview' = {

Templat Azure Resource Manager

Meskipun bahasa khusus domain Bicep (DSL) digunakan untuk menentukan sumber daya, file Bicep dikompilasi ke dalam templat Azure Resource Manager saat Anda menyebarkan templat. File main.json yang disertakan dalam repositori GitHub adalah versi templat Azure Resource Manager yang dikompilasi. File ini dihasilkan dari main.bicep file menggunakan alat baris perintah Bicep. Misalnya, saat Anda menyebarkan templat Bicep, templat tersebut main.json menghasilkan file. Anda juga dapat membuat main.json file secara manual menggunakan bicep build perintah tanpa menyebarkan templat.

bicep build main.bicep

Untuk informasi selengkapnya, lihat artikel Bicep CLI .

Mengonfigurasi templat

Untuk menjalankan templat Bicep, gunakan perintah berikut dari aistudio-basics direktori:

  1. Untuk membuat Grup Sumber Daya Azure baru, gunakan perintah berikut. Ganti exampleRG dengan nama grup sumber daya Anda, dan eastus dengan wilayah Azure untuk digunakan:

    az group create --name exampleRG --location eastus

  2. Untuk menjalankan templat, gunakan perintah berikut. Ganti myai dengan nama yang akan digunakan untuk sumber daya Anda. Nilai ini digunakan, bersama dengan awalan dan akhiran yang dihasilkan, untuk membuat nama unik untuk sumber daya yang dibuat oleh templat.

    Tip

    Harus aiHubName 5 karakter atau kurang. Ini tidak boleh sepenuhnya numerik atau berisi karakter berikut: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

    az deployment group create --resource-group exampleRG --template-file main.bicep --parameters aiHubName=myai

    Setelah operasi selesai, Anda dapat menggunakan hub untuk membuat proyek, mengelola sumber daya, dan berkolaborasi dengan orang lain.

Langkah berikutnya