Documentation sur Oracle Cloud Infrastructure

Offre de gratuité : Installer Spring Boot sur une instance Oracle Linux

Dans ce tutoriel, vous utiliserez un compte Oracle Cloud Infrastructure gratuit pour configurer une instance de calcul Oracle Linux. Ensuite, vous installerez une application Spring Boot et accéderez à votre nouvelle application à partir d'Internet. Enfin, ce tutoriel présentera toutes les étapes nécessaires pour configurer un réseau virtuel pour votre hôte et connecter l'hôte à Internet.

Voici les principales tâches :

  • Configurer un compartiment pour vos activités de développement.
  • Installer votre instance Oracle Linux et la connecter à votre réseau en nuage virtuel (VCN).
    • Configurez un réseau en nuage virtuel Oracle Cloud Infrastructure et les services de réseau connexes nécessaires pour que votre hôte puisse se connecter à Internet.
    • Configurez des clés de chiffrement ssh pour accéder à votre serveur Oracle Linux.
  • Configurer les règles de trafic entrant pour votre VCN.
  • Configurer Spring Boot sur votre instance.
  • Vous connecter à votre instance à partir d'Internet.

Voici un schéma simplifié de la configuration de votre instance Linux.

Schéma des composants nécessaires pour exécuter une application Spring Boot sur Oracle Cloud Infrastructure

Pour plus d'informations, voir :

Étapes préliminaires

Pour suivre ce tutoriel, vous devez disposer des éléments suivants :

Conditions requises

1. Configurer un compartiment à des fins de développement

Configurez un compartiment pour vos activités de développement.

Créer un compartiment

Créez un compartiment pour les ressources que vous allez créer dans ce tutoriel.

  1. Connectez-vous à la console Oracle Cloud Infrastructure.
  2. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Compartiments.
  3. Cliquez sur Créer un compartiment.
  4. Entrez les informations suivantes :
    • Nom : <your-compartment-name>
    • Description : Compartiment pour <your-description>.
    • Compartiment parent : <your-tenancy>(root)
  5. Cliquez sur Créer un compartiment.

Informations de référence : Créer un compartiment

2. Installer un réseau en nuage virtuel

Utilisez le flux de travail Démarrer l'assistant de VCN pour créer un nouveau réseau en nuage virtuel (VCN).

Le flux de travail effectue plusieurs opérations lors de l'installation du VCN :

  • Crée un réseau VCN.
  • Ajoute une passerelle Internet qui active les connexions Internet.
  • Crée et configure des sous-réseaux publics et privés pour le VCN.
  • Permet de configurer les tables de routage et les listes de sécurité pour les sous-réseaux.

Pour plus d'informations sur les réseaux en nuage virtuels, voir Gestion des VCN et des sous-réseaux.

Étapes d'installation

Pour créer un réseau VCN, procédez de la façon suivante :

Important

Les étapes fournies concernent un compte gratuit. Si vous utilisez un compte payant, les étapes peuvent différer de celles présentées ici.
  1. Ouvrez le menu de navigation , sélectionnez Service de réseau, puis Réseaux en nuage virtuels.
  2. Si nécessaire, sélectionnez votre compartiment dans le contrôle Compartiment dans la barre de navigation de gauche.
  3. Cliquez sur Démarrer l'Assistant VCN.
  4. Sélectionnez Créer un réseau VCN avec connectivité Internet.
  5. Cliquez sur Démarrer l'Assistant VCN.
  6. Configurez le VCN. La boîte de dialogue de configuration contient les sections suivantes.

    Informations de base

    Entrez le nom du VCN et sélectionnez un compartiment.

    • Nom : <name-for-the-vcn>

      Entrez un nom pour votre VCN. Évitez d'entrer des informations confidentielles.

    • compartiment : <your-compartment-name>

      Sélectionnez votre compartiment.

    Configurer le VCN

    • Conservez les valeurs par défaut pour le bloc IPv4 CIDR du VCN et la résolution DNS.

    Configurer le sous-réseau public

    • Conservez les valeurs par défaut pour le type d'adresse IP et le bloc CIDRIPv4 CIDR IPv4.

    Configurer le sous-réseau privé

    • Conservez les valeurs par défaut pour le type d'adresse IP et le bloc CIDRIPv4 CIDR IPv4.
  7. Cliquez sur Suivant.
  8. Révisez vos sélections. Cliquez sur Précédent pour revenir en arrière et apporter des modifications.
  9. Cliquez sur Créer pour créer le VCN.

    Le système crée le VCN et toutes ses ressources. Cela peut prendre un certain temps.

    Une fois la création terminée, cliquez sur Voir le VCN pour voir votre nouveau VCN.

3. Installer une instance Oracle Linux

Utilisez le flux de travail Créer une instance de machine virtuelle pour créer une nouvelle instance de calcul.

Le flux de travail effectue plusieurs opérations lors de l'installation de l'instance :

  • Il crée et installe une instance de calcul exécutant Oracle Linux.
  • Sélectionnez votre réseau VCN et votre sous-réseau public pour connecter l'instance Oracle Linux à Internet.
  • Il crée une paire de clés ssh que vous utiliserez pour vous connecter à l'instance.
Étapes d'installation

Pour commencer à installer une instance à l'aide du flux de travail Créer une instance de machine virtuelle, procédez de la façon suivante :

Important

Les étapes fournies concernent un compte gratuit. Si vous utilisez un compte payant, les étapes peuvent différer de celles présentées ici.
  1. Ouvrez le menu de navigation et sélectionnez Calcul. Sous Calcul, sélectionnez Instances.
  2. Cliquez sur Créer une instance.

    La page Créer une instance de calcul s'affiche.

  3. Sélectionnez le nom et le compartiment.

    Options initiales

    • Nom : <name-for-the-instance>

      Entrez le nom de votre instance. Évitez d'entrer des informations confidentielles.

    • Créer dans le compartiment : <your-compartment-name>

      Sélectionnez votre compartiment. Utilisez le compartiment créé à l'étape précédente.

  4. Vérifiez les paramètres Positionnement.
    • Utilisez les valeurs par défaut. Un domaine de disponibilité vous est affecté.

    Les valeurs par défaut sont les suivantes :

    • Domaine de disponibilité : AD-1
    • Type de capacité : Capacité sur demande
    • Domaine d'erreur : Laisser Oracle choisir le meilleur domaine d'erreur
    Note

    Pour l'offre de gratuité, utilisez Option Toujours gratuit disponible pour le domaine de disponibilité.
  5. Vérifiez les paramètres Sécurité.
    • Utilisez les paramètres par défaut.

    Les valeurs par défaut sont les suivantes :

    • instance dotée d'une protection maximale : désactivée
    • Calcul confidentiel : Désactivé
  6. Vérifiez les paramètres Image et forme. Cliquez sur Modifier.
    Note

    Voici des exemples de données pour une machine virtuelle Ampere A1. Les valeurs réelles peuvent être différentes.
    • Conservez l'image Oracle Linux 8 par défaut.
    • Cliquez sur Modifier la forme.
    • Sélectionnez Machine virtuelle.
    • Pour les séries de formes, sélectionnez Ampere.
    • Sélectionnez VM.Standard.A1. Flex la forme "Toujours gratuit".
    • Sélectionnez 1 OCPU.
    • Cliquez sur Sélectionner une forme.

    Les valeurs sélectionnées sont similaires aux suivantes :

    • Image : Oracle Linux 8
    • Sous-version de l'image : <current-build-date>
    • Forme : VM.Standard.A1. Champ flexible
    • OCPU : 1
    • Mémoire (Go) : 6
    • Bande passante de réseau (Gbit/s) : 1
    Note

    Pour l'offre de gratuité, utilisez les options de forme Option Toujours gratuit disponible.
  7. Vérifiez les paramètres du service Réseau. Sélectionnez le VCN que vous avez créé à l'étape précédente. Les valeurs de réseau sont similaires aux suivantes :
    • Réseau en nuage virtuel : <your-vcn>
    • Sous-réseau : <pubic-subnet-for-your-vcn>
    • Options de lancement : -
    • Enregistrement DNS : Oui
    • Utiliser les groupes de sécurité de réseau pour contrôler le trafic : Non
    • Affecter une adresse IPv4 publique : Oui
    • Adresse IPv4 privée : Affectation automatique lors de la création
    • adresse IPv6 : Non disponible
  8. Vérifiez les paramètres Ajouter des clés SSH. Utilisez les valeurs par défaut fournies par le flux de travail.
    • Sélectionnez l'option Générer une paire de clés pour moi.
    • Cliquez sur Enregistrer la clé privée et Enregistrer la clé publique pour enregistrer les clés SSH privée et publique pour cette instance de calcul.

    Si vous souhaitez utiliser vos propres clés SSH, sélectionnez l'une des options pour fournir votre clé publique.

    Note

    Placez vos fichiers de clé privée et publique dans un endroit sûr. Vous ne pourrez pas extraire de nouveau les clés une fois l'instance de calcul créée.
  9. Vérifiez les paramètres Volume de démarrage.

    Sélectionnez le paramètre Utiliser le chiffrement en transit. Laissez les deux autres paramètres vides.

  10. Vérifiez les paramètres Volumes par blocs. Utilisez les valeurs par défaut fournies par le flux de travail qui ne sélectionne aucun volume par blocs. Vous pourrez ajouter des volumes par blocs plus tard.
  11. Cliquez sur Créer pour créer l'instance. Le provisionnement du système peut prendre plusieurs minutes.

Vous avez créé une instance Oracle Linux pour exécuter un serveur Web Apache.

4. Activer l'accès Internet

L'Assistant Créer une instance de machine virtuelle crée automatiquement un VCN pour votre instance. Vous ajoutez une règle de trafic entrant à votre sous-réseau pour autoriser les connexions Internet sur le port 8080.

Créer une règle de trafic entrant pour votre VCN

Procédez de la façon suivante pour sélectionner le sous-réseau public de votre VCN et ajouter la règle de trafic entrant.

  1. Ouvrez le menu de navigation et cliquez successivement sur Service de réseau et Réseaux en nuage virtuels.
  2. Sélectionnez le VCN que vous avez créé.
  3. Maintenant que votre nouveau VCN est affiché, cliquez sur le lien de sous-réseau <your-subnet-name>.

    Les informations sur le sous-réseau public s'affichent avec les listes de sécurité au bas de la page. Un lien vers la liste de sécurité par défaut de votre VCN est présent.

  4. Cliquez sur le lien Liste de sécurité par défaut.

    Les règles de trafic entrant par défaut pour votre VCN s'affichent.

  5. Cliquez sur Ajouter des règles de trafic entrant.

    Une boîte de dialogue Ajouter des règles de trafic entrant s'affiche.

  6. Entrez les informations suivantes pour la règle de trafic entrant.

    Définissez la règle de trafic entrant comme suit :

    • Sans état : Coché
    • Type de source : CIDR
    • CIDR source : 0.0.0.0/0
    • Protocole IP : TCP
    • Intervalle de ports sources : (Laissez vide)
    • Intervalle de ports de destination : 8080
    • Description : Autoriser les connexions HTTP
  7. Cliquez sur Ajouter des règles de trafic entrant.
    À présent, les connexions HTTP sont autorisées. Votre VCN est configuré pour Spring Boot.
Vous avez créé une règle de trafic entrant qui rend votre instance disponible à partir d'Internet.

5. Installer et configurer Spring Boot

À présent, installez tous les logiciels nécessaires à votre application Spring Boot.

Configurer le port pour votre instance
  1. Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances.
  2. Cliquez sur le lien vers l'instance que vous avez créée à l'étape précédente.

    Dans la page Détails de l'instance, consultez la section Accès à l'instance. Notez l'adresse IP publique que le système a créée pour vous. Vous utiliserez cette adresse IP pour vous connecter à votre instance.

  3. Ouvrez une fenêtre de terminal ou d'invite de commande.
  4. Accédez au répertoire dans lequel vous avez stocké les clés de chiffrement ssh que vous avez créées.
  5. Connectez-vous à votre instance à l'aide de cette commande SSH 
    ssh -i <your-private-key-file> opc@<x.x.x.x>

    Puisque vous avez identifié votre clé publique lors de la création de l'instance, cette commande vous connecte à votre instance. Vous pouvez maintenant exécuter des commandes sudo pour installer et démarrer votre serveur.

  6. Activez une connexion HTTP sur le port 8080. 
    sudo firewall-cmd --permanent --add-port=8080/tcp
    sudo firewall-cmd --reload

Le pare-feu est configuré pour Spring Boot.

Installer Git

Installez Git v2 à l'aide du projet communautaire IUS (https://ius.io/). Naviguez jusqu'à la version courante de l'ensemble principal Git et téléchargez-la dans un répertoire ~/temp.

  1. Par exemple, la commande de téléchargement du RPM pour Git ressemble à ce qui suit. 
    cd
mkdir temp
cd ~/temp
wget https://repo.ius.io/7/x86_64/packages/g/git224-core-2.24.2-1.el7.ius.x86_64.rpm
  2. Installez le RPM à l'aide de yum. 
    sudo yum install git224-core-2.24.2-1.el7.ius.x86_64.rpm
  3. Testez le résultat. 
    git --version
git version 2.24.2

Git est installé.

Installer JDK 8
  1. Installez OpenJDK 8 à l'aide de yum. 
    sudo yum install java-1.8.0-openjdk-devel
java -version
  2. Définissez JAVA_HOME dans .bashrc.

    Mettez à jour le fichier :

    vi ~/.bashrc

    Saisissez le texte suivant dans le fichier et enregistrez celui-ci :

    # set JAVA_HOME
export JAVA_HOME=/etc/alternatives/java_sdk

    Activez la commande précédente dans la fenêtre courante.

    source ~/.bashrc

Java est installé.

Installer Maven 3.6

Installez Maven à partir d'un miroir Apache. Accédez à la page de téléchargement principale du site Maven (https://maven.apache.org/). Obtenez l'URL de la dernière version et téléchargez celle-ci à l'aide de wget.

  1. Téléchargez le fichier zip Maven, par exemple : 
    wget http://apache.mirrors.pair.com/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
  2. Extrayez les fichiers programme. 
    sudo tar xvfz apache-maven-3.6.3-bin.tar.gz
  3. Installez les fichiers programme en les déplaçant vers le répertoire /opt. 
    sudo mv apache-maven-3.6.3 /opt/
  4. Ajoutez le chemin Maven /opt/apache-maven-3.6.3/bin à votre variable d'environnement PATH et exécutez .bashrc. 
    vi ~/.bashrc
export PATH=$PATH:/opt/apache-maven-3.6.3/bin
source ~/.bashrc

Maven est prêt à être utilisé.

Créer votre application Spring Boot

Procédez de la façon suivante pour configurer votre application Spring Boot :

  1. À partir de votre répertoire de base, consultez le guide Spring Boot avec Docker à l'aide de Git : 
    git clone http://github.com/spring-guides/gs-spring-boot-docker.git
  2. Accédez au répertoire gs-spring-boot-docker/initial.
  3. Modifiez le fichier Application.java : src/main/java/hello/Application.java.
  4. Mettez à jour le code de la façon suivante : 
    
package hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class Application {

    @RequestMapping
    public String home(){
        return "<h1>Spring Boot Hello World!</h1>";
    }
    
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
    
}
  5. Enregistrez le fichier.
  6. Utilisez Maven pour créer l'application. 
    mvn package

    Vous obtenez un message de réussite.

    [INFO] BUILD SUCCESS
  7. Exécutez l'application. 
    java -jar target/gs-spring-boot-docker-0.1.0.jar
  8. Testez votre application à partir de la ligne de commande ou d'un navigateur.
    • À partir d'un nouveau terminal, connectez-vous à votre instance avec vos clés SSH et testez l'application à l'aide de curl :
      curl -X GET http://localhost:8080
    • Dans un navigateur, connectez-vous à l'adresse IP publique affectée à votre instance : http://<x.x.x.x>:8080.

    Spring Boot Hello World! s'affiche sur votre instance ou dans votre navigateur.

Félicitations! Vous avez créé une application Spring Boot sur votre instance.