GitHub connessioni

1. Accedi alla CodePipeline console.

2. Scegliere una delle seguenti opzioni.

   • Scegli di creare una pipeline. Segui i passaggi descritti in Create a Pipeline per completare la prima schermata e scegliere Avanti. Nella pagina Source, in Source Provider, scegli GitHub (tramite GitHub App).

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

3. Esegui una delle seguenti 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 con il tuo provider, scegli la connessione. Procedi al passaggio 3: salva l'azione sorgente 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 Connetti a GitHub. Viene visualizzata la pagina di richiesta di accesso.

2. Scegli Authorize AWS Connector per GitHub. La pagina di connessione viene visualizzata 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 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 for GitHub app e 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

   L'app viene installata una sola 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 for, lascia le impostazioni predefinite e scegli Installa.

6. Nella GitHub pagina Connetti a, 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 Pipeline triggers 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. Aggiungi trigger con tipi di eventi push o pull request 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, scegli default. CodePipeline L'azione accede ai file dal GitHub repository e archivia gli artefatti in un file ZIP nel pipeline artifact store.

   • Per archiviare un file JSON contenente un riferimento URL al repository in modo che le operazioni downstream possano eseguire direttamente comandi Git, scegliere Full clone (Clone completo). Questa opzione può essere utilizzata solo dalle azioni a valle. CodeBuild

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

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

Come creare una connessione

1. Apri un terminale (Linux, macOS o Unix) o prompt dei comandi (Windows). Usa il comando AWS CLI per eseguire il create-connection comando, specificando il valore --provider-type and --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 esito positivo, questo comando restituisce informazioni dell'ARN della 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, consulta Aggiornare una connessione in sospeso.

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

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

     "DetectChanges": "false",

   • Per configurare la configurazione dei trigger della pipeline per filtrare con i trigger, vedi maggiori dettagli in. Aggiungi trigger con tipi di eventi push o pull request di codice Ad esempio, quanto segue aggiunge al livello di pipeline la definizione JSON della pipeline. In questo esempio, release-v0 e release-v1 sono i tag Git da includere ed release-v2 è il tag Git da escludere.

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