face_mosaic_app

アップロードした写真に人の顔があればモザイクをかける Web アプリです。

使い方

1. 依存ライブラリをインストールします。

   pip install -r requirements.txt

   uv を利用する場合は次のように仮想環境を作成してインストールできます。

   uv venv .venv
   source .venv/bin/activate
   uv pip install -r requirements.txt

2. アプリを起動します。

   python app.py

   ポート 5000 が使用中の場合は環境変数 PORT で別のポート番号を指定できます。 例: PORT=8000 python app.py
3. ブラウザで http://localhost:5000 (別ポートを指定した場合はその番号) を開き、画像をアップロードすると、顔部分にモザイクがかかった画像が表示されます。

ファイル構成

• app.py : Flask アプリ本体
• templates/index.html : アップロードフォーム
• requirements.txt : 必要な Python パッケージ

Terraform でのデプロイ例

AWS 上に EC2 インスタンスを作成してアプリを公開するシンプルなサンプルを terraform ディレクトリに用意しています。以下のように実行します。

cd terraform
terraform init
terraform apply

ami_id や key_name などの変数は -var オプションや terraform.tfvars ファイルで指定してください。適用後、出力される instance_public_ip にブラウザ からアクセスすることでアプリを確認できます。

AWS での利用手順

1. AWS アカウントを作成し、IAM ユーザー を用意します。アクセスキーを取得したら aws configure でクレデンシャルを設定します。
2. EC2 用のキーペアを マネジメントコンソール から作成し、terraform.tfvars に key_name を設定します。キーファイル (.pem) は SSH 接続で必要になるので安全に保管してください。
3. デプロイするリージョンや AMI ID を terraform.tfvars で指定します。Ubuntu の AMI は AWS マーケットプレイス などで検索できます。
4. GitHub からアプリを取得するため repo_url 変数を設定します。自身のフォークを利用する場合は https://github.com/<ユーザー名>/face_mosaic_app の形式で指定してください。
5. 変数を用意したら次を実行します。

   cd terraform
   terraform init
   terraform apply

6. 数分待つと EC2 インスタンスが起動し、instance_public_ip が表示されます。ブラウザで http://<表示されたIP>:<port> を開くとアプリにアクセスできます。
7. 必要に応じて次のコマンドで SSH 接続も行えます。

   ssh -i <作成したpemファイル> ubuntu@<instance_public_ip>