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à.
Connessione GitHub
GitHub l'integrazione consente all' AWS DevOps agente di accedere agli archivi di codice e ricevere eventi di implementazione durante le indagini sugli incidenti. Questa integrazione segue un processo in due fasi: registrazione a livello di account GitHub, seguita dal collegamento di repository specifici a singoli Agent Spaces.
AWS DevOps Agent supporta istanze GitHub .com (SaaS) ed GitHub Enterprise Server (ospitate autonomamente).
Prerequisiti
Prima di connetterti GitHub, assicurati di avere:
Accesso alla console di amministrazione AWS DevOps dell'agente
Un account GitHub utente o un'organizzazione con autorizzazioni di amministratore
Autorizzazione a installare GitHub app nel tuo account o nella tua organizzazione
Per GitHub Enterprise Server, sono inoltre necessari:
Un'istanza di GitHub Enterprise Server (versione 3.x o successiva) accessibile tramite HTTPS
L'URL HTTPS dell'istanza di GitHub Enterprise Server (ad esempio,
https://github.example.com)(Facoltativo) Una connessione privata, se l'istanza di GitHub Enterprise Server non è accessibile pubblicamente
Registrazione GitHub (a livello di account)
GitHub è registrato a livello di AWS account e condiviso tra tutti gli Agent Space di quell'account. È sufficiente registrarsi GitHub una sola volta per AWS account.
Passaggio 1: accedi ai fornitori di pipeline
Accedi alla console di AWS gestione
Vai alla console dell' AWS DevOps agente
Vai alla scheda Funzionalità
Nella sezione Pipeline, fai clic su Aggiungi
Seleziona GitHubdall'elenco dei fornitori disponibili
Se GitHub non è ancora stato registrato, ti verrà prima richiesto di registrarlo.
Passaggio 2: Scegli il tipo di connessione
Nella schermata «Registra GitHub account /organizzazione», seleziona se ti stai connettendo come utente o organizzazione:
Utente: il tuo GitHub account personale con nome utente e profilo
Organizzazione: un GitHub account condiviso in cui più persone possono collaborare su più progetti contemporaneamente
Se ti connetti a un'istanza di GitHub Enterprise Server, seleziona la casella di controllo Usa GitHub Enterprise Server e inserisci l'URL HTTPS dell'istanza (ad esempio,https://github.example.com).
Se l'istanza di GitHub Enterprise Server non è accessibile pubblicamente, è possibile configurare facoltativamente una connessione privata per consentire ad AWS DevOps Agent di raggiungere l'istanza in modo sicuro. Per ulteriori informazioni, consulta Connessione a strumenti ospitati privatamente.
Nota
Non includete /api/v3 alcun percorso finale nell'URL: immettete solo l'URL di base.
Passaggio 3: configura l'app GitHub
Fai clic su Invia per iniziare il processo di configurazione dell'app. I passaggi successivi variano a seconda che ci si stia connettendo GitHub a.com o GitHub Enterprise Server.
Per GitHub .com
Verrai reindirizzato GitHub a installare l' GitHub app AWS DevOps Agent.
Seleziona l'account o l'organizzazione in cui installare l'app.
L'app consente all' AWS DevOps agente di ricevere eventi dagli archivi connessi, inclusi gli eventi di distribuzione.
Per GitHub Enterprise Server
GitHub Enterprise Server utilizza un flusso GitHub App Manifest, che configura automaticamente una nuova GitHub app sull'istanza. Ciò comporta due reindirizzamenti all'istanza di GitHub Enterprise Server.
Il browser verrà reindirizzato alla pagina «Crea GitHub app» dell'istanza GitHub Enterprise Server.
Verrà visualizzato il nome dell'app precompilato. Sentiti libero di cambiare il nome se necessario. Fai clic su Crea GitHub app.
Verrai reindirizzato nuovamente ad AWS DevOps Agent, che scambia il codice manifesto con le credenziali dell'app.
Passaggio 4: Seleziona i repository e completa l'installazione
Verrà visualizzata la pagina di installazione e autorizzazione dell' GitHub app.
Seleziona a quali repository consentire l'accesso all'app:
Tutti gli archivi: concedi l'accesso a tutti gli archivi attuali e futuri
Seleziona solo i repository: scegli repository specifici dal tuo account o dalla tua organizzazione
Fai clic su Installa e autorizza.
Verrai reindirizzato nuovamente alla console dell' AWS DevOps agente, dove GitHub apparirà come registrato a livello di account.
Connessione dei repository a un Agent Space
Dopo la registrazione GitHub a livello di account, puoi connettere repository specifici a singoli Agent Spaces:
Nella console dell' AWS DevOps agente, seleziona il tuo Agent Space
Vai alla scheda Funzionalità
Nella sezione Pipeline, fai clic su Aggiungi
Seleziona GitHubdall'elenco dei fornitori disponibili
Seleziona il sottoinsieme di repository pertinenti a questo Agent Space
Fate clic su Aggiungi per completare la connessione
È possibile collegare diversi set di repository a diversi Agent Spaces in base alle esigenze organizzative.
Comprendere l'app GitHub
L' GitHub app AWS DevOps Agent:
Richiede l'accesso in sola lettura ai tuoi repository
Riceve eventi di distribuzione e altri eventi del repository
Consente all' AWS DevOps agente di correlare le modifiche al codice con gli incidenti operativi
Può essere disinstallato in qualsiasi momento tramite le impostazioni GitHub
Per GitHub Enterprise Server, l' GitHub app viene creata automaticamente sull'istanza durante la registrazione. È possibile gestire l'accesso all'archivio dell'app o disinstallarla tramite Impostazioni > Applicazioni > GitHub App installate. Per eliminare completamente la definizione dell'app, vai a Impostazioni > Impostazioni sviluppatore > GitHub App.
Gestione delle GitHub connessioni
Aggiornamento dell'accesso all'archivio: per modificare i repository a cui l' GitHub app può accedere, accedi alle impostazioni dell' GitHub account o dell'organizzazione (o alle impostazioni dell'istanza GitHub Enterprise Server), accedi alle GitHub app installate e modifica la configurazione dell'app AWS DevOps Agent.
Visualizzazione degli archivi collegati: nella console dell' AWS DevOps agente, seleziona Agent Space e vai alla scheda Funzionalità per visualizzare gli archivi collegati nella sezione Pipeline.
Rimozione della GitHub connessione: per disconnetterti GitHub da un Agent Space, seleziona la connessione nella sezione Pipeline e fai clic su Rimuovi. Per disinstallare completamente l' GitHub app, disinstallala dalle impostazioni dell' GitHub account o dell'organizzazione. Per GitHub Enterprise Server, poiché l' GitHub app viene creata direttamente sull'istanza durante la registrazione, è possibile opzionalmente ripulire completamente l'app eseguendo entrambe le seguenti operazioni:
Disinstalla l'app: vai su Impostazioni > Applicazioni > GitHub App installate, fai clic su Configura sull'app, quindi disinstallala.
Elimina l'app: vai su Impostazioni > Impostazioni sviluppatore > GitHub App, seleziona l'app, vai alla scheda Avanzate e scegli Elimina GitHub app. Avviso: l'eliminazione dell' GitHub app è permanente e non può essere annullata. Se la elimini, dovrai registrare nuovamente GitHub Enterprise Server dall'inizio nella console di AWS DevOps Agent per creare una nuova app.
