Offre de gratuité : Installer Flask sur une machine virtuelle Ubuntu

Dans ce tutoriel, vous utiliserez un compte Oracle Cloud Infrastructure gratuit pour configurer une instance Ubuntu. Ensuite, vous configurerez un environnement virtuel pour votre hôte. Enfin, vous installerez Flask, un cadre d'application Web léger pour Python.

Voici les principales tâches :

Configurer un compartiment pour vos activités de développement.
Installer votre instance Ubuntu 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 Ubuntu Linux.
Configurer les règles de trafic entrant pour votre VCN.
Installer Flask sur votre machine virtuelle.
Créer une application Python Hello World.
Tester votre application.

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

Schéma des composants nécessaires pour exécuter un cadre d'application Web Flask 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

Un compte Oracle Cloud Infrastructure gratuit. Offre de gratuité pour Oracle Cloud Infrastructure.
Un ordinateur MacOS, Linux ou Windows sur lequel la prise en charge ssh est installée.

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.

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

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

2. Installer une instance Ubuntu 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 Ubuntu Linux.
Il crée un VCN avec le sous-réseau requis et les composants nécessaires pour connecter l'instance Ubuntu 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.

Cliquez sur l'icône Oracle Cloud pour accéder à la page de renvoi principale.
- Faites défiler vers le bas jusqu'à Lancer des ressources.
- Sélectionnez le flux de travail Créer une instance de machine virtuelle.
La page Créer une instance de calcul s'affiche. La page comprend les sections suivantes
- Nom et compartiment
- Positionnement
- Sécurité
- Image et forme
- Réseaux
- Ajouter des clés SSH
- Volume de démarrage
Sélectionnez le nom et le compartiment.
Options initiales
- Nom : <name-for-the-instance>
- Créer dans le compartiment : <your-compartment-name>
Entrez une valeur pour le nom ou utilisez la valeur par défaut fournie par le système. Pour le compartiment, sélectionnez celui que vous avez créé.
Vérifiez les paramètres Positionnement.
- Utilisez les valeurs par défaut. Un domaine de disponibilité vous est affecté.
Les données peuvent ressembler à celles-ci :

Domaine de disponibilité
- 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é.
Vérifiez les paramètres Sécurité.
- Utilisez les paramètres par défaut.
Les données peuvent ressembler à celles-ci :

Sécurité
- instance dotée d'une protection maximale : désactivée
- Calcul confidentiel : Désactivé
Vérifiez les paramètres Image et forme. Modifiez l'image du système d'exploitation.
- Cliquez sur Modifier.
- Cliquez sur Modifier l'image.
- Cliquez sur Ubuntu.
- Sélectionnez Canonical Ubuntu 22.04 ou une version ultérieure.
- Cliquez sur Sélectionner une image.
Note

Voici des exemples de données pour une machine virtuelle AMD. Les valeurs réelles peuvent être différentes.

Image et forme
- Image : Canonical Ubuntu 22.04
- Sous-version de l'image : <current-build-date>
- Forme : VM.Standard.E2.1.Micro
- OCPU : 1
- Mémoire (Go) : 1
- Bande passante de réseau (Gbit/s) : 0.48
Note

Pour l'offre de gratuité, utilisez les options de forme Option Toujours gratuit disponible.
- Passez à la section suivante.
Vérifiez les paramètres du service Réseau. Apportez les modifications suivantes aux valeurs par défaut.
- Cliquez sur Modifier.
- Réseau principal : Sélectionnez Créer un réseau en nuage virtuel.
- Nom du nouveau réseau en nuage virtuel : Utilisez le nom du VCN généré ou indiquez un nom.
- Créer dans le compartiment : <your-compartment-name>.
- Sous-réseau : Sélectionnez Créer un sous-réseau public.
- Nom du nouveau sous-réseau : Utilisez le nom du sous-réseau généré ou indiquez un nom.
- Créer dans le compartiment : <your-compartment-name>.
- Bloc CIDR : Utilisez la valeur par défaut (par exemple, 10.0.0.0/24).
- Adresse IPv4 publique : Utilisez la valeur par défaut de Affecter une adresse IPv4 publique.
- Passez à la section suivante.
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.
Vérifiez les paramètres Volume de démarrage.

Décochez le paramètre Spécifier la taille d'un volume de démarrage de client.

Vérifiez le paramètre Utiliser le chiffrement en transit.

Décochez le paramètre Chiffrer ce volume avec une clé que vous gérez.
Cliquez sur Créer pour créer l'instance. Le provisionnement du système peut prendre plusieurs minutes.

Vous avez créé une instance Ubuntu Linux.

3. Activer l'accès Internet

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

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.

Ouvrez le menu de navigation et cliquez successivement sur Service de réseau et Réseaux en nuage virtuels.
Sélectionnez le VCN que vous avez créé avec votre instance de calcul.
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.
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.
Cliquez sur Ajouter des règles de trafic entrant.

Une boîte de dialogue Ajouter des règles de trafic entrant s'affiche.
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 : 5000
- Description : Autoriser les connexions HTTP
Cliquez sur Ajouter une règle de trafic entrant. À présent, les connexions HTTP sont autorisées. Votre VCN est configuré pour le serveur Apache.
Cliquez sur Ajouter des règles de trafic entrant.
À présent, les connexions HTTP sont autorisées. Votre VCN est configuré pour le serveur Apache.

Vous avez créé une règle de trafic entrant qui rend votre instance disponible à partir d'Internet.

4. Créer une application Flask

À présent, configurez Flask sur votre instance Ubuntu Linux, puis créez et exécutez une application Flask.

Installer et configurer Flask

Pour configurer Flask avec Python 3, procédez de la façon suivante :

Ouvrez le menu de navigation et cliquez sur Calcul. Sous Calcul, cliquez sur Instances.
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.
Ouvrez une fenêtre de terminal ou d'invite de commande.
Accédez au répertoire dans lequel vous avez stocké les clés de chiffrement ssh que vous avez créées dans la première partie.
Connectez-vous à votre machine virtuelle à l'aide de cette commande SSH.
```
ssh -i <your-private-key-file> ubuntu@<x.x.x.x>
```
Puisque vous avez identifié votre clé publique lors de la création de la machine virtuelle, cette commande vous connecte à votre machine virtuelle. Vous pouvez maintenant exécuter des commandes sudo pour installer et démarrer votre serveur.
Mettez à jour les paramètres du pare-feu.
Le pare-feu Ubuntu est désactivé par défaut. Toutefois, vous devez mettre à jour votre configuration iptables pour autoriser le trafic HTTP. Pour mettre à jour iptables, exécutez les commandes suivantes :
```
sudo iptables -I INPUT 6 -m state --state NEW -p tcp --dport 5000 -j ACCEPT
sudo netfilter-persistent save
```
Les commandes ajoutent une règle pour autoriser le trafic HTTP au moyen du port 5000 et enregistrent les modifications apportées aux fichiers de configuration iptables.

Installez pip3 pour Python 3.

sudo apt update
sudo apt install -y python3-pip

Installez et activez un environnement virtuel ainsi qu'un encapsuleur d'environnement virtuel.
Vous pouvez utiliser un environnement virtuel pour gérer les dépendances de votre projet. Chaque projet peut se trouver dans son propre environnement virtuel pour héberger des groupes indépendants de bibliothèques Python.

L'encapsuleur virtualenvwrapper est une extension de virtualenv. Il fournit un ensemble de commandes, ce qui rend le travail avec des environnements virtuels beaucoup plus agréable. De plus, il réunit tous vos environnements virtuels au même endroit. L'encapsuleur virtualenvwrapper active le remplissage à l'aide de la touche de tabulation pour les noms d'environnement.
```
pip3 install virtualenv
pip3 install virtualenvwrapper
```

Configurez votre encapsuleur d'environnement virtuel dans.bashrc.

Mettez à jour le fichier :

sudo vi .bashrc

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

# set up Python env
export WORKON_HOME=~/envs
export PATH=$PATH:/home/ubuntu/.local/bin
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS=' -p /usr/bin/python3 '
source /home/ubuntu/.local/bin/virtualenvwrapper.sh

Activez les commandes précédentes dans la fenêtre courante.

source ~/.bashrc

Démarrez un environnement virtuel.
```
mkvirtualenv flask01
```
La commande retourne : (flask01) ubuntu@<ubuntu-instance-name>:~$
Installez Flask.
```
pip3 install Flask
```

Créez une application "Hello, World!".

Créez le fichier :

sudo vi hello.py

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

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, World!'

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int("5000"), debug=True)

Exécutez le programme Python.

export FLASK_APP=hello.py
flask run --host=0.0.0.0

Vous pouvez maintenant tester votre cadre d'application.

À partir d'un nouveau terminal, connectez-vous à votre machine virtuelle Ubuntu avec vos clés SSH, puis entrez curl localhost :5000 dans la ligne de commande. Vous pouvez également connecter votre navigateur à l'adresse IP publique affectée à votre machine virtuelle : http://<x.x.x.x>:5000.

L'application retourne Hello World! sur votre machine virtuelle ou dans votre navigateur.

Félicitations! Vous avez installé Flask sur votre machine virtuelle Oracle Cloud Infrastructure.

Étape suivante

Vous avez installé Flask et créé une application Python sur Oracle Cloud Infrastructure à l'aide d'une machine virtuelle Ubuntu.

Pour en savoir plus sur le développement à l'aide des produits Oracle, consultez les sites suivants :

Documentation sur Oracle Cloud Infrastructure