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. # Tutorial: Verwenden Sie CodeDeploy zum Bereitstellen einer Anwendung von GitHub In diesem Tutorial verwenden Sie, CodeDeploy um eine Beispielanwendungsrevision von GitHub für eine einzelne Amazon EC2 EC2-Instance bereitzustellen, auf der Amazon Linux ausgeführt wird, eine einzelne Red Hat Enterprise Linux (RHEL) -Instance oder eine einzelne Windows Server-Instance. Informationen zur GitHub Integration mit CodeDeploy finden Sie unter. [Integrieren CodeDeploy mit GitHub](integrations-partners-github.md) **Anmerkung** Sie können es auch verwenden CodeDeploy , um eine Anwendungsversion von GitHub auf einer Ubuntu Server-Instanz bereitzustellen. Sie können die unter beschriebene Beispielrevision verwenden oder eine Version erstellen[Tutorial: Bereitstellen einer Anwendung auf einer lokalen Instanz mit CodeDeploy (Windows Server, Ubuntu Server oder Red Hat Enterprise Linux)](tutorials-on-premises-instance.md), die mit einer Ubuntu-Server-Instanz und kompatibel ist CodeDeploy. [Schritt 2: Erstellen Sie eine Version der Beispielanwendung](tutorials-on-premises-instance-2-create-sample-revision.md) Wie Sie eine eigene Revision erstellen, erfahren Sie unter [Planen Sie eine Revision für CodeDeploy](application-revisions-plan.md) und [Hinzufügen einer Anwendungsspezifikationsdatei zu einer Revision für CodeDeploy](application-revisions-appspec-file.md). **Topics** + [Voraussetzungen](tutorials-github-prerequisites.md) + [Schritt 1: Richten Sie ein GitHub Konto ein](tutorials-github-create-github-account.md) + [Schritt 2: Erstellen Sie ein GitHub Repository](tutorials-github-create-github-repository.md) + [Schritt 3: Laden Sie eine Beispielanwendung in Ihr GitHub Repository hoch](tutorials-github-upload-sample-revision.md) + [Schritt 4: Stellen Sie eine Instanz bereit](tutorials-github-provision-instance.md) + [Schritt 5: Erstellen Sie eine Anwendung und eine Bereitstellungsgruppe](tutorials-github-create-application.md) + [Schritt 6: Stellen Sie die Anwendung auf der Instanz bereit](tutorials-github-deploy-application.md) + [Schritt 7: Überwachen und verifizieren Sie die Bereitstellung](tutorials-github-verify.md) + [Schritt 8: Bereinigen](tutorials-github-clean-up.md) # Voraussetzungen Führen Sie die folgenden Schritte durch, bevor Sie mit diesem Tutorial beginnen: + Installieren Sie Git auf Ihrem lokalen Computer. Informationen zur Installation von Git finden Sie unter [Git-Downloads](http://git-scm.com/downloads). + Führen Sie die unter [Erste Schritte mit CodeDeploy](getting-started-codedeploy.md) beschriebenen Schritte durch, einschließlich der Installation und Konfiguration der AWS CLI. Dies ist besonders wichtig, wenn Sie den verwenden möchten AWS CLI , um eine Revision von der Instanz aus GitHub bereitzustellen. # Schritt 1: Richten Sie ein GitHub Konto ein Sie benötigen ein GitHub Konto, um ein GitHub Repository zu erstellen, in dem die Revision gespeichert wird. Wenn Sie bereits ein GitHub Konto haben, fahren Sie mit fort[Schritt 2: Erstellen Sie ein GitHub Repository](tutorials-github-create-github-repository.md). 1. Gehe zu [https://github.com/join](https://github.com). 1. Geben Sie einen Benutzernamen, eine E-Mail-Adresse und ein Passwort ein. 1. Wählen Sie **Anmelden für GitHub** und folgen Sie dann den Anweisungen. # Schritt 2: Erstellen Sie ein GitHub Repository Sie benötigen ein GitHub Repository, um die Revision zu speichern. Wenn Sie bereits über ein GitHub Repository verfügen, stellen Sie sicher, dass Sie es **CodeDeployGitHubDemo** in diesem Tutorial durch seinen Namen ersetzen, und fahren Sie dann mit fort[Schritt 3: Laden Sie eine Beispielanwendung in Ihr GitHub Repository hoch](tutorials-github-upload-sample-revision.md). 1. Führen Sie auf der [GitHub Startseite](https://github.com/dashboard) einen der folgenden Schritte aus: + Wählen Sie in **Your repositories** die Option **New repository**. + Wählen Sie auf der Navigationsleiste **Create new** (**\$1**) und dann **New repository**. 1. Gehen Sie auf der Seite **Create a new repository** wie folgt vor: + Geben Sie in das Textfeld **Repository name (Repository-Name)** **CodeDeployGitHubDemo** ein. + Wählen Sie die Option **Public** aus. **Anmerkung** Die Auswahl der Standardoption **Public** bedeutet, dass alle dieses Repository sehen können. Sie können die Option **Private (Privat)** auswählen, um zu begrenzen, wer das Repository sehen und ein Commit dafür durchführen kann. + Deaktivieren Sie das Kontrollkästchen **Initialize this repository with a README**. Sie werden stattdessen im nächsten Schritt manuell eine Datei namens `README.md` erstellen. + Wählen Sie **Repository erstellen** aus. 1. Befolgen Sie die für Ihren lokalen Computer passende Anleitung, um das Repository über die Befehlszeile zu erstellen. **Anmerkung** Wenn Sie die Zwei-Faktor-Authentifizierung aktiviert haben GitHub, stellen Sie sicher, dass Sie Ihr persönliches Zugriffstoken anstelle Ihres GitHub Anmeldekennworts eingeben, wenn Sie zur Eingabe eines Kennworts aufgefordert werden. Weitere Informationen finden Sie unter [Bereitstellung Ihres 2FA-Authentifizierungscodes](https://help.github.com/articles/providing-your-2fa-authentication-code/). **Auf lokalen Linux-, macOS- oder Unix-Computern:** 1. Führen Sie im Terminal nacheinander die folgenden Befehle aus, wobei Ihr GitHub Benutzername angegeben *user-name* ist: ``` mkdir /tmp/CodeDeployGitHubDemo ``` ``` cd /tmp/CodeDeployGitHubDemo ``` ``` touch README.md ``` ``` git init ``` ``` git add README.md ``` ``` git commit -m "My first commit" ``` ``` git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git ``` ``` git push -u origin master ``` 1. Lassen Sie unter `/tmp/CodeDeployGitHubDemo` das Terminal offen. **Auf lokalen Computern mit Windows:** 1. Rufen Sie eine Eingabeaufforderung als Administrator auf und führen Sie nacheinander die folgenden Befehle aus: ``` mkdir c:\temp\CodeDeployGitHubDemo ``` ``` cd c:\temp\CodeDeployGitHubDemo ``` ``` notepad README.md ``` 1. Speichern Sie die Datei `README.md` im Editor. Schließen Sie den Editor. Führen Sie nacheinander die folgenden Befehle aus, wobei Ihr GitHub Benutzername angegeben *user-name* ist: ``` git init ``` ``` git add README.md ``` ``` git commit -m "My first commit" ``` ``` git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git ``` ``` git push -u origin master ``` 1. Lassen Sie unter `c:\temp\CodeDeployGitHubDemo` die Befehlszeile offen. # Schritt 3: Laden Sie eine Beispielanwendung in Ihr GitHub Repository hoch In diesem Schritt kopieren Sie eine Beispielrevision aus einem öffentlichen Amazon S3 S3-Bucket in Ihr GitHub Repository. (Der Einfachheit halber handelt es sich bei den für dieses Tutorial bereitgestellten Beispielrevisionen um einzelne Webseiten.) **Anmerkung** Falls Sie statt unserer Beispielrevision eine eigene Revision verwenden möchten, gilt für diese Revision Folgendes: Sie muss die unter [Planen Sie eine Revision für CodeDeploy](application-revisions-plan.md) und [Hinzufügen einer Anwendungsspezifikationsdatei zu einer Revision für CodeDeploy](application-revisions-appspec-file.md) beschriebenen Richtlinien erfüllen. Sie muss mit dem ausgewählten Instance-Typ kompatibel sein. Seien Sie von Ihrem GitHub Dashboard aus zugänglich. Wenn Ihre Revision diese Anforderungen erfüllt, können Sie direkt mit [Schritt 5: Erstellen Sie eine Anwendung und eine Bereitstellungsgruppe](tutorials-github-create-application.md) fortfahren. Wenn Sie auf einer Ubuntu Server-Instanz bereitstellen, müssen Sie eine Version, die mit einer Ubuntu-Server-Instanz kompatibel ist, in Ihr GitHub Repository hochladen und CodeDeploy. Weitere Informationen erhalten Sie unter [Planen Sie eine Revision für CodeDeploy](application-revisions-plan.md) und [Hinzufügen einer Anwendungsspezifikationsdatei zu einer Revision für CodeDeploy](application-revisions-appspec-file.md). **Topics** + [Eine Beispielrevision von einem lokalen Linux-, macOS- oder Unix-Computer übertragen](#tutorials-github-upload-sample-revision-unixes) + [Übertragen einer Beispielrevision per Push von einem lokalen Computer mit Windows](#tutorials-github-upload-sample-revision-windows) ## Eine Beispielrevision von einem lokalen Linux-, macOS- oder Unix-Computer übertragen Führen Sie bei geöffnetem Terminal, beispielsweise unter `/tmp/CodeDeployGitHubDemo` nacheinander die nachfolgenden Befehle aus. **Anmerkung** Wenn Sie die Bereitstellung auf einer Windows Server-Instanz planen, ersetzen `SampleApp_Windows.zip` Sie dies `SampleApp_Linux.zip` in den Befehlen. ``` (Amazon S3 copy command) ``` ``` unzip SampleApp_Linux.zip ``` ``` rm SampleApp_Linux.zip ``` ``` git add . ``` ``` git commit -m "Added sample app" ``` ``` git push ``` Wo *(Amazon S3 copy command)* ist einer der folgenden: + `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Linux.zip . --region us-east-2`für die Region USA Ost (Ohio) + `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Linux.zip . --region us-east-1`für die Region USA Ost (Nord-Virginia) + `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Linux.zip . --region us-west-1` für die Region USA West (Nordkalifornien) + `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Linux.zip . --region us-west-2`für die Region USA West (Oregon) + `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Linux.zip . --region ca-central-1`für die Region Kanada (Zentral) + `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Linux.zip . --region eu-west-1`für die Region Europa (Irland) + `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Linux.zip . --region eu-west-2`für die Region Europa (London) + `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Linux.zip . --region eu-west-3`für die Region Europa (Paris) + `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Linux.zip . --region eu-central-1`für die Region Europa (Frankfurt) + `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Linux.zip . --region il-central-1`für die Region Israel (Tel Aviv) + `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Linux.zip . --region ap-east-1`für die Region Asien-Pazifik (Hongkong) + `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Linux.zip . --region ap-northeast-1`für die Region Asien-Pazifik (Tokio) + `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Linux.zip . --region ap-northeast-2`für die Region Asien-Pazifik (Seoul) + `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Linux.zip . --region ap-southeast-1`für die Region Asien-Pazifik (Singapur) + `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Linux.zip . --region ap-southeast-2`für die Region Asien-Pazifik (Sydney) + `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Linux.zip . --region ap-southeast-4`für die Region Asien-Pazifik (Melbourne) + `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Linux.zip . --region ap-south-1`für die Region Asien-Pazifik (Mumbai) + `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Linux.zip . --region sa-east-1`für die Region Südamerika (São Paulo) ## Übertragen einer Beispielrevision per Push von einem lokalen Computer mit Windows Führen Sie bei geöffneter Befehlszeile, beispielsweise unter `c:\temp\CodeDeployGitHubDemo`, nacheinander die nachfolgenden Befehle aus. **Anmerkung** Wenn Sie die Bereitstellung auf einer Amazon Linux- oder RHEL-Instance planen, ersetzen Sie dies `SampleApp_Windows.zip` in `SampleApp_Linux.zip` den Befehlen. ``` (Amazon S3 copy command) ``` Entpacken Sie den Inhalt der ZIP-Datei `the` direkt in das lokale Verzeichnis (zum Beispiel `c:\temp\CodeDeployGitHubDemo`), nicht in ein neues Unterverzeichnis. ``` git add . ``` ``` git commit -m "Added sample app" ``` ``` git push ``` Wo *(Amazon S3 copy command)* ist einer der folgenden: + `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Windows.zip . --region us-east-2`für die Region USA Ost (Ohio) + `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Windows.zip . --region us-east-1`für die Region USA Ost (Nord-Virginia) + `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Windows.zip . --region us-west-1` für die Region USA West (Nordkalifornien) + `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Windows.zip . --region us-west-2`für die Region USA West (Oregon) + `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Windows.zip . --region ca-central-1`für die Region Kanada (Zentral) + `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Windows.zip . --region eu-west-1`für die Region Europa (Irland) + `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Windows.zip . --region eu-west-2`für die Region Europa (London) + `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Windows.zip . --region eu-west-3`für die Region Europa (Paris) + `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Windows.zip . --region eu-central-1`für die Region Europa (Frankfurt) + `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Windows.zip . --region il-central-1`für die Region Israel (Tel Aviv) + `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Windows.zip . --region ap-east-1`für die Region Asien-Pazifik (Hongkong) + `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Windows.zip . --region ap-northeast-1`für die Region Asien-Pazifik (Tokio) + `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Windows.zip . --region ap-northeast-2`für die Region Asien-Pazifik (Seoul) + `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Windows.zip . --region ap-southeast-1`für die Region Asien-Pazifik (Singapur) + `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Windows.zip . --region ap-southeast-2`für die Region Asien-Pazifik (Sydney) + `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Windows.zip . --region ap-southeast-4`für die Region Asien-Pazifik (Melbourne) + `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Windows.zip . --region ap-south-1`für die Region Asien-Pazifik (Mumbai) + `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Windows.zip . --region sa-east-1`für die Region Südamerika (São Paulo) Um Ihre eigene Revision auf eine Ubuntu Server-Instanz zu übertragen, kopieren Sie Ihre Revision in Ihr lokales Repo und rufen Sie dann Folgendes auf: ``` git add . git commit -m "Added Ubuntu app" git push ``` # Schritt 4: Stellen Sie eine Instanz bereit In diesem Schritt erstellen oder konfigurieren Sie die Instance, in der Sie die Beispielanwendung bereitstellen werden. Sie können die Bereitstellung auf einer Amazon EC2 EC2-Instance oder einer lokalen Instance durchführen, auf der eines der Betriebssysteme ausgeführt wird, die von unterstützt werden. CodeDeploy Weitere Informationen hierzu erhalten Sie unter [Betriebssysteme, die vom Agenten unterstützt werden CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). (Wenn Sie bereits eine Instance für die Verwendung in CodeDeploy Bereitstellungen konfiguriert haben, fahren Sie mit dem nächsten Schritt fort.) **Um eine Instanz bereitzustellen** 1. Folgen Sie den Anweisungen unter [Starten Sie eine Amazon EC2 EC2-Instance (Konsole)](instances-ec2-create.md#instances-ec2-create-console) So stellen Sie eine Instanz bereit. 1. Denken Sie beim Starten der Instance daran, auf der Seite **Tags hinzufügen** ein Tag anzugeben. Einzelheiten zur Angabe des Tags finden Sie unter[Starten Sie eine Amazon EC2 EC2-Instance (Konsole)](instances-ec2-create.md#instances-ec2-create-console). **Um zu überprüfen, ob der CodeDeploy Agent auf der Instance ausgeführt wird** + Folgen Sie den Anweisungen unter[Stellen Sie sicher, dass der CodeDeploy Agent läuft](codedeploy-agent-operations-verify.md), um zu überprüfen, ob der Agent ausgeführt wird. Nachdem Sie die Instanz erfolgreich bereitgestellt und überprüft haben, ob der CodeDeploy Agent ausgeführt wird, fahren Sie mit dem nächsten Schritt fort. # Schritt 5: Erstellen Sie eine Anwendung und eine Bereitstellungsgruppe In diesem Schritt verwenden Sie die CodeDeploy Konsole oder die, AWS CLI um eine Anwendung und eine Bereitstellungsgruppe zu erstellen, mit der Sie die Beispielversion aus Ihrem GitHub Repository bereitstellen können. ## Erstellen einer Anwendung und einer Bereitstellungsgruppe (Konsole) 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodeDeploy Konsole unter [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **Anmerkung** Melden Sie sich mit demselben Benutzer an, den Sie eingerichtet haben. [Erste Schritte mit CodeDeploy](getting-started-codedeploy.md) 1. Erweitern Sie im Navigationsbereich die Option **Bereitstellen** und wählen Sie dann **Anwendungen** aus. 1. Wählen Sie **Create application (Anwendung erstellen)** und anschließend **Custom application (Benutzerdefinierte Anwendung)**. 1. Geben Sie unter **Application name (Anwendungsname)** **CodeDeployGitHubDemo-App** ein. 1. Wählen Sie unter **Compute Platform (Plattform für die Datenverarbeitung)** die Option **EC2/On-premises (EC2/Lokal)** aus. 1. Wählen Sie **Create application** aus. 1. Wählen Sie auf der Registerkarte **Deployment groups (Bereitstellungsgruppen)**, die Option **Create deployment group (Bereitstellungsgruppe erstellen)** aus. 1. Geben Sie unter **Deployment group name (Name der Bereitstellungsgruppe)** **CodeDeployGitHubDemo-DepGrp** ein. 1. Wählen Sie **unter Servicerolle** den Namen Ihrer CodeDeploy Servicerolle aus, die Sie unter [Servicerolle erstellen für](getting-started-create-service-role.md) erstellt haben CodeDeploy. 1. Wählen Sie unter **Deployment type (Bereitstellungstyp)** die Option **In-place (Lokal)** aus. 1. Wählen Sie in der **Umgebungskonfiguration** je nach Art der Instance, die Sie verwenden, **Amazon EC2 EC2-Instances oder **On-Premises-Instances**** aus. Geben Sie in den Feldern **Key (Schlüssel)** und **Value (Wert)** den Schlüssel und den Wert des Instance-Tags ein, der auf Ihre Instance als Teil von [Schritt 4: Stellen Sie eine Instanz bereit](tutorials-github-provision-instance.md) angewendet wurde. 1. **Wählen Sie unter **Bereitstellungskonfiguration** die Option. CodeDeployDefault AllatOnce**. 1. Deaktivieren Sie unter **Load Balancer** die Option **Enable load balancing (Load Balancing aktivieren)**. 1. Erweitern Sie **Advanced (Erweitert)**. 1. Wählen Sie unter **Alarms (Alarme)** die Option **Ignore alarm configuration (Alarmkonfiguration ignorieren)** aus. 1. Wählen Sie **Create deployment group (Bereitstellungsgruppe erstellen)** und fahren Sie mit dem nächsten Schritt fort. ## Erstellen einer Anwendung und einer Bereitstellungsgruppe (CLI) 1. Rufen Sie den Befehl **create-application** zum Erstellen einer Anwendung in CodeDeploy mit dem Namen `CodeDeployGitHubDemo-App` auf: ``` aws deploy create-application --application-name CodeDeployGitHubDemo-App ``` 1. Rufen Sie den Befehl **create-deployment-group** auf, um eine Bereitstellungsgruppe mit dem Namen `CodeDeployGitHubDemo-DepGrp` zu erstellen: + Wenn Sie auf einer Amazon EC2 EC2-Instance bereitstellen, *ec2-tag-key* ist der Amazon EC2 EC2-Instance-Tag-Schlüssel, der als Teil von auf Ihre Amazon EC2 EC2-Instance angewendet wurde. [Schritt 4: Stellen Sie eine Instanz bereit](tutorials-github-provision-instance.md) + Wenn Sie auf einer Amazon EC2 EC2-Instance bereitstellen, *ec2-tag-value* ist dies der Amazon EC2 EC2-Instance-Tag-Wert, der als Teil von auf Ihre Amazon EC2 EC2-Instance angewendet wurde. [Schritt 4: Stellen Sie eine Instanz bereit](tutorials-github-provision-instance.md) + Wenn Sie die Bereitstellung auf einer lokalen Instance durchführen, *on-premises-tag-key* ist dies der lokale Instance-Tag-Schlüssel, der als Teil von auf Ihre lokale Instance angewendet wurde. [Schritt 4: Stellen Sie eine Instanz bereit](tutorials-github-provision-instance.md) + Wenn Sie die Bereitstellung auf einer lokalen Instanz durchführen, *on-premises-tag-value* ist dies der Wert des Tags für die lokale Instanz, der als Teil von auf Ihre lokale Instanz angewendet wurde. [Schritt 4: Stellen Sie eine Instanz bereit](tutorials-github-provision-instance.md) + *service-role-arn*ist der Dienstrollen-ARN für die Servicerolle, die Sie unter [Eine Servicerolle erstellen für](getting-started-create-service-role.md) erstellt haben CodeDeploy. (Befolgen Sie die Anweisungen unter [Rufen Sie die Servicerolle ARN (CLI) ab](getting-started-create-service-role.md#getting-started-get-service-role-cli), um den ARN der erforderlichen Service-Rolle zu ermitteln.) ``` aws deploy create-deployment-group --application-name CodeDeployGitHubDemo-App --ec2-tag-filters Key=ec2-tag-key,Type=KEY_AND_VALUE,Value=ec2-tag-value --on-premises-tag-filters Key=on-premises-tag-key,Type=KEY_AND_VALUE,Value=on-premises-tag-value --deployment-group-name CodeDeployGitHubDemo-DepGrp --service-role-arn service-role-arn ``` **Anmerkung** Der [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)Befehl bietet Unterstützung für die Erstellung von Triggern, die zum Senden von Amazon SNS SNS-Benachrichtigungen an Themenabonnenten über bestimmte Ereignisse in Bereitstellungen und Instances führen. Der Befehl unterstützt auch Optionen für das automatische Rollback von Bereitstellungen und die Einrichtung von Alarmen, um Bereitstellungen zu beenden, wenn die Überwachungsschwellenwerte in CloudWatch Amazon-Alarmen erreicht werden. Befehle für diese Aktionen sind in diesem Tutorial nicht enthalten. # Schritt 6: Stellen Sie die Anwendung auf der Instanz bereit In diesem Schritt verwenden Sie die CodeDeploy Konsole oder die, AWS CLI um die Beispielrevision aus Ihrem GitHub Repository auf Ihrer Instanz bereitzustellen. ## Mit der Konsole stellen Sie die Revision wie folgt bereit: 1. Klicken Sie auf der Seite **Deployment group details (Details der Bereitstellungsgruppe)** auf **Create deployment (Bereitstellung erstellen)**. 1. Wählen Sie unter **Deployment group (Bereitstellungsgruppe)** die Option **`CodeDeployGitHubDemo-DepGrp`** aus. 1. Wählen Sie **unter Revisionstyp** die Option **GitHub**. 1. Führen **Sie unter GitHub Verbinden mit** einen der folgenden Schritte aus: + Um eine Verbindung für CodeDeploy Anwendungen mit einem GitHub Konto herzustellen, melden Sie sich auf einer separaten Registerkarte GitHub im Webbrowser ab. Geben Sie **GitHub unter Konto** einen Namen ein, um diese Verbindung zu identifizieren, und wählen Sie dann **Connect GitHub**. Auf der Webseite werden Sie aufgefordert, die Interaktion mit GitHub der genannten Anwendung CodeDeploy zu autorisieren. `CodeDeployGitHubDemo-App` Fahren Sie fort mit Schritt 5. + Um eine Verbindung zu verwenden, die Sie bereits erstellt haben, wählen Sie **GitHubunter Konto** ihren Namen und dann **Connect** aus GitHub. Fahren Sie fort mit Schritt 7. + Um eine Verbindung zu einem anderen GitHub Konto herzustellen, melden Sie sich GitHub in einem separaten Webbrowser-Tab ab. Wählen **Sie Connect einem anderen GitHub Konto** verbinden und dann **Connect GitHub**. Fahren Sie fort mit Schritt 5. 1. Folgen Sie den Anweisungen auf der **Anmeldeseite**, um sich mit Ihrem GitHub Konto anzumelden. 1. Wählen Sie auf der Seite **Authorize application** die Option **Authorize application**. 1. Geben Sie auf der Seite **Einrichtung CodeDeploy erstellen** im Feld **Repository-Name** den GitHub Benutzernamen ein, mit dem Sie sich angemeldet haben, gefolgt von einem Schrägstrich (`/`), gefolgt von dem Namen des Repositorys, in das Sie Ihre Anwendungsrevision übertragen haben (z. B.***my-github-user-name*/CodeDeployGitHubDemo**). Falls Sie sich nicht sicher sind, welchen Wert Sie eingeben sollen, oder ein anderes Repository angeben möchten: 1. Rufen Sie in einem separaten Webbrowser-Tab Ihr [GitHub Dashboard](https://github.com/dashboard) auf. 1. Platzieren Sie unter **Your repositories** den Mauszeiger auf dem Namen des Ziel-Repositorys. Es erscheint ein Tooltip mit dem Namen des GitHub Benutzers oder der Organisation, gefolgt von einem Schrägstrich (`/`), gefolgt vom Namen des Repositorys. Geben Sie diesen Wert in **Repository name (Repository-Name)** ein. **Anmerkung** Wenn der Name des Ziel-Repositorys nicht in **Ihren Repositorys** angezeigt wird, verwenden Sie das ** GitHubSuchfeld**, um das Ziel-Repository und den GitHub Benutzer- oder Organisationsnamen zu suchen. 1. Geben Sie in das Feld **Commit-ID** die ID des Commits ein, der mit der Übertragung der Revision Ihrer Anwendung verknüpft ist. GitHub Falls Sie sich nicht sicher sind, welchen Wert Sie eingeben müssen: 1. Rufen Sie in einem separaten Webbrowser-Tab Ihr [GitHub Dashboard](https://github.com/dashboard) auf. 1. Wählen Sie unter **Your repositories (Ihre Repositorys)** **CodeDeployGitHubDemo** aus. 1. Suchen Sie in der Liste der Commits nach der Commit-ID, die dem Push Ihrer Anwendungsrevision zugeordnet ist, und kopieren Sie sie nach GitHub. Diese ID ist in der Regel 40 Zeichen lang und besteht aus Buchstaben und Zahlen. (Verwenden Sie nicht die kürzere Version der Commit-ID. Sie besteht in der Regel aus den ersten zehn Zeichen der längeren Version.) 1. Fügen Sie die Commit-ID in das Feld **Commit ID** ein. 1. Wählen Sie **Deploy**, und fahren Sie mit dem nächsten Schritt fort. ## Mit der CLI stellen Sie die Revision wie folgt bereit: Bevor Sie AWS CLI Befehle aufrufen können, mit denen Sie interagieren GitHub (z. B. den **create-deployment** Befehl, den Sie als Nächstes aufrufen), müssen Sie die CodeDeploy Erlaubnis erteilen, Ihr GitHub Benutzerkonto GitHub für die Interaktion mit der `CodeDeployGitHubDemo-App` Anwendung zu verwenden. Das können Sie derzeit nur über die CodeDeploy -Konsole tun. 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodeDeploy Konsole unter [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy). **Anmerkung** Melden Sie sich mit demselben Benutzer an, den Sie eingerichtet haben. [Erste Schritte mit CodeDeploy](getting-started-codedeploy.md) 1. Erweitern Sie im Navigationsbereich die Option **Bereitstellen** und wählen Sie dann **Anwendungen** aus. 1. Wählen Sie **CodeDeployGitHubDemo-App**. 1. Klicken Sie auf der Registerkarte **Deployments (Bereitstellungen)** auf **Create deployment (Bereitstellung erstellen)**. **Anmerkung** Sie erstellen keine neue Bereitstellung. Dies ist derzeit die einzige Möglichkeit, die CodeDeploy Erlaubnis zu erteilen, GitHub im Namen Ihres GitHub Benutzerkontos mit Ihnen zu interagieren. 1. Wählen Sie in **der Bereitstellungsgruppe** die Option **CodeDeployGitHubDemo-** ausDepGrp. 1. Wählen Sie unter **Revisionstyp** die Option aus **GitHub**. 1. Führen **Sie unter GitHub Verbinden mit** einen der folgenden Schritte aus: + Um eine Verbindung für CodeDeploy Anwendungen mit einem GitHub Konto herzustellen, melden Sie sich auf einer separaten Registerkarte GitHub im Webbrowser ab. Geben Sie **GitHub unter Konto** einen Namen ein, um diese Verbindung zu identifizieren, und wählen Sie dann **Connect** aus GitHub. Auf der Webseite werden Sie aufgefordert, die Interaktion mit GitHub der genannten Anwendung CodeDeploy zu autorisieren. `CodeDeployGitHubDemo-App` Fahren Sie fort mit Schritt 8. + Um eine Verbindung zu verwenden, die Sie bereits erstellt haben, wählen Sie **GitHubunter Konto** ihren Namen und dann **Connect** aus GitHub. Fahren Sie fort mit Schritt 10. + Um eine Verbindung zu einem anderen GitHub Konto herzustellen, melden Sie sich GitHub in einem separaten Webbrowser-Tab ab. Wählen **Sie Connect einem anderen GitHub Konto** verbinden und dann **Connect GitHub**. Fahren Sie fort mit Schritt 8. 1. Folgen Sie den Anweisungen auf der **Anmeldeseite**, um sich mit Ihrem GitHub Benutzernamen oder Ihrer E-Mail-Adresse und Ihrem Passwort anzumelden. 1. Wählen Sie auf der Seite **Authorize application** die Option **Authorize application**. 1. Wählen Sie auf der Seite **Bereitstellung CodeDeploy erstellen** die Option **Abbrechen** aus. 1. Rufen Sie den **create-deployment** Befehl auf, um die Revision aus Ihrem GitHub Repository für die Instance bereitzustellen. Dabei gilt: + *repository*ist Ihr GitHub Kontoname, gefolgt von einem Schrägstrich (`/`), gefolgt vom Namen Ihres Repositorys (`CodeDeployGitHubDemo`), zum Beispiel. `MyGitHubUserName/CodeDeployGitHubDemo` Falls Sie sich nicht sicher sind, welchen Wert Sie verwenden sollen, oder ein anderes Repository angeben möchten: 1. [Gehen Sie in einem separaten Webbrowser-Tab zu Ihrem GitHub Dashboard.](https://github.com/dashboard) 1. Platzieren Sie unter **Your repositories** den Mauszeiger auf dem Namen des Ziel-Repositorys. Es erscheint ein Tooltip mit dem Namen des GitHub Benutzers oder der Organisation, gefolgt von einem Schrägstrich (`/`), gefolgt vom Namen des Repositorys. Das ist der Wert, den Sie verwenden müssen. **Anmerkung** Wenn der Name des Ziel-Repositorys nicht in **Ihren Repositorys** erscheint, verwenden Sie das ** GitHubSuchfeld**, um das Ziel-Repository und den entsprechenden GitHub Benutzer- oder Organisationsnamen zu finden. + *commit-id*ist der Commit, der mit der Version der Anwendungsrevision verknüpft ist, die Sie in Ihr Repository übertragen haben (z. B.`f835159a...528eb76f`). Falls Sie sich nicht sicher sind, welchen Wert Sie verwenden müssen: 1. Rufen Sie in einem separaten Webbrowser-Tab Ihr [GitHub Dashboard](https://github.com/dashboard) auf. 1. Wählen Sie unter **Your repositories (Ihre Repositorys)** **CodeDeployGitHubDemo** aus. 1. Suchen Sie in der Liste der Commits nach der Commit-ID, die dem Push Ihrer Anwendungsrevision zugeordnet GitHub ist. Diese ID ist in der Regel 40 Zeichen lang und besteht aus Buchstaben und Zahlen. (Verwenden Sie nicht die kürzere Version der Commit-ID. Sie besteht in der Regel aus den ersten zehn Zeichen der längeren Version.) Verwenden Sie diesen Wert. Wenn Sie auf einem lokalen Linux-, macOS- oder Unix-Computer arbeiten: ``` aws deploy create-deployment \ --application-name CodeDeployGitHubDemo-App \ --deployment-config-name CodeDeployDefault.OneAtATime \ --deployment-group-name CodeDeployGitHubDemo-DepGrp \ --description "My GitHub deployment demo" \ --github-location repository=repository,commitId=commit-id ``` Wenn Sie auf einem lokalen Computer mit Windows arbeiten: ``` aws deploy create-deployment --application-name CodeDeployGitHubDemo-App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name CodeDeployGitHubDemo-DepGrp --description "My GitHub deployment demo" --github-location repository=repository,commitId=commit-id ``` # Schritt 7: Überwachen und verifizieren Sie die Bereitstellung In diesem Schritt verwenden Sie die CodeDeploy Konsole oder die, AWS CLI um den Erfolg der Bereitstellung zu überprüfen. Außerdem öffnen Sie die in der erstellten oder konfigurierten Instance bereitgestellte Webseite in Ihrem Webbrowser. **Anmerkung** Wenn Sie die Bereitstellung auf einer Ubuntu Server-Instanz durchführen, verwenden Sie Ihre eigene Teststrategie, um festzustellen, ob die bereitgestellte Version auf der Instanz erwartungsgemäß funktioniert, und fahren Sie dann mit dem nächsten Schritt fort. **Mit der Konsole überwachen und überprüfen Sie die Bereitstellung wie folgt:** 1. Erweitern Sie im Navigationsbereich die Option **Bereitstellen** und wählen Sie dann **Bereitstellungen** aus. 1. **Suchen Sie in der Liste der Bereitstellungen nach der Zeile mit dem **Anwendungswert CodeDeployGitHubDemo** **-App und dem **Bereitstellungsgruppenwert** -**. CodeDeployGitHubDemo DepGrp** Wenn weder **Succeeded** noch **Failed** in der Spalte **Status** angezeigt werden, betätigen Sie mehrmals die Schaltfläche **Refresh**. 1. Wenn **Failed** in der Spalte **Status** angezeigt wird, befolgen Sie die Anweisungen in [Instanzdetails anzeigen (Konsole)](instances-view-details.md#instances-view-details-console), um die Probleme mit der Bereitstellung zu beheben. 1. Wenn **Succeeded** in der Spalte **Status** angezeigt wird, können Sie die Bereitstellung in Ihrem Webbrowser überprüfen. Unsere Beispielrevision stellt eine einzelne Webseite in der Instance bereit. Wenn Sie die Bereitstellung auf einer Amazon EC2 EC2-Instance durchführen, gehen Sie in Ihrem Webbrowser zu `http://public-dns` für die Instance (z. B.`http://ec2-01-234-567-890.compute-1.amazonaws.com`). 1. Wenn Sie die Webseite sehen können, sind keine Fehler aufgetreten. Nachdem Sie das Deployment einer Version von erfolgreich verwendet AWS CodeDeploy haben GitHub, können Sie mit dem nächsten Schritt fortfahren[Schritt 8: Bereinigen](tutorials-github-clean-up.md). **Mit der CLI überwachen und überprüfen Sie die Bereitstellung wie folgt:** 1. Rufen Sie den Befehl **list-deployments** auf, um die Bereitstellungs-ID für die Anwendung `CodeDeployGitHubDemo-App` und die Bereitstellungsgruppe `CodeDeployGitHubDemo-DepGrp` abzurufen: ``` aws deploy list-deployments --application-name CodeDeployGitHubDemo-App --deployment-group-name CodeDeployGitHubDemo-DepGrp --query "deployments" --output text ``` 1. Rufen Sie den Befehl **get-deployment** mit der Bereitstellungs-ID aus der Ausgabe des Befehls **list-deployments** auf: ``` aws deploy get-deployment --deployment-id deployment-id --query "deploymentInfo.[status, creator]" --output text ``` 1. Wenn **Failed** zurückgegeben wird: Befolgen Sie die Anweisungen unter [Instanzdetails anzeigen (Konsole)](instances-view-details.md#instances-view-details-console), um die Probleme mit der Bereitstellung zu beheben. 1. Wenn **Succeeded** zurückgegeben wird: Überprüfen Sie die Bereitstellung in Ihrem Webbrowser. Unsere Beispielrevision ist eine einzelne Webseite, die in der Instance bereitgestellt wird. Wenn Sie die Bereitstellung auf einer Amazon EC2 EC2-Instance durchführen, können Sie diese Seite in Ihrem Webbrowser aufrufen, indem Sie zu `http://public-dns` der Amazon EC2 EC2-Instance gehen (z. B.`http://ec2-01-234-567-890.compute-1.amazonaws.com`). 1. Wenn Sie die Webseite sehen können, sind keine Fehler aufgetreten. Sie haben die Bereitstellung aus Ihrem GitHub Repository erfolgreich verwendet AWS CodeDeploy . # Schritt 8: Bereinigen Um weitere Gebühren für Ressourcen zu vermeiden, die Sie in diesem Tutorial verwendet haben, müssen Sie die Amazon EC2 EC2-Instance und die zugehörigen Ressourcen beenden. Optional können Sie auch die zu diesem Tutorial gehörenden CodeDeploy-Bereitstellungskomponentendatensätze löschen. Wenn Sie ein GitHub Repository nur für dieses Tutorial verwendet haben, können Sie es jetzt auch löschen. ## Um einen CloudFormation Stack zu löschen (wenn Sie die CloudFormation Vorlage zum Erstellen einer Amazon EC2 EC2-Instance verwendet haben) 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudFormation Konsole unter [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/). 1. Wählen Sie in der Spalte **Stacks** den Stack aus, der mit `CodeDeploySampleStack` beginnt. 1. Wählen Sie **Löschen** aus. 1. Wählen Sie bei Aufforderung **Delete stack (Stack löschen)** aus. Die Amazon EC2 EC2-Instance und das zugehörige IAM-Instance-Profil und die Service-Rolle werden gelöscht. ## Heben Sie wie folgt manuell die Registrierung einer lokalen Instance auf und bereinigen Sie sie (falls Sie eine lokale Instance bereitgestellt haben): 1. Verwenden Sie den AWS CLI , um den Befehl [deregister](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html) für die lokale Instance aufzurufen, die hier dargestellt wird durch *your-instance-name* und die zugehörige Region durch: *your-region* ``` aws deploy deregister --instance-name your-instance-name --no-delete-iam-user --region your-region ``` 1. [Rufen Sie von der lokalen Instanz aus den Befehl uninstall auf:](https://docs.aws.amazon.com/cli/latest/reference/deploy/uninstall.html) ``` aws deploy uninstall ``` ## Um eine Amazon EC2 EC2-Instance manuell zu beenden (wenn Sie eine Amazon EC2 EC2-Instance manuell gestartet haben) 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon EC2 EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. Wählen Sie im Navigationsbereich unter **Instances** die Option **Instances**. 1. Wählen Sie das Kästchen neben der Amazon EC2 EC2-Instance aus, die Sie beenden möchten. Zeigen Sie im Menü **Actions** auf **Instance State**, und wählen Sie dann **Terminate**. 1. Wählen Sie bei Aufforderung **Yes, Terminate**. ## Um die Datensätze der CodeDeploy Bereitstellungskomponenten zu löschen 1. Melden Sie sich bei [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) an AWS-Managementkonsole und öffnen Sie die CodeDeploy Konsole. **Anmerkung** Melden Sie sich mit demselben Benutzer an, den Sie eingerichtet haben. [Erste Schritte mit CodeDeploy](getting-started-codedeploy.md) 1. Erweitern Sie im Navigationsbereich die Option **Bereitstellen** und wählen Sie dann **Anwendungen** aus. 1. Wählen Sie **CodeDeployGitHubDemo-App**. 1. Klicken Sie auf **Delete Application (Anwendung löschen)**. 1. Geben Sie bei der Aufforderung **Delete** ein und klicken Sie dann auf **Delete (Löschen)**. ## Um dein GitHub Repository zu löschen Weitere Informationen finden [Sie in der [GitHub Hilfe](https://help.github.com) unter Löschen eines Repositorys](https://help.github.com/articles/deleting-a-repository/).