Distribuzione di un'applicazione Laravel su Elastic Beanstalk

Laravel è un framework open source model-view-controller (MVC) per PHP. Questo tutorial illustra il processo di generazione di un'applicazione Laravel, la sua distribuzione in un AWS Elastic Beanstalk ambiente e la configurazione per la connessione a un'istanza di database Amazon Relational Database Service (Amazon RDS).

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 Guida introduttiva a 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 puoi installare il sottosistema Windows per Linux per ottenere una versione integrata per Windows di Ubuntu e Bash.

Laravel 6 richiede PHP 7.2 o versioni successive. Richiede anche le estensioni PHP riportate nella sezione dei requisiti del server nella documentazione ufficiale di Laravel. Seguire le istruzioni riportate nell'argomento Configurazione dell'ambiente di PHP sviluppo per Elastic Beanstalk per installare PHP e Composer.

Per informazioni sul supporto e sulla manutenzione di Laravel, vedere l'argomento relativo alle policy di supporto nella documentazione ufficiale di Laravel.

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.

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

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

Installazione di Laravel e creazione di un sito Web

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

~$ composer create-project --prefer-dist laravel/laravel eb-laravel

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

In caso di problemi durante l'installazione di Laravel, consulta l'argomento relativo all'installazione nella documentazione ufficiale: https://laravel.com/docs/6.x.

Distribuzione dell'applicazione

Crea un bundle di origine che contiene i file creati da Composer. Il comando seguente crea un bundle di origine denominato laravel-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-laravel$ zip ../laravel-default.zip -r * .[^.]* -x "vendor/*"

Carica il bundle di origine in Elastic Beanstalk per distribuire Laravel nell'ambiente.

Configurazione delle impostazioni di Composer

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

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

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

Fino qui, tutto bene. Nella fase successiva potrai aggiungere un database all'ambiente e configurare Laravel in modo che si connetta a esso.

Aggiunta di un database all'ambiente

Avvia un'istanza database RDS nel tuo ambiente Elastic Beanstalk. Puoi utilizzare i database MySQL, SQLServer o PostgreSQL con Laravel su Elastic Beanstalk. Per questo esempio, utilizziamo MySQL.

La creazione di un'istanza di database richiede circa 10 minuti. Per ulteriori informazioni sui database associati a un ambiente Elastic Beanstalk, consultare Aggiunta di un database all'ambiente Elastic Beanstalk.

Nel frattempo, è possibile aggiornare il codice sorgente per leggere le informazioni di connessione dall'ambiente. Elastic Beanstalk fornisce i dettagli di connessione tramite variabili di ambiente, ad esempio RDS_HOSTNAME, a cui puoi accedere dalla tua applicazione.

La configurazione del database Laravel è memorizzata in un file denominato database.php nella cartella config del tuo codice di progetto. Individua la voce mysql e modifica le variabili host, database, username e and password per leggere i valori corrispondenti da Elastic Beanstalk:

...
    'connections' => [

        'sqlite' => [
            'driver' => 'sqlite',
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
        ],

        'mysql' => [
            'driver' => 'mysql',
            'host' => env('RDS_HOSTNAME', '127.0.0.1'),
            'port' => env('RDS_PORT', '3306'),
            'database' => env('RDS_DB_NAME', 'forge'),
            'username' => env('RDS_USERNAME', 'forge'),
            'password' => env('RDS_PASSWORD', ''),
            'unix_socket' => env('DB_SOCKET', ''),
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
...

Per verificare che la connessione al database sia configurata correttamente, aggiungi il codice a index.php per connetterti al database e aggiungi un codice per la risposta predefinita:

...
if(DB::connection()->getDatabaseName())
{
   echo "Connected to database ".DB::connection()->getDatabaseName();
}
$response->send();
...

Quando l'istanza database ha terminato l'avvio, raggruppa e distribuisci l'applicazione aggiornata nel tuo ambiente.

La distribuzione di una nuova versione dell'applicazione richiede meno di un minuto. Al termine della distribuzione, aggiorna la pagina Web di nuovo per verificare che la connessione al database sia riuscita:

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.

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

Inoltre, puoi terminare le risorse di database create al di fuori dell'ambiente Elastic Beanstalk. Quando termini un'istanza database Amazon RDS, puoi acquisire uno snapshot e successivamente ripristinare i dati in un'altra istanza.

Passaggi successivi

Per ulteriori informazioni su Laravel, visita il sito Web ufficiale di Laravel su laravel.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.

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

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

L'esecuzione di un'istanza database Amazon RDS nell'ambiente Elastic Beanstalk è perfetta per le attività di sviluppo e test, ma vincola il ciclo di vita del database al tuo ambiente. Per istruzioni sulla connessione a un database in esecuzione al di fuori del tuo ambiente, consulta Aggiungere un'istanza Amazon RDS DB al tuo ambiente PHP Elastic Beanstalk.

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.