Configurazione dell'accesso Amplify ai GitHub repository

Amplify ora utilizza la funzione GitHub App per autorizzare l'accesso in sola lettura ai GitHub repository di Amplify. Con l' GitHub app Amplify, le autorizzazioni sono più precise e consentono di concedere ad Amplify l'accesso solo ai repository specificati. Per ulteriori informazioni sulle GitHub app, consulta Informazioni sulle GitHub app sul GitHub sito Web.

Quando colleghi una nuova app archiviata in un GitHub repository, per impostazione predefinita Amplify utilizza l' GitHub app per accedere al repository. Tuttavia, le app Amplify esistenti che hai collegato in precedenza dai GitHub repository utilizzano OAuth per l'accesso. CI/CD continuerà a funzionare per queste app, ma ti consigliamo vivamente di migrarle per utilizzare la nuova GitHub app Amplify.

Quando distribuisci una nuova app o esegui la migrazione di un'app esistente utilizzando la console Amplify, vieni automaticamente indirizzato alla posizione di installazione dell' GitHub app Amplify. Per accedere manualmente alla landing page di installazione dell'app, apri un browser Web e accedi all'app per regione. Usa il formatohttps://github.com/apps/aws-amplify-REGION, sostituendo REGION con la regione in cui distribuirai l'app Amplify. Ad esempio, per installare l' GitHub app Amplify nella regione Stati Uniti occidentali (Oregon), vai a https://github.com/apps/aws-amplify-us-west -2.

Installazione e autorizzazione dell' GitHub app Amplify per una nuova distribuzione

Quando distribuisci una nuova app su Amplify dal codice esistente in un GitHub repository, utilizza le seguenti istruzioni per installare e autorizzare l' GitHub app.

Per installare e autorizzare l' GitHub app Amplify

1. AccediAWS Management Console e apri la console Amplify.

2. Nella pagina Tutte le app, scegli Nuova app, quindi Host web app.

3. Nella pagina Inizia con Amplify Hosting, scegli GitHub, quindi scegli Continua.

4. Se è la prima volta che connetti un GitHub repository, nel tuo browser si apre una nuova pagina all' GitHubindirizzo .com, che richiede l'autorizzazioneAWS Amplify all'accesso al tuo GitHub account. Selezionare Authorize (Autorizza).

5. Successivamente, devi installare l' GitHub app Amplify nel tuo GitHub account. Si apre una pagina su GitHub.com che richiede l'autorizzazione per l'installazione e l'autorizzazioneAWS Amplify nel tuo GitHub account.

6. Seleziona l' GitHub account in cui desideri installare l' GitHub app Amplify.

7. 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 che stai migrando nei repository selezionati.

8. Scegli Installa e autorizza.

9. Verrai reindirizzato alla pagina Aggiungi filiale del repository per la tua app nella console di Amplify.

10. Nell'elenco Repository aggiornati di recente, seleziona il nome del repository da connettere.

11. Nell'elenco delle filiali, selezionare il nome del ramo del repository da connettere.

12. Seleziona Successivo.

13. Nella pagina Configura le impostazioni di build, scegli Avanti.

14. Nella pagina Revisione, scegli Salva e distribuisci.

Migrazione di un'OAuthapp esistente all'app Amplify GitHub

Le app Amplify esistenti che hai precedentemente collegato dai GitHub repository utilizzano OAuth per l'accesso al repository. È fortemente consigliato effettuare la migrazione di queste applicazioni per usare l' GitHubapplicazione Amplify.

Utilizza le seguenti istruzioni per migrare un'app ed eliminare il webhook OAuth corrispondente nel tuo GitHub account. Tieni presente che la procedura per la migrazione varia a seconda che l' GitHub app Amplify sia già installata. Dopo aver eseguito la migrazione della prima app e aver installato e autorizzato l' GitHub app, devi solo aggiornare le autorizzazioni del repository per le migrazioni successive delle app.

Per migrare un'app da OAuth all' GitHub app

1. AccediAWS Management Console e apri la console Amplify.

2. Scegli l'app da usare per la migrazione.

3. Nella pagina delle informazioni dell'app, individua il messaggio blu Migra alla nostra GitHub app e scegli Avvia migrazione.

4. Nella pagina Installa e autorizza GitHub l'app, scegli Configura GitHub app.

5. Una nuova pagina si apre nel tuo browser GitHub su.com, che richiede l'autorizzazione all'autorizzazioneAWS Amplify nel tuo GitHub account. Selezionare Authorize (Autorizza).

6. Seleziona l' GitHub account in cui desideri installare l' GitHub app Amplify.

7. 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 che stai migrando nei repository selezionati.

8. Scegli Installa e autorizza.

9. Verrai reindirizzato alla pagina Installa e autorizza GitHub l'app per la tua app nella console di Amplify. Se GitHub l'autorizzazione è andata a buon fine, visualizzerai un messaggio di esito positivo. Scegli, Avanti.

10. Nella pagina Installazione completa, scegli Installazione completa. Questo passaggio elimina il webhook esistente, ne crea uno nuovo e completa la migrazione.

Configurazione dell' GitHub app Amplify per implementazioniAWS CloudFormation, CLI e SDK

Le app Amplify esistenti che hai precedentemente collegato dai GitHub repository utilizzano OAuth per l'accesso al repository. Ciò può includere le app distribuite utilizzando l'interfaccia a riga di comando (CLI) Amplify o gli SDK.AWS CloudFormation È fortemente consigliato effettuare la migrazione di queste applicazioni per usare la nuova GitHub app Amplify. La migrazione deve essere eseguita nella console Amplify inAWS Management Console. Per istruzioni, consulta Migrazione di un'OAuthapp esistente all'app Amplify GitHub .

Puoi utilizzare l'interfacciaAWS CloudFormation a riga di comando di Amplify e gli SDK per distribuire una nuova app Amplify che utilizza l' GitHub app per l'accesso al repository. Questo processo richiede che tu installi prima l' GitHub app Amplify nel tuo GitHub account. Successivamente, dovrai generare un token di accesso personale nel tuo GitHub account. Infine, implementa l'app e specifica il token di accesso personale.

Installa l' GitHub app Amplify nel tuo account

1. Apri un browser Web e accedi alla posizione di installazione dell' GitHubapp Amplify nellaAWS regione in cui distribuirai l'app.

   Usa il formatohttps://github.com/apps/aws-amplify-REGION/installations/new, sostituendo REGION con il tuo input. Ad esempio, se stai installando la tua app nella regione Stati Uniti occidentali (Oregon), specificahttps://github.com/apps/aws-amplify-us-west-2/installations/new.

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

3. 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 che stai migrando nei repository selezionati.

4. Scegli Install (Installa).

Genera un token di accesso personale nel tuo GitHub account

1. Accedi al tuo GitHub account.

2. Nell'angolo in alto a destra, individua la foto del tuo profilo e scegli Impostazioni dal menu.

3. Dal menu di navigazione a sinistra, scegli Impostazioni sviluppatore.

4. Nella pagina GitHub App, nel menu di navigazione a sinistra, scegli Token di accesso personali.

5. Nella pagina Token di accesso personali, scegli Genera nuovo token.

6. Nella pagina Nuovo token di accesso personale, in Nota inserisci un nome descrittivo per il token.

7. Nella sezione Seleziona ambiti, seleziona admin:repo_hook.

8. Scegli Generate token (Genera token).

9. Copia e salva il token di accesso personale. Dovrai fornirlo quando distribuisci un'app Amplify con la CLI o gli SDK.AWS CloudFormation

Dopo aver installato GitHub l'app Amplify nel tuo GitHub account e aver generato un token di accesso personale, puoi distribuire una nuova app con l'Amplify CLI o gli SDK.AWS CloudFormation Utilizzare ilaccessToken campo per specificare il token di accesso personale creato nella procedura precedente. Per ulteriori informazioni, consulta il riferimento CreateAppall'API Amplify e AWS::Amplify::Appla Guida per l'AWS CloudFormationutente.

Il seguente comando CLI implementa una nuova app Amplify che utilizza l' GitHub app per l'accesso al repository. Sostituisci myapp-using-githubapphttps://github.com/Myaccount/react-app e MY_TOKEN con le tue informazioni.

aws amplify create-app --name myapp-using-githubapp --repository https://github.com/Myaccount/react-app --access-token MY_TOKEN
   
  

Configurazione delle anteprime web con l' GitHub app Amplify

Un'anteprima web distribuisce ogni pull request (PR) effettuata nel tuo GitHub repository su un URL di anteprima univoco. Le anteprime ora utilizzano l' GitHub app Amplify per accedere al tuo GitHub repository. Per istruzioni sull'installazione e l'autorizzazione dell' GitHub App per le anteprime web, consultaAbilita le anteprime web.