View a markdown version of this page

Connessione GitLab - AWS DevOps Agente

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 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. Ogni registrazione è collegata a un GitLab utente o a un GitLab gruppo.

Passaggio 1: accedi ai fornitori di pipeline

  1. Accedi alla console di AWS gestione

  2. Passa alla console AWS DevOps dell'agente

  3. Vai alla pagina Capability Provider (accessibile dalla barra di navigazione laterale)

  4. Cerca GitLabnella sezione Provider disponibili sotto Pipeline e scegli 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

  2. Vai alle impostazioni utente e seleziona Access Tokens

  3. 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 sarà supportata in un secondo momento. L'aggiunta di ora evita la necessità di creare un nuovo token in futuro.

  4. Imposta la scadenza del token su un massimo di 365 giorni dalla data corrente

  5. Copia il token generato

  6. Torna alla console dell' AWS DevOps agente

  7. Incolla il token nel campo «Token di accesso»

Fase 3: Completa la registrazione

(Facoltativo) Tag: aggiungi AWS tag alla GitLab registrazione per scopi organizzativi.

Scegli Avanti per rivedere la configurazione, quindi scegli Invia per completare il processo GitLab di 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

  2. Vai alla scheda Funzionalità

  3. Nella sezione Pipeline, scegli Aggiungi

  4. Seleziona GitLabdall'elenco dei fornitori disponibili

  5. Seleziona la GitLab registrazione che contiene i progetti che desideri utilizzare

  6. Seleziona i GitLab progetti pertinenti al tuo Agent Space

  7. Seleziona Salva

AWS DevOps Agent monitora questi progetti per individuare eventuali implementazioni da GitLab Pipelines per condurre indagini causali. Un singolo Agent Space può utilizzare progetti provenienti da più registrazioni. Per aggiungere progetti da un'altra registrazione, ripeti questi passaggi.

Configurazione della revisione del codice e dei test automatici

Quando si selezionano i progetti nella fase di GitLab connessione, questi vengono aggiunti automaticamente alla sezione Code Review e Automated Testing. Questa sezione configura quali progetti attivano automaticamente le funzionalità di test Revisioni del codice di preparazione al rilascio e i test automatici.

La configurazione Code Review e Automated Testing include:

  • Funzionalità: scegli funzionalità di revisione del codice e test automatizzati per ogni progetto. La sezione fornisce due impostazioni per progetto:

    • Attivazione automatica della revisione delle modifiche: se abilitato per un progetto, DevOps Agent viene eseguito automaticamente Revisioni del codice di preparazione al rilascio ogni volta che viene aperta o aggiornata una richiesta di unione. I risultati della revisione vengono visualizzati come commenti in linea sulla richiesta di unione. Questa opzione è abilitata per impostazione predefinita per tutti i progetti collegati.

    • Test di verifica automatizzati: se abilitato per un progetto, DevOps l'agente crea, esegue e verifica le modifiche al codice in un ambiente di verifica gestito durante le revisioni del codice. Ciò fornisce una convalida funzionale oltre all'analisi statica. Per ulteriori informazioni, consulta Test di verifica automatizzati. Questa opzione è abilitata per impostazione predefinita per tutti i progetti collegati.

  • Elenco progetti: mostra tutti i progetti selezionati durante la fase di connessione. Utilizza il campo di ricerca per filtrare i progetti per nome. Ogni progetto ha caselle di controllo indipendenti per entrambe le funzionalità.

  • Ruolo di runtime (opzionale): scegli il ruolo IAM che DevOps Agent assume per eseguire funzionalità automatizzate sui progetti selezionati. Questo ruolo viene utilizzato per accedere ai servizi interni necessari durante le compilazioni, come registri di pacchetti privati e sistemi di archiviazione degli artefatti. Ti consigliamo di utilizzare un ruolo diverso da quello di agente principale.

Per configurare le revisioni automatiche:

  1. Dopo aver collegato i tuoi progetti, vai alla sezione Revisione del codice e test automatizzati nelle impostazioni di GitLab integrazione.

  2. Per ogni progetto, attiva o disattiva la funzionalità di revisione automatica delle modifiche a seconda che desideri o meno revisioni automatiche delle richieste di unione.

  3. Per ogni progetto, abilita o disabilita la funzionalità di test di verifica automatizzata a seconda che desideri eseguire i test di verifica automatizzati in un ambiente di verifica gestito.

  4. Facoltativamente, seleziona un ruolo IAM dal menu a discesa del ruolo Runtime che DevOps l'agente assumerà durante l'esecuzione di funzionalità automatizzate sui progetti selezionati.

  5. Scegli Salva per applicare la configurazione.

Una volta configurata, ogni nuova richiesta di unione in un progetto con Auto Trigger Change Review abilitata attiverà automaticamente una revisione del codice di preparazione al rilascio. Se è abilitato anche il test di verifica automatizzato, la revisione include la convalida funzionale in un ambiente di verifica. Per ulteriori informazioni sulle revisioni del codice, consultaRevisioni del codice di preparazione al rilascio.

Gestione delle GitLab connessioni

  • 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 scegli Rimuovi. Per rimuovere completamente la GitLab registrazione, rimuovila prima da tutti gli Agent Spaces, quindi elimina la registrazione a livello di account.