Tutorial: creare un progetto con un repository GitHub di sorgenti

ConAWS CodeStar, puoi configurare il tuo repository per creare, rivedere e unire le richieste pull con il tuo team di progetto.

In questo tutorial, creerai un progetto con un esempio di codice sorgente di un'applicazione web in un GitHub repository, una pipeline che distribuisce le tue modifiche e istanze EC2 in cui l'applicazione è ospitata nel cloud. Dopo la creazione del progetto, questo tutorial mostra come creare e unire una GitHub pull request che apporti una modifica alla home page dell'applicazione web.

Passaggio 1: crea il progetto e crea il tuo repository GitHub

In questo passaggio, utilizza la console per creare il progetto e creare una connessione al nuovo GitHub repository. Per accedere al tuo GitHub repository, crei una risorsa di connessione da AWS CodeStar utilizzare per gestire l'autorizzazione con. GitHub Quando il progetto viene creato, le relative risorse aggiuntive vengono fornite automaticamente.

1. Accedere aAWS Management Console, quindi aprire la AWS CodeStar console all'indirizzo https://console.aws.amazon.com/codestar/.

2. Scegliere la regione AWS in cui si desidera creare il progetto e le sue risorse.

3. Nella AWS CodeStarpagina, scegli Crea progetto.

4. Nella pagina Scegli un modello di progetto, seleziona le caselle di controllo Applicazione Web, Node.js e Amazon EC2. Quindi scegli tra i modelli disponibili per quel set di opzioni.

   Per ulteriori informazioni, consulta Modelli di progetto AWS CodeStar.

5. Seleziona Next (Successivo).

6. Per Project name (Nome progetto), immettere un nome per il progetto (ad esempio, MyTeamProject). Se scegli un nome differente, assicurati di utilizzarlo in tutto il tutorial.

7. In Project repository, scegli. GitHub

8. Se hai scelto GitHub, dovrai scegliere o creare una risorsa di connessione. Se hai una connessione esistente, selezionala nel campo di ricerca. Altrimenti, creerai una nuova connessione qui. Scegli Connect a GitHub.

   Viene visualizzata la pagina Crea una connessione.

   Nota

   Per creare una connessione, è necessario disporre di un GitHub account. Se stai creando una connessione per un'organizzazione, devi essere il proprietario dell'organizzazione.

   

   1. In Crea connessione GitHub all'app, in Nome connessione, inserisci un nome per la connessione. Scegli Connect a GitHub.

      La GitHub pagina Connect to visualizza e mostra il campo GitHub App.

   2. In GitHub App, scegli l'installazione di un'app o scegli Installa una nuova app per crearne una.

      Nota

      È sufficiente installare una sola app per tutte le connessioni a un provider specifico. Se hai già installato il AWS Connector for GitHub app, sceglilo e salta questo passaggio.

   3. Nella GitHub pagina Installa AWS Connector per, scegli l'account in cui desideri installare l'app.

      Nota

      Se hai già installato l'app, puoi scegliere Configure (Configura) per passare a una pagina di modifica per l'installazione dell'app oppure è possibile utilizzare il pulsante Indietro per tornare alla console.

   4. Se viene visualizzata la pagina Conferma la password per continuare, inserisci GitHub la password, quindi scegli Accedi.

   5. Nella GitHub pagina Install AWS Connector per, lascia le impostazioni predefinite e scegli Installa.

   6. Nella GitHub pagina Connect to, l'ID di installazione per la nuova installazione viene visualizzato in GitHubApp.

      Dopo aver creato correttamente la connessione, nella pagina di CodeStar creazione del progetto viene visualizzato il messaggio Ready to connect.

      Nota

      Puoi visualizzare la tua connessione in Impostazioni nella console Developer Tools. Per ulteriori informazioni, consulta Guida introduttiva alle connessioni.

      

   7. Per il proprietario del repository, scegli l' GitHuborganizzazione o il tuo account personale. GitHub

   8. Per Nome del repository, accetta il nome del GitHub repository predefinito o inseriscine uno diverso.

   9. Scegli Pubblico o Privato.

      Nota

      Se desideri utilizzarlo AWS Cloud9 come ambiente di sviluppo, devi scegliere un repository pubblico.

   10. (Facoltativo) Per la descrizione del repository, inserisci una descrizione per il GitHub repository.

9. Configura le tue istanze Amazon EC2 in Amazon EC2 Configuration se il tuo progetto viene distribuito su istanze Amazon EC2 e desideri apportare modifiche. Ad esempio, è possibile scegliere tra i tipi di istanze disponibili per il progetto.

   In Coppia di chiavi, scegli la coppia di chiavi Amazon EC2 in cui hai creato. Fase 4: creare una coppia di chiavi Amazon EC2 per progetti AWS CodeStar Seleziona Riconosco di avere accesso al file della chiave privata.

10. Seleziona Successivo.

11. Esaminare le risorse e i dettagli di configurazione.

12. Scegli Next (Avanti) oppure Create project (Crea progetto). (L'opzione visualizzata dipende dal modello di progetto).

    Attendi qualche minuto per la creazione del progetto.

13. Dopo aver creato il progetto, scegli Visualizza applicazione per visualizzare l'applicazione web.

Passaggio 2: Visualizza il codice sorgente

In questo passaggio vengono visualizzati il codice sorgente e gli strumenti che è possibile utilizzare per il repository dei sorgenti.

1. Nella barra di navigazione del progetto, scegli Repository.

   Per visualizzare un elenco di commit in GitHub, scegli Visualizza i commit. Verrà aperta la cronologia dei commit in. GitHub

   Per visualizzare i problemi, scegli la scheda Problemi relativa al tuo progetto. Per creare un nuovo problema in GitHub, scegli Crea GitHub problema. Verrà aperto il modulo di emissione del repository in GitHub.

2. Nella scheda Archivio, scegli il link sotto Nome archivio e il repository del tuo progetto si aprirà in una nuova scheda o finestra. Questo repository contiene il codice sorgente del tuo progetto.

Fase 3: Creare una GitHub Pull Request

In questo passaggio, apporti una piccola modifica al tuo codice sorgente e crei una pull request.

1. Nel GitHub, crea un nuovo ramo di funzionalità nel tuo repository. Scegli il campo a discesa del ramo principale e inserisci un nuovo ramo nel campo denominato. feature-branch Scegli Crea nuovo ramo. Il ramo viene creato e verificato automaticamente.

2. Nel GitHub, apporta una modifica al feature-branch ramo. Apri la cartella pubblica e apri il index.html file.

3. Nella AWS CodeStar console, in Richieste Pull, per creare una richiesta pull GitHub, scegli Crea richiesta pull. Questo apre il modulo di pull request del repository. GitHub In GitHub, scegli l'icona a forma di matita per modificare il file.

   DopoCongratulations!, aggiungi la stringa Well done, <name>! e sostituiscila <name> con il tuo nome. Scegliere Commit changes (Applica modifiche). La modifica viene assegnata al tuo feature branch.

4. Nella AWS CodeStar console, scegli il tuo progetto. Scegli la scheda Repository. In Richieste pull, scegli Crea richiesta pull.

   Il modulo si apre in GitHub. Lascia il ramo principale nel ramo base. Per Compare to, scegli il tuo ramo di funzionalità. Visualizza la differenza.

5. In GitHub, scegli Crea pull request. Viene creata una richiesta pull denominata Update index.html.

6. Nella AWS CodeStar console, visualizza la nuova pull request. Scegli Unisci modifiche per confermare le modifiche nel repository e unisci la pull request con il ramo principale del repository.

7. Torna al progetto AWS CodeStar e controlla la pagina Pipeline. Ora dovresti vedere la distribuzione della pipeline.

8. Dopo aver creato il progetto, scegli Visualizza applicazione per visualizzare l'applicazione web.