Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # QuickStart: Stellen Sie eine.NET-Core-Anwendung für Windows auf Elastic Beanstalk bereit QuickStart In diesem Tutorial erfahren Sie, wie Sie eine.NET Core-Anwendung für Windows erstellen und in einer AWS Elastic Beanstalk Umgebung bereitstellen. **Nicht für Produktionszwecke** Beispiele dienen nur zur Veranschaulichung. Verwenden Sie keine Beispielanwendungen in der Produktion. **Topics** + [Ihre AWS Konto](#dotnet-quickstart-aws-account) + [Voraussetzungen](#dotnet-quickstart-prereq) + [Schritt 1: Erstellen Sie eine.NET-Core-Anwendung für Windows](#dotnet-quickstart-create-app) + [Schritt 2: Führen Sie Ihre Anwendung lokal aus](#dotnet-quickstart-run-local) + [Schritt 3: Stellen Sie Ihre.NET Core on Windows-Anwendung mit der EB CLI bereit](#dotnet-quickstart-deploy) + [Schritt 4: Führen Sie Ihre Anwendung auf Elastic Beanstalk aus](#dotnet-quickstart-run-eb-ap) + [Schritt 5: Bereinigen](#go-tutorial-cleanup) + [AWS Ressourcen für Ihre Anwendung](#dotnet-quickstart-eb-resources) + [Nächste Schritte](#dotnet-quickstart-next-steps) + [Bereitstellung mit der Elastic Beanstalk Beanstalk-Konsole](#dotnet-quickstart-console) ## Ihre AWS Konto Wenn Sie noch kein AWS Kunde sind, müssen Sie ein AWS Konto erstellen. Wenn Sie sich registrieren, können Sie auf Elastic Beanstalk und andere AWS Dienste zugreifen, die Sie benötigen. Wenn Sie bereits ein AWS Konto haben, können Sie weitermachen zu. [Voraussetzungen](#dotnet-quickstart-prereq) ### Erstellen Sie ein AWS Konto #### Melde dich an für ein AWS-Konto Um loszulegen AWS, benötigen Sie eine AWS-Konto. Informationen zum Erstellen eines AWS-Konto finden Sie unter [Erste Schritte mit einem AWS-Konto](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) im *AWS -Kontenverwaltung Referenzhandbuch*. ## Voraussetzungen 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 in Auflistungen angezeigt, denen ein Eingabeaufforderungssymbol (>) und gegebenenfalls der Name des aktuellen Verzeichnisses vorangestellt sind. ``` C:\eb-project> this is a command this is output ``` ### EB-CLI Dieses Tutorial verwendet die Befehlszeilenschnittstelle Elastic Beanstalk Command Line Interface (EB CLI). Detaillierte Anweisungen zum Installieren und Konfigurieren der EB CLI finden Sie unter [EB CLI mit Setup-Skript installieren (empfohlen)](eb-cli3.md#eb-cli3-install) und [Konfigurieren der EB CLI](eb-cli3-configuration.md). ### .NET Core unter Windows Falls Sie das .NET SDK nicht auf Ihrem lokalen Computer installiert haben, können Sie es installieren, indem Sie auf der Website mit der [.NET-Dokumentation auf den Link „.NET](https://learn.microsoft.com/en-us/dotnet/) [herunterladen](https://dotnet.microsoft.com/en-us/download)“ klicken. Überprüfen Sie Ihre .NET SDK-Installation, indem Sie den folgenden Befehl ausführen. ``` C:\> dotnet --info ``` ## Schritt 1: Erstellen Sie eine.NET-Core-Anwendung für Windows Erstellen Sie ein Projektverzeichnis. ``` C:\> mkdir eb-dotnetcore C:\> cd eb-dotnetcore ``` Erstellen Sie als Nächstes eine Hello World RESTful-Beispiel-Webdienstanwendung, indem Sie die folgenden Befehle ausführen. ``` C:\eb-dotnetcore> dotnet new web --name HelloElasticBeanstalk C:\eb-dotnetcore> cd HelloElasticBeanstalk ``` ## Schritt 2: Führen Sie Ihre Anwendung lokal aus Führen Sie den folgenden Befehl aus, um Ihre Anwendung lokal auszuführen. ``` C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet run ``` Die Ausgabe sollte in etwa wie der folgende Text aussehen. ``` info: Microsoft.Hosting.Lifetime[14] Now listening on: https://localhost:7222 info: Microsoft.Hosting.Lifetime[14] Now listening on: http://localhost:5228 info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down. info: Microsoft.Hosting.Lifetime[0] Hosting environment: Development info: Microsoft.Hosting.Lifetime[0] Content root path: C:\Users\Administrator\eb-dotnetcore\HelloElasticBeanstalk ``` **Anmerkung** Der `dotnet` Befehl wählt zufällig einen Port aus, wenn die Anwendung lokal ausgeführt wird. In diesem Beispiel ist der Port 5228. Wenn Sie die Anwendung in Ihrer Elastic Beanstalk Beanstalk-Umgebung bereitstellen, wird die Anwendung auf Port 5000 ausgeführt. Geben Sie die URL-Adresse `http://localhost:{{port}}` in Ihren Webbrowser ein. Für dieses spezielle Beispiel lautet der Befehl`http://localhost:5228`. Der Webbrowser sollte „Hello World\!“ anzeigen. ## Schritt 3: Stellen Sie Ihre.NET Core on Windows-Anwendung mit der EB CLI bereit Führen Sie die folgenden Befehle aus, um eine Elastic Beanstalk Beanstalk-Umgebung für diese Anwendung zu erstellen. **Um eine Umgebung zu erstellen und Ihre Anwendung für.NET Core unter Windows bereitzustellen** 1. Führen Sie die folgenden Befehle im `HelloElasticBeanstalk` Verzeichnis aus, um Ihre Anwendung zu veröffentlichen und zu komprimieren. ``` C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet publish -o site C:\eb-dotnetcore\HelloElasticBeasntalk> cd site C:\eb-dotnetcore\HelloElasticBeasntalk\site> Compress-Archive -Path * -DestinationPath ../site.zip C:\eb-dotnetcore\HelloElasticBeasntalk\site> cd .. ``` 1. Erstellen Sie im `HelloElasticBeanstalk` aufgerufenen Ordner eine neue Datei `aws-windows-deployment-manifest.json` mit dem folgenden Inhalt: ``` { "manifestVersion": 1, "deployments": { "aspNetCoreWeb": [ { "name": "test-dotnet-core", "parameters": { "appBundle": "site.zip", "iisPath": "/", "iisWebSite": "Default Web Site" } } ] } } ``` 1. Initialisieren Sie mit dem Befehl **eb init** das EB CLI-Repository. ``` C:\eb-dotnetcore\HelloElasticBeasntalk> eb init -p iis dotnet-windows-server-tutorial --region {{us-east-2}} ``` Dieser Befehl erstellt eine Anwendung mit dem Namen `dotnet-windows-server-tutorial` und konfiguriert Ihr lokales Repository so, dass Umgebungen mit der neuesten Version der Windows-Serverplattform erstellt werden. 1. Verwenden Sie **eb create**, um eine Umgebung zu erstellen und die Anwendung darin bereitzustellen. Elastic Beanstalk erstellt automatisch eine Zip-Datei für Ihre Anwendung und startet sie auf Port 5000. ``` C:\eb-dotnetcore\HelloElasticBeasntalk> eb create dotnet-windows-server-env ``` Es dauert etwa fünf Minuten, bis Elastic Beanstalk Ihre Umgebung erstellt hat. ## Schritt 4: Führen Sie Ihre Anwendung auf Elastic Beanstalk aus Wenn der Prozess zur Erstellung Ihrer Umgebung abgeschlossen ist, öffnen Sie Ihre Website mit. **eb open** ``` C:\eb-dotnetcore\HelloElasticBeasntalk> eb open ``` Herzlichen Glückwunsch\! Sie haben eine.NET-Core-Anwendung für Windows mit Elastic Beanstalk bereitgestellt\! Es wird ein Browserfenster mit dem für die Anwendung erstellten Domainnamen geöffnet. ## Schritt 5: Bereinigen Sie können Ihre Umgebung beenden, wenn Sie mit der Arbeit an Ihrer Anwendung fertig sind. Elastic Beanstalk beendet alle AWS Ressourcen, die mit Ihrer Umgebung verknüpft sind. Führen Sie den folgenden Befehl aus, um Ihre Elastic Beanstalk Beanstalk-Umgebung mit der EB-CLI zu beenden. ``` C:\eb-dotnetcore\HelloElasticBeasntalk> eb terminate ``` ## AWS Ressourcen für Ihre Anwendung Sie haben gerade eine Einzelinstanzanwendung erstellt. Es dient als einfache Beispielanwendung mit einer einzigen EC2-Instance, sodass kein Lastenausgleich oder auto Skalierung erforderlich sind. Für Einzelinstanzanwendungen erstellt Elastic Beanstalk die folgenden Ressourcen: AWS + **EC2 instance (EC2-Instance)** – Eine virtuelle Amazon EC2-Maschine zum Ausführen von Webanwendungen auf der von Ihnen ausgewählten Plattform. Jede Plattform führt eine andere Gruppe von Software, Konfigurationsdateien und Skripts zur Unterstützung einer bestimmten Sprachversion, eines Framework, Webcontainers oder einer Kombination daraus aus. Die meisten Plattformen verwenden entweder Apache oder nginx als Reverse-Proxy, der Web-Datenverkehr vor Ihrer Web-App verarbeitet, Anforderungen an sie weiterleitet, statische Komponenten verarbeitet und Zugriffs- und Fehlerprotokolle generiert. + **Instance security group (Instance-Sicherheitsgruppe)** – Eine Amazon EC2-Sicherheitsgruppe, die so konfiguriert ist, dass eingehender Datenverkehr auf Port 80 zugelassen wird. Mit dieser Ressource kann HTTP-Datenverkehr vom Load Balancer die EC2-Instance mit Ihrer Web-App erreichen. Standardmäßig ist Datenverkehr ist auf anderen Ports nicht zulässig. + **Amazon S3-Bucket** – Ein Speicherort für Ihren Quellcode, Protokolle und andere Artefakte, die bei der Verwendung von Elastic Beanstalk erstellt werden. + ** CloudWatch Amazon-Alarme** — Zwei CloudWatch Alarme, die die Auslastung der Instances in Ihrer Umgebung überwachen und ausgelöst werden, wenn die Last zu hoch oder zu niedrig ist. Wenn ein Alarm ausgelöst wird, wird Ihre Auto Scaling-Gruppe nach oben oder nach unten skaliert. + **CloudFormation stack** — Elastic Beanstalk verwendet CloudFormation , um die Ressourcen in Ihrer Umgebung zu starten und Konfigurationsänderungen zu propagieren. Die Ressourcen werden in einer Vorlage definiert, die Sie in der [CloudFormation -Konsole](https://console.aws.amazon.com/cloudformation) anzeigen können. + **Domainname** *— Ein Domainname, der in der Form an Ihre Web-App weitergeleitet wird. {{subdomain}} {{region}}.elasticbeanstalk.com*. Elastic Beanstalk verwaltet all diese Ressourcen. Wenn Sie die Umgebung beenden, werden alle darin enthaltenen Ressourcen von Elastic Beanstalk beendet. ## Nächste Schritte Nachdem Sie eine Umgebung erstellt haben, in der eine Anwendung ausgeführt wird, können Sie jederzeit eine neue Version der Anwendung oder eine andere Anwendung bereitstellen. Das Bereitstellen einer neuen Anwendungsversion geht sehr schnell, da keine EC2-Instances bereitgestellt oder neu gestartet werden müssen. Sie können Ihre neue Umgebung auch mit der Elastic Beanstalk Beanstalk-Konsole erkunden. Ausführliche Schritte finden [Sie unter Erkunden Sie Ihre Umgebung](GettingStarted.md#GettingStarted.Explore) im Kapitel *Erste Schritte* dieses Handbuchs. **Probieren Sie weitere Tutorials aus** Wenn Sie andere Tutorials mit anderen Beispielanwendungen ausprobieren möchten, finden Sie weitere Informationen unter[QuickStart für ASP.NET](aspnet-quickstart.md). Nachdem Sie ein oder zwei Beispielanwendungen bereitgestellt haben und bereit sind, .NET Core lokal auf Windows-Anwendungen zu entwickeln und auszuführen, finden Sie weitere Informationen unter [Einrichten der .NET-Entwicklungsumgebung](dotnet-devenv.md) ## Bereitstellung mit der Elastic Beanstalk Beanstalk-Konsole Sie können die Beispielanwendung auch mit der Elastic Beanstalk Beanstalk-Konsole starten. Ausführliche Schritte finden Sie unter [Erstellen einer Beispielanwendung](GettingStarted.md#GettingStarted.CreateApp) im Kapitel *Erste Schritte* dieses Handbuchs.