Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Cette rubrique fournit des instructions pour configurer un environnement de développement Python afin de tester votre application localement avant de la déployer AWS Elastic Beanstalk. Il fait également référence à des sites Web qui fournissent des instructions d'installation pour des outils utiles.
Pour accéder aux outils et aux étapes de configuration courants qui s'appliquent à toutes les langues, veuillez consulter Configuration de votre machine de développement pour une utilisation avec Elastic Beanstalk.
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 outputSous 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
Pour accéder aux outils et aux étapes de configuration courants qui s'appliquent à toutes les langues, veuillez consulter Configuration de votre machine de développement pour une utilisation avec Elastic Beanstalk.
Sections
Prérequis
La liste suivante fournit les prérequis courants pour travailler avec Elastic Beanstalk et vos applications Python :
-
Langage Python : installez la version du langage Python incluse dans la version de plateforme Elastic Beanstalk Python que vous avez choisie. Pour obtenir la liste des versions de langage Python prises en charge, consultez la section Plateformes Python prises en charge dans le guide AWS Elastic Beanstalk des plateformes. Si Python n'est pas encore configuré sur votre machine de développement, consultez la page de téléchargement de Python
sur le site Web de Python. -
piputilitaire — L'piputilitaire est le programme d'installation de packages de Python. Il installe et répertorie les dépendances de votre projet, afin qu'Elastic Beanstalk sache comment configurer l'environnement de votre application. Pour plus d'informationspip, consultez la page pipsur le site Web pip.pypa.io. -
(Facultatif) L'interface de ligne de commande Elastic Beanstalk (EB CLI) : l'interface de ligne de commande EB peut empaqueter votre application avec les fichiers de déploiement nécessaires. Il peut également créer un environnement Elastic Beanstalk et y déployer votre application. Vous pouvez également effectuer des déploiements via la console Elastic Beanstalk, de sorte que l'EB CLI n'est pas strictement nécessaire.
-
Une
SSHinstallation fonctionnelle — Vous pouvez vous connecter à vos instances en cours d'exécution à l'aide du protocole SSH pour examiner ou déboguer un déploiement. -
virtualenvpackage — Cetvirtualenvoutil crée un environnement de développement et de test pour votre application. Elastic Beanstalk peut répliquer cet environnement sans installer de packages supplémentaires qui ne sont pas requis par votre application. Pour plus d'informations, consultez le site Web de virtualenv. Après avoir installé Python, vous pouvez installer le virtualenvpackage à l'aide de la commande suivante :$pip install virtualenv
Utilisation d’un environnement virtuel
Une fois les conditions préalables en place, configurez un environnement virtuel avec virtualenv pour installer les dépendances de votre application. En utilisant un environnement virtuel, vous pouvez déterminer exactement quels packages sont nécessaires à votre application afin que les packages requis soient installés sur les EC2 instances qui exécutent votre application.
Pour configurer un environnement virtuel
-
Ouvrez une fenêtre de ligne de commande et tapez :
$virtualenv /tmp/eb_python_appeb_python_appRemplacez-le par un nom adapté à votre application (utiliser le nom de votre application est une bonne idée). La commandevirtualenvcrée un environnement virtuel pour vous dans le répertoire spécifié et imprime les résultats de ses actions :Running virtualenv with interpreter /usr/bin/python New python executable in /tmp/eb_python_app/bin/python3.7 Also creating executable in /tmp/eb_python_app/bin/python Installing setuptools, pip...done. -
Une fois que votre environnement virtuel est prêt, démarrez-le en exécutant le script
activatesitué dans le répertoirebinde l'environnement. Par exemple, pour démarrer l'environnement eb_python_app créé à l'étape précédente, tapez :$source /tmp/eb_python_app/bin/activateL'environnement virtuel affiche son nom (par exemple :
(eb_python_app)) au début de chaque invite de commande, pour vous rappeler que vous êtes dans un environnement Python virtuel. -
Pour arrêter d'utiliser votre environnement virtuel et revenir à l'interpréteur Python par défaut du système avec toutes les bibliothèques installées, exécutez la commande
deactivate.(eb_python_app) $deactivate
Note
Une fois l'environnement virtuel créé, vous pouvez le redémarrer à tout moment en exécutant à nouveau son script activate.
Configuration d'un projet Python pour Elastic Beanstalk
Vous pouvez utiliser l'interface de ligne de commande (CLI) Elastic Beanstalk pour préparer vos applications Python à déployer avec Elastic Beanstalk.
Pour configurer une application Python à déployer avec Elastic Beanstalk
-
Depuis votre environnement virtuel, revenez vers le haut de l'arborescence de votre projet (
python_eb_app) et saisissez :pip freeze >requirements.txtCette commande copie les noms et les versions des packages qui sont installés dans votre environnement virtuel dans
requirements.txt. Par exemple, si le package PyYAML, version 3.11 est installé dans votre environnement virtuel, le fichier contiendra la ligne :PyYAML==3.11Cela permet à Elastic Beanstalk de répliquer l'environnement Python de votre application à l'aide des mêmes packages et de la même version que ceux utilisés pour développer et tester votre application.
-
Configurez le référentiel de l'interface de ligne de commande (CLI) EB avec la commande eb init. Suivez les invites pour choisir une région, une plateforme et d'autres options. Pour obtenir des instructions complètes, veuillez consulter Gestion des environnements Elastic Beanstalk avec l'interface de ligne de commande EB.
Par défaut, Elastic Beanstalk recherche un fichier appelé application.py pour démarrer votre application. S'il n'existe pas dans le projet Python que vous avez créé, certains ajustements de l'environnement de votre application sont nécessaires. Vous devrez également définir des variables d'environnement afin que les modules de votre application puissent être chargés. Pour plus d'informations, consultez Utilisation de la plateforme Python Elastic Beanstalk.
