QuickStart: Déployer une application Java sur Elastic Beanstalk

Ce QuickStart didacticiel explique le processus de création d'une application Java et de son déploiement sur un AWS Elastic Beanstalk environnement.

Note

Ce QuickStart didacticiel est destiné à des fins de démonstration. N'utilisez pas l'application créée dans ce didacticiel pour le trafic de production.

Votre AWS compte

Si vous n'êtes pas déjà AWS client, vous devez créer un AWS . L'inscription vous permet d'accéder à Elastic Beanstalk et à d'autres AWS les services dont vous avez besoin.

Si vous possédez déjà un AWS compte, vous pouvez passer àPrérequis.

Créez un AWS compte

Inscrivez-vous pour un Compte AWS

Si vous n'avez pas de Compte AWS, procédez comme suit pour en créer un.

Pour vous inscrire à un Compte AWS

1. Ouvrez l'https://portal.aws.amazon.com/billing/inscription.

2. Suivez les instructions en ligne.

   Dans le cadre de la procédure d‘inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.

   Lorsque vous vous inscrivez à un Compte AWS, une Utilisateur racine d'un compte AWSest créé. L'utilisateur root a accès à tous Services AWS et les ressources du compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l‘utilisateur racine pour effectuer les tâches nécessitant un accès utilisateur racine.

AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à https://aws.amazon.com/et en choisissant Mon compte.

Création d'un utilisateur doté d'un accès administratif

Une fois que vous vous êtes inscrit à un Compte AWS, sécurisez votre Utilisateur racine d'un compte AWS, activer AWS IAM Identity Center, et créez un utilisateur administratif afin de ne pas utiliser l'utilisateur root pour les tâches quotidiennes.

Sécurisez votre Utilisateur racine d'un compte AWS

1. Connectez-vous au AWS Management Consoleen tant que propriétaire du compte en choisissant Utilisateur root et en saisissant votre Compte AWS adresse e-mail. Sur la page suivante, saisissez votre mot de passe.

   Pour obtenir de l'aide pour vous connecter à l'aide de l'utilisateur root, consultez la section Connexion en tant qu'utilisateur root dans Connexion à AWS Guide de l'utilisateur.

2. Activez l'authentification multifactorielle (MFA) pour votre utilisateur root.

   Pour obtenir des instructions, voir Activer un MFA appareil virtuel pour votre Compte AWS utilisateur root (console) dans le guide de IAM l'utilisateur.

Création d'un utilisateur doté d'un accès administratif

1. Activez IAM Identity Center.

   Pour obtenir des instructions, voir Activation AWS IAM Identity Center dans le .AWS IAM Identity Center Guide de l'utilisateur.

2. Dans IAM Identity Center, accordez un accès administratif à un utilisateur.

   Pour un didacticiel sur l'utilisation du Répertoire IAM Identity Center comme source d'identité, voir Configurer l'accès utilisateur avec la valeur par défaut Répertoire IAM Identity Center dans le .AWS IAM Identity Center Guide de l'utilisateur.

Connexion en tant qu‘utilisateur doté d'un accès administratif

• Pour vous connecter avec votre utilisateur IAM Identity Center, utilisez l'URLidentifiant envoyé à votre adresse e-mail lorsque vous avez créé l'utilisateur IAM Identity Center.

  Pour obtenir de l'aide pour vous connecter à l'aide d'un utilisateur d'IAMIdentity Center, consultez la section Connexion au AWS portail d'accès dans le Connexion à AWS Guide de l'utilisateur.

Attribution d'un accès à d'autres utilisateurs

1. Dans IAM Identity Center, créez un ensemble d'autorisations conforme à la meilleure pratique consistant à appliquer les autorisations du moindre privilège.

   Pour obtenir des instructions, voir Créer un ensemble d'autorisations dans AWS IAM Identity Center Guide de l'utilisateur.

2. Attribuez des utilisateurs à un groupe, puis attribuez un accès par authentification unique au groupe.

   Pour obtenir des instructions, voir Ajouter des groupes dans AWS IAM Identity Center Guide de l'utilisateur.

Prérequis

Pour suivre les procédures décrites dans ce guide, vous aurez besoin d'un shell ou d'un terminal de ligne de commande pour exécuter des commandes. Dans les listes, les commandes sont précédées d'un symbole d'invite ($) et du nom du répertoire actuel, le cas échéant.

~/eb-project$ this is a command
this is output

Sous Linux et macOS, vous pouvez utiliser le shell et le gestionnaire de package de votre choix. Sur Windows, vous pouvez installer le sous-système Windows pour Linux afin d'obtenir une version intégrée à Windows d'Ubuntu et de Bash.

EB CLI

Ce didacticiel utilise l'interface de ligne de commande (EB) d'Elastic Beanstalk. CLI Pour plus de détails sur l'installation et la configuration de l'EBCLI, reportez-vous Installation de l'interface de ligne de commande Elastic Beanstalk aux sections etConfiguration de l'interface de ligne de commande EB.

Java et Maven

Si Amazon Corretto n'est pas installé sur votre machine locale, vous pouvez l'installer en suivant les instructions d'installation du guide de l'utilisateur d'Amazon Corretto.

Vérifiez votre installation Java en exécutant la commande suivante.

~$ java -version 

Ce didacticiel utilise Maven. Suivez les instructions de téléchargement et d'installation sur le site Web du projet Apache Maven. Pour plus d'informations sur Maven, consultez le centre des utilisateurs de Maven sur le site Web du projet Apache Maven.

Vérifiez votre installation Maven en exécutant la commande suivante.

~$ mvn -v

Étape 1 : Création d'une application Java

Créez un répertoire de projet.

~$ mkdir eb-java
~$ cd eb-java

Créez ensuite une application qui vous allez déployer à l'aide d'Elastic Beanstalk. Nous allons créer un service RESTful Web « Hello World ».

Cet exemple utilise le framework Spring Boot. Cette application ouvre un écouteur sur le port 5000. Elastic Beanstalk transmet les demandes à votre application sur le port 5000 par défaut.

Créez les fichiers suivants :

Ce fichier crée une application Spring Boot simple.

Exemple ~/eb-java/src/main/java/com/example/Application.java

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Ce fichier crée un mappage qui renvoie une chaîne que nous définissons ici.

Exemple ~/eb-java/src/main/java/com/example/Controller.java

package com.example;
    
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
    
@RestController
public class Controller {
    
    @GetMapping("/")
    public String index() {
       return "Hello Elastic Beanstalk!";
    }
}

Ce fichier définit la configuration du projet Maven.

Exemple ~/eb-java/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.3</version>
  </parent>

  <groupId>com.example</groupId>
  <artifactId>BeanstalkJavaExample</artifactId>
  <version>1.0-SNAPSHOT</version>

  <properties>
    <java.version>21</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

Ce fichier de propriétés remplace le port par défaut qui est 5000. Il s'agit du port par défaut vers lequel Elastic Beanstalk envoie le trafic pour les applications Java.

Exemple ~/eb-java/application.properties

server.port=5000

Étape 2 : Exécutez votre application localement

Package de votre application à l'aide de la commande suivante :

~/eb-java$ mvn clean package

Exécutez votre application localement à l'aide de la commande suivante :

~/eb-java$ java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

Pendant que l'application est en cours d'exécution, naviguez jusqu'à http://127.0.0.1:5000/ dans votre navigateur. Vous devriez voir le texte « Hello Elastic Beanstalk ! ».

Étape 3 : Déployez votre application Java avec l'EB CLI

Avant de déployer votre application Java sur Elastic Beanstalk, nettoyons l'application de compilation de votre répertoire et créons un Buildfile et un Procfile pour contrôler la façon dont l'application est créée et exécutée dans votre environnement Elastic Beanstalk.

Pour préparer et configurer le déploiement de l'application

1. Nettoyez l'application créée.

   ~/eb-java$ mvn clean

2. Créez votre Buildfile.

   Exemple ~/eb-java/Buildfile

   build: mvn clean package

   Ceci Buildfile indique la commande utilisée pour créer votre application. Si vous n'incluez pas un Buildfile pour une application Java, Elastic Beanstalk n'essaie pas de créer votre application.

3. Créez votre Procfile.

   Exemple ~/eb-java/Procfile

   web: java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

   Ceci Procfile indique la commande utilisée pour exécuter votre application. Si vous n'incluez pas de fichier Procfile pour une application Java, Elastic Beanstalk part du principe qu'il JAR existe un fichier à la racine de votre bundle source et essaie de l'exécuter à l'aide de la commande. java -jar

Maintenant que vous avez configuré les fichiers de configuration pour créer et démarrer votre application, vous êtes prêt à la déployer.

Pour créer un environnement et déployer votre application Java

1. Initialisez votre CLI référentiel EB à l'aide de la eb init commande.

   ~/eb-java eb init -p corretto java-tutorial --region us-east-2
           
   Application java-tutorial has been created.

   Cette commande crée une application nommée java-tutorial et configure votre dépôt local pour créer des environnements dotés de la dernière version de la plateforme Java.

2. (Facultatif) Exécutez à eb init nouveau pour configurer une paire de clés par défaut que vous pourrez utiliser SSH pour vous connecter à l'EC2instance qui exécute votre application.

   ~/eb-java$ eb init
   Do you want to set up SSH for your instances?
   (y/n): y
   Select a keypair.
   1) my-keypair
   2) [ Create new KeyPair ]

   Sélectionnez une paire de clés si vous en avez déjà une, ou suivez les invites pour en créer une. Si vous ne voyez pas l'invite ou que vous avez besoin de modifier vos paramètres ultérieurement, exécutez eb init -i.

3. Créez un environnement et déployez-y votre application avec eb create. Elastic Beanstalk crée automatiquement un fichier zip pour votre application et le démarre sur le port 5000.

   ~/eb-java$ eb create java-env

   Il faut environ cinq minutes à Elastic Beanstalk pour créer votre environnement.

Étape 4 : Exécutez votre application sur Elastic Beanstalk

Lorsque le processus de création de votre environnement est terminé, ouvrez votre site Web aveceb open.

~/eb-java eb open

Félicitations ! Vous avez déployé une application Java avec Elastic Beanstalk ! Celle-ci ouvre une fenêtre de navigation en utilisant le nom de domaine créé pour votre application.

Étape 5 : nettoyer

Vous pouvez mettre fin à votre environnement lorsque vous avez fini d'utiliser votre application. Elastic Beanstalk met fin à tout AWS ressources associées à votre environnement.

Pour mettre fin à votre environnement Elastic Beanstalk avec l'EB, exécutez CLI la commande suivante.

~/eb-java$ eb terminate

AWS ressources pour votre application

Vous venez de créer une application à instance unique. Il s'agit d'un exemple d'application simple avec une seule EC2 instance, il ne nécessite donc pas d'équilibrage de charge ni de dimensionnement automatique. Pour les applications à instance unique, Elastic Beanstalk crée les éléments suivants : AWS ressources :

• EC2instance — Une machine EC2 virtuelle Amazon configurée pour exécuter des applications Web sur la plateforme de votre choix.

  Chaque plateforme exécute un ensemble distinct de logiciels, de fichiers de configuration et de scripts pour prendre en charge une version de langage, une infrastructure ou un conteneur web spécifiques, ou une combinaison de ces éléments. La plupart des plateformes utilisent Apache ou nginx comme proxy inverse qui traite le trafic web devant votre application web, lui transmet les demandes, traite les ressources statiques et génère des journaux d'accès et d'erreurs.

• Groupe de sécurité d'instance : groupe EC2 de sécurité Amazon configuré pour autoriser le trafic entrant sur le port 80. Cette ressource permet au HTTP trafic provenant de l'équilibreur de charge d'atteindre l'EC2instance qui exécute votre application Web. Par défaut, le trafic n'est pas autorisé sur les autres ports.

• Compartiment Amazon S3 – Emplacement de stockage pour votre code source, les journaux et autres artefacts qui sont créés lorsque vous utilisez Elastic Beanstalk.

• CloudWatch Alarmes Amazon : deux CloudWatch alarmes qui surveillent la charge sur les instances de votre environnement et sont déclenchées si la charge est trop élevée ou trop faible. Lorsqu'une alarme est déclenchée, votre groupe Auto Scaling s'adapte en fonction, à la hausse ou à la baisse.

• AWS CloudFormation stack — Elastic Beanstalk utilise AWS CloudFormation pour lancer les ressources de votre environnement et propager les modifications de configuration. Les ressources sont définies dans un modèle que vous pouvez consulter dans AWS CloudFormation console.

• Nom de domaine : nom de domaine qui permet d'accéder à votre application Web sous la forme subdomain.region.elasticbeanstalk.com.

Elastic Beanstalk gère toutes ces ressources. Lorsque vous arrêtez votre environnement, Elastic Beanstalk arrête toutes les ressources qu'il contient.

Étapes suivantes

Dès que vous disposez d'un environnement exécutant une application, vous pouvez à tout moment déployer une nouvelle version de l'application ou une application totalement différente. Le déploiement d'une nouvelle version d'application est très rapide car il ne nécessite ni le provisionnement ni le redémarrage des instances. EC2 Vous pouvez également explorer votre nouvel environnement à l'aide de la console Elastic Beanstalk. Pour connaître les étapes détaillées, consultez la section Explorez votre environnement dans le chapitre Mise en route de ce guide.

Essayez d'autres didacticiels

Si vous souhaitez essayer d'autres didacticiels avec différents exemples d'applications, consultezExemples d'applications et de didacticiels.

Une fois que vous avez déployé un ou deux exemples d'applications et que vous êtes prêt à commencer à développer et à exécuter des applications Java en local, voirConfiguration de votre environnement de développement Java.

Déployez avec la console Elastic Beanstalk

Vous pouvez également utiliser la console Elastic Beanstalk pour lancer l'exemple d'application. Pour connaître les étapes détaillées, voir Création d'un exemple d'application dans le chapitre Mise en route de ce guide.