AWS LightsailでFlaskアプリをデプロイする

Last updated at 2024-12-16Posted at 2024-12-14

はじめに

AWS Lightsailというサービスに触れる機会があったため、ハンズオン形式でデプロイ手順を記事にまとめました。
比較的簡単な手順ですが、備忘録として記録し、これから同様の環境構築を行う方の参考になれば幸いです。

最終目標

Lightsailを使ってFlaskアプリをデプロイすること。

この記事でやること

AWS Lightsailの設定
Flaskアプリのデプロイ

LET'S START

前提条件

AWSアカウントが作成済みで、コンソールにログインできる状態
Flaskアプリが作成済み（筆者はGitHubでリポジトリを管理しています）
ドメインを取得済み（任意、なくても問題ありません）

1. Lightsailインスタンスの作成

AWS Management Consoleにログインし、Lightsailサービスに移動
「インスタンスの作成」をクリック
設計図（blueprint）の選択→「OSのみ」を選択
OS→「Amazon Linux 2023」を選択
ネットワークタイプを選択→「デュアルスタック」を選択
サイズを選択→「$5」を選択（適宜変更可能）
Lightsailのインスタンス名を入力
インスタンスの作成をクリック

2. 静的IPの作成（任意）

Lightsailインスタンスは、デフォルトでは再起動時にIPアドレスが変わる仕様です。ドメインを使用する場合や安定した接続が必要な場合には、静的IPの作成をお勧めします。
また、DNSの反映時間を考慮すると、インスタンスを作成して真っ先に静的IPを作成しインスタンスにアタッチする方が効率が良いです。

左側のナビゲーションペインで、「ネットワーキング」を選択
「静的IPの作成」をクリック
静的IPを作成するリージョンを選択
作成したインスタンスに静的IPをアタッチ
静的IPの名前を入力
「Create(作成)」をクリック

以降はドメインを取得している場合のみ必要な手順です。

ドメインのDNS設定を開く
管理しているドメインの一覧から該当のドメインを選択
「DNSレコード設定」画面でAレコードを設定
- ホスト名: 空欄または@（ルートドメインの場合）
- 値: Lightsailで作成した静的IP（例: 123.45.67.89）
- TTL: 標準設定（通常3600秒）を使用
サブドメインの設定（必要に応じて）
サブドメイン（例: www.example.com）もLightsailに関連付ける場合、サブドメイン用に別のAレコードを追加する。

3. インスタンスへのSSH接続

LightsailのブラウザベースSSHクライアントを使用します。

Lightsailダッシュボードで作成したインスタンスをクリック
「接続」タブを選択し、ブラウザベースのSSHクライアントを起動

4. Flaskなどのパッケージのインストール

システムパッケージの更新
```
sudo yum update -y
```
Pythonとpipのインストール
Amazon Linux 2023にはデフォルトでPython3がインストールされていますが、バージョンを確認し、pipをインストールします。
```
sudo yum install -y python3
sudo yum install -y python3-pip
```
Gitのインストール
```
sudo yum install -y git
```

5. GitHubへのSSH接続

SSHキーを作成
```
mkdir ~/.ssh
cd ~/.ssh
ssh-keygen -t rsa
```
→ Enterキーを3回押してパスフレーズをスキップ。
公開鍵を確認
```
cat id_rsa.pub
```
GitHubでSSHキーを登録
1. GitHubにログインし、左上のアカウントのアイコンから「Settings」をクリック
2. 画面右端のサイドメニューから「SSH and GPG keys」をクリック
3. 「New SSH key」をクリック
4. 表示されたAdd new SSH Keyのタブから「Title」と「Key」を入力し「Add SSH key」をクリック
GitHub疎通確認
```
ssh -T git@github.com
```

6. Flaskアプリの配置・パッケージのインストール

アプリを配置する場所に移動
```
cd ~
```

リポジトリをクローン

git clone git@github.com:Ymmy833y/flask-sample.git # 適宜修正してください
cd flask-sample # 適宜修正してください

以降は各環境によって異なります。

筆者は仮想環境を使って依存関係を管理していたので、venv作成→依存関係のインストールを行います。

仮想環境の作成・起動

python3 -m venv venv
source venv/bin/activate

依存関係のインストール
```
pip install -r requirements.txt
```

注意事項
この後、Flaskアプリをプロダクション環境で稼働させるにあたり、Gunicornを使用します。
Gunicornが依存関係に含まれていない場合、下記コマンドを用いてGunicornをインストールしてください。

pip3 install gunicorn

7. GunicornとSystemdの設定

GNU nanoを使用してサービスファイルを作成

sudo nano /etc/systemd/system/flask-sample.service # ファイル名は適宜修正してください

下記内容を記述（Description、WorkingDirectory、ExecStart については適宜修正してください）

[Unit]
Description=Gunicorn instance to serve Flask app (flask-sample)
After=network.target

[Service]
User=ec2-user
Group=ec2-user
WorkingDirectory=/home/ec2-user/flask-sample
ExecStart=/bin/bash -c 'source /home/ec2-user/flask-sample/venv/bin/activate && exec gunicorn -w 3 -b 0.0.0.0:5000 run:app'

[Install]
WantedBy=multi-user.target

サービスを有効化して起動

sudo systemctl daemon-reload
sudo systemctl enable flask-sample
sudo systemctl start flask-sample

サービスのステータス確認
```
sudo systemctl status Flask-sample
```
Active (running)と表示されていれば成功です

8. Nginxの設定

Nginxを使用してFlaskアプリをリバースプロキシとして設定します。

GNU nanoを使用してNginxの設定ファイルを作成
```
sudo nano /etc/nginx/conf.d/flask-sample.conf
```

下記内容を記述（server_name、root については適宜修正してください）

server {
    listen 80;
    server_name your-domain.jp www.your-domain.jp;

    # Flaskアプリケーションの静的ファイルのルートディレクトリ
    root /home/ec2-user/flask-sample;

    location / {
        proxy_pass http://127.0.0.1:5000;  # Flaskアプリケーションが動作するポート
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_buffer_size 128k;
        proxy_buffers 4 256k;
        proxy_busy_buffers_size 256k;
    }
}

設定の適用
設定ファイルを保存後、Nginxの設定をテストして適用します
```
sudo nginx -t
sudo systemctl reload nginx
```

9. 動作確認

静的IPまたはドメインでアプリにアクセス
DNS設定が反映されているか確認するには、WhatsMyDNS を使用

さいごに

SSL証明書の設定についても触れたかったのですが、ボリューミーになるため今回は割愛します。なお、設定する際は Let's Encrypt を使用する方法をおすすめします。

この記事がAWS LightsailでのFlaskアプリのデプロイに役立てば幸いです。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up