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 Docker Compose-Anwendung auf Elastic Beanstalk bereit Dieses QuickStart Tutorial führt Sie durch den Prozess der Erstellung einer Docker Compose-Anwendung mit mehreren Containern und deren Bereitstellung in einer Umgebung. AWS Elastic Beanstalk Sie erstellen eine Flask-Webanwendung mit einem Nginx-Reverse-Proxy, um zu demonstrieren, wie Docker Compose die Orchestrierung mehrerer Container vereinfacht. **Nicht für Produktionszwecke** Beispiele dienen nur zur Veranschaulichung. Verwenden Sie keine Beispielanwendungen in der Produktion. **Topics** + [Ihr AWS Konto](#docker-compose-quickstart-aws-account) + [Voraussetzungen](#docker-compose-quickstart-prereq) + [Schritt 1: Erstellen Sie eine Docker Compose-Anwendung](#docker-compose-quickstart-create-app) + [Schritt 2: Führen Sie Ihre Anwendung lokal aus](#docker-compose-quickstart-run-local) + [Schritt 3: Stellen Sie Ihre Docker Compose-Anwendung mit der EB CLI bereit](#docker-compose-quickstart-deploy) + [Schritt 4: Testen Sie Ihre Anwendung auf Elastic Beanstalk](#docker-compose-quickstart-run-eb-ap) + [Schritt 5: Bereinigen](#docker-compose-quickstart-cleanup) + [AWS Ressourcen für Ihre Anwendung](#docker-compose-quickstart-eb-resources) + [Nächste Schritte](#docker-compose-quickstart-next-steps) + [Bereitstellung mit der Elastic Beanstalk Beanstalk-Konsole](#docker-compose-quickstart-console) ## Ihr 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](#docker-compose-quickstart-prereq) ### Erstellen Sie ein AWS Konto #### Melde dich an für ein AWS-Konto Wenn Sie noch keine haben AWS-Konto, führen Sie die folgenden Schritte aus, um eine zu erstellen. **Um sich für eine anzumelden AWS-Konto** 1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup) 1. Folgen Sie den Online-Anweisungen. Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben. Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). AWS sendet Ihnen nach Abschluss des Anmeldevorgangs eine Bestätigungs-E-Mail. Sie können Ihre aktuellen Kontoaktivitäten jederzeit einsehen und Ihr Konto verwalten, indem Sie zu [https://aws.amazon.com/](https://aws.amazon.com/)gehen und **Mein Konto** auswählen. #### Erstellen eines Benutzers mit Administratorzugriff Nachdem Sie sich für einen angemeldet haben AWS-Konto, sichern Sie Ihren Root-Benutzer des AWS-Kontos AWS IAM Identity Center, aktivieren 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. Melden Sie sich [AWS-Managementkonsole](https://console.aws.amazon.com/)als Kontoinhaber an, indem Sie **Root-Benutzer** auswählen und Ihre AWS-Konto E-Mail-Adresse eingeben. Geben Sie auf der nächsten Seite Ihr Passwort ein. Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter [Anmelden als Root-Benutzer](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) im *AWS-Anmeldung -Benutzerhandbuch* zu. 1. Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für den Root-Benutzer. Anweisungen finden Sie unter [Aktivieren eines virtuellen MFA-Geräts für Ihren AWS-Konto Root-Benutzer (Konsole)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) im *IAM-Benutzerhandbuch*. **Erstellen eines Benutzers mit Administratorzugriff** 1. Aktivieren Sie das IAM Identity Center. Anweisungen finden Sie unter [Aktivieren AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) im *AWS IAM Identity Center -Benutzerhandbuch*. 1. Gewähren Sie einem Administratorbenutzer im IAM Identity Center Benutzerzugriff. *Ein Tutorial zur Verwendung von IAM-Identity-Center-Verzeichnis als Identitätsquelle finden Sie IAM-Identity-Center-Verzeichnis im Benutzerhandbuch unter [Benutzerzugriff mit der Standardeinstellung konfigurieren](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html).AWS IAM Identity Center * **Anmelden als Administratorbenutzer** + Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-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 [im *AWS-Anmeldung Benutzerhandbuch* unter Anmeldung beim AWS Access-Portal](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html). **Weiteren Benutzern Zugriff zuweisen** 1. Erstellen Sie im IAM-Identity-Center einen Berechtigungssatz, der den bewährten Vorgehensweisen für die Anwendung von geringsten Berechtigungen folgt. Anweisungen hierzu finden Sie unter [ Berechtigungssatz erstellen](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) im *AWS IAM Identity Center -Benutzerhandbuch*. 1. Weisen Sie Benutzer einer Gruppe zu und weisen Sie der Gruppe dann Single Sign-On-Zugriff zu. Eine genaue Anleitung finden Sie unter [ Gruppen hinzufügen](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) im *AWS IAM Identity Center -Benutzerhandbuch*. ## 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 (\$1) 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](https://docs.microsoft.com/en-us/windows/wsl/install-win10), um eine Windows-integrierte Version von Ubuntu und Bash zu erhalten. ### 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). ### Docker und Docker Compose Um diesem Tutorial zu folgen, benötigen Sie eine funktionierende lokale Installation von Docker und Docker Compose. Weitere Informationen finden [Sie unter Docker herunterladen und Docker](https://docs.docker.com/get-docker/) [Compose installieren auf der Docker-Dokumentationswebsite](https://docs.docker.com/compose/install/). Stellen Sie sicher, dass Docker und Docker Compose installiert sind und ausgeführt werden, indem Sie die folgenden Befehle ausführen. ``` ~$ docker info ~$ docker compose version ``` ## Schritt 1: Erstellen Sie eine Docker Compose-Anwendung In diesem Beispiel erstellen wir mit Docker Compose eine Multicontainer-Anwendung, die aus einer Flask-Webanwendung und einem Nginx-Reverse-Proxy besteht. Dies zeigt, wie Docker Compose die Orchestrierung mehrerer Container vereinfacht, die zusammenarbeiten. Die Anwendung beinhaltet eine Konfiguration zur Gesundheitsüberwachung, die es Elastic Beanstalk ermöglicht, detaillierte Anwendungsmetriken von Ihrem Nginx-Proxy zu sammeln. Die Anwendung besteht aus der folgenden Struktur: ``` ~/eb-docker-compose-flask/ |-- docker-compose.yml |-- web/ | |-- Dockerfile | |-- app.py | `-- requirements.txt |-- proxy/ | |-- Dockerfile | `-- nginx.conf `-- .platform/ `-- hooks/ `-- postdeploy/ `-- 01_setup_healthd_permissions.sh ``` Erstellen Sie die Verzeichnisstruktur und fügen Sie die folgenden Dateien hinzu: Erstellen Sie zunächst die `docker-compose.yml` Hauptdatei, die die Dienste und ihre Beziehungen definiert. **Example `~/eb-docker-compose-flask/docker-compose.yml`** ``` services: web: build: ./web expose: - "5000" nginx-proxy: build: ./proxy ports: - "80:80" volumes: - "/var/log/nginx:/var/log/nginx" depends_on: - web ``` Erstellen Sie die Flask-Webanwendung im `web` Verzeichnis. Fügen Sie Ihrer `app.py` Datei den folgenden Inhalt hinzu. **Example `~/eb-docker-compose-flask/web/app.py`** ``` from flask import Flask app = Flask(__name__) @app.route('/') def hello_world(): return 'Hello Elastic Beanstalk! This is a Docker Compose application' ``` Fügen Sie Ihrem Webservice die folgenden Inhalte hinzu`Dockerfile`. **Example `~/eb-docker-compose-flask/web/Dockerfile`** ``` FROM public.ecr.aws/docker/library/python:3.12 COPY . /app WORKDIR /app RUN pip install Flask==3.1.1 EXPOSE 5000 CMD [ "python3", "-m" , "flask", "run", "--host=0.0.0.0"] ``` Erstellen Sie den Nginx-Reverse-Proxy im `proxy` Verzeichnis. Fügen Sie Ihrer Datei den folgenden Inhalt hinzu`nginx.conf`. Diese Konfiguration beinhaltet eine Einrichtung zur Gesundheitsüberwachung, die es Elastic Beanstalk ermöglicht, detaillierte Anwendungsmetriken zu sammeln. Weitere Informationen zur Anpassung der Protokollformate für die Gesundheitsüberwachung finden Sie unter. [Format der Protokolle der erweiterten Zustandsberichte](health-enhanced-serverlogs.md) **Example `~/eb-docker-compose-flask/proxy/nginx.conf`** ``` events { worker_connections 1024; } http { include /etc/nginx/mime.types; default_type application/octet-stream; map $http_upgrade $connection_upgrade { default "upgrade"; } # Health monitoring log format for Elastic Beanstalk log_format healthd '$msec"$uri"$status"$request_time"$upstream_response_time"$http_x_forwarded_for'; upstream flask_app { server web:5000; } server { listen 80 default_server; root /usr/share/nginx/html; # Standard access log access_log /var/log/nginx/access.log; # Health monitoring log for Elastic Beanstalk if ($time_iso8601 ~ "^(\d{4})-(\d{2})-(\d{2})T(\d{2})") { set $year $1; set $month $2; set $day $3; set $hour $4; } access_log /var/log/nginx/healthd/application.log.$year-$month-$day-$hour healthd; location / { proxy_pass http://flask_app; proxy_http_version 1.1; proxy_set_header Connection $connection_upgrade; proxy_set_header Upgrade $http_upgrade; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } } ``` Fügen Sie Ihrem Proxydienst `Dockerfile` die folgenden Inhalte hinzu. **Example `~/eb-docker-compose-flask/proxy/Dockerfile`** ``` FROM public.ecr.aws/nginx/nginx:alpine COPY nginx.conf /etc/nginx/nginx.conf EXPOSE 80 ``` Erstellen Sie abschließend ein Plattform-Hook-Skript, um die erforderlichen Protokollverzeichnisse und Berechtigungen für die Zustandsüberwachung einzurichten. Plattform-Hooks ermöglichen es Ihnen, während des Bereitstellungsprozesses benutzerdefinierte Skripts auszuführen. Weitere Informationen zu Plattform-Hooks finden Sie unter[Plattform-Hooks](platforms-linux-extend.hooks.md). **Example `~/eb-docker-compose-flask/.platform/hooks/postdeploy/01_setup_healthd_permissions.sh`** ``` #!/bin/bash set -ex NGINX_CONTAINER=$(docker ps --filter "name=nginx-proxy" -q) if [ -z "$NGINX_CONTAINER" ]; then echo "Error: No nginx-proxy container found running" exit 1 fi NGINX_UID=$(docker exec ${NGINX_CONTAINER} id -u nginx) NGINX_GID=$(docker exec ${NGINX_CONTAINER} id -g nginx) mkdir -p /var/log/nginx/healthd chown -R ${NGINX_UID}:${NGINX_GID} /var/log/nginx ``` ## Schritt 2: Führen Sie Ihre Anwendung lokal aus Verwenden Sie den Befehl [docker compose up](https://docs.docker.com/compose/reference/up/), um Ihre Multicontainer-Anwendung lokal zu erstellen und auszuführen. Docker Compose erstellt beide Container-Images und startet die in Ihrer Datei definierten Dienste. `docker-compose.yml` ``` ~/eb-docker-compose-flask$ docker compose up --build ``` Die **--build** Option stellt sicher, dass Docker Compose die Container-Images erstellt, bevor die Dienste gestartet werden. Sie sollten eine Ausgabe sehen, die zeigt, dass sowohl der Webdienst als auch der Nginx-Proxy-Service gestartet werden. Navigieren Sie `http://localhost` in Ihrem Browser zu. Du solltest den Text „Hello Elastic Beanstalk\$1 Dies ist eine Docker Compose-Anwendung“. Der Nginx-Proxy empfängt Ihre Anfrage auf Port 80 und leitet sie an die Flask-Anwendung weiter, die auf Port 5000 läuft. Wenn Sie mit dem Testen fertig sind, beenden Sie die Anwendung, indem Sie **Ctrl\$1C** im Terminal drücken, oder führen Sie den folgenden Befehl in einem separaten Terminal aus: ``` ~/eb-docker-compose-flask$ docker compose down ``` ## Schritt 3: Stellen Sie Ihre Docker Compose-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 Docker Compose-Anwendung bereitzustellen** 1. Initialisieren Sie mit dem Befehl **eb init** das EB CLI-Repository. ``` ~/eb-docker-compose-flask$ eb init -p docker docker-compose-tutorial --region us-east-2 Application docker-compose-tutorial has been created. ``` Dieser Befehl erstellt eine Anwendung mit dem Namen `docker-compose-tutorial` und konfiguriert Ihr lokales Repository so, dass Umgebungen mit der neuesten Version der Docker-Plattform erstellt werden. 1. (Optional) Führen Sie **eb init** erneut aus, um ein Standardschlüsselpaar für die SSH-Verbindung zur EC2-Instance (auf der die Anwendung ausgeführt wird) zu konfigurieren. ``` ~/eb-docker-compose-flask$ 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. 1. Verwenden Sie **eb create**, um eine Umgebung zu erstellen und die Anwendung darin bereitzustellen. Elastic Beanstalk erkennt Ihre `docker-compose.yml` Datei automatisch und stellt Ihre Multi-Container-Anwendung bereit. ``` ~/eb-docker-compose-flask$ eb create docker-compose-tutorial ``` Elastic Beanstalk benötigt etwa fünf Minuten, um Ihre Umgebung zu erstellen und Ihre Multi-Container-Anwendung bereitzustellen. ## Schritt 4: Testen Sie Ihre Anwendung auf Elastic Beanstalk Wenn der Prozess zur Erstellung Ihrer Umgebung abgeschlossen ist, öffnen Sie Ihre Website mit. **eb open** ``` ~/eb-docker-compose-flask$ eb open ``` Großartig\$1 Sie haben eine Docker Compose-Anwendung mit mehreren Containern mit Elastic Beanstalk bereitgestellt\$1 Es wird ein Browserfenster mit dem für die Anwendung erstellten Domainnamen geöffnet. Sie sollten die Nachricht von Ihrer Flask-Anwendung sehen, die über den Nginx-Reverse-Proxy bereitgestellt wird. ## 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. ``` ~/eb-docker-compose-flask$ eb terminate ``` ## AWS Ressourcen für Ihre Anwendung Sie haben gerade eine Einzelinstanzanwendung erstellt, auf der mehrere Container ausgeführt werden. 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. Ihre Docker Compose-Anwendung führt mehrere Container auf einer einzigen EC2-Instance aus, wobei Elastic Beanstalk die Orchestrierung automatisch übernimmt. ## 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. Nachdem Sie ein oder zwei Beispielanwendungen bereitgestellt haben und bereit sind, mit der lokalen Entwicklung und Ausführung von Docker Compose-Anwendungen zu beginnen, finden Sie unter[Vorbereiten Ihres Docker-Images für die Bereitstellung auf Elastic Beanstalk](single-container-docker-configuration.md). ## Bereitstellung mit der Elastic Beanstalk Beanstalk-Konsole Sie können auch die Elastic Beanstalk Beanstalk-Konsole verwenden, um eine Docker Compose-Anwendung zu starten. Erstellen Sie eine ZIP-Datei, die Ihre `docker-compose.yml` Datei und alle zugehörigen Verzeichnisse und Dateien enthält, und laden Sie sie dann hoch, wenn Sie eine neue Anwendung erstellen. Eine ausführliche Anleitung dazu finden [Sie unter Erstellen einer Beispielanwendung](GettingStarted.md#GettingStarted.CreateApp) im Kapitel *Erste Schritte* dieses Handbuchs.