Anteprime Web per le pull request - AWS AmplifyOspitare
Abilita le anteprime webAccesso all'anteprima Web con sottodomini

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

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.

Le fasi di un'anteprima PR, che mostrano che un URL di anteprima univoco viene creato all'apertura di un PR e l'URL di anteprima viene eliminato quando il PR viene unito.
Importante

Per motivi di sicurezza, puoi abilitare le anteprime web su tutte le app con repository 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 diWEB_COMPUTE hosting richiedono un ruolo di servizio IAM. Pertanto, non puoi abilitare le anteprime web per questi tipi di app se il loro repository è pubblico.

Amplify applica questa restrizione per impedire a terze parti di inviare codice arbitrario che verrebbe eseguito utilizzando le autorizzazioni del ruolo IAM della tua app.

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.

    La pagina delle anteprime con un ramo selezionato e il pulsante Gestito richiamato in alto a destra.

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

  5. Per le applicazioni fullstack, procedi in uno dei seguenti:

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

La pagina delle anteprime con le informazioni su un PR, incluso l'URL di anteprima univoco.

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

Una pull request in un GitHub account in cui puoi scegliere Dettagli per visualizzare l'URL di anteprima.

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 automatici, consultaConfigura sottodomini automatici per un dominio personalizzato Amazon Route 53.