Aracılığıyla paylaş

Azure AI Foundry hub'ı oluşturmak için Azure Resource Manager şablonu kullanma

  • Makale

Önemli

Bu makalede işaretlenen (önizleme) öğeler şu anda genel önizleme aşamasındadır. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri Ek Kullanım Koşulları.

Azure AI Foundry için bir hub oluşturmak için Microsoft Bicep şablonu kullanın. Şablon, kaynakları tek ve eşgüdümlü bir işlem olarak oluşturmayı kolaylaştırır. Bicep şablonu, dağıtım için gereken kaynakları tanımlayan bir metin belgesidir. Ayrıca dağıtım parametrelerini de belirtebilir. Parametreler, şablon kullanılırken giriş değerleri sağlamak için kullanılır.

Bu makalede kullanılan şablon adresinde https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basicsbulunabilir. Hem kaynak main.bicep dosya hem de derlenmiş Azure Resource Manager şablonu (main.json) dosyası kullanılabilir. Bu şablon aşağıdaki kaynakları oluşturur:

  • Azure kaynak grubu (henüz yoksa)
  • Azure AI Foundry hub'ı
  • Azure Depolama Hesabı
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Azure AI hizmetleri (şablon tarafından oluşturulur)

Önkoşullar

  • Azure aboneliği. Aboneliğiniz yoksa ücretsiz bir hesap oluşturun.

  • GitHub deposundaki şablon dosyalarının bir kopyası. GitHub deposunu yerel makinenize kopyalamak için Git'i kullanabilirsiniz. Hızlı başlangıç deposunu yerel makinenize kopyalamak ve dizine gitmek için aistudio-basics aşağıdaki komutu kullanın.

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

  • Bicep komut satırı araçları. Bicep komut satırı araçlarını yüklemek için Bicep CLI yükleme makalesini kullanın.

Şablonu anlama

Bicep şablonu aşağıdaki dosyalardan oluşur:

Dosya Açıklama
main.bicep Parametreleri ve değişkenleri tanımlayan ana Bicep dosyası. Parametreleri ve değişkenleri alt dizindeki modules diğer modüllere geçirme.
ai-hub.bicep Hub'ı tanımlar.
dependent-resources.bicep Azure Depolama Hesabı, Container Registry, Key Vault ve Application Insights gibi hub için bağımlı kaynakları tanımlar.

Önemli

Örnek şablonlar, oluşturduğu Azure kaynakları için her zaman en son API sürümünü kullanmayabilir. Şablonu kullanmadan önce en son API sürümlerini kullanacak şekilde değiştirmenizi öneririz. Her Azure hizmetinin kendi API sürümleri kümesi vardır. Belirli bir hizmete yönelik API hakkında bilgi için Azure REST API başvurusundaki hizmet bilgilerini gözden geçirin.

Merkez, Azure Machine Learning'i temel alır. Azure Machine Learning'in en son API sürümleri hakkında bilgi için bkz . Azure Machine Learning REST API başvurusu. Bu API sürümünü güncelleştirmek için kaynak türünün girdisini Microsoft.MachineLearningServices/<resource> bulun ve en son sürüme güncelleştirin. Aşağıdaki örnek, api sürümünü kullanan bir hub için bir giriştir 2023-08-01-preview:

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

Azure Resource Manager şablonu

Kaynakları tanımlamak için Bicep etki alanına özgü dil (DSL) kullanılırken, şablonu dağıttığınızda Bicep dosyası bir Azure Resource Manager şablonunda derlenmiştir. main.json GitHub deposuna eklenen dosya, şablonun derlenmiş bir Azure Resource Manager sürümüdür. Bu dosya, Bicep komut satırı araçları kullanılarak dosyasından oluşturulur main.bicep . Örneğin, Bicep şablonunu dağıttığınızda dosyayı oluşturur main.json . Şablonu dağıtmadan komutunu kullanarak bicep build dosyayı el ile de oluşturabilirsinizmain.json.

bicep build main.bicep

Daha fazla bilgi için Bicep CLI makalesine bakın.

Şablonu yapılandırma

Bicep şablonunu çalıştırmak için dizininden aistudio-basics aşağıdaki komutları kullanın:

  1. Yeni bir Azure Kaynak Grubu oluşturmak için aşağıdaki komutu kullanın. öğesini kaynak grubunuzun adıyla ve eastus kullanılacak Azure bölgesiyle değiştirinexampleRG:

    az group create --name exampleRG --location eastus

  2. Şablonu çalıştırmak için aşağıdaki komutu kullanın. öğesini kaynaklarınız için kullanılacak adla değiştirin myai . Bu değer, şablon tarafından oluşturulan kaynaklar için benzersiz bir ad oluşturmak üzere oluşturulan ön ek ve soneklerle birlikte kullanılır.

    İpucu

    aiHubName 5 veya daha az karakter olmalıdır. Tamamen sayısal olamaz veya şu karakterleri içeremez: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

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

    İşlem tamamlandıktan sonra, proje oluşturmak, kaynakları yönetmek ve başkalarıyla işbirliği yapmak için hub'ınızı kullanabilirsiniz.

Sonraki adımlar