Starte einASP. NETAPICore-Web-Docker-Container auf einer Amazon EC2 Linux-Instance - AWS Prescriptive Guidance
ÜbersichtVoraussetzungen und EinschränkungenArchitekturToolsEpenZugehörige Ressourcen

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.

Starte einASP. NETAPICore-Web-Docker-Container auf einer Amazon EC2 Linux-Instance

Erstellt von Vijai Anand Ramalingam () und Sreelaxmi Pai () AWS AWS

Umgebung: PoC oder Pilotprojekt

Technologien: Container und Mikroservices; Web- und mobile Apps

Arbeitslast: Microsoft

AWSDienste: AmazonEC2; Elastic Load Balancing (ELB)

Übersicht

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 einrichten, auf der Sie Ihre containerisierten Anwendungen testen AWS können, ohne dass eine aufwändige Infrastruktur für die Container-Orchestrierung erforderlich ist.

Der erste Schritt auf dem Weg zur Modernisierung besteht darin, die Anwendung zu transformieren. Wenn es ein Vermächtnis ist. NETFramework-Anwendung, auf die Sie zuerst die Laufzeit ändern müssenASP. NETKern. 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 (AmazonECS) oder Amazon Elastic Kubernetes Service (Amazon) bereitstellen. EKS 

Dieses Muster behandelt die Aspekte der Erstellung, Ausführung und Validierung der modernen Anwendungsentwicklung auf einer Amazon Elastic Compute Cloud (AmazonEC2) Linux-Instance.

Voraussetzungen und Einschränkungen

Voraussetzungen

Produktversionen

  • Visual Studio Community 2022 oder höher

Architektur

Zielarchitektur

Dieses Muster verwendet eine AWS CloudFormation Vorlage, um die im folgenden Diagramm gezeigte Architektur mit hoher Verfügbarkeit zu erstellen. Eine Amazon EC2 Linux-Instance wird in einem privaten Subnetz gestartet. AWSSystems Manager Session Manager wird verwendet, um auf die private Amazon EC2 Linux-Instance zuzugreifen und die API Ausführung im Docker-Container zu testen.

Ein Benutzer, der auf die Amazon EC2 Linux-Instance zugreift und die API Ausführung im Docker-Container testet.

  1. Zugriff auf die Linux-Instance über Session Manager

Tools

AWSDienste

  • AWSBefehlszeilenschnittstelle — Die AWS Befehlszeilenschnittstelle (AWSCLI) ist ein Open-Source-Tool für die Interaktion mit AWS Diensten ü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.

  • AWSManagementkonsole — Die AWS Managementkonsole ist eine Webanwendung, die eine breite Palette 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 für die Ausführung der AWS damit verbundenen Aufgaben benötigen.

  • AWSSystems Manager Session Manager — Session Manager ist eine vollständig verwaltete AWS Systems Manager Manager-Funktion. Mit Session Manager können Sie Ihre Amazon Elastic Compute Cloud (AmazonEC2) -Instances verwalten. Session Manager bietet eine sichere und überprüfbare Knotenverwaltung, ohne dass eingehende Ports geöffnet, Bastion-Hosts verwaltet oder Schlüssel verwaltet werden müssen. SSH

Andere Tools

  • Visual Studio 2022 — Visual Studio 2022 ist eine integrierte Entwicklungsumgebung (IDE).

  • Docker — 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

AufgabeBeschreibungErforderliche Fähigkeiten

Erstellen Sie ein BeispielASP. NETCore-Web API mit Visual Studio.

Um ein Beispiel zu erstellenASP. NETCore WebAPI, gehen Sie wie folgt vor:

  1. Öffnen Sie Visual Studio 2022.

  2. Wählen Sie Create a new project (Neues Projekt erstellen).

  3. Wählen Sie die ASP. NETVorlage für das API Core-Webprojekt und wählen Sie Weiter aus.

  4. Geben Sie den Projektnamen ein DemoNetCoreWebAPI, und wählen Sie Weiter aus.

  5. Wählen Sie Create (Erstellen) aus.

  6. Um das Projekt lokal auszuführen, drücken Sie F5.

  7. Stellen Sie mithilfe von Swagger sicher, dass der WeatherForecastAPIStandardendpunkt die Ergebnisse zurückgibt.

  8. Öffnen Sie die Befehlszeile, navigieren Sie zum Projektordner .csproj und führen Sie die folgenden Befehle aus, um das neue Web in Ihr Repository zu übertragen. API 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 auf der Grundlage der Anforderungen das entsprechende aus. NETBasisbild. Für Informationen über. NETundASP. NETBilder zum Kern finden Sie unter Docker Hub. 

  • Erstellen Sie das Dockerfile mit Visual Studio und 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
AufgabeBeschreibungErforderliche Fähigkeiten

Richten Sie die Infrastruktur ein.

Starten Sie die AWS CloudFormation Vorlage, um die Infrastruktur zu erstellen. Sie umfasst Folgendes: 

  • Eine virtuelle private Cloud (VPC), die den AWSVPCQuick Start verwendet, mit zwei öffentlichen und zwei privaten Subnetzen, die sich über zwei Availability Zones erstrecken.

  • Die erforderliche IAM Rolle, um AWS Systems Manager zu aktivieren.

  • In einem der privaten Subnetze eine Amazon Linux 2-Demo-Instance mit dem neuesten SSM Agenten. Obwohl diese Instanz keine direkte Verbindung über das Internet hat, kann sie mit AWS Systems Manager Session Manager sicher aufgerufen werden, ohne dass ein Bastion-Host erforderlich ist.

    Hinweis: Amazon Linux 2 nähert sich dem Ende des Supports. Weitere Informationen finden Sie unter Amazon Linux FAQs 2.

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.

App-Entwickler, Administrator, AWS 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.

    Hinweis: Amazon Linux 2 nähert sich dem Ende des Supports. Weitere Informationen finden Sie unter Amazon Linux FAQs 2.

  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/<username>/<repo-name>.git

  3. Führen Sie den folgenden Befehl aus, um zur Dockerfile zu navigieren.

    cd <repo-name>/DemoNetCoreWebAPI/
App-Entwickler, Administrator, AWS 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
AufgabeBeschreibungErforderliche Fähigkeiten

Testen Sie das Web API mit dem Befehl curl.

Führen Sie den folgenden Befehl ausAPI, um das Web zu testen.

curl -X GET "http://localhost/WeatherForecast" -H  "accept: text/plain"

Überprüfen Sie die API Antwort.

Hinweis: Sie können die curl-Befehle für jeden Endpunkt von Swagger abrufen, wenn Sie ihn lokal ausführen.

App-Developer
AufgabeBeschreibungErforderliche Fähigkeiten

Alle Ressourcen löschen.

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.

AWSAdministrator, AWS DevOps

Zugehörige Ressourcen