Men-deploy aplikasi Laravel ke Elastic Beanstalk

Laravel adalah kerangka kerja open source, model-view-controller (MVC) untuk PHP. Tutorial ini memandu Anda melalui proses menghasilkan aplikasi Laravel, menerapkannya ke AWS Elastic Beanstalk lingkungan, dan mengonfigurasinya untuk terhubung ke instance database Amazon Relational Database Service (Amazon RDS).

Prasyarat

Tutorial ini mengasumsikan Anda memiliki pengetahuan tentang operasi Elastic Beanstalk dasar dan konsol Elastic Beanstalk. Jika belum, ikuti petunjuk di Memulai dengan Elastic Beanstalk untuk meluncurkan lingkungan Elastic Beanstalk pertama Anda.

Untuk mengikuti prosedur di panduan ini, Anda memerlukan terminal atau shell baris perintah untuk menjalankan perintah. Perintah ditampilkan dalam daftar yang diawali dengan simbol prompt ($) dan nama direktori saat ini, bila perlu.

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

Di Linux dan macOS, Anda dapat menggunakan shell dan manajer paket pilihan Anda. Pada Windows Anda dapat menginstal Windows Subsystem untuk Linux untuk mendapatkan versi Windows terintegrasi dari Ubuntu dan Bash.

Laravel 6 membutuhkan PHP 7.2 atau yang lebih baru. Laravel 6 juga membutuhkan ekstensi PHP yang tercantum dalam topik persyaratan server dalam dokumentasi Laravel resmi. Ikuti petunjuk dalam topik Menyiapkan lingkungan PHP pengembangan Anda untuk Elastic Beanstalk untuk menginstal PHP dan Composer.

Untuk informasi dukungan dan pemeliharaan Laravel, lihat topik kebijakan dukungan pada dokumentasi Laravel resmi.

Meluncurkan lingkungan Elastic Beanstalk

Gunakan konsol Elastic Beanstalk untuk membuat lingkungan Elastic Beanstalk. Pilih platform PHP lalu terima pengaturan default dan kode sampel.

Pembuatan lingkungan membutuhkan waktu sekitar 5 menit dan membuat sumber daya berikut:

Semua sumber daya ini dikelola oleh Elastic Beanstalk. Ketika Anda mengakhiri lingkungan, Elastic Beanstalk mengakhiri semua sumber daya yang dimuatnya.

Menginstal Laravel dan menghasilkan sebuah situs web

Composer dapat menginstal Laravel dan membuat proyek kerja dengan satu perintah:

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

Komposer yang diinstal Laravel dan dependensinya, dan menghasilkan proyek default.

Jika Anda mengalami masalah apa pun saat menginstal Laravel, kunjungi topik instalasi dalam dokumentasi resmi: https://laravel.com/docs/6.x.

Men-deploy aplikasi Anda

Buat paket sumber berisi file yang dibuat oleh Composer. Perintah berikut membuat paket sumber yang bernama laravel-default.zip. Paket sumber tidak termasuk file dalam folder vendor, yang memerlukan banyak ruang dan tidak perlu men-deploy aplikasi Anda ke Elastic Beanstalk.

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

Mengunggah paket sumber ke Elastic Beanstalk untuk men-deploy Laravel ke lingkungan Anda.

Mengonfigurasi pengaturan Composer

Ketika deployment selesai, klik URL untuk membuka aplikasi Laravel Anda di peramban:

Apa ini? Secara default, Elastic Beanstalk menyajikan akar proyek Anda di jalur akar situs web. Dalam hal ini, meskipun, halaman default (index.php) tersebut berada di satu tingkat di bawah dalam folder public. Anda dapat memverifikasinya dengan menambahkan /public ke URL. Sebagai contoh, http://laravel.us-east-2.elasticbeanstalk.com/public.

Untuk menyajikan aplikasi Laravel di jalur akar, gunakan konsol Elastic Beanstalk untuk mengonfigurasikan akar dokumen untuk situs web.

Sejauh ini, baik-baik saja. Selanjutnya Anda akan menambahkan basis data ke lingkungan Anda dan mengonfigurasi Laravel agar terhubung ke sana.

Menambahkan basis data ke lingkungan Anda

Meluncurkan instans DB RDS di lingkungan Elastic Beanstalk Anda. Anda dapat menggunakan basis data MySQL, SQLServer, atau PostgreSQL dengan Laravel pada Elastic Beanstalk. Untuk contoh ini, kita akan menggunakan MySQL.

Membuat instans basis data membutuhkan waktu sekitar 10 menit. Untuk informasi lebih lanjut tentang database yang digabungkan ke lingkungan Elastic Beanstalk, lihat. Menambahkan basis data ke lingkungan Elastic Beanstalk Anda

Sementara itu, Anda dapat memperbarui kode sumber untuk membaca informasi koneksi dari lingkungan. Elastic Beanstalk menyediakan detail koneksi menggunakan variabel lingkungan, seperti RDS_HOSTNAME, yang dapat Anda akses dari aplikasi Anda.

Konfigurasi basis data Laravel disimpan dalam sebuah file bernama database.php dalam folder config pada kode proyek Anda. Temukan entri mysql dan modifikasi variabel host, database, username, and password untuk membaca nilai-nilai yang sesuai dari 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,
        ],
...

Untuk memverifikasi bahwa koneksi basis data dikonfigurasi dengan benar, tambahkan kode ke index.php untuk menghubungkan ke basis data dan menambahkan beberapa kode ke respons default:

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

Ketika instans DB telah menyelesaikan peluncuran, paketkan dan deploy aplikasi yang telah diperbarui ke lingkungan Anda.

Men-deploy versi baru dari aplikasi Anda membutuhkan waktu kurang dari satu menit. Ketika deployment selesai, refresh halaman web lagi untuk memverifikasi bahwa koneksi basis data berhasil:

Pembersihan

Jika Anda sudah selesai bekerja dengan Elastic Beanstalk, Anda dapat mengakhiri lingkungan Anda. Elastic Beanstalk AWS menghentikan semua sumber daya yang terkait dengan lingkungan Anda, seperti instans Amazon EC2, instans database, penyeimbangbeban, grup keamanan, dan alarm.

Dengan Elastic Beanstalk, Anda dengan mudah dapat membuat lingkungan baru untuk aplikasi Anda kapan saja.

Selain itu, Anda dapat mengakhiri sumber daya basis data yang Anda buat di luar lingkungan Elastic Beanstalk Anda. Ketika Anda mengakhiri instans DB Amazon RDS, Anda dapat mengambil snapshot dan memulihkan data ke instans lain kelak.

Langkah selanjutnya

Untuk informasi selengkapnya tentang Laravel, kunjungi situs web resmi Laravel di laravel.com.

Ketika aplikasi terus dikembangkan, Anda mungkin akan menginginkan sebuah cara untuk mengelola lingkungan dan men-deploy aplikasi Anda tanpa membuat file .zip secara manual dan mengunggahnya ke konsol Elastic Beanstalk. Elastic Beanstalk Command Line Interface (EB CLI easy-to-use ) menyediakan perintah untuk membuat, mengkonfigurasi, dan menyebarkan aplikasi ke lingkungan Elastic Beanstalk dari baris perintah.

Dalam tutorial ini, Anda menggunakan konsol Elastic Beanstalk untuk mengonfigurasi opsi komposer. Untuk membuat bagian konfigurasi ini dari sumber aplikasi Anda, Anda dapat menggunakan file konfigurasi seperti berikut.

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

Untuk informasi selengkapnya, lihat Penyesuaian lingkungan lanjutan dengan file konfigurasi (.ebextensions).

Menjalankan instans Amazon RDS DB dalam lingkungan Elastic Beanstalk Anda sangat bagus untuk pengembangan dan pengujian, tetapi mengikat siklus hidup basis data Anda ke lingkungan Anda. Lihat Menambahkan instans Amazon RDS DB ke lingkungan PHP Elastic Beanstalk Anda untuk petunjuk dalam menghubungkan ke basis data yang berjalan di luar lingkungan Anda.

Terakhir, jika Anda berencana menggunakan aplikasi dalam lingkungan produksi, Anda akan ingin mengonfigurasikan nama domain khusus untuk lingkungan Anda dan mengaktifkan HTTPS untuk koneksi yang aman.