Distribuzione di un'applicazione Symfony su Elastic Beanstalk

Symfony è un framework open source per lo sviluppo di applicazioni Web PHP dinamiche. Questo tutorial illustra il processo di generazione di un'applicazione Symfony e la sua distribuzione in un ambiente. AWS Elastic Beanstalk

Prerequisiti

Questo tutorial presuppone determinate conoscenze sulle operazioni di base di Elastic Beanstalk e della console Elastic Beanstalk. Se non lo hai già fatto, segui le istruzioni in Nozioni di base sull'uso di Elastic Beanstalk per avviare il tuo primo ambiente Elastic Beanstalk.

Per seguire le procedure in questa guida, devi usare un terminale a riga di comando o una shell per eseguire i comandi. I comandi vengono visualizzati in elenchi preceduti da un simbolo di prompt ($) e dal nome della directory corrente, se appropriato.

~/eb-project$ this is a command
this is output

Su Linux e macOS usa la tua shell e il tuo programma di gestione dei pacchetti preferiti. Su Windows è possibile installare il sottosistema Windows per Linux per ottenere una versione integrata con Windows di Ubuntu e Bash.

Symfony 4.4.9 richiede PHP 7.1.3 o versioni successive. Richiede anche le estensioni PHP elencate nell'argomento dei requisiti tecnici nella documentazione ufficiale di installazione di Symfony. In questo tutorial viene utilizzato PHP 7.2 e la versione della piattaforma Elastic Beanstalk corrispondente. Seguire le istruzioni riportate nell'argomento Configurazione dell'ambiente di sviluppo PHP per installare PHP e Composer.

Per informazioni sul supporto e sulla manutenzione di Symfony, consulta l'argomento relativo alle versioni di Symfony sul sito Web di Symfony. Per ulteriori informazioni sugli aggiornamenti relativi al supporto della versione PHP per Symfony 4.4.9, consulta Note di rilascio di Symfony 4.4.9 sul sito Web di Symfony.

Avvio di un ambiente Elastic Beanstalk

Utilizza la console Elastic Beanstalk per creare un ambiente Elastic Beanstalk. Scegli la piattaforma PHP e accetta le impostazioni predefinite e il codice di esempio.

Per avviare un ambiente (console)

1. Apri la console Elastic Beanstalk utilizzando questo link preconfigurato: console.aws.amazon.com/elasticbeanstalk/home#/ newApplication?applicationname=tutorials &EnvironmentType= LoadBalanced

2. Per Platform (Piattaforma), selezionare il ramo della piattaforma e la piattaforma che corrispondono al linguaggio utilizzato dall'applicazione.

3. In Application code (Codice applicazione), scegli Sample application (Applicazione di esempio).

4. Selezionare Review and launch (Controlla e avvia).

5. Verificare le opzioni disponibili. Scegliere l'opzione disponibile che si desidera utilizzare e, quando si è pronti, scegliere Create app (Crea app).

Occorrono circa cinque minuti per creare l'ambiente e le seguenti risorse:

• Istanza EC2: una macchina virtuale Amazon Elastic Compute Cloud (Amazon EC2) configurata per l'esecuzione di app Web sulla piattaforma scelta.

  Ogni piattaforma esegue un insieme specifico di software, file di configurazione e script per supportare una versione della lingua, un framework, un container Web specifici o una determinata combinazione di essi. La maggior parte delle piattaforme utilizza Apache o NGINX come proxy inverso su cui viene eseguita l'app Web, inoltra le richieste all'app, fornisce asset statici e genera log degli accessi e di errore.

• Gruppo di sicurezza istanze: un gruppo di sicurezza di Amazon EC2 configurato per abilitare il traffico in entrata sulla porta 80. Questa risorsa consente al traffico TTP proveniente dal sistema di bilanciamento del carico di raggiungere l'istanza EC2 in esecuzione sull'app Web. Per impostazione predefinita, il traffico non è consentito su altre porte.

• Sistema di bilanciamento del carico: un sistema di bilanciamento del carico Elastic Load Balancing configurato per distribuire richieste alle istanze in esecuzione sull'applicazione. Un sistema di bilanciamento del carico inoltre elimina la necessità di esporre le proprie istanze direttamente in Internet.

• Gruppo di sicurezza del sistema di bilanciamento del carico: un gruppo di sicurezza di Amazon EC2 configurato per abilitare il traffico in entrata sulla porta 80. Questa risorsa HTTP consente al traffico proveniente da Internet di raggiungere il sistema di bilanciamento del carico. Per impostazione predefinita, il traffico non è consentito su altre porte.

• Gruppo Auto Scaling: un gruppo Auto Scaling configurato per sostituire un'istanza se viene terminata o diventa non disponibile.

• Bucket Amazon S3: posizione di storage per il codice sorgente, i log e altri artefatti creati quando si utilizza Elastic Beanstalk.

• CloudWatch Allarmi Amazon: due CloudWatch allarmi che monitorano il carico sulle istanze nel tuo ambiente e che vengono attivati se il carico è troppo alto o troppo basso. Quando viene attivato un allarme, il gruppo Auto Scaling aumenta o diminuisce di conseguenza.

• AWS CloudFormation stack: Elastic AWS CloudFormation Beanstalk utilizza per avviare le risorse nell'ambiente e propagare le modifiche alla configurazione. Le risorse sono definite in un modello, visualizzabile nella console AWS CloudFormation.

• Nome dominio: un nome di dominio che esegue l'instradamento all'applicazione Web utilizzando il formato sottodominio.regione.elasticbeanstalk.com.

  Nota

  Per aumentare la sicurezza delle tue applicazioni Elastic Beanstalk, il dominio elasticbeanstalk.com è registrato nella Public Suffix List (PSL). Per una maggiore sicurezza, ti consigliamo di utilizzare i cookie con un prefisso __Host- se hai bisogno di impostare cookie sensibili nel nome di dominio predefinito per le tue applicazioni Elastic Beanstalk. 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.

Tutte queste risorse sono gestite da Elastic Beanstalk. Quando arresti l'ambiente, Elastic Beanstalk termina tutte le risorse che contiene.

Nota

Il bucket Amazon S3 creato da Elastic Beanstalk è condiviso tra gli ambienti e non viene eliminato quando l'ambiente viene terminato. Per ulteriori informazioni, consultare Utilizzo di Elastic Beanstalk con Amazon S3.

Installazione di Symfony e creazione di un sito Web

Composer è in grado di installare Symfony e di creare un progetto funzionante con un unico comando:

~$ composer create-project symfony/website-skeleton eb-symfony

Composer installa Symfony e le relative dipendenze e genera un progetto predefinito.

In caso di problemi durante l'installazione di Symfony, consulta l'argomento relativo all'installazione nella documentazione ufficiale di Symfony.

Distribuzione dell'applicazione

Passare alla directory del progetto.

~$ cd eb-symfony

Crea un bundle di origine che contiene i file creati da Composer. Il comando seguente crea un bundle di origine denominato symfony-default.zip. Esclude i file nella cartella vendor, che occupano molto spazio e non sono necessari per la distribuzione dell'applicazione in Elastic Beanstalk.

eb-symfony$ zip ../symfony-default.zip -r * .[^.]* -x "vendor/*"

Carica il bundle di origine in Elastic Beanstalk per distribuire Symfony nel tuo ambiente.

Per distribuire un bundle di origine

1. Apri la console Elastic Beanstalk e, nell'elenco Regioni, seleziona la tua. Regione AWS

2. Nel pannello di navigazione selezionare Environments (Ambienti), quindi selezionare il nome dell'ambiente dall'elenco.

   Nota

   Se si dispone di molti ambienti, utilizzare la barra di ricerca per filtrare l'elenco degli ambienti.

3. Nella pagina della panoramica dell'ambiente scegliere Upload and deploy (Carica e distribuisci).

4. Utilizzare la finestra di dialogo su schermo per caricare il bundle di origine.

5. Selezionare Deploy (Distribuisci).

6. Al termine della distribuzione, è possibile scegliere l'URL del sito per aprire il sito Web in una nuova scheda.

Nota

Per ottimizzare ulteriormente il bundle di origine, inizializza un repository Git e utilizza il comando git archive per creare il bundle di origine. Il progetto predefinito di Symfony include un file .gitignore che indica a Git di escludere la cartella vendor e gli altri file non necessari per la distribuzione.

Configurazione delle impostazioni di Composer

Al termine della distribuzione, fai clic sull'URL per aprire la tua applicazione Symfony nel browser.

Di cosa si tratta? Per impostazione predefinita, Elastic Beanstalk fornisce la radice del progetto al percorso principale del sito Web. In questo caso, tuttavia, la pagina predefinita (app.php) è a un livello inferiore nella cartella web. Puoi eseguire una verifica aggiungendo /public all'URL. Ad esempio, http://symfony.us-east-2.elasticbeanstalk.com/public.

Per distribuire l'applicazione Symfony nel percorso root, utilizza la console Elastic Beanstalk per configurare la radice del documento del sito Web.

Per configurare la radice del documento del sito Web

1. Apri la console Elastic Beanstalk e, nell'elenco Regioni, seleziona la tua. Regione AWS

2. Nel pannello di navigazione selezionare Environments (Ambienti), quindi selezionare il nome dell'ambiente dall'elenco.

   Nota

   Se si dispone di molti ambienti, utilizzare la barra di ricerca per filtrare l'elenco degli ambienti.

3. Nel riquadro di navigazione, seleziona Configuration (Configurazione).

4. Nella categoria di configurazione Updates, monitoring, and logging (Aggiornamenti, monitoraggio e registrazione), scegli Edit (Modifica).

5. In Document root (Radice documento), immettere /public.

6. Per salvare le modifiche scegli Apply (Applica) nella parte inferiore della pagina.

7. Al termine dell'aggiornamento, fai clic sull'URL per riaprire il tuo sito all'interno del browser.

Pulizia

Dopo aver usato Elastic Beanstalk, puoi terminare l'ambiente. Elastic Beanstalk AWS interrompe tutte le risorse associate all'ambiente, come istanze Amazon EC2, istanze di database, sistemi di bilanciamentodel carico, gruppi di sicurezza e allarmi.

Per terminare l'ambiente Elastic Beanstalk dalla console

1. Apri la console Elastic Beanstalk e, nell'elenco Regioni, seleziona la tua. Regione AWS

2. Nel pannello di navigazione selezionare Environments (Ambienti), quindi selezionare il nome dell'ambiente dall'elenco.

   Nota

   Se si dispone di molti ambienti, utilizzare la barra di ricerca per filtrare l'elenco degli ambienti.

3. Seleziona Actions (Operazioni), quindi Terminate environment (Termina ambiente).

4. Utilizza la finestra di dialogo su schermo per confermare la terminazione dell'ambiente.

Con Elastic Beanstalk puoi creare facilmente un nuovo ambiente per l'applicazione in qualsiasi momento.

Passaggi successivi

Per ulteriori informazioni su Symfony, consulta la presentazione di Symfony su symfony.com.

Mentre continui a sviluppare l'applicazione, potrebbe essere necessario un metodo per gestire gli ambienti e distribuire l'applicazione senza creare manualmente un file .zip e caricarlo sulla console Elastic Beanstalk. L'Elastic Beanstalk Command Line Interface (EB CLI easy-to-use ) fornisce comandi per creare, configurare e distribuire applicazioni in ambienti Elastic Beanstalk dalla riga di comando.

In questo tutorial, hai utilizzato la console Elastic Beanstalk per configurare le opzioni Composer. Per rendere questa configurazione parte della tua origine delle applicazioni, puoi utilizzare un file di configurazione come il seguente.

Esempio .ebextensions/composer.config

option_settings:
  aws:elasticbeanstalk:container:php:phpini:
    document_root: /public

Per ulteriori informazioni, consultare Personalizzazione avanzata dell'ambiente con i file di configurazione (.ebextensions).

Symfony utilizza i propri file di configurazione per configurare le connessioni del database. Per istruzioni sulla connessione a un database con Symfony, consulta Connessione a un database con Symfony.

Infine, se prevedi di usare l'applicazione in un ambiente di produzione, devi configurare un nome di dominio personalizzato per l'ambiente e abilitare HTTPS per le connessioni sicure.