GitHub connessioni

1. Accedi alla CodePipeline console.

2. Scegliere una delle seguenti opzioni.

   • Scegli di creare una pipeline. Segui i passaggi descritti in Crea una pipeline per completare la prima schermata e scegli Avanti. Nella pagina Sorgente, in Source Provider, scegli GitHub (Versione 2).

   • Scegliete di modificare una pipeline esistente. Scegliete Modifica, quindi scegliete Modifica fase. Scegli di aggiungere o modificare l'azione sorgente. Nella pagina Modifica azione, in Nome azione, inserisci il nome dell'azione. Nel provider Action, scegli GitHub (Versione 2).

3. Esegui una di queste operazioni:

   • In Connessione, se non hai già creato una connessione con il tuo provider, scegli Connetti a GitHub. Procedi al passaggio 2: Crea una connessione a GitHub.

   • In Connessione, se hai già creato una connessione al tuo provider, scegli la connessione. Procedi al passaggio 3: Salva l'azione di origine per la tua connessione.

Per creare una connessione a GitHub

1. Nelle impostazioni di GitHub connessione, il nome della connessione viene visualizzato in Nome connessione. Scegli Connect a GitHub. Viene visualizzata la pagina di richiesta di accesso.

2. Scegli Autorizza AWS connettore per GitHub. La pagina di connessione visualizza e mostra il campo GitHub App.

   

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

   È 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.

   Nota

   Se desideri creare un token di accesso utente, assicurati di aver già installato AWS Connector per GitHub app, quindi lascia vuoto il campo di installazione dell'app. CodeConnections utilizzerà il token di accesso utente per la connessione.

4. Nella GitHub pagina Install AWS Connector for, scegli l'account in cui desideri installare l'app.

   Nota

   Puoi installare l'app solo una volta per ogni GitHub account. 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.

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

6. Nella GitHub pagina Connect to, l'ID di connessione per la nuova installazione viene visualizzato in GitHub App. Scegli Connetti.

Per salvare l'azione GitHub sorgente

1. In Repository name (Nome repository), scegliere il nome del repository di terze parti.

2. In Trigger Pipeline puoi aggiungere trigger se la tua azione è un'azione. CodeConnections Per configurare la configurazione dei trigger della pipeline e, facoltativamente, filtrare con i trigger, vedi maggiori dettagli in. Filtra i trigger nelle richieste push o pull di codice

3. In Output artifact format (Formato artefatto di output), occorre scegliere il formato degli artefatti.

   • Per memorizzare gli artefatti di output dell' GitHub azione utilizzando il metodo predefinito, scegliete default. CodePipeline L'azione accede ai file dal GitHub repository e memorizza gli artefatti in un ZIP file nel Pipeline Artifact Store.

   • Per archiviare un JSON file che contiene un URL riferimento al repository in modo che le azioni a valle possano eseguire direttamente i comandi Git, scegli Full clone. Questa opzione può essere utilizzata solo dalle CodeBuild azioni a valle.

     Se scegli questa opzione, dovrai aggiornare le autorizzazioni per il tuo ruolo di CodeBuild Project Service come mostrato in. Aggiungi le autorizzazioni per le connessioni a Bitbucket, Enterprise Server o.com CodeBuild GitClone GitHub GitHub GitLab Per un tutorial che mostra come usare l'opzione Full clone, consulta. Tutorial: usa il clone completo con una sorgente di GitHub pipeline

4. Scegli Avanti nella procedura guidata o Salva nella pagina Modifica azione.

Per creare una connessione

1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa il AWS CLI per eseguire il create-connection comando, specificando l'--provider-typee --connection-name per la tua connessione. In questo esempio, il nome del provider di terze parti è GitHub e il nome della connessione specificato è MyConnection.

   aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

   In caso di successo, questo comando restituisce le ARN informazioni di connessione simili alle seguenti.

   {
       "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }

2. Utilizzare la console per completare la connessione. Per ulteriori informazioni, vedere Aggiornare una connessione in sospeso.

3. Per impostazione predefinita, la pipeline rileva le modifiche al codice inviato al repository delle sorgenti di connessione. Per configurare la configurazione del trigger della pipeline per il rilascio manuale o per i tag Git, esegui una delle seguenti operazioni:

   • Per configurare la configurazione del trigger della pipeline in modo che inizi solo con una versione manuale, aggiungi la seguente riga alla configurazione:

     "DetectChanges": "false",

   • Per configurare la configurazione del trigger della pipeline per filtrare con i trigger, vedi maggiori dettagli in. Filtra i trigger nelle richieste push o pull di codice Ad esempio, quanto segue si aggiunge al livello di pipeline della definizione della pipeline. JSON In questo esempio, release-v0 e release-v1 sono i tag Git da includere e release-v2 il tag Git da escludere.

     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]