Démarrage rapide : Lancer une application Azure Spring Cloud en utilisant le portail AzureQuickstart: Launch an Azure Spring Cloud application using the Azure portal

Azure Spring Cloud vous permet d’exécuter facilement sur Azure une application de microservices basée sur Spring Cloud.Azure Spring Cloud enables you to easily run Spring Cloud based microservice applications on Azure.

Ce guide de démarrage rapide vous montre comment déployer une application Spring Cloud sur Azure.This quickstart shows you how to deploy an existing Spring Cloud application to Azure. Vous trouverez l’exemple de code d’application utilisé dans ce tutoriel dans notre référentiel d’exemples GitHub.You can find the sample application code used in this tutorial in our GitHub samples repository. Quand vous aurez terminé, vous pourrez accéder à l’exemple d’application fourni en ligne et à le gérer via le portail Azure.When you're finished, the provided sample application will be accessible online and ready to be managed via the Azure portal.

Dans ce guide de démarrage rapide, vous découvrez comment :Following this quickstart, you will learn how to:

  • Provisionner une instance de serviceProvision a service instance
  • Définir un serveur de configuration pour une instanceSet a configuration server for an instance
  • Générer localement une application de microservicesBuild a microservices application locally
  • Déployer chaque microserviceDeploy each microservice
  • Affecter un point de terminaison public pour votre applicationAssign public endpoint for your application

PrérequisPrerequisites

Notes

Azure Spring Cloud est actuellement disponible en préversion publique.Azure Spring Cloud is currently offered as a public preview. Les offres en préversion publique permettent aux clients de tester les nouvelles fonctionnalités avant leur publication officielle.Public preview offerings allow customers to experiment with new features prior to their official release. Les fonctionnalités et services en préversion publique ne sont pas destinés à une utilisation en contexte de production.Public preview features and services are not meant for production use. Pour plus d’informations sur le support offert lors des préversions, consultez notre FAQ ou soumettez une Demande de support.For more information about support during previews, please review our FAQ or file a Support request to learn more.

Conseil

Azure Cloud Shell est un interpréteur de commandes interactif et gratuit que vous pouvez utiliser pour exécuter les étapes de cet article.The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. Les outils Azure les plus courants sont préinstallés, notamment les dernières versions de Git, JDK, Maven et Azure CLI.It has common Azure tools preinstalled, including the latest versions of Git, JDK, Maven, and the Azure CLI. Si vous êtes connecté à votre abonnement Azure, lancez Azure Cloud Shell à partir de shell.azure.com.If you are logged in to your Azure subscription, launch your Azure Cloud Shell from shell.azure.com. Pour en savoir plus, lisez notre documentation sur Azure Cloud Shell.You can learn more about Azure Cloud Shell by reading our documentation

Pour suivre ce guide de démarrage rapide :To complete this quickstart:

  1. Installez GitInstall Git
  2. Installez JDK 8Install JDK 8
  3. Installez Maven 3.0 ou ultérieurInstall Maven 3.0 or above
  4. Installez Azure CLI 2.0.67 ou version ultérieureInstall the Azure CLI version 2.0.67 or higher
  5. Souscrire à un abonnement AzureSign up for an Azure subscription

Installez l’extension Azure CLIInstall the Azure CLI extension

Installer l’extension Azure Spring Cloud pour Azure CLI avec la commande suivanteInstall the Azure Spring Cloud extension for the Azure CLI using the following command

az extension add --name spring-cloud

Provisionner une instance de service sur le portail AzureProvision a service instance on the Azure portal

  1. Dans un navigateur web, ouvrez ce lien vers Azure Spring Cloud dans le portail Azure.In a web browser, open this link to Azure Spring Cloud in the Azure portal.

  2. Remplissez le formulaire sur la page Créer Azure Spring Cloud.Fill out the form on the Azure Spring Cloud Create page. Tenez compte des recommandations suivantes :Consider the following guidelines:

    • Nom du service : Spécifiez le nom de votre instance de service.Service Name: Specify the name of your service instance. Le nom doit comporter entre 4 et 32 caractères, et contenir uniquement des lettres minuscules, des chiffres et des traits d’union.The name must be between 4 and 32 characters long and can contain only lowercase letters, numbers, and hyphens. Le premier caractère du nom du service doit être une lettre, et le dernier doit être une lettre ou un chiffre.The first character of the service name must be a letter and the last character must be either a letter or a number.
    • Abonnement : Sélectionnez l’abonnement à facturer pour cette ressource.Subscription: Select the subscription you want to be billed for this resource. Vérifiez que cet abonnement a été ajouté à notre liste verte pour Azure Spring Cloud.Ensure that this subscription has been added to our allow-list for Azure Spring Cloud.
    • Groupe de ressources : Une bonne pratique consiste à créer des groupes de ressources pour les nouvelles ressources.Resource group: Creating new resource groups for new resources is a best practice.
    • Localisation : Sélectionnez l’emplacement de votre instance de service.Location: Select the location for your service instance. Les emplacements actuellement pris en charge sont USA Est, USA Ouest 2, Europe Ouest et Asie Sud-Est.Currently supported locations include East US, West US 2, West Europe, and Southeast Asia.
  3. Cliquez sur Vérifier et créer.Click Review and create.

  4. Vérifiez vos spécifications, puis cliquez sur Créer.Verify your specifications, and click Create.

Le déploiement du service nécessite environ 5 minutes.It takes about 5 minutes for the service to deploy. Une fois le déploiement terminé, la page Vue d’ensemble de l’instance de service apparaît.Once it is deployed, the Overview page for the service instance will appear.

Configurer votre serveur de configurationSet up your configuration server

  1. Accédez à la page Vue d’ensemble du service, puis sélectionnez Serveur de configuration.Go to the service Overview page and select Config Server.

  2. Dans la section Référentiel par défaut, définissez URI sur « https://github.com/Azure-Samples/piggymetrics », définissez LABEL (ÉTIQUETTE) sur « config », puis sélectionnez Appliquer pour enregistrer vos modifications.In the Default repository section, set URI to "https://github.com/Azure-Samples/piggymetrics", set LABEL to "config", and select Apply to save your changes.

    Capture d’écran du portail ASC

Générer et déployer des applications de microservicesBuild and deploy microservice applications

  1. Ouvrez Azure Cloud Shell et clonez le référentiel de l’exemple d’application sur votre ordinateur local.Open an Azure Cloudshell and clone the sample app repository to your local machine. Nous commençons ici par créer un répertoire temporaire nommé source-code avant de cloner l’application.Here, we first create a temporary directory called source-code before cloning the app.

    mkdir source-code
    cd source-code
    git clone https://github.com/Azure-Samples/piggymetrics
    
  2. Générez le package cloné.Build the cloned package.

    cd piggymetrics
    mvn clean package -DskipTests
    
  3. Affectez des noms à votre groupe de ressources et à votre service.Assign names to your resource group and your service. Veillez à remplacer les espaces réservés ci-dessous par le nom du groupe de ressources et le nom du service que vous avez précédemment provisionnés dans ce tutoriel.Be sure to substitute the placeholders below with the resource group name and service name that you provisioned earlier in this tutorial.

    az configure --defaults group=<resource group name>
    az configure --defaults spring-cloud=<service instance name>
    
  4. Créez l’application gateway et déployez le fichier JAR.Create the gateway application and deploy the JAR file.

    az spring-cloud app create -n gateway
    az spring-cloud app deploy -n gateway --jar-path ./gateway/target/gateway.jar
    
  5. En suivant le même modèle, créez les applications account-service et auth-service, et déployez leurs fichiers JAR.Following the same pattern, create the account-service and auth-service applications and deploy their JAR files.

    az spring-cloud app create -n account-service
    az spring-cloud app deploy -n account-service --jar-path ./account-service/target/account-service.jar
    az spring-cloud app create -n auth-service
    az spring-cloud app deploy -n auth-service --jar-path ./auth-service/target/auth-service.jar
    
  6. Le déploiement des applications prend quelques minutes.It takes a few minutes to finish deploying the applications. Pour vérifier qu’elles ont été déployées, accédez au panneau Applications dans le portail Azure.To confirm that they have deployed, go to the Apps blade in the Azure portal. Vous devez voir une ligne pour chacune des trois applications.You should see a line each of the three applications.

Affecter un point de terminaison public à la passerelleAssign a public endpoint to gateway

  1. Ouvrez l’onglet Applications dans le menu de gauche.Open the Apps tab in the menu on the left.

  2. Sélectionnez l’application gateway pour afficher la page Vue d’ensemble.Select the gateway application to show the Overview page.

  3. Sélectionnez Affecter un domaine pour affecter un point de terminaison public à la passerelle.Select Assign Domain to assign a public endpoint to gateway. Cette opération peut prendre quelques minutes.This can a few minutes.

    Capture d’écran du portail ASC

  4. Entrez le point de terminaison IP public affecté (libellé URL) dans votre navigateur pour voir votre application en cours d’exécution.Enter the assigned public endpoint (labeled URL) into your browser to view your running application.

    Capture d’écran du portail ASC

Étapes suivantesNext steps

Dans ce démarrage rapide, vous avez appris comment :In this quickstart, you learned how to:

  • Provisionner une instance de serviceProvision a service instance
  • Définir un serveur de configuration pour une instanceSet a configuration server for an instance
  • Générer localement une application de microservicesBuild a microservices application locally
  • Déployer chaque microserviceDeploy each microservice
  • Affecter un point de terminaison public pour votre passerelle d’applicationAssign public endpoint for your application gateway