Flussi di lavoro in team con gli ambienti backend Amplify

L'implementazione di un feature branch è costituita da un frontend e da un ambiente backend opzionale. Il frontend è costruito e distribuito su una rete globale di distribuzione di contenuti (CDN), mentre il backend è distribuito da Amplify Studio o dall'Amplify CLI per. AWS Per ulteriori informazioni su questo scenario di distribuzione, vedereGuida introduttiva alle implementazioni continue a stack completo.

Nota

Puoi riutilizzare facilmente gli ambienti backend di Amplify nelle tue app Amplify. Per ulteriori informazioni, consulta Usa i backend di Amplify su tutte le app.

Amplify Hosting distribuisce continuamente risorse di backend come le API GraphQL e le funzioni Lambda con le implementazioni del tuo settore di funzionalità. Puoi utilizzare i seguenti modelli di ramificazione per implementare il tuo backend e frontend con Amplify Hosting.

Flusso di lavoro del ramo feature

• Crea ambienti backend di produzione, test e sviluppo con Amplify Studio o l'interfaccia a riga di comando di Amplify.

• Mappa il backend prod al ramo principale.

• Mappa il backend di test al ramo di sviluppo.

• I membri del team possono utilizzare l'ambiente di backend di sviluppo per testare singoli rami di funzionalità.

1. Installare l'interfaccia a riga di comando di Amplify per inizializzare un nuovo progetto Amplify.

   npm install -g @aws-amplify/cli

2. Inizializzare un ambiente di back-end prod per il progetto. Se non hai un progetto, creane uno usando strumenti di bootstrap come create-react-app o Gatsby.

   create-react-app next-unicorn
   cd next-unicorn
   amplify init
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: prod
   ...
   amplify push

3. Aggiungere gli ambienti di back-end test e dev.

   amplify env add
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: test
   ...
   amplify push
   
   amplify env add
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: dev
   ...
   amplify push

4. Invia il codice a un repository Git di tua scelta (in questo esempio assumeremo che tu abbia effettuato il push su main).

   git commit -am 'Added dev, test, and prod environments'
   git push origin main

5. Visita Amplify nel AWS Management Console per vedere il tuo attuale ambiente di backend. Passa di un livello superiore dalla breadcrumb per visualizzare un elenco di tutti gli ambienti di backend creati nella scheda Ambienti backend.

   

6. Passa alla scheda Ambienti frontend e collega il tuo provider di repository e la filiale principale.

   

7. Nella schermata delle impostazioni di build, scegli un ambiente di backend esistente per configurare la distribuzione continua con la filiale principale. Scegli prod dal menu a discesa e assegna il ruolo di servizio ad Amplify. Scegliere Save and deploy (Salva e distribuisci). Una volta completata la build, otterrai una distribuzione della filiale principale disponibile all'indirizzo https://main.appid.amplifyapp.com.

   

8. Collega il ramo di sviluppo in Amplify (supponiamo che il ramo di sviluppo e il ramo principale siano gli stessi a questo punto). Scegliere l'ambiente di back-end test.

   

9. Amplify è ora configurato. È possibile iniziare a lavorare su nuove funzionalità in un ramo feature. Aggiungere funzionalità di back-end utilizzando l'ambiente di back-end dev dalla workstation locale.

   git checkout -b newinternet
   amplify env checkout dev
   amplify add api
   ...
   amplify push

10. Dopo avere terminato di lavorare sulla funzionalità, eseguire il commit del codice e creare una richiesta di pull da rivedere internamente.

    git commit -am 'Decentralized internet v0.1'
    git push origin newinternet

11. Per visualizzare in anteprima l'aspetto delle modifiche, accedi alla console di Amplify e collega il tuo ramo delle funzionalità. Nota: se sul tuo sistema è AWS CLI installato (non l'Amplify CLI), puoi connettere una filiale direttamente dal tuo terminale. È possibile reperire il proprio appid accedendo a App settings > General > AppARN (Impostazioni applicazione > Generali > ARNapp): arn:aws:amplify:<region>:<region>:apps/<appid>

    aws amplify create-branch --app-id <appid> --branch-name <branchname>
    aws amplify start-job --app-id <appid> --branch-name <branchname> --job-type RELEASE

12. La funzionalità sarà disponibile all'indirizzo https://newinternet.appid.amplifyapp.com per essere condivisa con i colleghi. Se tutto appare corretto, unire PR al ramo develop.

    git checkout develop
    git merge newinternet
    git push

13. Questo darà il via a una build che aggiornerà il backend e il frontend in Amplify con una distribuzione filiale all'indirizzo https://dev.appid.amplifyapp.com. È possibile condividere questo link con parti interessate interne affinché possano esaminare la nuova funzionalità.

14. Elimina il tuo ramo delle funzionalità da Git, Amplify e rimuovi l'ambiente backend dal cloud (puoi sempre crearne uno nuovo in base a «amplify env checkout prod» ed eseguendo «amplify env add»).

    git push origin --delete newinternet
    aws amplify delete-branch --app-id <appid> --branch-name <branchname>
    amplify env remove dev

Flusso di lavoro di GitFlow

GitFlowutilizza due rami per registrare la cronologia del progetto. Il ramo principale tiene traccia solo del codice di rilascio e il ramo di sviluppo viene utilizzato come ramo di integrazione per nuove funzionalità. GitFlowsemplifica lo sviluppo parallelo isolando il nuovo sviluppo dal lavoro completato. Il nuovo sviluppo (come le funzionalità e le correzioni di bug non urgenti) viene svolto nei rami feature. Quando lo sviluppatore è sicuro che il codice sia pronto per il rilascio, il ramo feature viene ricollegato al ramo develop delle integrazioni. Gli unici commit al ramo principale sono le unioni dei rami di rilascio e i rami degli hotfix (per correggere i bug di emergenza).

Lo schema seguente mostra una configurazione consigliata conGitFlow. Puoi seguire lo stesso processo descritto nella sezione relativa al flusso di lavoro del ramo feature di cui sopra.

Per sandbox sviluppatore

• Ogni sviluppatore di un team crea un ambiente sandbox nel cloud che è separato dal computer locale. Ciò consente agli sviluppatori di lavorare in modo isolato l'uno dall'altro senza sovrascrivere le modifiche degli altri membri del team.

• Ogni filiale di Amplify ha il proprio backend. Ciò garantisce che Amplify utilizzi il repository Git come un'unica fonte di verità da cui implementare le modifiche, anziché affidarsi agli sviluppatori del team per trasferire manualmente il backend o il front-end alla produzione dai computer locali.

1. Installare l'interfaccia a riga di comando di Amplify per inizializzare un nuovo progetto Amplify.

   npm install -g @aws-amplify/cli

2. Inizializza un ambiente di backend mary per il tuo progetto. Se non hai un progetto, creane uno usando strumenti di bootstrap come create-react-app o Gatsby.

   cd next-unicorn
   amplify init
    ? Do you want to use an existing environment? (Y/n): n
    ? Enter a name for the environment: mary
   ...
   amplify push

3. Invia il codice a un repository Git di tua scelta (in questo esempio supponiamo che tu abbia effettuato il push su main.

   git commit -am 'Added mary sandbox'
   git push origin main

4. Collega il tuo repository > main ad Amplify.

5. La console Amplify rileverà gli ambienti di backend creati dalla CLI di Amplify. Scegli Crea nuovo ambiente dal menu a discesa e assegna il ruolo di servizio ad Amplify. Scegliere Save and deploy (Salva e distribuisci). Una volta completata la build, otterrai una distribuzione della filiale principale disponibile all'indirizzo https://main.appid.amplifyapp.com con un nuovo ambiente di backend collegato alla filiale.

6. Collega il ramo di sviluppo in Amplify (supponiamo che il ramo di sviluppo e il ramo principale siano gli stessi a questo punto) e scegli Crea nuovo ambiente. Una volta completata la compilazione, all'indirizzo https://develop.appid.amplifyapp.com sarà disponibile una distribuzione del ramo develop con un nuovo ambiente di back-end collegato al ramo.