Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Aggiornare un'azione di origine della GitHub versione 1 a un'azione di origine della GitHub versione 2
In AWS CodePipeline, sono supportate due versioni dell'azione di GitHub origine:
-
Consigliato: l'azione della GitHub versione 2 utilizza l'autenticazione basata sull'app Github supportata da una risorsa. CodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite Installa un'applicazione AWS CodeStar Connections nell' GitHub organizzazione in modo da poter gestire l'accesso in. GitHub
-
Non consigliato: l'azione della GitHub versione 1 utilizza i token OAuth per l'autenticazione GitHub e utilizza un webhook separato per rilevare le modifiche. Questo non è più il metodo consigliato.
Nota
Le connessioni non sono disponibili nelle regioni Asia Pacifico (Hong Kong), Asia Pacifico (Hyderabad), Asia Pacifico (Giacarta), Asia Pacifico (Melbourne), Asia Pacifico (Osaka), Africa (Città del Capo), Medio Oriente (Bahrein), Medio Oriente (Emirati Arabi Uniti), Europa (Spagna), Europa (Zurigo), Israele (Tel Aviv) o (Stati Uniti occidentali). AWS GovCloud Per fare riferimento ad altre azioni disponibili, consulta. Integrazioni di prodotti e servizi con CodePipeline Per considerazioni su questa azione nella regione Europa (Milano), si veda la nota inCodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite.
L'utilizzo dell'azione della GitHub versione 2 anziché dell'azione della GitHub versione 1 presenta alcuni importanti vantaggi:
-
Con le connessioni, CodePipeline non sono più necessarie app OAuth o token di accesso personali per accedere al tuo repository. Quando crei una connessione, installi un' GitHub app che gestisce l'autenticazione nel tuo GitHub repository e consente le autorizzazioni a livello di organizzazione. È necessario autorizzare i token OAuth come utente per accedere al repository. Per ulteriori informazioni sull'accesso basato su OAuth rispetto GitHub all'accesso basato su app, consulta. GitHub https://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps
-
Quando gestisci le azioni della GitHub versione 2 nella CLI o CloudFormation, non devi più archiviare il tuo token di accesso personale come segreto in Secrets Manager. Non è più necessario fare riferimento dinamicamente al segreto memorizzato nella configurazione dell' CodePipeline azione. Si aggiunge invece l'ARN della connessione alla configurazione dell'azione. Per un esempio di configurazione dell'azione, vediCodeStarSourceConnection per Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com e GitLab azioni autogestite.
-
Quando si crea una risorsa di connessione da utilizzare con l'azione della GitHub versione 2 in CodePipeline, è possibile utilizzare la stessa risorsa di connessione per associare altri servizi supportati, come CodeGuru Reviewer, al repository.
-
Nella versione 2 di Github, puoi clonare i repository per accedere ai metadati git nelle CodeBuild azioni successive, mentre nella versione 1 di Github puoi solo scaricare il codice sorgente.
-
Un amministratore installa l'app per gli archivi della tua organizzazione. Non è più necessario tenere traccia dei token OAuth che dipendono dalla persona che ha creato il token.
Tutte le app installate in un'organizzazione hanno accesso allo stesso set di repository. Per cambiare chi può accedere a ciascun repository, modifica la policy IAM per ogni connessione. Per un esempio, vedi Esempio: una politica ristretta per l'utilizzo di connessioni con un repository specifico.
È possibile utilizzare i passaggi descritti in questo argomento per eliminare l'azione di origine della GitHub versione 1 e aggiungere un'azione di origine della GitHub versione 2 dalla console. CodePipeline
Argomenti
Passaggio 1: Sostituisci l' GitHub azione della versione 1
Utilizza la pagina di modifica della pipeline per sostituire l'azione della versione 1 con GitHub un'azione della versione 2 GitHub .
Per sostituire l'azione della versione 1 GitHub
-
Accedi alla CodePipeline console.
-
Scegli la tua pipeline e scegli Modifica. Scegli Modifica fase nella fase di origine. Viene visualizzato un messaggio che consiglia di aggiornare l'azione.
-
Nel provider Action, scegli GitHub (Versione 2).
-
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.
-
Passaggio 2: Creare una connessione a GitHub
Dopo aver scelto di creare la connessione, viene GitHub visualizzata la pagina Connetti a.
Per creare una connessione a GitHub
-
Nelle impostazioni di GitHub connessione, il nome della connessione viene visualizzato in Nome connessione.
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 l' GitHub app, sceglila e salta questo passaggio.
-
Se GitHub viene visualizzata la pagina di autorizzazione, accedi con le tue credenziali e scegli di continuare.
-
Nella pagina di installazione dell'app, un messaggio indica che l' AWS CodeStar app sta tentando di connettersi al tuo GitHub account.
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.
-
Nella AWS CodeStar pagina di installazione, scegli Installa.
-
Nella GitHub pagina Connect to, viene visualizzato l'ID di connessione per la nuova installazione. Scegli Connetti.
Passaggio 3: Salva l'azione GitHub sorgente
Completa gli aggiornamenti nella pagina Modifica azione per salvare la nuova azione sorgente.
Per salvare l'azione GitHub sorgente
-
In Repository, inserisci il nome del tuo repository di terze parti. In Branch, inserisci il ramo in cui desideri che la pipeline rilevi le modifiche all'origine.
Nota
In Repository, digita
owner-name/repository-name
come mostrato in questo esempio:my-account/my-repository
-
In Formato di output degli artefatti, scegliete il formato per gli artefatti.
-
Per memorizzare gli artefatti di output derivanti dall' GitHub azione utilizzando il metodo predefinito, scegliete predefinito. CodePipeline L'azione accede ai file dal GitHub repository e archivia gli artefatti in un file ZIP nell'archivio degli artefatti della pipeline.
-
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 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
-
-
In Output Artifacts, puoi mantenere il nome dell'artefatto di output per questa azione, ad esempio.
SourceArtifact
Scegli Fine per chiudere la pagina Modifica azione. -
Scegliete Fine per chiudere la pagina di modifica dello stage. Scegliete Salva per chiudere la pagina di modifica della pipeline.