Publier une application Spring Boot en tant que conteneur Docker avec le kit de ressources Azure pour EclipsePublish a Spring Boot app as a Docker container by using the Azure Toolkit for Eclipse

L’Spring Framework est une solution open source qui aide les développeurs Java à créer des applications d’entreprise.The Spring Framework is an open-source solution that helps Java developers create enterprise-level applications. Un des projets les plus connus basés sur cette plateforme est Spring Boot, qui fournit une approche simplifiée pour la création d’applications Java autonomes.One of the more-popular projects that is built on top of that platform is Spring Boot, which provides a simplified approach for creating standalone Java applications.

Docker est une solution open source qui aide les développeurs à automatiser le déploiement, la mise à l’échelle et la gestion de leurs applications qui s’exécutent dans des conteneurs.Docker is an open-source solution that helps developers automate the deployment, scaling, and management of their applications that are running in containers.

Ce didacticiel détaille la marche à suivre pour déployer une application Spring Boot en tant que conteneur Docker vers Microsoft Azure à l’aide du kit de ressources Azure pour Eclipse.This tutorial walks you through the steps to deploy a Spring Boot application as a Docker container to Microsoft Azure by using the Azure Toolkit for Eclipse.

PrérequisPrerequisites

Pour réaliser les étapes décrites dans cet article, vous devez installer Azure Toolkit for Eclipse, ce qui nécessite les composants logiciels suivants :To complete the steps in this article, you will need to install the Azure Toolkit for Eclipse, which requires the following software components:

Notes

La page Azure Toolkit for Eclipse sur Eclipse Marketplace liste les versions compatibles avec le kit de ressources.The Azure Toolkit for Eclipse page at the Eclipse Marketplace lists the builds that are compatible with the toolkit.

Cloner le référentiel Docker Spring Boot par défautClone the default Spring Boot Docker repository

Importer le référentiel publicImport the public repository

Les étapes suivantes détaillent les étapes du clonage du référentiel Spring Boot Docker sur votre ordinateur local à l’aide d’IntelliJ.The following steps walk you through cloning the Spring Boot Docker repository to your local computer by using IntelliJ. Si vous voulez utiliser une ligne de commande, consultez Déployer une application Spring Boot sur Linux dans Azure Container Service.If you want to use a command line, see Deploy a Spring Boot application on Linux in Azure Container Service.

  1. Ouvrez Eclipse.Open Eclipse.

  2. Cliquez sur Fichier > Importer.Click File > Import.

    Menu Importer fichier

  3. Lorsque la boîte de dialogue Importer s’ouvre :When the Import dialog box opens:

    a.a. Développez Git.Expand Git.

    b.b. Sélectionnez Projets de Git.Select Projects from Git.

    c.c. Cliquez sur Suivant.Click Next.

    Boîte de dialogue Importer

  4. Sur la page Sélectionner une source de référentiel :On the Select Repository Source page:

    a.a. Sélectionnez Cloner l’URI.Select Clone URI.

    b.b. Cliquez sur Suivant.Click Next.

    Sélectionner la page source du référentiel

  5. Sur la page Référentiel Git source :On the Source Git Repository page:

    a.a. Pour URI, entrez https://github.com/spring-guides/gs-spring-boot-docker.git.For URI, enter https://github.com/spring-guides/gs-spring-boot-docker.git. Cette étape devrait compléter automatiquement les champs Hôte et Chemin d’accès du référentiel avec les valeurs appropriées.This step should automatically populate the Host and Repository path fields with the correct values.

    b.b. Le référentiel Spring Boot est public. Vous n’avez donc pas à entrer vos identifiants Git.The Spring Boot repository is public, so you should not have to enter your Git username and password.

    c.c. Cliquez sur Suivant.Click Next.

    Page du référentiel Git source

  6. Dans la page Sélection de la branche, cliquez sur Suivant.On the Branch Selection page, click Next.

    Page Sélection de la branche

  7. Sur la page Destination locale :On the Local Destination page:

    a.a. Spécifiez le dossier local où vous souhaitez placer votre référentiel local.Specify the local folder where you want your local repo.

    b.b. Cliquez sur Suivant.Click Next.

    Page Destination locale

  8. Sur la page Sélectionner un assistant pour l’importation de projets :On the Select a wizard to use for importing projects page:

    a.a. Sélectionnez Importer en tant que projet général.Select Import as a general project.

    b.b. Cliquez sur Suivant.Click Next.

    Page « Sélectionner un assistant pour l’importation de projets »

  9. Sur la page Importer des projets :On the Import Projects page:

    a.a. Spécifiez le nom de votre projet.Specify your project name.

    b.b. Cliquez sur Terminer.Click Finish.

    Page Importer des projets

  10. Une fois le référentiel cloné avec succès, tous les fichiers répertoriés dans Eclipse sont visibles.When the repository is cloned successfully, you see all the files listed in Eclipse.

    Référentiel local

Créer un projet Maven à partir de votre référentiel localCreate a Maven project from your local repository

Le référentiel Spring Boot Docker contient un projet Maven terminé à utiliser pour ce didacticiel.The Spring Boot Docker repository contains a completed Maven project, which you will use for this tutorial.

  1. Cliquez sur Fichier > Importer.Click File > Import.

    Commande Importer du menu Fichier

  2. Lorsque la boîte de dialogue Importer s’ouvre :When the Import dialog box opens:

    a.a. Développez Maven.Expand Maven.

    b.b. Sélectionnez Projets Maven existants.Select Existing Maven Projects.

    c.c. Cliquez sur Suivant.Click Next.

    Boîte de dialogue Importer

  3. Sur la page Projets Maven :On the Maven Projects page:

    a.a. Pour Répertoire racine, spécifiez le dossier complete dans votre référentiel local.For Root Directory, specify the complete folder in your local repository.

    b.b. Développez la section Avancé, puis entrez un nom personnalisé dans le champ Modèle de nom.Expand the Advanced section, and enter a custom name for Name template.

    c.c. Activez la case à cocher pour le fichier pom.xml dans le projet.Select the box for the pom.xml file in the project.

    d.d. Cliquez sur Terminer.Click Finish.

    Page Projets Maven

  4. Une fois le projet Maven ouvert, vous pouvez voir un deuxième projet répertorié dans Eclipse.When the Maven project is opened successfully, you see a second project listed in Eclipse.

    Projet Maven local

Générer votre application Spring Boot à l’aide de MavenBuild your Spring Boot app by using Maven

  1. Dans l’explorateur de projets d’Eclipse, sélectionnez le projet Maven.In the Eclipse Project Explorer, select the Maven project.

  2. Cliquez sur Exécuter > Exécuter en tant que > build Maven.Click Run > Run As > Maven build.

    Commandes pour exécuter en tant que build Maven

  3. Une fois votre application générée, la fenêtre de console affiche l’état.When your application is successfully built, the console window shows the status.

    Build Maven réussie

Publier votre application web sur Azure en utilisant un conteneur DockerPublish your web app to Azure by using a Docker container

  1. Dans l’explorateur de projets d’Eclipse, sélectionnez le projet Maven.In the Eclipse Project Explorer, select the Maven project.

  2. Cliquez sur le menu Azure Publier, puis sur Publier en tant que conteneur Docker.Click the Azure Publish menu, and then click Publish as Docker Container.

    Commande Publier en tant que conteneur Docker

  3. Lorsque la boîte de dialogue Déploiement de conteneur Docker sur Azure s’affiche :When the Deploying Docker Container on Azure dialog box appears:

    a.a. Entrez un nom d’image Docker personnalisé.Enter a custom Docker image name.

    b.b. Pour Artefact à déployer, spécifiez le chemin d’accès au fichier gs-spring-boot-docker-0.1.0.jar que vous venez de créer.For Artifact to deploy, specify the path to the gs-spring-boot-docker-0.1.0.jar file you just built.

    Spécifiez les options Docker

    Tous les hôtes Docker existants s’affichent.Any existing Docker hosts are displayed.

  4. Si vous choisissez d’effectuer le déploiement sur un hôte existant, vous pouvez passer à l’étape 5.If you choose to deploy to an existing host, you can skip to step 5. Autrement, procédez comme suit pour créer un hôte :Otherwise, use the following steps to create a host:

    a.a. Cliquez sur Add.Click Add.

    Ajouter un nouvel hôte Docker

    b.b. Quand la boîte de dialogue Create Docker Host (Créer un hôte Docker) apparaît, vous pouvez accepter les valeurs par défaut ou spécifier divers paramètres personnalisés pour votre nouvel hôte DockerWhen the Create Docker Host dialog box appears, you can choose to accept the defaults, or you can specify any custom settings for your new Docker host. (pour des descriptions détaillées des différents paramètres, consultez Publier une application web en tant que conteneur Docker à l’aide d’Azure Toolkit for IntelliJ). Cliquez sur Next une fois que vous avez spécifié les paramètres à utiliser.(For detailed descriptions of the various settings, see Publish a web app as a Docker container by using the Azure Toolkit for IntelliJ.) Click Next when you have specified which settings to use.

    Spécifier les options de l’hôte Docker

    c.c. Vous pouvez utiliser des identifiants de connexion existants d’un coffre de clés Azure, ou entrer de nouveaux identifiants de connexion Docker.You can choose to use existing login credentials from an Azure key vault, or you can choose to enter new Docker login credentials. Cliquez sur Finish une fois que vous avez spécifié vos options.Click Finish when you have specified your options.

    Spécifier les identifiants de connexion à l’hôte Docker

  5. Sélectionnez votre hôte Docker, puis cliquez sur Suivant.Select your Docker host, and then click Next.

    Sélectionner l’hôte Docker à utiliser

  6. Dans la dernière page de la boîte de dialogue Déploiement de conteneur Docker sur Azure, vous devez spécifier les options suivantes :On the last page of the Deploying Docker Container on Azure dialog box, specify the following options:

    a.a. Vous pouvez spécifier un nom personnalisé pour le conteneur qui doit héberger votre conteneur Docker, ou accepter le nom par défaut.You can choose to specify a custom name for the container that will host your Docker container, or you can accept the default.

    b.b. Entrez les ports TCP de votre hôte Docker en utilisant la syntaxe suivante : «  [port externe] : [port interne] .Enter the TCP ports for your docker host by using the following syntax: [external port]:[internal port]. Par exemple, dans 80:8080, 80 est un port externe et 8080 le port interne par défaut de Spring Boot.For example, 80:8080 specifies an external port of 80 and the default internal Spring Boot port of 8080.

    Si vous avez personnalisé le port interne (par exemple, en modifiant le fichier application.yml), vous devez spécifier le numéro de port pour que le routage dans Azure soit correct.If you have customized your internal port (for example, by editing the application.yml file), you need to specify the port number for the correct routing to occur in Azure.

    c.c. Après avoir configuré ces options, cliquez sur Terminer.After you configure these options, click Finish.

    Déployer un conteneur Docker dans Azure

  7. Une fois que le kit de ressources Azure a terminé la publication, le journal d’activité d’Azure affiche le statut Publié.When the Azure Toolkit has finished publishing, the Azure Activity Log displays Published for the status.

    Déploiement réussi de l’hôte Docker

Étapes suivantesNext steps

Pour obtenir des ressources supplémentaires pour Docker, consultez le Site web de Docker.For additional resources for Docker, see the official Docker website.

Pour signaler des bogues ou demander de nouvelles fonctionnalités, créez une entrée dans notre dépôt GitHub.To report bugs or request new features, create issues on our GitHub repository. Vous pouvez aussi poser des questions sur Stack Overflow avec la balise azure-java-tools.Or, ask questions on Stack Overflow with tag azure-java-tools.

Pour plus d’informations sur l’utilisation de Java avec Azure, consultez les liens suivants :For more information about using Java with Azure, see the following links: