Einrichtung Ihrer Python-Entwicklungsumgebung für Elastic Beanstalk

Dieses Thema enthält Anweisungen zum Einrichten einer Python-Entwicklungsumgebung, um Ihre Anwendung lokal zu testen, bevor Sie sie bereitstellen AWS Elastic Beanstalk. Es verweist auch auf Websites, die Installationsanweisungen für nützliche Tools enthalten.

Allgemeine Einrichtungsschritte und Tools für alle Sprachen finden Sie unter Konfigurieren des Entwicklungscomputers für die Verwendung mit Elastic Beanstalk.

Um die Verfahren in diesem Leitfaden zu befolgen, benötigen Sie ein Befehlszeilen-Terminal oder eine Shell für die Ausführung der Befehle. Befehle werden ggf. in Auflistungen mit einem vorangestellten Eingabeaufforderungssymbol ($) und dem Namen des aktuellen Verzeichnisses angezeigt.

~/eb-project$ this is a command
this is output

In Linux und macOS können Sie Ihren bevorzugten Shell- und Paket-Manager verwenden. Unter Windows können Sie das Windows-Subsystem für Linux installieren, um eine Windows-integrierte Version von Ubuntu und Bash zu erhalten.

Allgemeine Einrichtungsschritte und Tools für alle Sprachen finden Sie unter Konfigurieren des Entwicklungscomputers für die Verwendung mit Elastic Beanstalk.

Voraussetzungen

Die folgende Liste enthält die allgemeinen Voraussetzungen für die Arbeit mit Elastic Beanstalk und Ihren Python-Anwendungen:

• Python-Sprache — Installieren Sie die Version der Python-Sprache, die in der von Ihnen ausgewählten Version der Elastic Beanstalk-Python-Plattform enthalten ist. Eine Liste unserer unterstützten Python-Sprachversionen finden Sie unter Unterstützte Python-Plattformen im AWS Elastic Beanstalk Leitfaden für Plattformen. Wenn Sie Python noch nicht auf Ihrem Entwicklungscomputer eingerichtet haben, besuchen Sie die Python-Downloadseite auf der Python-Website.

• pipHilfsprogramm — Das pip Hilfsprogramm ist Pythons Paket-Installer. Es installiert und listet Abhängigkeiten für Ihr Projekt auf, sodass Elastic Beanstalk weiß, wie die Umgebung Ihrer Anwendung eingerichtet wird. Weitere Informationen pip dazu finden Sie auf der Pip-Seite auf der pip.pypa.io-Website.

• (Optional) Das Elastic Beanstalk Command Line Interface (EBCLI) — Das EB CLI kann Ihre Anwendung mit den erforderlichen Bereitstellungsdateien verpacken. Es kann auch eine Elastic Beanstalk Beanstalk-Umgebung erstellen und Ihre Anwendung darauf bereitstellen. Sie können Bereitstellungen auch über die Elastic Beanstalk Beanstalk-Konsole vornehmen, sodass die EB nicht unbedingt CLI erforderlich ist.

• Eine funktionierende SSH Installation — Sie können mit dem SSH Protokoll eine Verbindung zu Ihren laufenden Instances herstellen, um ein Deployment zu untersuchen oder zu debuggen.

• virtualenvPaket — Dieses virtualenv Tool erstellt eine Entwicklungs- und Testumgebung für Ihre Anwendung. Elastic Beanstalk kann diese Umgebung replizieren, ohne zusätzliche Pakete zu installieren, die für Ihre Anwendung nicht erforderlich sind. Weitere Informationen finden Sie auf der virtualenv-Website. Nach der Installation von Python können Sie das virtualenv Paket mit dem folgenden Befehl installieren:

  $ pip install virtualenv

Verwenden einer virtuellen Umgebung

Sofern die Voraussetzungen erfüllt sind, können Sie eine virtuelle Umgebung mit virtualenv einrichten und die Anwendungsabhängigkeiten installieren. Mithilfe einer virtuellen Umgebung können Sie genau erkennen, welche Pakete von Ihrer Anwendung benötigt werden, sodass die erforderlichen Pakete auf den EC2 Instanzen installiert werden, auf denen Ihre Anwendung ausgeführt wird.

So richten Sie eine virtuelle Umgebung ein

1. Öffnen Sie ein Befehlszeilenfenster und geben Sie Folgendes ein:

   $ virtualenv /tmp/eb_python_app

   Ersetzen eb_python_app mit einem Namen, der für Ihre Anwendung sinnvoll ist (es ist eine gute Idee, den Namen Ihrer Anwendung zu verwenden). Der Befehl virtualenv erstellt für Sie eine virtuelle Umgebung im angegebenen Verzeichnis und druckt die Ergebnisse seiner Aktionen:

   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.

2. Sobald die virtuelle Umgebung bereit ist, starten Sie diese mithilfe des Skripts activate, das Sie im Verzeichnis bin der Umgebung finden. Um die im vorherigen Schritt erstellte Umgebung eb_python_app zu starten, geben Sie beispielsweise Folgendes ein:

   $ source /tmp/eb_python_app/bin/activate

   In der virtuellen Umgebung wird der Name (z. B. (eb_python_app)) am Anfang jeder Eingabeaufforderung angezeigt, damit Sie wissen, dass es sich um eine virtuelle Python-Umgebung handelt.

3. Führen Sie den Befehl deactivate aus, um die Verwendung Ihrer virtuellen Umgebung zu beenden und zum standardmäßigen Python-Interpreter des Systems mit allen installierten Bibliotheken zurückzukehren.

   (eb_python_app) $ deactivate

Anmerkung

Wenn sie erstellt ist, können Sie die virtuelle Umgebung jederzeit starten, indem Sie das Skript activate erneut ausführen.

Konfigurieren eines Python-Projekts für Elastic Beanstalk

Sie können Elastic Beanstalk verwenden, CLI um Ihre Python-Anwendungen für die Bereitstellung mit Elastic Beanstalk vorzubereiten.

So konfigurieren Sie eine Python-Anwendung für die Bereitstellung mit Elastic Beanstalk

1. Kehren Sie in der virtuellen Umgebung nach oben zum Verzeichnisbaum des Projekts zurück (python_eb_app) und geben Sie Folgendes ein:

   pip freeze >requirements.txt

   Mit diesem Befehl werden die Namen und Versionen der Pakete, die in Ihrer virtuellen Umgebung installiert sindrequirements.txt, kopiert. Wenn beispielsweise das YAML Py-Paket, Version 3.11, in Ihrer virtuellen Umgebung installiert ist, enthält die Datei die folgende Zeile:

   PyYAML==3.11

   Auf diese Weise verwendet Elastic Beanstalk dieselben Pakete und Versionen, mit denen Sie die Anwendung entwickelt und getestet haben, um die Python-Umgebung der Anwendung zu replizieren.

2. Konfigurieren Sie das CLI EB-Repository mit dem eb init Befehl. Folgen Sie den Anweisungen und wählen Sie die Region, die Plattform und andere Optionen aus. Detaillierte Anweisungen finden Sie unter Elastic Beanstalk-Umgebungen mit der EB CLI verwalten.

Standardmäßig sucht Elastic Beanstalk nach einer Datei namens application.py, um die Anwendung zu starten. Falls diese im erstellten Python-Projekt nicht vorhanden ist, sind bestimmte Anpassungen an der Anwendungsumgebung erforderlich. Außerdem müssen Sie Umgebungsvariablen festlegen, damit die Anwendungsmodule geladen werden können. Weitere Informationen finden Sie unter Verwenden der Elastic Beanstalk Python-Plattform.