Guida introduttiva al codice esistente - AWS Amplify Ospitare

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

Guida introduttiva al codice esistente

Questa procedura guidata illustra come creare, distribuire e ospitare in modo continuo un'app Web moderna. Le app Web moderne includono framework di applicazioni a pagina singola (SPA) (ad esempio, React, Angular o Vue) e generatori di siti statici (SSG) (ad esempio, Hugo, Jekyll o Gatsby). Amplify Hosting supporta anche app Web che utilizzano il rendering lato server (SSR) e vengono create utilizzando Next.js.

Per iniziare, accedi alla console Amplify. Se parti dalla AWS Amplifyhome page, scegli Inizia nella parte superiore della pagina.


         La AWS Amplify home page con il pulsante Get Started cerchiato in rosso.

Quindi scegli Inizia in Delivery.


         La sezione Consegna nella parte inferiore della AWS Amplify home page con la Guida introduttiva cerchiata in rosso.

Se parti dalla pagina Tutte le app, scegli Nuova app, quindi Ospita app web nell'angolo in alto a destra.


         Schermata della pagina Tutte le app nella console Amplify.

Passaggio 1: Connect un repository

Connect il tuo GitHub Bitbucket o AWS CodeCommit il tuo GitLab repository. Hai anche la possibilità di caricare manualmente gli artefatti della build senza connettere un repository Git. Per ulteriori informazioni, consulta Manual Deploys.


            Schermata della pagina Inizia a usare Amplify Hosting nella console Amplify.

Dopo aver autorizzato la console Amplify con Bitbucket GitLab, AWS CodeCommit oppure, Amplify recupera un token di accesso dal provider del repository, ma non lo archivia sui server. AWS Amplify accede al repository utilizzando chiavi di distribuzione installate solo in uno specifico repository.

Per gli GitHub archivi, Amplify ora utilizza la funzione Apps per autorizzare GitHub l'accesso ad Amplify. Con l'app GitHub Amplify, le autorizzazioni sono più ottimizzate, consentendoti di concedere ad Amplify l'accesso solo ai repository che specifichi. Per ulteriori informazioni sull'installazione e l'autorizzazione dell'App, consulta. GitHub Configurazione dell'accesso Amplify ai GitHub repository

Dopo aver connesso il provider del servizio del repository, seleziona un repository, quindi scegli un ramo corrispondente da creare e distribuire.


            Schermata della sezione Repository branch nella console Amplify con un ramo selezionato.

Passaggio 2a: Conferma le impostazioni di costruzione per il front-end

Per il ramo selezionato, Amplify ispeziona il repository per rilevare automaticamente la sequenza di comandi di compilazione da eseguire.


            Schermata delle impostazioni di build per il ramo.

Importante: verifica che i comandi di compilazione e la directory dell'output di compilazione (artifacts > baseDirectory) siano corretti. Se devi modificare queste informazioni, seleziona Modifica per aprire l'editor YML. Puoi salvare le impostazioni di build sui nostri server oppure puoi scaricare il codice YML e aggiungerlo alla radice del tuo repository (per monorepos, archivia l'YML nella directory principale dell'app).


            Schermata dei comandi di compilazione nella finestra di modifica.

Per ulteriori informazioni, consulta la sintassi YAML delle specifiche di compilazione.

Passaggio 2b: conferma le impostazioni di build per il backend

Se hai collegato un repository fornito da Amplify CLI v1.0+ (esegui amplify -v per trovare la versione CLI), Amplify Hosting distribuirà o aggiornerà automaticamente le risorse di backend (qualsiasi risorsa fornita dalla CLI Amplify) in un unico flusso di lavoro con la build del frontend. Puoi scegliere di puntare un ambiente di back-end esistente al tuo ramo oppure creare un ambiente completamente nuovo. step-by-step Per un tutorial, consulta Guida introduttiva alle distribuzioni fullstack.


            Schermata della sezione Configura le impostazioni di build nella console Amplify.

Per implementare la funzionalità di backend utilizzando la CLI Amplify durante la compilazione, crea o riutilizza un ruolo di servizio (IAM). AWS Identity and Access Management I ruoli IAM sono un modo sicuro per concedere ad Amplify le autorizzazioni ad agire sulle risorse del tuo account. Per istruzioni dettagliate, vedi Aggiungere un ruolo di servizio.

Nota: la CLI Amplify non verrà eseguita senza un ruolo di servizio IAM abilitato.


            Schermata delle impostazioni di configurazione di configurazione in cui si specifica il ruolo del servizio.

Fase 2c: Aggiungere variabili di ambiente (opzionale)

Quasi tutte le app devono ricevere informazioni sulla configurazione in fase di runtime. Tali configurazioni possono includere dettagli sulla connessione del database, chiavi API o parametri diversi. Le variabili di ambiente forniscono un mezzo per esporre queste configurazioni in fase di compilazione.

Fase 3: Salvare e distribuire

Rivedi tutte le impostazioni per verificare che siano configurate correttamente. Scegli Salva e distribuisci per distribuire la tua app Web nella rete AWS globale di distribuzione dei contenuti (CDN). La creazione del front-end richiede in genere da 1 a 2 minuti, ma può variare in base alle dimensioni dell'app.

Accedi alla schermata dei registri di compilazione scegliendo un indicatore di avanzamento nella sezione branch. Una compilazione presenta i seguenti passaggi:

  1. Provisioning - l'ambiente di compilazione viene configurato utilizzando un'immagine Docker su un host con 4 vCPU e 7 GB di memoria. Ogni compilazione riceve la propria istanza host, facendo sì che tutte le risorse siano isolate in modo sicuro. I contenuti del file Docker vengono visualizzati per consentire all'immagine predefinita di soddisfare i tuoi requisiti.

  2. Compilazione - la fase di compilazione consiste in tre passaggi: configurazione (clona il repository nel container). distribuzione del back-end (esegue l'interfaccia a riga di comando di Amplify per distribuire le risorse back-end) e compilazione del front-end (compila gli artefatti front-end).

  3. Implementazione: una volta completata la build, tutti gli artefatti vengono distribuiti in un ambiente di hosting gestito da Amplify Hosting. Puoi visualizzare la tua app sul dominio. amplifyapp.com Ogni distribuzione è atomica - Le distribuzioni atomiche eliminano le finestre di manutenzione facendo in modo che l'app Web venga aggiornata solo dopo il completamento dell'intera distribuzione.

    
                  Schermata dello stato di avanzamento della costruzione della filiale.
Nota

Per aumentare la sicurezza delle tue applicazioni Amplify, il dominio amplifyapp.com è registrato nella Public Suffix List (PSL). Per una maggiore sicurezza, ti consigliamo di utilizzare i cookie con un __Host- prefisso se hai bisogno di impostare cookie sensibili nel nome di dominio predefinito per le tue applicazioni Amplify. Questa pratica ti aiuterà a difendere il tuo dominio dai tentativi CSRF (cross-site request forgery). Per ulteriori informazioni, consulta la pagina Impostazione cookie nella pagina Mozilla Developer Network.

Passaggi successivi