Utilizzo delle richieste pull inAWS CodeCommitrepository - AWS CodeCommit

AWS CodeCommit non è più disponibile per i nuovi clienti. I clienti esistenti di AWS CodeCommit possono continuare a utilizzare il servizio normalmente. Scopri di più»

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à.

Utilizzo delle richieste pull inAWS CodeCommitrepository

Una richiesta di pull rappresenta per te e gli altri utenti del repository lo strumento principale tramite cui rivedere, commentare e unire le modifiche al codice da un ramo a un altro. È possibile utilizzare le richieste pull per rivedere in modo collaborativo le modifiche minori o le correzioni apportate al codice, le principali funzionalità aggiunte o le nuove versioni del software rilasciato. Questo è un possibile flusso di lavoro per una richiesta di pull:

Li Juan, un'addetta allo sviluppo che utilizza un repository denominato MyDemoRepo, desidera lavorare su una nuova funzionalità per una futura versione di un prodotto. Per mantenere il lavoro svolto separato dal codice pronto per la produzione, crea un ramo all'esterno del ramo predefinito, a cui assegna il nome feature-randomizationfeature. Scrive codice, esegue commit e infine esegue il push del codice della nuova funzionalità in questo ramo. Desidera che altri utenti del repository rivedano il codice per garantirne la qualità prima dell'unione delle modifiche nel ramo predefinito. A tale scopo, crea una richiesta di pull. Tale richiesta contiene il confronto tra il ramo su cui lavora e quello del codice in cui intende unire le modifiche (in questo caso, il ramo predefinito). È inoltre possibile creare una regola di approvazione che richiede un numero specificato di utenti per approvare la richiesta pull. Può anche specificare un pool di approvazioni di utenti. Altri utenti rivedono il codice e le modifiche da lei apportate, aggiungendo commenti e suggerimenti. È possibile che Li Juan aggiorni più volte il ramo su cui lavora modificando il codice in base ai commenti. Le modifiche che apporta vengono integrate nella richiesta di pull ogni volta che ne esegue il push al ramo in CodeCommit. Potrebbe anche integrare le modifiche apportate nel ramo di destinazione previsto mentre la richiesta di pull è aperta, in modo da garantire che gli utenti revisionino tutte le modifiche proposte nel contesto. Quando lei e i suoi revisori sono soddisfatti e le condizioni per le regole di approvazione (se presenti) sono state soddisfatte, lei o uno dei suoi revisori unisce il suo codice e chiude la richiesta pull.

Creazione di una richiesta di pull

Per le richieste pull sono necessari due rami: un ramo di origine che contiene il codice che deve essere rivisto e un ramo di destinazione, dove verrà unito il codice revisionato. Il ramo di origine contiene il commit AFTER, ovvero il commit con le modifiche da unire nel ramo di destinazione. Il ramo di destinazione contiene il commit BEFORE, che rappresenta lo stato del codice prima che il ramo della richiesta di pull venisse unito nel ramo di destinazione. La scelta della strategia di unione interessa tutti i dettagli di come i commit siano uniti tra i rami di origine e di destinazione nella console di CodeCommit. Per ulteriori informazioni sulle strategie di unione in CodeCommit, consultaUnione di una richiesta di pull (console).

Rami di origine e destinazione per una richiesta di pull, in cui è mostrata la relazione tra commit "before" e "after"

La richiesta di pull mostra le differenze tra l'inizio del ramo di origine e l'ultimo commit nel ramo di destinazione quando la richiesta di pull viene creata, in modo da consentire agli utenti di visualizzare e commentare le modifiche. È possibile aggiornare la richiesta di pull in base ai commenti eseguendo il commit e il push delle modifiche al ramo di origine.

Aggiunta di un commento a una riga in una richiesta pull.

Quando il codice è stato esaminato e i requisiti della regola di approvazione (se presenti) sono stati soddisfatti, è possibile chiudere la richiesta pull in uno dei diversi modi seguenti:

  • Unire i rami in locale ed eseguire il push delle modifiche. La richiesta verrà chiusa automaticamenteSe viene utilizzata la strategia di unione ad avanzamento rapido e non ci sono conflitti di unione.

  • Utilizzare la console AWS CodeCommit per chiudere la richiesta di pull senza unione, risolvere i conflitti in un'unione oppure, se non ci sono conflitti, per chiudere e unire i rami utilizzando una delle strategie di unione disponibili.

  • Utilizzo della AWS CLI.

Prima di creare una richiesta di pull:

  • Assicurati di aver eseguito il commit e il push a un ramo (ramo di origine) delle modifiche apportate al codice che desideri vengano revisionate.

  • Configura le notifiche per il repository, in modo che altri utenti possano essere informati sulla richiesta di pull e sulle modifiche apportate. Questa fase è facoltativa, ma è consigliata.

  • Creare e associare i modelli di regola di approvazione al repository, in modo che le regole di approvazione vengano create automaticamente per le richieste pull per garantire la qualità del codice. Per ulteriori informazioni, consultare Utilizzo dei modelli di regola di approvazione.

Le richieste pull sono più efficaci se configuri gli utenti di IAM per gli utenti del repository nel tuo account Amazon Web Services. È più facile identificare quale utente ha fatto un determinato commento. L'altro vantaggio è che gli utenti di IAM possono utilizzare le credenziali Git per l'accesso al repository. Per ulteriori informazioni, consultare Fase 1: Configurazione iniziale per CodeCommit. Le richieste pull possono essere utilizzate con altri tipi di utenti, inclusi quelli con accesso federato.

Per informazioni sull'utilizzo di altri aspetti del repository in CodeCommit, consultaLavorare con i repository,Utilizzo dei modelli di regola di approvazione,Utilizzo di file,Lavorare con i commit,Gestione dei rami, eUtilizzo delle preferenze utente.

Argomenti