Integrieren CodeDeploy mit GitHub

CodeDeploy unterstützt GitHub, einen webbasierten Dienst zum Hosten und Teilen von Code. CodeDeploy kann Anwendungsrevisionen, die in GitHub Repositorys oder Amazon S3 S3-Buckets gespeichert sind, für Instances bereitstellen. CodeDeploy unterstützt nur GitHub EC2/lokale Bereitstellungen.

CodeDeploy Revisionen werden bereitgestellt von GitHub

So stellen Sie eine Anwendungsrevision aus einem GitHub Repository auf Instanzen bereit:

1. Erstellen Sie eine Version, die kompatibel ist mit CodeDeploy und dem Amazon EC2 EC2-Instance-Typ, für den Sie die Bereitstellung durchführen möchten.

   Zum Erstellen einer kompatiblen Revision befolgen Sie die Anweisungen in Planen Sie eine Überarbeitung für CodeDeploy und Hinzufügen einer Anwendungsspezifikationsdatei zu einer Revision für CodeDeploy.

2. Verwenden Sie ein GitHub Konto, um Ihre Version zu einem GitHub Repository hinzuzufügen.

   Informationen zum Erstellen eines GitHub Kontos finden Sie unter Beitreten GitHub. Informationen zum Erstellen eines GitHub Repositorys finden Sie unter Repo erstellen.

3. Verwenden Sie die Seite „Bereitstellung erstellen“ in der CodeDeploy Konsole oder den AWS CLI create-deployment Befehl, um Ihre Revision aus Ihrem GitHub Repository auf Ziel-Instances bereitzustellen, die für die Verwendung in CodeDeploy Bereitstellungen konfiguriert sind.

   Wenn Sie den create-deployment Befehl aufrufen möchten, müssen Sie zunächst GitHub auf der Seite „Bereitstellung erstellen“ der Konsole die CodeDeploy Erlaubnis erteilen, im Namen Ihres bevorzugten GitHub Kontos mit der angegebenen Anwendung zu interagieren. Sie müssen dies nur einmal für jede Anwendung tun.

   Informationen zur Verwendung der Seite „Bereitstellung erstellen“ für die Bereitstellung aus einem GitHub Repository finden Sie unterErstellen Sie eine Bereitstellung mit CodeDeploy.

   Informationen zum Aufrufen des create-deployment Befehls zur Bereitstellung aus einem GitHub Repository finden Sie unterErstellen Sie eine EC2 /On-Premises Compute Platform-Bereitstellung () CLI.

   Informationen zum Vorbereiten von Instanzen für die Verwendung in CodeDeploy Bereitstellungen finden Sie unterArbeiten mit Instanzen für CodeDeploy.

Weitere Informationen finden Sie unter Tutorial: Verwenden Sie CodeDeploy zum Bereitstellen einer Anwendung von GitHub.

GitHub Verhalten mit CodeDeploy

Themen

• GitHub Authentifizierung mit Anwendungen in CodeDeploy
• CodeDeploy Interaktion mit privaten und öffentlichen Repositorien GitHub
• CodeDeploy Interaktion mit von der Organisation verwalteten Repositorys GitHub
• Automatisch bereitstellen von CodePipeline mit CodeDeploy

GitHub Authentifizierung mit Anwendungen in CodeDeploy

Nachdem Sie die CodeDeploy Erlaubnis zur Interaktion erteilt haben GitHub, wird die Verknüpfung zwischen diesem GitHub Konto und der Anwendung in gespeichert CodeDeploy. Sie können die Anwendung mit einem anderen GitHub Konto verknüpfen. Sie können auch die Erlaubnis CodeDeploy zur Interaktion mit widerrufen GitHub.

Um ein GitHub Konto mit einer Anwendung zu verknüpfen in CodeDeploy

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodeDeploy Konsole unter https://console.aws.amazon.com/codedeploy.

   Anmerkung

   Melden Sie sich mit demselben Benutzer an, den Sie eingerichtet habenErste Schritte mit CodeDeploy.

2. Erweitern Sie im Navigationsbereich die Option Bereitstellen und wählen Sie dann Anwendungen aus.

3. Wählen Sie die Anwendung aus, die Sie mit einem anderen GitHub Konto verknüpfen möchten.

4. Wenn Ihre Anwendung keine Bereitstellungsgruppe hat, wählen Sie Bereitstellungsgruppe erstellen, um eine zu erstellen. Weitere Informationen finden Sie unter Erstellen Sie eine Bereitstellungsgruppe mit CodeDeploy. Eine Bereitstellungsgruppe ist erforderlich, um im nächsten Schritt Bereitstellung erstellen auszuwählen.

5. Wählen Sie unter Bereitstellungen die Option Bereitstellung erstellen.

   Anmerkung

   Sie müssen keine neue Bereitstellung erstellen. Dies ist derzeit die einzige Möglichkeit, ein anderes GitHub Konto mit einer Anwendung zu verknüpfen.

6. Wählen Sie in den Bereitstellungseinstellungen für Revisionstyp die Option Meine Anwendung ist gespeichert in aus GitHub.

7. Führen Sie eine der folgenden Aktionen aus:

   • Um eine Verbindung für AWS CodeDeploy Anwendungen mit einem GitHub Konto herzustellen, melden Sie sich auf einer separaten Registerkarte GitHub im Webbrowser ab. Geben Sie im Feld GitHub Tokenname einen Namen zur Identifizierung dieser Verbindung ein, und wählen Sie dann Connect aus GitHub. Auf der Webseite werden Sie aufgefordert, die Interaktion mit GitHub Ihrer CodeDeploy Anwendung zu autorisieren. Fahren Sie fort mit Schritt 10.

   • Um eine Verbindung zu verwenden, die Sie bereits erstellt haben, wählen Sie im Feld GitHubTokenname den Namen aus, und klicken Sie dann auf Connect GitHub. Fahren Sie fort mit Schritt 8.

   • Um eine Verbindung zu einem anderen GitHub Konto herzustellen, melden Sie sich GitHub in einem separaten Webbrowser-Tab ab. Geben Sie im Feld GitHub Tokenname einen Namen zur Identifizierung der Verbindung ein, und wählen Sie dann Connect aus GitHub. Auf der Webseite werden Sie aufgefordert, die Interaktion mit GitHub Ihrer CodeDeploy Anwendung zu autorisieren. Fahren Sie fort mit Schritt 10.

8. Wenn Sie noch nicht angemeldet sind GitHub, folgen Sie den Anweisungen auf der Anmeldeseite, um sich mit dem GitHub Konto anzumelden, mit dem Sie die Anwendung verknüpfen möchten.

9. Wählen Sie Anwendung autorisieren aus. GitHub CodeDeployerteilt die Erlaubnis, im Namen des GitHub angemeldeten GitHub Kontos mit der ausgewählten Anwendung zu interagieren.

10. Wenn Sie keine Bereitstellung erstellen möchten, wählen Sie Cancel.

Um die Erlaubnis zur Interaktion zu CodeDeploy widerrufen GitHub

1. Melden Sie sich GitHub mit den Anmeldeinformationen für das GitHub Konto an, für das Sie die AWS CodeDeploy Erlaubnis widerrufen möchten.

2. Öffnen Sie die Seite GitHub Anwendungen, suchen Sie CodeDeployin der Liste der autorisierten Anwendungen nach, und folgen Sie dann den Anweisungen GitHub zum Widerrufen der Autorisierung für eine Anwendung.

CodeDeploy Interaktion mit privaten und öffentlichen Repositorien GitHub

CodeDeploy unterstützt die Bereitstellung von Anwendungen aus privaten und öffentlichen GitHub Repositorien. Wenn Sie in Ihrem Namen die CodeDeploy Erlaubnis zum Zugriff GitHub erteilen, CodeDeploy hat er Lese- und Schreibzugriff auf alle privaten GitHub Repositorys, auf die Ihr GitHub Konto Zugriff hat. Liest jedoch CodeDeploy nur aus Repositorys. GitHub Es wird in keines Ihrer privaten GitHub Repositorys schreiben.

CodeDeploy Interaktion mit von der Organisation verwalteten Repositorys GitHub

Standardmäßig gewähren GitHub Repositorys, die von einer Organisation verwaltet werden (im Gegensatz zu den eigenen privaten oder öffentlichen Repositorys Ihres Kontos), keinen Zugriff auf Anwendungen von Drittanbietern, einschließlich. CodeDeploy Ihre Bereitstellung schlägt fehl, wenn die Einschränkungen für Drittanbieteranwendungen einer Organisation aktiviert sind GitHub und Sie versuchen, Code aus ihrem GitHub Repository bereitzustellen. Dieses Problem lässt sich auf zweierlei Weise lösen.

• Als Mitglied einer Organisation können Sie den Eigentümer der Organisation bitten, den Zugriff auf zu genehmigen CodeDeploy. Die Schritte zur Beantragung dieses Zugriffs hängen davon ab, ob Sie bereits eine Autorisierung CodeDeploy für Ihr individuelles Konto vorgenommen haben:

  • Wenn Sie CodeDeploy in Ihrem Konto autorisierten Zugriff darauf haben, finden Sie weitere Informationen unter Beantragung der Genehmigung Ihrer autorisierten Anwendungen durch die Organisation.

  • Wenn Sie CodeDeploy in Ihrem Konto noch keinen autorisierten Zugriff darauf haben, finden Sie weitere Informationen unter Beantragung der Genehmigung durch die Organisation für Anwendungen von Drittanbietern.

• Der Eigentümer der Organisation kann alle für Drittanbieteranwendungen geltenden Beschränkungen der Organisation deaktivieren. Weitere Informationen finden Sie unter Einschränkungen für Drittanbieteranwendungen für Ihr Unternehmen deaktivieren.

Weitere Informationen finden Sie unter Einschränkungen für Drittanbieteranwendungen.

Automatisch bereitstellen von CodePipeline mit CodeDeploy

Sie können eine Bereitstellung von a aus auslösen CodePipeline , wenn sich der Quellcode ändert. Weitere Informationen finden Sie unter CodePipeline.