Creazione di una richiesta di pull

La creazione di richieste pull aiuta altri utenti a vedere ed esaminare le modifiche del codice prima di unirle in un altro ramo. In primo luogo, è necessario creare un ramo per le modifiche del codice che viene definito come il ramo di origine della richiesta pull. Dopo aver eseguito il commit e aver inviato le modifiche al repository, puoi creare una richiesta pull che confronta il contenuto del ramo di origine con il contenuto del ramo di destinazione.

Puoi creare una pull request nella CodeCatalyst console Amazon da una filiale specifica, dalla pagina delle pull request o dalla panoramica del progetto. La creazione di una richiesta pull da un ramo specifico fornisce automaticamente il nome del repository e il ramo di origine nella pagina di creazione della pull request. Quando crei una pull request, riceverai automaticamente e-mail su eventuali aggiornamenti alla pull request, nonché quando la pull request viene unita o chiusa.

Nota

Durante la creazione di una pull request, la differenza visualizzata è la differenza tra la punta del ramo di origine e la punta del ramo di destinazione. Una volta creata la pull request, la differenza visualizzata sarà tra la revisione della pull request scelta e il commit che costituiva la punta del ramo di destinazione quando è stata creata la pull request. Per ulteriori informazioni sulle differenze e sulle basi di unione in Git, consulta git-merge-basela documentazione di Git.

Puoi utilizzare la funzione Write description for me durante la creazione di richieste pull per fare in modo che Amazon Q crei automaticamente una descrizione delle modifiche contenute in una richiesta pull. Quando scegli questa opzione, Amazon Q analizza le differenze tra il ramo di origine che contiene le modifiche al codice e il ramo di destinazione in cui desideri unire queste modifiche. Quindi crea un riepilogo di quali sono tali modifiche, nonché la migliore interpretazione dell'intento e dell'effetto di tali modifiche. Questa funzionalità è disponibile solo nella regione degli Stati Uniti occidentali (Oregon) per le CodeCatalyst pull request. La funzione Scrivi descrizione per me non è disponibile per le richieste pull negli archivi collegati.

Nota

Nota

Realizzato da Amazon Bedrock: AWS implementa il rilevamento automatico degli abusi. Poiché le funzioni Scrivi descrizione per me, Crea un riepilogo dei contenuti, Consiglia attività, Usa Amazon Q per creare o aggiungere funzionalità a un progetto e Assegna problemi ad Amazon Q con Amazon Q Developer Agent per le funzionalità di sviluppo software sono basate su Amazon Bedrock, gli utenti possono sfruttare appieno i controlli implementati in Amazon Bedrock per rafforzare la sicurezza e l'uso responsabile dell'intelligenza artificiale (AI).

Per creare una pull request

1. Vai al tuo progetto.

2. Esegui una di queste operazioni:

   • Nel riquadro di navigazione, scegli Codice, scegli Richieste pull, quindi scegli Crea richiesta pull.

   • Nella home page del repository, scegli Altro, quindi scegli Crea richiesta pull.

   • Nella pagina del progetto, scegli Crea richiesta pull.

3. Nel repository Source, assicurati che il repository di origine specificato sia quello che contiene il codice commesso. Questa opzione appare solo se non hai creato la pull request dalla pagina principale del repository.

4. Nel ramo di destinazione, scegli il ramo in cui unire il codice dopo averlo esaminato.

5. Nel ramo di origine, scegli il ramo che contiene il codice commesso.

6. In Pull request title, inserisci un titolo che aiuti gli altri utenti a capire cosa deve essere esaminato e perché.

7. (Facoltativo) Nella descrizione della richiesta Pull, fornisci informazioni come un link ai problemi o una descrizione delle modifiche.

   Suggerimento

   Puoi scegliere Write description for me per generare CodeCatalyst automaticamente una descrizione delle modifiche contenute nella pull request. Puoi apportare modifiche alla descrizione generata automaticamente dopo averla aggiunta alla pull request.

   Questa funzionalità richiede che le funzionalità di intelligenza artificiale generativa siano abilitate per lo spazio e non è disponibile per le richieste pull negli archivi collegati. Per ulteriori informazioni, consulta Gestione delle funzionalità di intelligenza artificiale generativa.

8. (Facoltativo) In Problemi, scegli Problemi di collegamento, quindi scegli un problema dall'elenco o inserisci il relativo ID. Per scollegare un problema, scegli l'icona di scollegamento.

9. (Facoltativo) In Revisori obbligatori, scegli Aggiungi revisori richiesti. Scegli dall'elenco dei membri del progetto per aggiungerli. I revisori obbligatori devono approvare le modifiche prima che la pull request possa essere unita al ramo di destinazione.

   Nota

   Non è possibile aggiungere un revisore sia come revisore obbligatorio che come revisore opzionale. Non puoi aggiungerti come revisore.

10. (Facoltativo) In Revisori opzionali, scegli Aggiungi revisori opzionali. Scegli dall'elenco dei membri del progetto per aggiungerli. I revisori opzionali non devono approvare le modifiche come requisito prima che la pull request possa essere unita al ramo di destinazione.

11. Esamina le differenze tra le filiali. La differenza mostrata in una pull request è rappresentata dalle modifiche tra la revisione nel ramo di origine e la base di unione, che è l'head commit del ramo di destinazione al momento della creazione della pull request. Se non viene visualizzata alcuna modifica, i rami potrebbero essere identici oppure potresti aver scelto lo stesso ramo sia per l'origine che per la destinazione.

12. Quando sei sicuro che la pull request contenga il codice e le modifiche che desideri rivedere, scegli Crea.

    Nota

    Dopo aver creato la pull request, puoi aggiungere commenti. I commenti possono essere aggiunti alla pull request o alle singole righe dei file, nonché alla pull request complessiva. È possibile aggiungere collegamenti a risorse, ad esempio file, utilizzando il segno @ seguito dal nome del file.

Per creare una pull request da una filiale

1. Vai al progetto in cui desideri creare una pull request.

2. Nel riquadro di navigazione, scegli Archivi di origine, quindi scegli il repository che contiene il ramo in cui devi rivedere le modifiche al codice.

3. Scegli la freccia a discesa accanto al nome del ramo predefinito, quindi scegli il ramo che desideri dall'elenco. Per visualizzare tutti i rami di un repository, scegli Visualizza tutto.

4. Scegli Altro, quindi scegli Crea pull request.

5. Il repository e il ramo sorgente sono preselezionati automaticamente. Nel ramo di destinazione, scegli il ramo in cui unirai il codice una volta esaminato. In Pull request title, inserisci un titolo che aiuti gli altri utenti del progetto a capire cosa deve essere esaminato e perché. Facoltativamente, fornisci ulteriori informazioni nella descrizione della richiesta Pull, ad esempio incollando un link a problemi correlati in CodeCatalyst o aggiungendo una descrizione delle modifiche apportate.

   Nota

   I flussi di lavoro configurati per l'esecuzione di eventi pull request create verranno eseguiti dopo la creazione della pull request, se il ramo di destinazione per la pull request corrisponde a uno dei rami specificati nel flusso di lavoro.

6. Esamina le differenze tra i rami. Se non viene visualizzata alcuna modifica, i rami potrebbero essere identici oppure potresti aver scelto lo stesso ramo sia per l'origine che per la destinazione.

7. (Facoltativo) In Problemi, scegli Problemi di collegamento, quindi scegli un problema dall'elenco o inserisci il relativo ID. Per scollegare un problema, scegli l'icona di scollegamento.

8. (Facoltativo) In Revisori obbligatori, scegli Aggiungi revisori richiesti. Scegli dall'elenco dei membri del progetto per aggiungerli. I revisori obbligatori devono approvare le modifiche prima che la pull request possa essere unita al ramo di destinazione.

   Nota

   Non puoi aggiungere un revisore sia come obbligatorio che come facoltativo. Non puoi aggiungerti come revisore.

9. (Facoltativo) In Revisori opzionali, scegli Aggiungi revisori opzionali. Scegli dall'elenco dei membri del progetto per aggiungerli. I revisori opzionali non devono approvare le modifiche prima che la pull request possa essere unita al ramo di destinazione.

10. Quando ritieni che la pull request contenga le modifiche che desideri rivedere e includa i revisori richiesti, scegli Crea.

Se hai dei flussi di lavoro configurati per essere eseguiti laddove il ramo corrisponde al ramo di destinazione nella pull request, vedrai le informazioni su tali flussi di lavoro in Panoramica nell'area dei dettagli della pull request dopo la creazione della pull request. Per ulteriori informazioni, consulta Aggiungere trigger ai flussi di lavoro.