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 alle CI/CD tubazioni
L'integrazione della pipeline CI/CD consente ad AWS DevOps Agent di monitorare le implementazioni e correlare le modifiche al codice con gli incidenti operativi durante le indagini. Collegando i CI/CD provider, l'agente può tenere traccia degli eventi di implementazione e associarli a AWS risorse per aiutare a identificare le potenziali cause alla radice durante la risposta agli incidenti.
AWS DevOps Agent supporta l'integrazione con CI/CD le piattaforme più diffuse attraverso un processo in due fasi:
1. **Registrazione a livello di account**: registra il tuo CI/CD provider una volta a livello di account AWS
1. **Connessione Agent Space**: collega progetti o repository specifici a singoli Agent Spaces in base alle esigenze organizzative
Questo approccio consente di condividere le registrazioni dei CI/CD provider su più Agent Spaces mantenendo al contempo un controllo granulare su quali progetti vengono monitorati da ogni spazio.
## Fornitori supportati CI/CD
AWS DevOps Agent supporta le seguenti CI/CD piattaforme:
+ **GitHub**— Connect i repository [GitHubda.com](http://GitHub.com) utilizzando l' GitHub app AWS DevOps Agent.
+ **GitLab**— Connect progetti da [GitLab.com,](http://gitlab.com) GitLab istanze gestite o implementazioni self-hosted GitLab accessibili pubblicamente.
**Argomenti**
+ [Connessione GitHub](connecting-to-cicd-pipelines-connecting-github.md)
+ [Connessione GitLab](connecting-to-cicd-pipelines-connecting-gitlab.md)
# 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
1. Accedi alla console di AWS gestione
1. Vai alla console dell' AWS DevOps agente
1. Vai alla scheda **Funzionalità**
1. **Nella sezione **Pipeline**, fai clic su Aggiungi**
1. Seleziona **GitHub**dall'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](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
**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
1. Verrai reindirizzato GitHub a installare l' GitHub app AWS DevOps Agent.
1. Seleziona l'account o l'organizzazione in cui installare l'app.
1. 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.
1. Il browser verrà reindirizzato alla pagina «Crea GitHub app» dell'istanza GitHub Enterprise Server.
1. Verrà visualizzato il nome dell'app precompilato. Sentiti libero di cambiare il nome se necessario. Fai clic su **Crea GitHub app**.
1. 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
1. Verrà visualizzata la pagina di **installazione e autorizzazione** dell' GitHub app.
1. 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
1. Fai clic su **Installa e autorizza**.
1. 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:
1. Nella console dell' AWS DevOps agente, seleziona il tuo Agent Space
1. Vai alla scheda **Funzionalità**
1. **Nella sezione **Pipeline**, fai clic su Aggiungi**
1. Seleziona **GitHub**dall'elenco dei fornitori disponibili
1. Seleziona il sottoinsieme di repository pertinenti a questo Agent Space
1. 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.
# Connessione GitLab
GitLab l'integrazione consente all' AWS DevOps agente di monitorare le implementazioni da GitLab Pipelines per fornire informazioni sulle indagini causali durante la risposta agli incidenti. Questa integrazione segue un processo in due fasi: registrazione a livello di account GitLab, seguita dal collegamento di progetti specifici a singoli Agent Spaces.
## Registrazione GitLab (a livello di account)
GitLab è registrato a livello di AWS account e condiviso tra tutti gli Agent Space di quell'account. I singoli Agent Spaces possono quindi scegliere quali progetti specifici applicare al proprio Agent Space.
### Passaggio 1: accedi ai fornitori di pipeline
1. Accedi alla console di AWS gestione
1. Vai alla console dell' AWS DevOps agente
1. Vai alla pagina **Capability Provider** (accessibile dalla barra di navigazione laterale)
1. **Cerca **GitLab**nella sezione Provider **disponibili** sotto **Pipeline** e fai clic su Registra**
### Fase 2: Configurare GitLab la connessione
Nella pagina GitLab di registrazione, configura quanto segue:
**Tipo di connessione**: seleziona se ti stai connettendo come persona o come gruppo:
+ **Personale** (impostazione predefinita): il tuo account GitLab utente individuale con nome utente e profilo
+ **Gruppo**: in GitLab, utilizzi i gruppi per gestire uno o più progetti correlati contemporaneamente
**GitLab tipo di istanza**: scegli a quale tipo di GitLab istanza ti stai connettendo:
+ **GitLab.com** (impostazione predefinita) — Il GitLab servizio pubblico
+ **Accessibile pubblicamente, ospitato autonomamente GitLab**: seleziona la casella **Usa endpoint con hosting GitLab autonomo** e fornisci l'URL alla tua istanza GitLab
**Nota**
**Attualmente sono supportate solo le GitLab istanze accessibili al pubblico.
**Token di accesso**: fornisci un token di accesso GitLab personale:
1. In una scheda separata del browser, accedi al tuo GitLab account
1. Vai alle impostazioni utente e seleziona **Access Tokens**
1. Crea un nuovo token di accesso personale con le seguenti autorizzazioni:
+ `read_repository`— Necessario per accedere ai contenuti del repository
+ `read_virtual_registry`— Necessario per accedere alle informazioni del registro virtuale
+ `read_registry`— Necessario per accedere alle informazioni del registro
+ `api`— Richiesto per l'accesso alle API di lettura e scrittura
+ `self_rotate`- Necessario per la rotazione dei token. Questa funzionalità non è attualmente supportata da AWS DevOps Agent, ma lo sarà in un secondo momento. L'aggiunta di ora evita la necessità di creare un nuovo token in futuro.
1. Imposta la scadenza del token su un massimo di 365 giorni dalla data corrente
1. Copia il token generato
1. Torna alla console dell' AWS DevOps agente
1. Incolla il token nel campo «Token di accesso»
### Fase 3: Completa la registrazione
**(Facoltativo) Tag**: aggiungi AWS tag alla GitLab registrazione per scopi organizzativi.
Fai clic su **Avanti** per rivedere la configurazione, quindi fai clic su **Invia** per completare il processo di GitLab registrazione. Il sistema convaliderà il token di accesso e stabilirà la connessione.
## Collegamento dei progetti a un Agent Space
Dopo la registrazione GitLab a livello di account, puoi collegare progetti specifici a singoli Agent Spaces:
1. Nella console dell' AWS DevOps agente, seleziona il tuo Agent Space
1. Vai alla scheda **Funzionalità**
1. **Nella sezione **Pipeline**, fai clic su Aggiungi**
1. Seleziona **GitLab**dall'elenco dei fornitori disponibili
1. Seleziona i GitLab progetti pertinenti al tuo Agent Space
1. Fai clic su **Salva**
AWS DevOps L'agente monitorerà questi progetti per individuare eventuali implementazioni da parte di GitLab Pipelines al fine di fornire informazioni sulle indagini causali.
## Gestione delle connessioni GitLab
+ **Aggiornamento del token** di accesso: se il token di accesso scade o deve essere aggiornato, puoi aggiornarlo nella console dell' AWS DevOps agente modificando la GitLab registrazione a livello di account.
+ **Visualizzazione dei progetti collegati**: nella console dell' AWS DevOps agente, seleziona Agent Space e vai alla scheda Funzionalità per visualizzare i progetti collegati nella sezione Pipeline.
+ **Rimozione della GitLab connessione****: per disconnettere GitLab i progetti da un Agent Space, seleziona la connessione nella sezione Pipeline e fai clic su Rimuovi.** Per rimuovere completamente la GitLab registrazione, rimuovila prima da tutti gli Agent Spaces, quindi elimina la registrazione a livello di account.