目的
今回は、AWSを使ってEC2インスタンスにLaravelアプリをデプロイしていきます。
AMIはAmazon Linux 2023を使っています。
構築自体は済んでいるので、ssh接続して作業していきます。
各種詳細は末尾の参考ドキュメントを参照願います。
EC2インスタンスにインストールするもの
- nginx/1.26.2
- PHP 8.3.10 (cli) (built: Jul 30 2024 13:44:37) (NTS gcc x86_64)
- Ver 8.4.3 for Linux on x86_64 (MySQL Community Server - GPL)
- Git
EC2インスタンスへのインストール
Nginx1.26
ec2-user@AL2023
# パッケージを更新
sudo dnf upgrade
# Nginxをインストールして、バージョンを確認
sudo dnf install nginx
nginx -v
# 起動
sudo systemctl start nginx
# 起動状態の確認
systemctl status nginx
# 自動起動の設定
sudo systemctl enable nginx
Nginxの初期設定
Nginxで受けたHTTPリクエストをLaravelに伝えるための設定を行なっていきます。
ポイント
Laravelのルーティングは、すべてのリクエストをindex.phpで受け取ります。
また、受け取る際、NginxはFastCGIサーバ（php-fpm）にリクエストを転送します。
sudo vim /etc/nginx/nginx.conf
/etc/nginx/nginx.conf
server {
listen 80;
listen [::]:80;
server_name _;
- root /usr/share/nginx/html;
+ # Laravelのpublic/index.phpが応答するよう設定
+ root /var/www/[後にGitHubからクローンするプロジェクト名]/public;
+
+ # クリックジャッキング対策（HTTPレスポンスの際、他のサイトではフレーム内への埋め込みを許可しない）
+ add_header X-Frame-Options "SAMEORIGIN";
+ # ブラウザがサーバ指定のMIMEタイプを厳密に守るよう指定（スニッフィングの禁止）
+ add_header X-Content-Type-Options "nosniff";
+
+ # スラッシュで終わっているリクエストが来た際、処理するファイルを定義する
+ index index.php;
+ charset utf-8;
+
+ # / 以下のリクエスト全てを判定する（例：/about/indexなど）
+ location / {
+ # 該当するファイル、ディレクトリが静的資材として存在しなければ、index.phpにリクエストを転送
+ try_files $uri $uri/ /index.php?$query_string;
+ }
+
+ location = /favicon.ico { access_log off; log_not_found off; }
+ location = /robots.txt { access_log off; log_not_found off; }
+
- error_page 404 /404.html;
+ error_page 404 /index.php;
- location = /404.html {
- }
- error_page 500 502 503 504 /50x.html;
- location = /50x.html {
- }
+
+ location ~ \.php$ {
+ # php-fpmのソケットファイルの場所を定義する（環境によって異なるため後述します）
+ fastcgi_pass unix:/var/run/php-fpm/www.sock;
+ fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+ include fastcgi_params;
+ fastcgi_hide_header X-Powered-By;
+ }
+
+ location ~ /\.(?!well-known).* {
+ deny all;
+ }
}
一口メモ
php-fpmのソケットファイルの場所は、環境によって異なります。
Ubuntuなどでは/var/run/php/となりますが、Amazon Linuxでは/var/run/php-fpm/となります。
以下のコマンドでソケットファイルの場所を確認できますので、ご自身の環境に合った定義を行います。
sudo cat /etc/php-fpm.d/www.conf | grep listen
ec2-user@AL2023
# 設定が正しいかテストし、反映する
sudo nginx -t
sudo systemctl reload nginx
PHP8.3
ec2-user@AL2023
# インストールできるパッケージ名を検索
dnf search php
# PHP8.3をインストールして、バージョンを確認
sudo dnf install php8.3.x86_64
php -v
php-fpm -v
PHPの初期設定
NginxからUnixソケット通信の送受信設定を行なっていきます。
sudo vim /etc/php-fpm.d/www.conf
/etc/php-fpm.d/www.conf
- user = apache
+ user = nginx
- group = apache
+ group = nginx
+ ;ソケットファイルのパーミッションを設定
+ listen.owner = nginx
+ listen.group = nginx
+ listen.mode = 0660
ec2-user@AL2023
# 設定を反映
sudo systemctl restart php-fpm.service
MySQL8.4
ec2-user@AL2023
# MySQL公式リポジトリのインストール
sudo dnf install https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm
# リポジトリが正常に追加されたことを確認
dnf repolist enabled | grep mysql.*-community
# MySQLサーバとクライアントをインストールして、バージョンを確認
sudo dnf install mysql-community-server
mysqld --version
# MySQLドライバのインストール
sudo dnf install php-pdo php-mysqlnd
sudo systemctl restart php-fpm
# MySQLサーバの起動
sudo systemctl start mysqld
# 起動状態の確認
systemctl status mysqld
MySQLの初期設定
MySQLサーバ初回起動時にスーパーユーザroot@localhostが作成されるため、初期パスワードを変更します。
ec2-user@AL2023
# 設定された初期パスワードを確認
sudo grep 'temporary password' /var/log/mysqld.log
# MySQLサーバに接続(上記で確認した初期パスワードを入れます)
mysql -uroot -p
# 初期パスワードを変更
mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY '[変更後パスワード]';
パスワード設定時にバリデーションが効いています！
- 8文字以上であること
- 大文字、小文字、数字、記号が1文字以上含まれていること
データベース作成
ec2-user@AL2023
mysql -u root -p
mysql> create database MyLaravelDB;
mysql> show databases;
GitHubからLaravelアプリをClone
サーバの設定が済んだので、LaravelアプリをCloneしていきます。
ec2-user@AL2023
sudo dnf install git
# SSHキーを生成する
ssh-keygen -t ed25519 -C "your_email@example.com"
# ssh-agentを開始する
eval "$(ssh-agent -s)"
# SSHキーをssh-agentに追加する
ssh-add ~/.ssh/id_ed25519
# SSHキーをクリップボードにコピーする
cat ~/.ssh/id_ed25519.pub
GitHubにSSHキーを登録
- GitHubにログインし、自分のプロフィール画像をクリック > Settingsを開く
- 左のツリーから SSH and GPG keysを開く
- New SSH keyボタンをクリック
- Titleを入力 > Authentication Keyを選択 > Keyにコピーした公開鍵を貼り付ける
- Add SSH keyボタンをクリック
git clone
ec2-user@AL2023
# SSH接続を確認
ssh -T git@github.com
# (成功)Hi username! You've successfully authenticated, but GitHub does not provide shell access.
# ディレクトリの所有者を変更してからクローンする（/var/www/はrootが所有者になっているため）
# sudoを付ければ解決かと思ったが、実行するユーザがrootに切り替わるため、SSHキーが/root/.sshに未保存のため失敗する
cd /var/www/
sudo chown -R ec2-user:ec2-user /var/www
git clone git@github.com:*********/*********.git
# Nginxに、storageとbootstrap/cacheディレクトリに書き込み権限を付与
sudo chown -R nginx:nginx /var/www/[プロジェクト名]/storage /var/www/[プロジェクト名]/bootstrap/cache
sudo chmod -R 775 /var/www/[プロジェクト名]/storage /var/www/[プロジェクト名]/bootstrap/cache
.envファイルを作成してDB設定を行う
ec2-user@AL2023
cd [プロジェクトディレクトリ]
# .env.exampleをコピーして.envを作成
cp .env.example .env
vim .env
.env
- APP_URL=http://localhost
+ APP_URL=http://[EC2インスタンスのオープンIPアドレス]
- DB_CONNECTION=sqlite
+ DB_CONNECTION=mysql
+ DB_HOST=127.0.0.1
+ DB_PORT=3306
+ DB_DATABASE=[MySQLで作成のDB]
+ DB_USERNAME=root
+ DB_PASSWORD=[rootのパスワード]
Composerのインストール
ComposerのインストールはComposerのインストールを参照ください。
ec2-user@AL2023
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
# パスを通す
sudo mv composer.phar /usr/local/bin/composer
# Composerで依存関係をインストールする
composer install
APP_KEYの自動生成とDBマイグレーション
ec2-user@AL2023
php artisan key:generate
php artisan migrate
最後に
ブラウザで、EC2インスタンスのオープンIPアドレスに接続して、アプリが動作する確認を行います。
http://[EC2インスタンスのオープンIPアドレス]
エラーが出たらキャッシュをクリアしてみましょう
cd /var/www/[プロジェクト名]
php artisan config:clear
php artisan cache:clear
php artisan view:clear