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.
# Führen Sie einen ASP.NET Core-Web-API-Docker-Container auf einer Amazon EC2 Linux-Instance aus
*Vijai Anand Ramalingam und Sreelaxmi Pai, Amazon Web Services*
## Zusammenfassung
Dieses Muster ist für Benutzer gedacht, die damit beginnen, ihre Anwendungen in der Amazon Web Services (AWS) Cloud zu containerisieren. Wenn Sie beginnen, Apps in der Cloud zu containerisieren, sind in der Regel keine Container-Orchestrierungsplattformen eingerichtet. Mit diesem Muster können Sie schnell eine Infrastruktur auf AWS einrichten, um Ihre containerisierten Anwendungen zu testen, ohne dass eine aufwändige Container-Orchestrierungsinfrastruktur erforderlich ist.
Der erste Schritt auf dem Weg zur Modernisierung besteht darin, die Anwendung zu transformieren. Wenn es sich um eine ältere .NET Framework-Anwendung handelt, müssen Sie zuerst die Laufzeit auf ASP.NET Core ändern. Führen Sie dann die folgenden Schritte aus:
+ Erstellen Sie das Docker-Container-Image
+ Führen Sie den Docker-Container mit dem erstellten Image aus
+ Überprüfen Sie die Anwendung, bevor Sie sie auf einer beliebigen Container-Orchestrierungsplattform wie Amazon Elastic Container Service (Amazon ECS) oder Amazon Elastic Kubernetes Service (Amazon EKS) bereitstellen.
Dieses Muster behandelt die Aspekte der Erstellung, Ausführung und Validierung der modernen Anwendungsentwicklung auf einer Amazon Elastic Compute Cloud (Amazon EC2) Linux-Instance.
## Voraussetzungen und Einschränkungen
**Voraussetzungen**
+ Ein aktives [Amazon Web Services (AWS) -Konto](https://aws.amazon.com/account/)
+ Eine [AWS Identity and Access Management (IAM) -Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) mit ausreichendem Zugriff, um AWS-Ressourcen für dieses Muster zu erstellen
+ [Visual Studio Community 2022](https://visualstudio.microsoft.com/downloads/) oder höher wurde heruntergeladen und installiert
+ Ein auf ASP.NET Core modernisiertes .NET Framework-Projekt
+ Ein Repositorium GitHub
**Produktversionen**
+ Visual Studio Community 2022 oder höher
## Architektur
**Zielarchitektur**
Dieses Muster verwendet eine [ CloudFormation AWS-Vorlage](https://console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/new?stackName=SSM-SSH-Demo&templateURL=https://aws-quickstart.s3.amazonaws.com/quickstart-examples/samples/session-manager-ssh/session-manager-example.yaml), um die im folgenden Diagramm gezeigte Architektur mit hoher Verfügbarkeit zu erstellen. Eine Amazon EC2 Linux-Instance wird in einem privaten Subnetz gestartet. AWS Systems Manager Session Manager wird verwendet, um auf die private Amazon EC2 Linux-Instance zuzugreifen und die API zu testen, die im Docker-Container läuft.
1. Zugriff auf die Linux-Instance über Session Manager
## Tools
**AWS-Services**
+ [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) — AWS Command Line Interface (AWS CLI) ist ein Open-Source-Tool für die Interaktion mit AWS-Services über Befehle in Ihrer Befehlszeilen-Shell. Mit minimaler Konfiguration können Sie AWS-CLI-Befehle ausführen, die Funktionen implementieren, die denen der browserbasierten AWS-Managementkonsole entsprechen.
+ [AWS-Managementkonsole](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/learn-whats-new.html) — Die AWS-Managementkonsole ist eine Webanwendung, die eine breite Sammlung von Servicekonsolen für die Verwaltung von AWS-Ressourcen umfasst und sich auf diese bezieht. Wenn Sie sich zum ersten Mal anmelden, sehen Sie die Startseite der Konsole. Die Startseite bietet Zugriff auf jede Servicekonsole und bietet einen zentralen Ort, an dem Sie auf die Informationen zugreifen können, die Sie zur Ausführung Ihrer AWS-bezogenen Aufgaben benötigen.
+ [AWS Systems Manager Session Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager.html) — Session Manager ist eine vollständig verwaltete Funktion von AWS Systems Manager. Mit Session Manager können Sie Ihre Amazon Elastic Compute Cloud (Amazon EC2) -Instances verwalten. Session Manager bietet eine sichere und überprüfbare Knotenverwaltung, ohne dass eingehende Ports geöffnet, Bastion-Hosts verwaltet oder SSH-Schlüssel verwaltet werden müssen.
**Andere Tools**
+ [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) — Visual Studio 2022 ist eine integrierte Entwicklungsumgebung (IDE).
+ [Docker](https://www.docker.com/) — Docker ist eine Reihe von Platform-as-a-Service (PaaS) -Produkten, die Virtualisierung auf Betriebssystemebene nutzen, um Software in Containern bereitzustellen.
**Code**
```
FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
WORKDIR /src
COPY ["DemoNetCoreWebAPI/DemoNetCoreWebAPI.csproj", "DemoNetCoreWebAPI/"]
RUN dotnet restore "DemoNetCoreWebAPI/DemoNetCoreWebAPI.csproj"
COPY . .
WORKDIR "/src/DemoNetCoreWebAPI"
RUN dotnet build "DemoNetCoreWebAPI.csproj" -c Release -o /app/build
FROM build AS publish
RUN dotnet publish "DemoNetCoreWebAPI.csproj" -c Release -o /app/publish
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "DemoNetCoreWebAPI.dll"]
```
## Epen
### Entwickeln Sie die ASP.NET Core-Web-API
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Erstellen Sie mit Visual Studio ein Beispiel für eine ASP.NET Core-Web-API. | Gehen Sie wie folgt vor, um ein Beispiel für eine ASP.NET Core-Web-API zu erstellen:1. Öffnen Sie Visual Studio 2022.
2. Wählen Sie **Create a new project (Neues Projekt erstellen)**.
3. Wählen Sie die **ASP.NET Core Web API-Projektvorlage** aus und klicken Sie auf **Weiter**.
4. Geben Sie als Projektnamen **DemoNetCoreWebAPI** ein und wählen Sie **Weiter** aus.
5. Wählen Sie **Erstellen** aus.
6. Um das Projekt lokal auszuführen, drücken Sie F5.
7. Stellen Sie mithilfe von [Swagger](https://swagger.io/) sicher, dass der **WeatherForecast**Standard-API-Endpunkt die Ergebnisse zurückgibt.
8. Öffnen Sie die Befehlszeile, navigieren Sie zum Projektordner .csproj und führen Sie die folgenden Befehle aus, um die neue Web-API in Ihr Repository zu übertragen. GitHub git add --all
git commit -m "Initial Version"
git push
| App-Developer |
| Erstellen Sie eine Docker-Datei. | Gehen Sie wie folgt vor, um ein Dockerfile zu erstellen:+ *Erstellen Sie das Dockerfile manuell mithilfe des Dockerfile-Beispiels im Abschnitt Code.* Wählen Sie je nach den Anforderungen das entsprechende .NET-Basisimage aus. Informationen zu Images, die sich auf .NET und ASP.NET Core beziehen, finden Sie unter [Docker Hub](https://hub.docker.com/_/microsoft-dotnet/).
+ [Erstellen Sie das Dockerfile mit Visual Studio und Docker Desktop.](https://www.docker.com/products/docker-desktop) Klicken Sie im Solution Explorer mit der rechten Maustaste auf das Projekt und wählen Sie **Hinzufügen** -> **Docker Support**. Wählen Sie für **Target OS** **Linux** aus. Stellen Sie sicher, dass sich das neue Dockerfile im selben Pfad wie die Lösungsdatei (.sln) befindet.
Führen Sie den folgenden Befehl aus, um die Änderungen in Ihr GitHub Repository zu übertragen.git add --all
git commit -m "Dockerfile added"
git push
| App-Developer |
### Richten Sie die Amazon EC2 Linux-Instance ein
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Richten Sie die Infrastruktur ein. | Starten Sie die [ CloudFormation AWS-Vorlage](https://console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/new?stackName=SSM-SSH-Demo&templateURL=https://aws-quickstart.s3.amazonaws.com/quickstart-examples/samples/session-manager-ssh/session-manager-example.yaml), um die Infrastruktur zu erstellen, die Folgendes umfasst: + Eine virtuelle private Cloud (VPC), die den [AWS VPC Quick Start](https://aws.amazon.com/quickstart/architecture/vpc/) verwendet, mit zwei öffentlichen und zwei privaten Subnetzen, die sich über zwei Availability Zones erstrecken.
+ Die für die Aktivierung von AWS Systems Manager erforderliche IAM-Rolle.
+ In einem der privaten Subnetze eine Amazon Linux 2-Demo-Instance mit dem neuesten SSM-Agenten. Obwohl diese Instance keine direkte Verbindung über das Internet hat, kann sie mit dem AWS Systems Manager Session Manager sicher aufgerufen werden, ohne dass ein Bastion-Host erforderlich ist.Amazon Linux 2 nähert sich dem Ende des Supports. Weitere Informationen finden Sie unter [Amazon Linux FAQs 2.](https://aws.amazon.com/amazon-linux-2/faqs/)
Weitere Informationen zum Zugriff auf eine private EC2 Amazon-Instance mit Session Manager, ohne dass ein Bastion-Host erforderlich ist, finden Sie im Blogbeitrag [Toward a bastion-less world](https://aws.amazon.com/blogs/infrastructure-and-automation/toward-a-bastion-less-world/). | App-Entwickler, AWS-Administrator, AWS DevOps |
| Melden Sie sich bei der Amazon EC2 Linux-Instance an. | Gehen Sie wie folgt vor, um eine Verbindung zur Amazon EC2 Linux-Instance im privaten Subnetz herzustellen:1. Öffnen Sie die EC2 Amazon-Konsole.
2. Wählen Sie im Navigationsbereich **Instances** aus.
3. Wählen Sie die Amazon Linux 2-Demo-Instance und dann **Connect** aus.Amazon Linux 2 nähert sich dem Ende des Supports. Weitere Informationen finden Sie unter [Amazon Linux FAQs 2.](https://aws.amazon.com/amazon-linux-2/faqs/)
4. Klicken Sie auf **Session Manager**.
5. Wählen Sie **Connect**, um ein neues Terminalfenster zu öffnen.
6. Führen Sie den folgenden Befehl aus. sudo su
| App-Developer |
| Installieren und starten Sie Docker. | Gehen Sie wie folgt vor, um Docker in der Amazon EC2 Linux-Instance zu installieren und zu starten:1. Führen Sie den folgenden Befehl aus, um Docker zu installieren.yum install -y docker
2. Führen Sie den folgenden Befehl aus, um den Docker-Dienst zu starten. service docker start
3. Führen Sie den folgenden Befehl aus, um die Docker-Installation zu überprüfen.docker info
| App-Entwickler, AWS-Administrator, AWS DevOps |
| Installiere Git und klone das Repository. | Gehen Sie wie folgt vor, um Git auf der Amazon EC2 Linux-Instance zu installieren und das Repository von GitHub zu klonen.1. Führen Sie den folgenden Befehl aus, um Git zu installieren.yum install git -y
2. Führen Sie den folgenden Befehl aus, um das Repository zu klonen.git clone https://github.com//.git
3. Führen Sie den folgenden Befehl aus, um zur Dockerfile zu navigieren.cd /DemoNetCoreWebAPI/
| App-Entwickler, AWS-Administrator, AWS DevOps |
| Erstellen Sie den Docker-Container und führen Sie ihn aus. | Gehen Sie wie folgt vor, um das Docker-Image zu erstellen und den Container in der Amazon EC2 Linux-Instance auszuführen:1. Führen Sie den folgenden Befehl aus, um das Docker-Image zu erstellen.docker build -t aspnetcorewebapiimage -f Dockerfile .
2. Führen Sie den folgenden Befehl aus, um alle Docker-Images anzuzeigen.docker images
3. Führen Sie den folgenden Befehl aus, um den Container zu erstellen und auszuführen.docker run -d -p 80:80 --name aspnetcorewebapicontainer aspnetcorewebapiimage
| App-Entwickler, AWS-Administrator, AWS DevOps |
### Testen Sie die Web-API
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Testen Sie die Web-API mit dem Befehl curl. | Führen Sie den folgenden Befehl aus, um die Web-API zu testen.curl -X GET "http://localhost/WeatherForecast" -H "accept: text/plain"
Überprüfen Sie die API-Antwort.Sie können die curl-Befehle für jeden Endpunkt von Swagger abrufen, wenn Sie ihn lokal ausführen. | App-Developer |
### Bereinigen von Ressourcen
| Aufgabe | Description | Erforderliche Fähigkeiten |
| --- | --- | --- |
| Löschen Sie alle Ressourcen. | Löschen Sie den Stapel, um alle Ressourcen zu entfernen. Dadurch wird sichergestellt, dass Ihnen keine Dienste in Rechnung gestellt werden, die Sie nicht nutzen. | AWS-Administrator, AWS DevOps |
## Zugehörige Ressourcen
+ [Stellen Sie mithilfe von PuTTY von Windows aus eine Connect zu Ihrer Linux-Instance her](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html)
+ [Erstellen Sie eine Web-API mit ASP.NET Core](https://docs.microsoft.com/en-us/aspnet/core/tutorials/first-web-api?view=aspnetcore-5.0&tabs=visual-studio)
+ [Auf dem Weg zu einer Welt ohne Bastionen](https://aws.amazon.com/blogs/infrastructure-and-automation/toward-a-bastion-less-world/)