Anteprime Web per le richieste pull

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

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

Quando le anteprime web sono attivate per la tua app, ogni PR conta ai fini della quota Amplify di 50 filiali per app. Per evitare di superare questa quota, assicurati di chiudere la tua. PRs Per ulteriori informazioni sulle quote, consulta Quote del servizio Amplify Hosting.

Nota

Attualmente, la variabile di AWS_PULL_REQUEST_ID ambiente non è disponibile quando viene utilizzata AWS CodeCommit come provider di repository.

Sicurezza dell'anteprima Web

Per motivi di sicurezza, puoi abilitare le anteprime Web su tutte le app con archivi privati, ma non su tutte le app con archivi pubblici. Se il tuo repository Git è pubblico, puoi configurare le anteprime solo per le app che non richiedono un ruolo di servizio IAM. Ad esempio, le app con backend e le app distribuite sulla piattaforma di WEB_COMPUTE hosting richiedono un ruolo di servizio IAM. Pertanto, non puoi abilitare le anteprime web per questi tipi di app se il loro archivio è pubblico. Amplify applica questa restrizione per impedire a terze parti di inviare codice arbitrario da eseguire utilizzando le autorizzazioni dei ruoli IAM della tua app.

Quando le anteprime web sono abilitate per un'applicazione in un archivio pubblico, con un ruolo SSR Compute, devi gestire con attenzione le filiali che possono accedere al ruolo. Ti consigliamo di non utilizzare un ruolo a livello di app. Invece, dovresti assegnare un ruolo Compute a livello di filiale. Ciò consente di concedere le autorizzazioni solo alle filiali che richiedono l'accesso a risorse specifiche. Per ulteriori informazioni, consulta Aggiungere un ruolo SSR Compute per consentire l'accesso alle risorse AWS.

Abilita le anteprime web per le richieste pull

Per le app archiviate in un GitHub repository, le anteprime web utilizzano l'app Amplify per l'accesso ai repository. GitHub Se stai abilitando le anteprime web su un'app Amplify esistente che hai precedentemente distribuito da GitHub un repository OAuth utilizzando for access, devi prima migrare l'app per utilizzare l'app Amplify. GitHub Per le istruzioni sulla migrazione, Migrazione di un file esistente OAuth dall'app all'app Amplify GitHub consulta.

Per abilitare le anteprime web per le richieste pull

1. Scegli Hosting, quindi 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'app Amplify nel tuo account GitHub :

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

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

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

   4. Esegui una di queste operazioni:

      • Per applicare l'installazione a tutti gli archivi, scegli Tutti gli archivi.

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

   5. Seleziona Salva

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

4. Nella pagina Gestisci le impostazioni di anteprima, attiva le anteprime delle richieste Pull. Quindi scegli Conferma.

5. Per le applicazioni fullstack, effettuate 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 Pull per questo ramo a un ambiente esistente.

6. Scegli Conferma.

La prossima volta che invii una pull request per la filiale, Amplify crea e distribuisce il tuo PR su un URL di anteprima. Dopo la chiusura della pull request, l'URL di anteprima viene eliminato e qualsiasi ambiente di backend temporaneo collegato alla pull request viene eliminato. Solo per i GitHub repository, puoi accedere a un'anteprima dell'URL direttamente dalla pull request del tuo GitHub account.

Accesso all'anteprima Web con sottodomini

Le anteprime Web per le richieste pull sono accessibili con i sottodomini di 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 pull request vengono eliminati automaticamente. Questo è il comportamento predefinito per le anteprime web dopo aver configurato le distribuzioni di feature branch basate su pattern per la tua app. Per istruzioni sulla configurazione dei sottodomini automatici, consulta. Configurazione di sottodomini automatici per un dominio personalizzato Amazon Route 53