Implantar uma aplicação Laravel no Elastic Beanstalk

O Laravel é uma framework de controlador de visualização de modelo (MVC) de código aberto para PHP. Este tutorial fornece orientações detalhadas sobre o processo para gerar uma aplicação Laravel, implantá-la em um ambiente do AWS Elastic Beanstalk e configurá-la para conexão com uma instância de banco de dados do Amazon Relational Database Service (Amazon RDS).

Pré-requisitos

Este tutorial pressupõe que você tenha conhecimento das operações básicas e do console do Elastic Beanstalk. Caso ainda não tenha, siga as instruções em Introdução ao Elastic Beanstalk para iniciar seu primeiro ambiente do Elastic Beanstalk.

Para seguir os procedimentos neste manual, você precisa de um terminal de linha de comando ou de um shell para executar os comandos. Nas listagens, os comandos são mostrados precedidos por um símbolo de prompt ($) e pelo nome do diretório atual, quando apropriado.

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

No Linux e no macOS, você pode usar seu gerenciador de pacotes e de shell preferido. No Windows, você pode instalar o subsistema Windows para Linux para obter uma versão do Ubuntu e Bash integrada ao Windows.

O Laravel 6 requer PHP 7.2 ou posterior. Ele também requer as extensões PHP listadas no tópico requisitos do servidor na documentação oficial do Laravel. Siga as instruções do tópico Configurar seu ambiente de desenvolvimento PHP para o Elastic Beanstalk para instalar o PHP e o Composer.

Para obter informações sobre suporte e manutenção do Laravel, consulte o tópico política de suporte na documentação oficial do Laravel.

Iniciar um ambiente do Elastic Beanstalk

Use o console do Elastic Beanstalk para criar um ambiente do Elastic Beanstalk. Escolha a configuração da Plataforma PHP e aceite as configurações padrão e código de exemplo.

A criação de ambiente leva cerca de 5 minutos e cria os seguintes recursos:

Todos esses recursos são gerenciados pelo Elastic Beanstalk. Quando você encerra o ambiente, o Elastic Beanstalk encerra todos os recursos dele.

Instalar o Laravel e gerar um site

O Composer pode instalar o Laravel e criar um projeto de trabalho com um comando:

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

O Composer instala o Laravel e suas dependências, e gera um projeto padrão.

Se tiver problemas com a instalação do Laravel, consulte o tópico sobre instalação na documentação oficial: https://laravel.com/docs/6.x

Implantar o aplicativo

Crie um pacote de origem com os arquivos criados pelo Composer. O comando a seguir cria um pacote de origem chamado laravel-default.zip. Ele exclui arquivos na pasta vendor, que tomam muito espaço e não são necessários para implantação da aplicação no Elastic Beanstalk.

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

Faça upload do pacote de origem para o Elastic Beanstalk para implantar o Laravel no ambiente.

Definir as configurações do Composer

Quando a implantação for concluída, clique no URL para abrir o aplicativo Laravel no navegador:

O que é isso? Por padrão, o Elastic Beanstalk fornece a raiz do seu projeto no caminho raiz do site. Neste caso, contudo, a página padrão (index.php) está em um nível abaixo na pasta public. Você pode verificar isso adicionando /public ao URL. Por exemplo, http://laravel.us-east-2.elasticbeanstalk.com/public.

Para fornecer a aplicação Laravel no caminho raiz, use o console do Elastic Beanstalk para configurar a raiz do documento para o site.

Até agora, tudo tranquilo. Em seguida, adicione um banco de dados ao ambiente e configure o Laravel para se conectar a ele.

Adicionar um banco de dados ao seu ambiente

Execute uma instância de banco de dados do RDS no ambiente do Elastic Beanstalk. Você pode usar bancos de dados MySQL, SQLServer ou PostgreSQL com o Laravel no Elastic Beanstalk. Neste exemplo, usaremos MySQL.

A criação de uma instância de banco de dados leva cerca de 10 minutos. Para obter mais informações sobre bancos de dados acoplados a um ambiente do Elastic Beanstalk, consulte Adição de um banco de dados ao seu ambiente do Elastic Beanstalk.

Enquanto isso, atualize o código-fonte para ler as informações de conexão do ambiente. O Elastic Beanstalk fornece detalhes de conexão usando variáveis de ambiente, como RDS_HOSTNAME, que você pode acessar na aplicação.

A configuração de banco de dados do Laravel é armazenada em um arquivo chamado database.php na pasta config no código do projeto. Encontre a entrada mysql e modifique as variáveis de host, database, username, and password para ler os valores correspondentes do 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,
        ],
...

Para verificar se a conexão de banco de dados está configurada corretamente, adicione código a index.php para conectar ao banco de dados e adicionar código à resposta padrão:

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

Quando a instância de banco de dados tiver iniciado, empacote e implante o aplicativo atualizado em seu ambiente.

Implantar uma nova versão do seu aplicativo leva menos de um minuto. Quando a implantação for concluída, atualize a página da web novamente para verificar se a conexão com o banco de dados foi bem-sucedida:

Limpeza

Ao terminar de trabalhar com o Elastic Beanstalk, você pode encerrar o ambiente. O Elastic Beanstalk termina todos os recursos da AWS associados ao seu ambiente, como instâncias do Amazon EC2, instâncias de banco de dados, balanceadores de carga, grupos de segurança e alarmes.

Com o Elastic Beanstalk, é possível criar facilmente um ambiente para a aplicação a qualquer momento.

Além disso, é possível encerrar recursos do banco de dados que você criou fora do ambiente do Elastic Beanstalk. Ao encerrar uma instância de banco de dados do Amazon RDS, você poderá criar um snapshot e restaurar os dados em outra instância posteriormente.

Próximas etapas

Para obter mais informações sobre o Laravel, acesse o site oficial do Laravel em laravel.com.

À medida que você desenvolva a aplicação, provavelmente vai precisar de uma maneira de gerenciar ambientes e implantá-la sem criar manualmente um arquivo .zip e carregá-la no console do Elastic Beanstalk. A Interface de Linhas de Comando do Elastic Beanstalk (CLI do EB) oferece comandos fáceis de usar para criar, configurar e implantar aplicações em ambientes do Elastic Beanstalk na linha de comando.

Neste tutorial, você usou o console do Elastic Beanstalk para configurar as opções do Composer. Para tornar essa configuração parte de origem do aplicativo, você pode usar um arquivo de configuração, como o seguinte.

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

Para ter mais informações, consulte Personalização avançada de ambiente com arquivos de configuração (.ebextensions).

A execução de uma instância de banco de dados do Amazon RDS no ambiente do Elastic Beanstalk é ideal para desenvolvimento e teste, mas vincula o ciclo de vida do banco de dados ao ambiente. Para obter instruções sobre como se conectar a um banco de dados em execução fora de seu ambiente, consulte Adicionar uma instância de banco de dados do Amazon RDS ao seu ambiente PHP Elastic Beanstalk.

Por fim, se você planeja usar seu aplicativo em um ambiente de produção, configure um nome de domínio personalizado para seu ambiente e habilite HTTPS para conexões seguras.