Anteprime Web per le pull request

Le anteprime Web offrono ai team di sviluppo e controllo qualità (QA) un modo per visualizzare in anteprima le modifiche apportate alle pull request (PR) prima di unire il codice a un ramo di produzione o integrazione. Le pull request ti consentono di comunicare agli altri le modifiche che hai inviato a un ramo di un repository. Dopo l'apertura di una pull request, puoi discutere ed esaminare le potenziali modifiche con i collaboratori e aggiungere dei commit successivi prima che le modifiche vengano unite al ramo di base.

Nota

Attualmente, il branch di anteprima di Amplify supporta eAWS CodeCommit non ha la piena parità di funzionalità con GitHub. GitLab BitBucket La variabile diAWS_PULL_REQUEST_ID ambiente è disponibile solo se utilizzata GitHub come provider di repository.

Un'anteprima web distribuisce ogni pull request inviata al tuo repository su un URL di anteprima univoco, completamente diverso dall'URL utilizzato dal tuo sito principale. Per le app con ambienti backend forniti utilizzando l'Amplify CLI o Amplify Studio, ogni pull request (solo repository Git privati) genera un backend effimero che viene eliminato alla chiusura del PR.

Importante

Per motivi di sicurezza, le anteprime funzionano solo con repository privati per app full-stack.

Abilita le anteprime web

Per le app archiviate in un GitHub repository, le anteprime utilizzano l' GitHub app Amplify per l'accesso al repository. Se stai abilitando le anteprime web su un'app Amplify esistente che hai precedentemente distribuito da un GitHub repository utilizzando OAuth per l'accesso, devi prima migrare l'app per utilizzare l' GitHub app Amplify. Per le istruzioni sulla migrazione, consultaMigrazione di un'OAuthapp esistente all'app Amplify GitHub .

Per abilitare le anteprime web per le pull request

1. Scegli Impostazioni app, Anteprime e quindi scegli Abilita anteprime.

   Nota

   Le anteprime sono visibili nel menu delle impostazioni dell'app solo quando un'app è configurata per la distribuzione continua e connessa a un repository git. Per istruzioni su questo tipo di distribuzione, consulta Guida introduttiva al codice esistente.

2. Solo per i GitHub repository, procedi come segue per installare e autorizzare l' GitHub app Amplify nel tuo account:

   1. Nella finestra Installa GitHub app per abilitare le anteprime, scegli Installa GitHub app.

   2. Seleziona l' GitHub account in cui desideri configurare l' GitHubapp Amplify.

   3. Si apre una pagina su GitHub.com per configurare le autorizzazioni del repository per il tuo account.

   4. Completa una delle seguenti operazioni:

      • Per applicare l'installazione a tutti i repository, scegli Tutti i repository.

      • Per limitare l'installazione ai repository specifici selezionati, scegli Solo repository selezionati. Assicurati di includere il repository dell'app per cui stai abilitando le anteprime web nei repository selezionati.

   5. Selezionare Salva

3. Dopo aver abilitato le anteprime per il tuo repository, torna alla console Amplify per abilitare le anteprime per filiali specifiche. Nella pagina Anteprime, seleziona un ramo dall'elenco e scegli Gestisci.

   

4. Nella finestra Gestisci le impostazioni di anteprima per le filiali, attiva le anteprime delle richieste di pull.

5. In una delle seguenti operazioni:

   • Scegli, crea un nuovo ambiente di backend per ogni Pull Request. Questa opzione consente di testare le modifiche senza influire sulla produzione.

   • Scegli Indirizza tutte le richieste di pull per questo ramo a un ambiente esistente.

6. Scegli Confirm (Conferma).

La prossima volta che invii una pull request per la filiale, Amplify crea e distribuisce il tuo PR su un URL di anteprima.

Solo per i GitHub repository, puoi accedere a un'anteprima del tuo URL direttamente dalla pull request nel tuo GitHub account.

Dopo la chiusura della pull request, l'URL di anteprima viene eliminato e qualsiasi ambiente di backend temporaneo collegato alla richiesta di pull viene eliminato.

Accesso all'anteprima Web con sottodomini

Le anteprime Web delle richieste pull sono accessibili con sottodomini per un'app Amplify connessa a un dominio personalizzato gestito da Amazon Route 53. Quando la pull request viene chiusa, i rami e i sottodomini associati alla richiesta pull vengono eliminati automaticamente. Questo è il comportamento predefinito per le anteprime Web dopo aver impostato le distribuzioni dei rami di funzionalità basate su modelli per la tua app. Per istruzioni sull'impostazione dei sottodomini, consultaConfigura sottodomini automatici per un dominio personalizzato Amazon Route 53.