QuickStart: Stellen Sie eine bereit. NETCore-on-Linux-Anwendung für Elastic Beanstalk - AWS Elastic Beanstalk

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 bereit. NETCore-on-Linux-Anwendung für Elastic Beanstalk

Dieses QuickStart Tutorial führt Sie durch den Prozess der Erstellung eines. NETCore auf einer Linux-Anwendung und deren Bereitstellung auf einem AWS Elastic Beanstalk Umgebung.

Anmerkung

Dieses QuickStart Tutorial dient Demonstrationszwecken. Verwenden Sie die in diesem Tutorial erstellte Anwendung nicht für Produktionsdatenverkehr.

Ihre AWS Konto

Wenn Sie noch kein sind AWS Kunde, Sie müssen einen erstellen AWS Konto. Wenn Sie sich registrieren, erhalten Sie Zugriff auf Elastic Beanstalk und andere AWS Dienste, die Sie benötigen.

Wenn Sie bereits eine haben AWS Konto, zu dem Sie weitermachen könnenVoraussetzungen.

Melde dich an für ein AWS-Konto

Wenn Sie kein haben AWS-Konto, führen Sie die folgenden Schritte aus, um einen zu erstellen.

Um sich für eine anzumelden AWS-Konto
  1. Öffnen Sie https://portal.aws.amazon.com/billing/die Anmeldung.

  2. Folgen Sie den Online-Anweisungen.

    Bei der Anmeldung müssen Sie auch einen Telefonanruf entgegennehmen und einen Verifizierungscode über die Telefontasten eingeben.

    Wenn Sie sich für eine anmelden AWS-Konto, ein Root-Benutzer des AWS-Kontoswird erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen im Konto. Als bewährte Sicherheitsmethode weisen Sie einem Administratorbenutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um Aufgaben auszuführen, die Root-Benutzerzugriff erfordern.

AWS sendet Ihnen nach Abschluss des Anmeldevorgangs eine Bestätigungs-E-Mail. Du kannst jederzeit deine aktuellen Kontoaktivitäten einsehen und dein Konto verwalten, indem du zu https://aws.amazon.com/gehst und Mein Konto auswählst.

Erstellen eines Benutzers mit Administratorzugriff

Nachdem Sie sich für einen angemeldet haben AWS-Konto, sichern Sie sich Ihre Root-Benutzer des AWS-Kontos, aktivieren AWS IAM Identity Center, und erstellen Sie einen Administratorbenutzer, sodass Sie den Root-Benutzer nicht für alltägliche Aufgaben verwenden.

Sichern Sie Ihre Root-Benutzer des AWS-Kontos
  1. Melde dich an bei AWS Management Consoleals Kontoinhaber wählen Sie Root-Benutzer und geben Sie Ihren AWS-Konto E-Mail-Adresse. Geben Sie auf der nächsten Seite Ihr Passwort ein.

    Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter Als Root-Benutzer anmelden in der AWS-Anmeldung Benutzerleitfaden.

  2. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für Ihren Root-Benutzer.

    Anweisungen finden Sie unter Aktivieren Sie ein virtuelles MFA Gerät für Ihr AWS-Konto Root-Benutzer (Konsole) im IAMBenutzerhandbuch.

Erstellen eines Benutzers mit Administratorzugriff
  1. Aktivieren Sie IAM Identity Center.

    Anweisungen finden Sie unter Aktivieren AWS IAM Identity Center in der AWS IAM Identity Center Benutzerleitfaden.

  2. Gewähren Sie einem Benutzer in IAM Identity Center Administratorzugriff.

    Für ein Tutorial zur Verwendung des IAM-Identity-Center-Verzeichnis als Identitätsquelle finden Sie unter Benutzerzugriff mit der Standardeinstellung konfigurieren IAM-Identity-Center-Verzeichnis in der AWS IAM Identity Center Benutzerleitfaden.

Anmelden als Administratorbenutzer
  • Um sich mit Ihrem IAM Identity Center-Benutzer anzumelden, verwenden Sie die Anmeldung, URL die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM Identity Center-Benutzer erstellt haben.

    Hilfe bei der Anmeldung mit einem IAM Identity Center-Benutzer finden Sie unter Anmelden bei AWS Zugriffsportal im AWS-Anmeldung Benutzerleitfaden.

Weiteren Benutzern Zugriff zuweisen
  1. Erstellen Sie in IAM Identity Center einen Berechtigungssatz, der der bewährten Methode zur Anwendung von Berechtigungen mit den geringsten Rechten folgt.

    Eine Anleitung finden Sie unter Einen Berechtigungssatz erstellen im AWS IAM Identity Center Benutzerleitfaden.

  2. Weisen Sie Benutzer einer Gruppe zu und weisen Sie der Gruppe dann Single Sign-On-Zugriff zu.

    Anweisungen finden Sie unter Gruppen hinzufügen in der AWS IAM Identity Center Benutzerleitfaden.

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 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.

EB CLI

In diesem Tutorial wird das Elastic Beanstalk Command Line Interface (EBCLI) verwendet. Einzelheiten zur Installation und Konfiguration des EB finden Sie CLI unter Installieren Sie die Elastic Beanstalk Beanstalk-Befehlszeilenschnittstelle und. Konfigurieren der EB CLI

. NETCore unter Linux

Wenn du das nicht hast. NETSDKauf Ihrem lokalen Computer installiert, können Sie es installieren, indem Sie dem Download-Link folgen. NETLink auf der. NETDokumentationswebsite.

Verifiziere deine. NETSDKInstallation, indem Sie den folgenden Befehl ausführen.

~$ dotnet --info

Schritt 1: Erstellen Sie eine. NETCore auf Linux-Anwendung

Erstellen Sie ein Projektverzeichnis.

~$ mkdir eb-dotnetcore ~$ cd eb-dotnetcore

Erstellen Sie als Nächstes eine Hello World-Beispielanwendung, indem Sie die folgenden Befehle ausführen.

~/eb-dotnetcore$ dotnet new web --name HelloElasticBeanstalk ~/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.

~/eb-dotnetcore/HelloElasticBeasntalk$ dotnet run

Die Ausgabe sollte etwa wie der folgende Text aussehen.

Building... info: Microsoft.Hosting.Lifetime[14] Now listening on: https://localhost:7294 info: Microsoft.Hosting.Lifetime[14] Now listening on: http://localhost:5052 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]
Anmerkung

Der dotnet Befehl wählt zufällig einen Port aus, wenn die Anwendung lokal ausgeführt wird. In diesem Beispiel ist der Port 5052. 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 Befehlhttp://localhost:5052. Der Webbrowser sollte „Hello World!“ anzeigen.

Schritt 3: Stellen Sie Ihre bereit. NETCore-on-Linux-Anwendung mit dem EB CLI

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 bereitzustellen. NETCore auf Linux-Anwendung
  1. Kompilieren und veröffentlichen Sie Ihre Anwendung in einem Ordner für die Bereitstellung in der Elastic Beanstalk Beanstalk-Umgebung, die Sie gerade erstellen möchten.

    ~$ cd eb-dotnetcore/HelloElasticBeanstalk ~/eb-dotnetcore/HelloElasticBeanstalk$ dotnet publish -o site
  2. Navigieren Sie zu dem Site-Verzeichnis, in dem Sie Ihre App gerade veröffentlicht haben.

    ~/eb-dotnetcore/HelloElasticBeanstalk$ cd site
  3. Initialisieren Sie Ihr CLI EB-Repository mit dem eb init Befehl.

    Beachten Sie die folgenden Details zur Plattform-Branch-Version, die Sie im Befehl angeben:

    • Ersetzen Sie x.y.z den folgenden Befehl durch die neueste Version des Plattformzweigs. NET6 am AL2 023.

    • Die neueste Version der Plattformverzweigung finden Sie unter. NETCore unter Linux Unterstützte Plattformen in der AWS Elastic Beanstalk Leitfaden für Plattformen.

    • Ein Beispiel für einen Lösungsstapelnamen, der die Versionsnummer enthält, ist64bit-amazon-linux-2023-v3.1.1-running-.net-6. In diesem Beispiel ist die Zweigversion 3.1.1.

    ~eb-dotnetcore/HelloElasticBeanstalk/site$ eb init -p 64bit-amazon-linux-2023-vx.y.z-running-.net-6 dotnetcore-tutorial --region us-east-2 Application dotnetcore-tutorial has been created.

    Dieser Befehl erstellt eine Anwendung mit dem Namen dotnetcore-tutorial und konfiguriert Ihr lokales Repository so, dass Umgebungen mit dem erstellt werden. NETCore auf der Linux-Plattformversion, die im Befehl angegeben ist.

  4. (Optional) Führen Sie den eb init Vorgang erneut aus, um ein Standardschlüsselpaar zu konfigurieren, mit dem Sie eine Verbindung SSH zu der EC2 Instance herstellen können, auf der Ihre Anwendung ausgeführt wird.

    ~eb-dotnetcore/HelloElasticBeanstalk/site$ eb init Do you want to set up SSH for your instances? (y/n): y Select a keypair. 1) my-keypair 2) [ Create new KeyPair ]

    Wählen Sie ein Schlüsselpaar aus (sofern vorhanden) oder befolgen Sie die Anweisungen, um ein Schlüsselpaar zu erstellen. Falls keine Anweisungen angezeigt werden oder Sie die Einstellungen später ändern möchten, führen Sie eb init -i aus.

  5. 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.

    to

    ~eb-dotnetcore/HelloElasticBeanstalk/site$ eb create dotnet-tutorial

    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

~eb-dotnetcore/HelloElasticBeanstalk/site$ eb open

Herzlichen Glückwunsch! Sie haben eine bereitgestellt. NETCore-On-Linux-Anwendung mit Elastic Beanstalk! 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.

Um Ihre Elastic Beanstalk Beanstalk-Umgebung mit dem EB zu beenden, CLI führen Sie den folgenden Befehl aus.

~eb-dotnetcore/HelloElasticBeanstalk/site$ eb terminate

AWS Ressourcen für Ihre Anwendung

Sie haben gerade eine Einzelinstanzanwendung erstellt. Es dient als einfache Beispielanwendung mit einer einzigen EC2 Instanz, sodass kein Lastenausgleich oder auto Skalierung erforderlich sind. Für Einzelinstanzanwendungen erstellt Elastic Beanstalk Folgendes AWS Ressourcen:

  • EC2Instanz — Eine EC2 virtuelle Maschine von Amazon, die so konfiguriert ist, dass sie Web-Apps auf der von Ihnen ausgewählten Plattform ausführt.

    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-Sicherheitsgruppe — Eine EC2 Amazon-Sicherheitsgruppe, die so konfiguriert ist, dass sie eingehenden Datenverkehr auf Port 80 zulässt. Diese Ressource ermöglicht es dem HTTP Datenverkehr vom Load Balancer, die EC2 Instance zu erreichen, auf der Ihre Web-App ausgeführt wird. 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.

  • AWS CloudFormation Stack — Elastic Beanstalk verwendet AWS CloudFormation um die Ressourcen in Ihrer Umgebung zu starten und Konfigurationsänderungen zu verbreiten. Die Ressourcen sind in einer Vorlage definiert, die Sie in der Datei einsehen können AWS CloudFormation Konsole.

  • Domainname — Ein Domainname, der in der folgenden 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. Die Bereitstellung einer neuen Anwendungsversion ist sehr schnell, da dafür keine Bereitstellung oder Neustarts von Instances erforderlich sind. EC2 Sie können Ihre neue Umgebung auch mit der Elastic Beanstalk Beanstalk-Konsole erkunden. Ausführliche Schritte finden Sie unter Erkunden Sie Ihre Umgebung im Kapitel Erste Schritte dieses Handbuchs.

Nachdem Sie eine oder zwei Beispielanwendungen bereitgestellt haben und bereit sind, mit der Entwicklung und Ausführung zu beginnen. NETLokale Core-On-Linux-Anwendungen, sieheEinrichtung Ihres. NETCore on Linux-Entwicklungsumgebung für Elastic Beanstalk.

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 im Kapitel Erste Schritte dieses Handbuchs.