Déployer une instance de Spring PetClinic avec IA sur Azure Container Apps

Dans cet article, vous allez apprendre à utiliser Azure OpenAI Service et Azure Container Apps pour créer une interface de langage naturel pour l’exemple d’application Spring PetClinic.

Pour plus d’informations sur les détails architecturaux de cette application, consultez l’exemple Java PetClinic AI dans Container Apps.

Considérations

• Temps de déploiement : l’application avec IA déployée dans cet article nécessite une série de services connectés pour fonctionner. Le temps de déploiement peut aller jusqu’à 15 minutes. Planifiez votre temps en conséquence quand vous travaillez dans ce tutoriel.

• Disponibilité du modèle : l’exemple d’application utilise des modules de déploiement gpt-4o ettext-embedding-ada-002, qui peuvent ne pas être disponibles dans toutes les régions Azure.

  Pour plus d’informations sur la disponibilité, consultez les modèles azure OpenAI Service et sélectionnez votre région de déploiement souhaitée. Pour obtenir les meilleurs résultats, envisagez d’utiliser une des régions suivantes : USA Est, USA Est 2, USA Centre Nord, USA Centre Sud, Suède Centre, USA Ouest ou USA Ouest 3.

Prérequis

• Un abonnement Azure. Créez-en un gratuitement..
• Les rôles Contributor et User Access Administrator, ou le rôle Owner. Pour plus d’informations, consultez Affecter des rôles Azure à l’aide du portail Azure.
• Un compte GitHub.
• Dernière version de Git.
• La build Microsoft d’Open JDK, version 17 ou ultérieure.
• Azure Developer CLI.
• Azure CLI.
• Maven.

Programme d’installation

1. Clonez l’exemple d’application sur votre machine en exécutant la commande suivante :

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

2. Accédez au dossier spring-petclinic-ai à l’aide de la commande suivante :

   cd spring-petclinic-ai
   

3. Si vous ne l’avez pas déjà, installez l’extension containerapp pour Azure CLI en utilisant la commande suivante :

   az extension add --name containerapp --upgrade
   

4. Connectez-vous de façon sécurisée à votre compte Azure en utilisant la commande suivante :

   az auth login  
   

   Cette commande ouvre une page web où vous pouvez entrer vos informations d’identification Azure pour vous authentifier.

Déployer

1. Déployez automatiquement l’application en utilisant la commande suivante :

   azd up
   

2. Lorsque vous y êtes invité, entrez my-first-ai pour le nom de l’environnement.

   Après cela, entrez des valeurs pour Azure Subscription et Azure location, en remplaçant les espaces réservés <..> par vos valeurs réelles dans les invites suivantes :

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

   Une fois que vous avez fourni toutes les valeurs requises, il peut être nécessaire d’attendre jusqu’à 15 minutes pour que l’application soit déployée.

   Une fois le déploiement terminé, vous voyez une sortie similaire à ce qui suit pour vous informer d’un déploiement réussi :

   (✓) 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: Azure AI Services Model Deployment: openai-my-first-ai/text-embedding-ada-002 (42.909s)
   (✓) Done: Azure AI Services 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. Localisez l’URL de l’application.

   Inspectez la sortie et recherchez le message de réussite du déploiement, puis copiez l’URL dans le Presse-papiers.

   Le message de réussite ressemble à la sortie suivante :

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

Essayer votre application

1. Visualisez l’application dans un navigateur web en utilisant l’URL que vous avez copiée à la fin de la dernière section.

2. Vous pouvez interagir avec le chatbot via des prompts comme ceux-ci :

   • List all registered pet owners (Lister tous les propriétaires d’animaux inscrits)
   • Add a new pet owner named Steve (Ajouter un nouveau propriétaire d’animal nommé Steve)
   • Change Steve's name to Steven (Changer le nom de Steve en Steven)
   • Add a pet named Spot (Ajouter un animal appelé Spot)
   • List all vets in your system (Lister tous les vétérinaires de votre système)

L’image suivante montre le résultat quand il est demandé à l’application d’ajouter un nouveau propriétaire d’animal au système :

Mises à jour

Pendant que vous expérimentez l’exemple, si vous voulez déployer des modifications sur l’application, vous pouvez utiliser les commandes suivantes pour les publier :

azd package
azd deploy

Nettoyer les ressources

Si vous prévoyez de continuer avec d’autres tutoriels, vous pouvez conserver ces ressources. Quand vous n’avez plus besoin des ressources, supprimez le groupe de ressources, ce qui va aussi supprimer ses ressources.

az group delete --name rg-first-ai