Azure Container Apps'te Spring PetClinic'in yapay zeka özellikli bir örneğini dağıtma

Bu makalede, Spring PetClinic örnek uygulaması için doğal dil arabirimi oluşturmak üzere Azure OpenAI Hizmeti ve Azure Container Apps'i kullanmayı öğreneceksiniz.

PetClinic'in giriş sayfasının ekran görüntüsü.

Bu uygulamanın mimari ayrıntıları hakkında bilgi için bkz. Container Apps'te Java PetClinic AI örneğine genel bakış.

Dikkat edilmesi gereken noktalar

  • Dağıtım süresi: Bu makalede dağıtılan yapay zeka özellikli uygulamanın çalışması için bir dizi bağlı hizmet gerekir. Dağıtım sürelerinin tamamlanması 15 dakika kadar sürebilir. Bu öğreticide çalışırken zamanınızı uygun şekilde planlayın.

  • Model kullanılabilirliği: Örnek uygulama, tüm Azure bölgelerinde kullanılamayabilecek Azure OpenAI Hizmeti dağıtım modüllerini gpt-4o ve text-embedding-ada-002kullanır.

    Kullanılabilirlik hakkında daha fazla bilgi için bkz. Azure OpenAI Hizmeti modelleri ve istediğiniz dağıtım bölgesini seçin. En iyi sonuçlar için şu bölgelerden birini kullanmayı göz önünde bulundurun: Doğu ABD, Doğu ABD 2, Orta Kuzey ABD, Orta Güney ABD, Orta İsveç, Batı ABD veya Batı ABD 3.

Önkoşullar

Ayarlama

  1. Aşağıdaki komutu kullanarak örnek uygulamayı makinenize kopyalayın:

    git clone https://github.com/Azure-Samples/spring-petclinic-ai.git

  2. Aşağıdaki komutu kullanarak spring-petclinic-ai klasörüne gidin:

    cd spring-petclinic-ai

  3. Henüz sahip değilseniz aşağıdaki komutu kullanarak Azure CLI uzantısını yükleyin containerapp :

    az extension add --name containerapp --upgrade

  4. Aşağıdaki komutu kullanarak Azure hesabınızda güvenli bir şekilde oturum açın:

    az auth login

    Bu komut, kimlik doğrulaması için Azure kimlik bilgilerinizi girebileceğiniz bir web sayfası açar.

Dağıtma

  1. Aşağıdaki komutu kullanarak uygulamayı otomatik olarak dağıtın:

    azd up

  2. İstendiğinde ortam adı olarak my-first-ai yazın.

    Bundan sonra, aşağıdaki istemlerde yer tutucular için Azure SubscriptionAzure location gerçek değerlerinizi değiştirerek ve <..>değerlerini girin:

    ? Enter a new environment name: my-first-ai
? Select an Azure Subscription to use: <SUBSCRIPTION>
? Select an Azure location to use: <REGION>

    Gerekli tüm değerleri sağladıktan sonra uygulamanın dağıtılması için 15 dakika kadar beklemeniz gerekebilir.

    Dağıtım tamamlandığında, başarılı bir dağıtımı size bildirmek için aşağıdakine benzer bir çıktı görürsünüz:

    (✓) Done: Resource group: rg-my-first-ai (5.977s)
(✓) Done: Virtual Network: vnet-my-first-ai (7.357s)
(✓) Done: Container Registry: crb36onby7z5ooc (25.742s)
(✓) Done: Azure OpenAI: openai-my-first-ai (25.324s)
(✓) Done: Foundry Tools Model Deployment: openai-my-first-ai/text-embedding-ada-002 (42.909s)
(✓) Done: Foundry Tools Model Deployment: openai-my-first-ai/gpt-4o (44.21s)
(✓) Done: Container Apps Environment: aca-env-my-first-ai (3m1.361s)
(✓) Done: Container App: petclinic-ai (22.701s)

INFO: Deploy finish succeed!
INFO: App url: petclinic-ai.<CLUSTER>.<REGION>.azurecontainerapps.io

Packaging services (azd package)

(✓) Done: Packaging service petclinic-ai

Deploying services (azd deploy)

(✓) Done: Deploying service petclinic-ai
- Endpoint: https://petclinic-ai.<CLUSTER>.<REGION>.azurecontainerapps.io/

SUCCESS: Your up workflow to provision and deploy to Azure completed in 17 minutes 40 seconds.

  3. Uygulama URL'sini bulun.

    Çıktıyı inceleyin, dağıtım başarılı iletisini bulun ve URL'yi panoya kopyalayın.

    Başarı iletisi aşağıdaki çıkışa benzer:

    INFO: Deploy finish succeed!
INFO: App url: https://petclinic-ai.<CLUSTER>.<REGION>.azurecontainerapps.io

Uygulamanızı deneyin

  1. Son bölümün sonunda kopyaladığınız URL'yi kullanarak uygulamayı web tarayıcısında görüntüleyin.

  2. Sohbet botuyla aşağıdaki gibi istemlerle etkileşim kurabilirsiniz:

    • Tüm kayıtlı evcil hayvan sahiplerini listeleyin.
    • Steve adlı yeni bir evcil hayvan sahibi ekleyin.
    • Steve'in adını Steven olarak değiştir.
    • Spot adlı bir evcil hayvan ekleyin.
    • Sisteminizdeki tüm veterinerleri listeleyin.

Aşağıdaki görüntüde, uygulamanın sisteme yeni bir evcil hayvan sahibi eklemesini istemenin sonucu gösterilmektedir:

Adres ve diğer bilgilerle birlikte evcil hayvan hakkındaki bilgilerle birlikte yeni bir sahip ekleyen yapay zeka sohbet yardımcısı ekran görüntüsü.

Güncelleştirmeler

Örnekle denemeler yapılırken, uygulamada herhangi bir değişiklik dağıtmak istiyorsanız, değişikliklerinizi yayımlamak için aşağıdaki komutları kullanabilirsiniz:

azd package
azd deploy

Kaynakları temizleme

Sonraki öğreticilerle çalışmaya devam etmek istiyorsanız, bu kaynakları korumak isteyebilirsiniz. Kaynaklara artık ihtiyacınız kalmadığında kaynak grubunu silin; bu da kaynaklarını siler.

Kaynakları silmek için Azure portalını kullanarak bu örneğin kaynak grubunu bulun ve silin.

  • Last updated on