Tutorial: Ein Projekt mit einem GitHub Quell-Repository erstellen

Mit kannst du dein Repository so einrichtenAWS CodeStar, dass es Pull-Requests erstellt, überprüft und mit deinem Projektteam zusammenführt.

In diesem Tutorial erstellen Sie ein Projekt mit Beispielquellcode für Webanwendungen in einem GitHub Repository, einer Pipeline, die Ihre Änderungen bereitstellt, und EC2-Instances, in denen Ihre Anwendung in der Cloud gehostet wird. Nachdem Ihr Projekt erstellt wurde, zeigt Ihnen dieses Tutorial, wie Sie eine GitHub Pull-Anfrage erstellen und zusammenführen, die eine Änderung an der Startseite Ihrer Webanwendung vornimmt.

Schritt 1: Erstellen Sie das Projekt und erstellen Sie Ihr GitHub Repository

Verwenden Sie in diesem Schritt die Konsole, um Ihr Projekt zu erstellen und eine Verbindung zu Ihrem neuen GitHub Repository herzustellen. Um auf Ihr GitHub Repository zuzugreifen, erstellen Sie eine Verbindungsressource, mit AWS CodeStar der die Autorisierung verwaltet wird GitHub. Wenn das Projekt erstellt wird, werden die zusätzlichen Ressourcen für Sie bereitgestellt.

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

2. Wählen Sie die AWS-Region, in der Sie das Projekt und seine Ressourcen erstellen möchten.

3. Wählen Sie auf der AWS CodeStarSeite die Option Projekt erstellen aus.

4. Aktivieren Sie auf der Seite Projektvorlage auswählen die Kontrollkästchen Webanwendung, Node.js und Amazon EC2. Wählen Sie dann aus den Vorlagen für diese Optionen aus.

   Weitere Informationen finden Sie unter AWS CodeStar-Projektvorlagen.

5. Wählen Sie Weiter.

6. Geben Sie für Project name (Projektname) einen Namen für Ihr Projekt ein (z. B.: MyTeamProject). Wenn Sie einen anderen Namen vergeben, müssen Sie diesen im gesamten Tutorial verwenden.

7. Wählen Sie unter Projekt-Repository die Option GitHub.

8. Wenn Sie möchten GitHub, müssen Sie eine Verbindungsressource auswählen oder erstellen. Wenn Sie bereits eine Verbindung haben, wählen Sie diese im Suchfeld aus. Andernfalls erstellen Sie hier eine neue Verbindung. Wählen Sie Connect GitHub.

   Die Seite Verbindung erstellen wird angezeigt.

   Anmerkung

   Um eine Verbindung herzustellen, benötigen Sie ein GitHub Konto. Wenn Sie eine Verbindung für eine Organisation herstellen, müssen Sie der Eigentümer der Organisation sein.

   

   1. Geben Sie unter GitHub App-Verbindung erstellen im Feld Verbindungsname einen Namen für Ihre Verbindung ein. Wählen Sie Connect GitHub.

      Auf der GitHub Seite Connect wird das Feld GitHub Apps angezeigt und angezeigt.

   2. Wählen Sie unter GitHub Apps eine App-Installation aus oder wählen Sie Neue App installieren, um eine zu erstellen.

      Anmerkung

      Sie installieren eine App für alle Verbindungen mit einem bestimmten Anbieter. Wenn Sie den AWS Connector für GitHub App bereits installiert haben, wählen Sie ihn aus und überspringen Sie diesen Schritt.

   3. Wählen Sie auf der GitHub Seite AWSConnector installieren für das Konto aus, in dem Sie die App installieren möchten.

      Anmerkung

      Wenn Sie die App schon einmal installiert haben, können Sie Configure (Konfiguration) wählen und mit einer Änderungsseite für die App-Installation fortfahren. Alternativ kommen Sie über die Schaltfläche „Back“ (Zurück) zur Konsole zurück.

   4. Wenn die Seite „Passwort bestätigen, um fortzufahren“ angezeigt wird, geben Sie Ihr GitHub Passwort ein und wählen Sie dann Anmelden aus.

   5. Behalten Sie auf der GitHub Seite „AWSConnector installieren für“ die Standardeinstellungen bei und wählen Sie Installieren aus.

   6. Auf der GitHub Seite Connect wird die Installations-ID für Ihre neue Installation unter GitHubApps angezeigt.

      Nachdem die Verbindung erfolgreich hergestellt wurde, wird auf der Seite „Projekt CodeStar erstellen“ die Meldung Bereit zur Verbindung angezeigt.

      Anmerkung

      Sie können Ihre Verbindung in der Developer Tools-Konsole unter Einstellungen einsehen. Weitere Informationen finden Sie unter Erste Schritte mit Verbindungen.

      

   7. Wählen Sie als Repository-Besitzer die GitHub Organisation oder Ihr persönliches GitHub Konto aus.

   8. Akzeptieren Sie für GitHubRepository-Name den Standard-Repository-Namen oder geben Sie einen anderen ein.

   9. Wählen Sie Öffentlich oder Privat.

      Anmerkung

      Wenn Sie es AWS Cloud9 als Entwicklungsumgebung verwenden möchten, müssen Sie ein öffentliches Repository wählen.

   10. (Optional) Geben Sie unter Beschreibung des Repositorys eine Beschreibung für das GitHub Repository ein.

9. Konfigurieren Sie Ihre Amazon EC2 EC2-Instances in der Amazon EC2 EC2-Konfiguration, wenn Ihr Projekt auf Amazon EC2 EC2-Instances bereitgestellt wird und Sie Änderungen vornehmen möchten. Sie können beispielsweise aus den verfügbaren Instance-Typen für Ihr Projekt eine Auswahl treffen.

   Wählen Sie unter key pair das Amazon EC2 EC2-Schlüsselpaar aus, in Schritt 4: Erstellen Sie ein Amazon EC2 EC2-Schlüsselpaar für Projekte AWS CodeStar dem Sie es erstellt haben. Wählen Sie Ich bestätige, dass ich Zugriff auf die private Schlüsseldatei habe.

10. Wählen Sie Weiter aus.

11. Überprüfen Sie die Ressourcen und Konfigurationsdetails.

12. Wählen Sie Next (Weiter) oder Create project (Projekt erstellen). (Die angezeigte Wahlmöglichkeit hängt von Ihrer Projektvorlage ab.)

    Warten Sie ein paar Minuten, bis Ihr Projekt erstellt ist.

13. Nachdem Ihr Projekt erstellt wurde, wählen Sie Anwendung anzeigen, um Ihre Webanwendung anzuzeigen.

Schritt 2: Sehen Sie sich Ihren Quellcode an

In diesem Schritt sehen Sie sich Ihren Quellcode und die Tools an, die Sie für Ihr Quell-Repository verwenden können.

1. Wählen Sie in der Navigationsleiste für Ihr Projekt Repository aus.

   Um eine Liste der Commits in anzuzeigen GitHub, wähle Commits anzeigen. Dadurch wird Ihr Commit-Verlauf in geöffnet. GitHub

   Um Probleme anzuzeigen, wählen Sie den Tab Probleme für Ihr Projekt. Um ein neues Problem zu erstellen GitHub, wählen Sie GitHubAusgabe erstellen. Dadurch wird Ihr Repository-Problemformular in geöffnet GitHub.

2. Wählen Sie auf der Registerkarte Repository den Link unter Repository-Name aus, und das Repository Ihres Projekts wird in einem neuen Tab oder Fenster geöffnet. Dieses Repository enthält den Quellcode für Ihr Projekt.

Schritt 3: Erstellen Sie eine GitHub Pull-Anfrage

In diesem Schritt nehmen Sie eine geringfügige Änderung an Ihrem Quellcode vor und erstellen eine Pull-Anfrage.

1. Erstellen Sie GitHub unter einen neuen Feature-Branch in Ihrem Repository. Wählen Sie das Dropdown-Feld Hauptzweig und geben Sie einen neuen Zweig in das Feld mit dem Namen einfeature-branch. Wählen Sie Neuen Zweig erstellen. Der Branch wird für Sie erstellt und ausgecheckt.

2. In GitHub, nehmen Sie eine Änderung in der feature-branch Filiale vor. Öffnen Sie den öffentlichen Ordner und öffnen Sie die index.html Datei.

3. Wählen Sie in der AWS CodeStar Konsole unter Pull-Anfragen, um eine Pull-Anfrage zu erstellen GitHub, die Option Pull-Anfrage erstellen aus. Dadurch wird dein Repository-Pull-Request-Formular in geöffnet GitHub. Wählen Sie in GitHub das Stiftsymbol, um die Datei zu bearbeiten.

   Fügen Sie Congratulations! anschließend die Zeichenfolge hinzu Well done, <name>! und <name> ersetzen Sie sie durch Ihren Namen. Wählen Sie Commit changes (Änderungen übernehmen) aus. Die Änderung gilt für Ihren Feature-Branch.

4. Wählen Sie in der AWS CodeStar Konsole Ihr Projekt aus. Wählen Sie die Registerkarte Repository. Wählen Sie unter Pull-Anfragen die Option Pull-Anfrage erstellen aus.

   Das Formular wird in geöffnet GitHub. Belassen Sie den Hauptzweig im Basiszweig. Wählen Sie unter Vergleichen mit Ihren Feature-Branch aus. Sehen Sie sich den Unterschied an.

5. Wählen Sie GitHub unter Pull-Anfrage erstellen aus. Eine Pull-Anfrage mit dem Namen Update index.html wird erstellt.

6. Sehen Sie sich die neue Pull-Anfrage in der AWS CodeStar Konsole an. Wähle Änderungen zusammenführen, um die Änderungen in das Repository zu übernehmen und die Pull-Anfrage mit dem Hauptzweig deines Repositorys zusammenzuführen.

7. Kehren Sie zum Projekt zurück AWS CodeStar und überprüfen Sie die Pipeline-Seite. Sie sollten nun sehen, wie die Pipeline bereitgestellt wird.

8. Nachdem Ihr Projekt erstellt wurde, wählen Sie Anwendung anzeigen, um Ihre Webanwendung anzuzeigen.