Tutoriel : Création d'un projet avec un référentiel GitHub source

Vous pouvez ainsi configurer votre référentiel pour créer, examiner et fusionner des pull requests avec votre équipe de projet. AWS CodeStar

Dans ce didacticiel, vous allez créer un projet avec un exemple de code source d'application Web dans un GitHub référentiel, un pipeline qui déploie vos modifications et des instances EC2 où votre application est hébergée dans le cloud. Une fois votre projet créé, ce didacticiel explique comment créer et fusionner une GitHub pull request qui modifie la page d'accueil de votre application Web.

Étape 1 : Création du projet et création de votre GitHub référentiel

Au cours de cette étape, utilisez la console pour créer votre projet et créer une connexion à votre nouveau GitHub référentiel. Pour accéder à votre GitHub référentiel, vous créez une ressource de connexion qui AWS CodeStar permet de gérer les autorisations avec GitHub. Lorsque le projet est créé, ses ressources supplémentaires sont mises à votre disposition.

1. Connectez-vous à la AWS CodeStar consoleAWS Management Console, puis ouvrez-la à l'adresse https://console.aws.amazon.com/codestar/.

2. Choisissez la région AWS dans laquelle vous souhaitez créer le projet et ses ressources.

3. Sur la AWS CodeStarpage, choisissez Créer un projet.

4. Sur la page Choisir un modèle de projet, cochez les cases Application Web, Node.js et Amazon EC2. Ensuite, choisissez parmi les modèles disponibles pour cet ensemble d'options.

   Pour plus d'informations, veuillez consulter Modèles de projet AWS CodeStar.

5. Choisissez Suivant.

6. Pour Nom du projet, entrez un nom pour le projet (par exemple, MyTeamProject). Si vous utilisez un autre nom, veillez à l'utiliser tout au long de ce didacticiel.

7. Sous Référentiel de projets, choisissez GitHub.

8. Si vous le souhaitez GitHub, vous devrez choisir ou créer une ressource de connexion. Si vous avez déjà une connexion, sélectionnez-la dans le champ de recherche. Dans le cas contraire, vous allez créer une nouvelle connexion ici. Choisissez Connect to GitHub.

   La page Créer une connexion s'affiche.

   Note

   Pour créer une connexion, vous devez disposer d'un GitHub compte. Si vous créez une connexion pour une organisation, vous devez en être le propriétaire.

   

   1. Sous Créer une connexion à GitHub l'application, dans Nom de la connexion, entrez le nom de votre connexion. Choisissez Connect to GitHub.

      La GitHub page Connect to affiche et affiche le champ GitHub Applications.

   2. Sous GitHub Applications, choisissez une installation d'application ou choisissez Installer une nouvelle application pour en créer une.

      Note

      Installez une application pour toutes vos connexions à un fournisseur particulier. Si vous avez déjà installé le AWS Connector for GitHub app, choisissez-le et ignorez cette étape.

   3. Sur la GitHub page Installer le AWS connecteur pour, choisissez le compte sur lequel vous souhaitez installer l'application.

      Note

      Si vous avez déjà installé l'application, vous pouvez choisir Configure (Configurer) pour passer à une page de modification pour l'installation de votre application, ou vous pouvez utiliser le bouton Précédent pour revenir à la console.

   4. Si la page Confirmer le mot de passe pour continuer s'affiche, entrez votre GitHub mot de passe, puis choisissez Se connecter.

   5. Sur la GitHub page Installer le AWS connecteur pour, laissez les valeurs par défaut et choisissez Installer.

   6. Sur la GitHub page Connect to, l'ID d'installation de votre nouvelle installation apparaît dans GitHubApps.

      Une fois la connexion créée avec succès, le message Ready to connect s'affiche sur la page de CodeStar création de projet.

      Note

      Vous pouvez consulter votre connexion dans les paramètres de la console Developer Tools. Pour plus d'informations, voir Commencer à utiliser les connexions.

      

   7. Pour Propriétaire du référentiel, choisissez l' GitHuborganisation ou votre GitHub compte personnel.

   8. Pour Nom du référentiel, acceptez le nom du GitHub référentiel par défaut ou saisissez-en un autre.

   9. Choisissez Public ou Privé.

      Note

      Si vous souhaitez l'utiliser AWS Cloud9 comme environnement de développement, vous devez choisir un dépôt public.

   10. (Facultatif) Dans Description du référentiel, entrez une description pour le GitHub référentiel.

9. Configurez vos instances Amazon EC2 dans Configuration Amazon EC2 si votre projet est déployé sur des instances Amazon EC2 et que vous souhaitez apporter des modifications. Par exemple, vous pouvez choisir des types d'instances disponibles pour votre projet.

   Dans Key pair, choisissez la paire de clés Amazon EC2 que vous avez créée dans. Étape 4 : Création d'une paire de clés Amazon EC2 pour les projets AWS CodeStar Sélectionnez Je reconnais avoir accès au fichier de clé privée.

10. Choisissez Suivant.

11. Examinez les ressources et les détails de configuration.

12. Choisissez Suivant ou Créer un projet. (Le choix affiché dépend de votre modèle de projet.)

    Attendez quelques minutes pendant la création de votre projet.

13. Une fois votre projet créé, choisissez Afficher l'application pour afficher votre application Web.

Étape 2 : Afficher votre code source

Au cours de cette étape, vous visualisez votre code source et les outils que vous pouvez utiliser pour votre référentiel de sources.

1. Dans la barre de navigation de votre projet, choisissez Repository.

   Pour afficher la liste des validations dans GitHub, choisissez Afficher les validations. Cela ouvre l'historique de vos validations dans GitHub.

   Pour consulter les problèmes, choisissez l'onglet Problèmes correspondant à votre projet. Pour créer un nouveau problème dans GitHub, choisissez Créer un GitHub problème. Cela ouvre le formulaire de demande de dépôt dans GitHub.

2. Dans l'onglet Référentiel, cliquez sur le lien sous Nom du référentiel, et le référentiel de votre projet s'ouvre dans un nouvel onglet ou une nouvelle fenêtre. Ce dépôt contient le code source de votre projet.

Étape 3 : créer une GitHub pull request

Au cours de cette étape, vous apportez une modification mineure à votre code source et créez une pull request.

1. Dans GitHub, créez une nouvelle branche de fonctionnalités dans votre référentiel. Choisissez le champ déroulant de la branche principale et entrez une nouvelle branche dans le champ nomméfeature-branch. Choisissez Créer une nouvelle branche. La succursale est créée et extraite pour vous.

2. Dans GitHub, apportez une modification dans la feature-branch branche. Ouvrez le dossier public et ouvrez le index.html fichier.

3. Dans la AWS CodeStar console, sous Pull requests, pour créer une pull request dans GitHub, choisissez Create pull request. Cela ouvre le formulaire de pull request de votre dépôt dans GitHub. Dans GitHub, choisissez l'icône en forme de crayon pour modifier le fichier.

   EnsuiteCongratulations!, ajoutez la chaîne Well done, <name>! et remplacez-la <name> par votre nom. Choisissez Valider les modifications. La modification est validée dans votre branche de fonctionnalités.

4. Dans la AWS CodeStar console, choisissez votre projet. Choisissez l'onglet Référentiel. Sous Pull requests, choisissez Create pull request.

   Le formulaire s'ouvre dans GitHub. Laissez la branche principale dans la branche de base. Pour Comparer à, choisissez votre branche de fonctionnalités. Afficher le diff.

5. Dans GitHub, choisissez Create pull request. Une pull request nommée Update index.html est créée.

6. Dans la AWS CodeStar console, consultez la nouvelle pull request. Choisissez Fusionner les modifications pour valider les modifications dans le référentiel et fusionner la pull request avec la branche principale de votre référentiel.

7. Retournez au projet AWS CodeStar et consultez la page Pipeline. Vous devriez désormais voir le pipeline en cours de déploiement.

8. Une fois votre projet créé, choisissez Afficher l'application pour afficher votre application Web.