Documentation sur Oracle Cloud Infrastructure

Offre de gratuité : Installer Node Express 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 Node Express 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 NodeJS avec un cadre Express sur votre instance.

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

Schéma des composants nécessaires pour exécuter une application NodeJS avec un cadre Express sur Oracle Cloud Infrastructure

Pour plus d'informations, voir :

Étapes préliminaires

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

Exigences

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. Se connecter à 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 : Compartment for <your-description>.
    • compartiment parent : <your-tenancy>(root)
  5. Cliquez sur Créer un compartiment.

Inférence : Créez un compartiment

2. Installer un réseau en nuage virtuel

Utilisez le flux de travail Démarrer l'Assistant 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 réseaux VCN et des sous-réseaux.

Étapes d'installation

Pour créer un VCN, procédez comme suit :

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 du menu de navigation de gauche.
  3. Cliquez sur Démarrer l'Assistant VCN.
  4. Sélectionnez Créer un 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 du type d'adresse IP et du bloc CIDR IPv4 CIDR.

    Configurer le sous-réseau privé

    • Conservez les valeurs par défaut du type d'adresse IP et du bloc CIDR IPv4 CIDR.
  7. Cliquez sur Suivant.
  8. Vérifiez 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 moment.

    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 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 un nom pour 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

    Utilisez l'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 une machine virtuelle.
    • Pour la série de formes, sélectionnez Ampère.
    • 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 les 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 : Affectée automatiquement 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 Créer 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 du service Volumes par blocs. Utilisez les valeurs par défaut fournies par le flux de travail qui ne sélectionne aucun volume par blocs. Vous pouvez ajouter des volumes par blocs ultérieurement.
  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 3000.

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 sur Service de réseau, puis sur 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 : 3000
    • 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 Node Express.
Vous avez créé une règle de trafic entrant qui rend votre instance disponible à partir d'Internet.

5. Créer une application Node Express

À présent, configurez un cadre Express sur votre instance Oracle Linux, puis créez et exécutez une application NodeJS.

Installer et configurer Node Express

Procédez de la façon suivante pour configurer votre instance et créer votre application :

  1. Ouvrez le menu de navigation et cliquez sur Environnement de 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. Copiez 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 pour ce tutoriel.
  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 la connexion HTTP sur le port 3000. 
    
sudo firewall-cmd --permanent --add-port=3000/tcp
    sudo firewall-cmd --reload
  7. Installez la version la plus récente de NodeJS. 
    sudo yum update
    sudo yum install -y nodejs
    node --version
  8. Créez un répertoire pour votre application. 
    mkdir node-hello-app
  9. Accédez au répertoire node-hello-app. 
    cd node-hello-app
  10. Utilisez npm pour créer un fichier package.json : 
    npm init

    Entrez les informations suivantes :

    • name : node-hello-app
    • version : 1.0.0
    • description : Node Express Hello application
    • entry point : app.js (N'utilisez pas la valeur par défaut.)
    • test command : (Laissez vide)
    • git repository : git://github.com/username/repository.git (ou remplacez cette valeur par un référentiel git valide)
    • keywords : (Laissez vide)
    • auteur : Exemple d'utilisateur <username@example.com>
    • license : UPL-1.0

    Prévisualisation du contenu de package.json.

    About to write to /home/opc/node-hello-app/package.json:

{
  "name": "node-hello-app",
  "version": "1.0.0",
  "description": "Node Express Hello application",
  "main": "app.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "repository": {
    "type": "git",
    "url": "git://github.com/username/repository.git"
  },
  "author": "Example User <username@example.com>",
  "license": "UPL-1.0",
  "bugs": {
    "url": "https://github.com/username/repository/issues"
  },
  "homepage": "https://github.com/username/repository#readme"
}

    Entrez yes pour approuver vos réponses.

  11. Installez Express et enregistrez-le dans la liste des dépendances de package.json. 
    npm install express --save
  12. Vérifiez qu'Express est ajouté en tant que dépendance dans package.json. 
    cat package.json
    "dependencies": {
    "express": "^4.17.1"
}
  13. Créez une application "Hello, World!".

    Créez le fichier :

    vi app.js

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

    const express = require('express')
const app = express()

app.get('/', function (req, res) {
  res.send('Hello World!')
})

app.listen(3000, function() {
  console.log('Hello World app listening on port 3000!');
})
  14. Exécutez le programme NodeJS : 
    node app.js
  15. Testez l'application à l'aide de la ligne de commande ou d'un navigateur :
    • Pour tester l'application avec curl, à partir d'un nouveau terminal, connectez-vous à votre instance Ubuntu avec vos clés SSH, puis entrez ce qui suit dans la ligne de commande : curl -X GET http://localhost:3000
    • Dans un navigateur, connectez-vous à l'adresse IP publique affectée à votre instance : http://<x.x.x.x>:3000
    L'application Node retourne Hello World! sur votre instance ou dans votre navigateur.

Vous avez créé une application NodeJS locale sur une instance Oracle Cloud Infrastructure à l'aide d'un cadre Express.

Références :

Pour plus d'informations sur Express, voir :