QuickStart: Déployer une application Python sur Elastic Beanstalk

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

Votre AWS compte

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

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

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.

Framework Python et Flask

Vérifiez que vous disposez d'une version fonctionnelle de Python pip installée en exécutant les commandes suivantes.

~$ python3 --version
Python 3.N.N
>~$ python3 -m pip --version
pip X.Y.Z from ... (python 3.N.N)

Si l'une des commandes précédentes renvoie « Python introuvable », exécutez les commandes suivantes qui utilisent à la python place depython3. La configuration des alias et des liens symboliques peut varier en fonction du système d'exploitation et des personnalisations individuelles. Il est donc possible que la python3 commande ne fonctionne pas sur votre machine.

~$ python --version
Python 3.N.N
>~$ python -m pip --version
pip X.Y.Z from ... (python 3.N.N)

Si Python n'est pas installé sur votre machine locale, vous pouvez le télécharger depuis la page de téléchargement de Python sur le site Web de Python. Pour obtenir la liste des versions du langage Python prises en charge par Elastic Beanstalk, consultez la section Plateformes Python AWS Elastic Beanstalk prises en charge dans le guide des plateformes. Le site Web de téléchargement de Python fournit un lien vers le guide du développeur Python, où vous trouverez des instructions d'installation et de configuration.

Si votre résultat indique que vous disposez d'une version compatible de Python, mais que ce n'est pas le caspip, consultez la page d'installation sur le site Web pip.pypa.io. Il fournit des conseils pour installer pip dans un environnement Python qui ne l'a pas.

Vérifiez si Flask est installé en exécutant la commande suivante :

~$ pip list | grep Flask

Si Flask n'est pas installé, vous pouvez l'installer avec la commande suivante :

~$ pip install Flask

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

Créez un répertoire de projet.

~$ mkdir eb-python
~$ cd eb-python

Créez un exemple « Hello Elastic Beanstalk ! » Application Python que vous déploierez à l'aide d'Elastic Beanstalk.

Créez un fichier texte nommé application.py dans le répertoire que vous venez de créer avec le contenu suivant.

from flask import Flask
application = Flask(__name__)

@application.route('/')
def hello_elastic_beanstalk():
        return 'Hello Elastic Beanstalk!'

Créez un fichier texte nommé requirements.txt avec la ligne suivante. Ce fichier contient les pip packages nécessaires à l'exécution de l'application.

Flask

Étape 2 : Exécutez votre application localement

Exécutez la commande suivante pour exécuter votre application localement.

~/eb-python$ export FLASK_APP=application.py && flask run --port 5000

Vous devriez voir un résultat similaire à ce qui suit

Serving Flask app 'application.py'
Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
Running on http://127.0.0.1:5000
Press CTRL+C to quit
127.0.0.1 - - [01/Jan/1970 00:00:00] "GET / HTTP/1.1" 200 -

Accédez à http://localhost:5000 dans votre navigateur Web. Le navigateur Web doit afficher « Hello Elastic Beanstalk ! ».

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

Exécutez les commandes suivantes pour créer un environnement Elastic Beanstalk pour cette application.

É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-python$ eb open

Félicitations ! Vous avez déployé une application Python 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 AWS met fin à toutes les ressources associées à votre environnement.

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

~/eb-python$ 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 ressources suivantes : AWS

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.

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 Python localement, consultezConfiguration de votre environnement de développement Python pour Elastic Beanstalk.

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.