Distribuzione di un'applicazione Laravel su Elastic Beanstalk

Laravel è un framework open source, () per. model-view-controller MVC 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 (RDSAmazon).

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 7.2 o versione successiva. PHP Richiede anche le PHP estensioni elencate nell'argomento dei requisiti del server nella documentazione ufficiale di Laravel. Segui le istruzioni 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 PHPpiattaforma 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.

Se riscontri problemi durante l'installazione di Laravel, vai all'argomento di installazione nella documentazione ufficiale: 6.x. https://laravel.com/docs/

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 su URL per aprire l'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 verificarlo aggiungendo /public a. 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 RDS DB nel tuo ambiente Elastic Beanstalk. Puoi usare i SQL database My SQL o Postgree con Laravel su Elastic Beanstalk. SQLServer Per questo esempio, useremo My. SQL

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 EC2 Amazon, istanze di database, sistemi di bilanciamento del 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 interrompi un'istanza Amazon RDS DB, puoi scattare uno snapshot e ripristinare i dati su un'altra istanza in un secondo momento.

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 CLI (EB 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, consulta Personalizzazione avanzata dell'ambiente con i file di configurazione (.ebextensions).

L'esecuzione di un'istanza Amazon RDS DB nel tuo ambiente Elastic Beanstalk è ottima per lo sviluppo e i test, ma lega il ciclo di vita del database all'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 utilizzare la tua applicazione in un ambiente di produzione, ti consigliamo di configurare un nome di dominio personalizzato per il tuo ambiente e abilitare connessioni sicure. HTTPS