Erstellen Sie ein Elastic Beanstalk Beanstalk-Anwendungsquellpaket

In diesem Thema wird erklärt, wie Sie Ihre Anwendungsquelldateien in einem Quellpaket auf Elastic Beanstalk hochladen. Es werden die Anforderungen an ein Quellpaket, die Struktur und die Methoden zur Erstellung eines solchen Pakets erläutert.

Wenn Sie die AWS Elastic Beanstalk Konsole verwenden, um eine neue Anwendung oder eine Anwendungsversion bereitzustellen, müssen Sie die Dateien für die Anwendung in einem Quellpaket hochladen. Das Quell-Bundle muss folgende Anforderungen erfüllen:

• Es muss aus einer einzigen ZIP- oder WAR-Datei bestehen (Sie können mehrere WAR-Dateien in eine ZIP-Datei einbinden).

• Darf nicht größer sein als 500 MB

• Es darf keinen übergeordneten Ordner bzw. kein Top-Level-Verzeichnis enthalten (Unterverzeichnisse sind in Ordnung).

Soll eine Worker-Anwendung zur Verarbeitung regelmäßiger Hintergrundaufgaben bereitgestellt werden, muss das Quell-Bundle der Anwendung zudem eine cron.yaml-Datei enthalten. Weitere Informationen finden Sie unter Regelmäßige Aufgaben.

Wenn Sie Ihre Anwendung mit dem Elastic Beanstalk Command Line Interface (EBCLI), dem AWS Toolkit for Eclipse oder dem AWS Toolkit for Visual Studio bereitstellen, wird die ZIP WAR ODER-Datei automatisch korrekt strukturiert. Weitere Informationen finden Sie unter Verwenden der Elastic Beanstalk Beanstalk-Befehlszeilenschnittstelle (EB) CLI, Bereitstellung von Java-Anwendungen mit Elastic Beanstalk und Der AWS Toolkit for Visual Studio.

Erstellen eines Quell-Bundles mit der Befehlszeile

Erstellen Sie ein Quell-Bundle mit dem Befehl zip. Um ausgeblendete Dateien und Ordner einzuschließen, verwenden Sie ein Muster wie das Folgende.

~/myapp$ zip ../myapp.zip -r * .[^.]*
  adding: app.js (deflated 63%)
  adding: index.js (deflated 44%)
  adding: manual.js (deflated 64%)
  adding: package.json (deflated 40%)
  adding: restify.js (deflated 85%)
  adding: .ebextensions/ (stored 0%)
  adding: .ebextensions/xray.config (stored 0%)

So wird sichergestellt, dass Elastic Beanstalk-Konfigurationsdateien und andere Dateien und Ordner, die mit einem Punkt beginnen, im Archiv eingeschlossen werden.

Verwenden Sie für Tomcat-Webanwendungen jar, um ein Web-Archiv zu erstellen.

~/myapp$ jar -cvf myapp.war .

Die obigen Befehle schließen ausgeblendete Dateien ein, wodurch Ihr Quell-Bundle unnötig vergrößert werden kann. Verwenden Sie für eine bessere Kontrolle ein detaillierteres Dateimuster oder erstellen Sie Ihr Quell-Bundle mit Git.

Erstellen eines Quell-Bundles mit Git

Wenn Sie den Anwendungsquellcode mit Git verwalten, erstellen Sie das Quell-Bundle über den Befehl git archive.

$ git archive -v -o myapp.zip --format=zip HEAD

git archive schließt nur Dateien ein, die in git gespeichert sind, und schließt ignorierte Dateien und git Dateien aus. Dies trägt dazu bei, dass Ihr Quell-Bundle so klein wie möglich ist. Weitere Informationen finden Sie unter git-archive manual page.

Komprimieren von Dateien im Mac OS X Finder oder Windows-Explorer

Achten Sie beim Erstellen einer ZIP-Datei im Mac OS X Finder oder Windows-Explorer darauf, die Dateien und Unterordner selbst zu komprimieren (und nicht den übergeordneten Ordner).

Anmerkung

Die grafische Benutzeroberfläche (GUI) auf Mac OS X- und Linux-basierten Betriebssystemen zeigt keine Dateien und Ordner an, deren Namen mit einem Punkt (.) beginnen. Verwenden Sie die Befehlszeile anstelle vonGUI, um Ihre Anwendung zu komprimieren, wenn die ZIP Datei einen versteckten Ordner enthalten muss, z. B. .ebextensions Informationen zu Befehlszeilenverfahren zum Erstellen einer ZIP-Datei auf einem Mac OS X- oder Linux-basierten Betriebssystem finden Sie unter Erstellen eines Quell-Bundles mit der Befehlszeile.

Beispiel

Angenommen, Sie haben einen Python-Projektordner mit dem Namen myapp und folgenden Dateien und Unterordnern:

myapplication.py
README.md
static/
static/css
static/css/styles.css
static/img
static/img/favicon.ico
static/img/logo.png
templates/
templates/base.html
templates/index.html

Wie bereits oben in der Anforderungsliste dargelegt, muss das Quell-Bundle ohne übergeordneten Ordner komprimiert werden, sodass in der extrahierten Struktur kein zusätzliches Top-Level-Verzeichnis vorhanden ist. In diesem Beispiel soll bei der Dateiextraktion kein myapp-Ordner erstellt werden (bzw. in der Befehlszeile soll kein myapp-Segment zu den Dateipfaden hinzugefügt werden).

Dieses Dateistrukturbeispiel wird im ganzen Thema verwendet und veranschaulicht das Komprimieren von Dateien.

Erstellen eines Quellpakets für ein. NETAnwendung

Wenn Sie Visual Studio verwenden, können Sie das in der enthaltene Bereitstellungstool verwenden AWS Toolkit for Visual Studio , um Ihre bereitzustellen. NETBewerbung bei Elastic Beanstalk. Weitere Informationen finden Sie unter Bereitstellung von Elastic Beanstalk Beanstalk-Anwendungen in. NETmithilfe des Bereitstellungstools.

Wenn Sie manuell ein Quellpaket für Ihr erstellen müssen. NETAnwendung, Sie können nicht einfach eine ZIP Datei erstellen, die das Projektverzeichnis enthält. Dazu müssen Sie ein Webbereitstellungspaket für das Projekt erstellen, das für die Bereitstellung in Elastic Beanstalk geeignet ist. Es gibt mehrere Möglichkeiten, um ein Bereitstellungspaket zu erstellen:

• Erstellen Sie das Bereitstellungspaket mithilfe des Visual Studio-Assistenten Web veröffentlichen. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Webbereitstellungspakets in Visual Studio.

  Wichtig

  Beim Erstellen eines Webbereitstellungspakets muss der Site name (Site-Name) mit Default Web Site beginnen.

• Wenn Sie eine haben. NETProjekt, Sie können das Bereitstellungspaket mithilfe des msbuild Befehls erstellen, wie im folgenden Beispiel gezeigt.

  Wichtig

  Der Parameter DeployIisAppPath muss mit Default Web Site beginnen.

  C:/> msbuild <web_app>.csproj /t:Package /p:DeployIisAppPath="Default Web Site"

• Wenn Sie ein Website-Projekt haben, können Sie das Bereitstellungspaket mit dem IIS Web Deploy-Tool erstellen. Weitere Informationen finden Sie unter Packaging and Restoring a Web site.

  Wichtig

  Der Parameter apphostconfig muss mit Default Web Site beginnen.

Wenn Sie mehrere Anwendungen bereitstellen oder eineASP. NETKernanwendung: Platzieren Sie Ihren .ebextensions Ordner neben den Anwendungspaketen und der Manifestdatei im Stammverzeichnis des Quellpakets:

~/workspace/source-bundle/
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- AspNetCore101HelloWorld.zip
|-- AspNetCoreHelloWorld.zip
|-- aws-windows-deployment-manifest.json
`-- VS2015AspNetWebApiApp.zip

Testen des Quell-Bundles

Möglicherweise möchten Sie das Quell-Bundle lokal testen, bevor Sie es in Elastic Beanstalk hochladen. Da Elastic Beanstalk im Wesentlichen die Befehlszeile verwendet, um die Dateien zu extrahieren, ist es am besten, Ihre Tests von der Befehlszeile aus durchzuführen und nicht mit einem GUI Tool.

Stellen Sie sicher, dass die Dateien in denselben Ordner wie das Archiv selbst extrahiert werden und nicht in einen neuen Top-Level-Ordner bzw. -Verzeichnis.