1. サーバーに接続します
SSH を使用してサーバーに接続します。
ssh root@<server-ip>
2. ログイン認証情報にアクセスする
アプリケーションを管理するために、fastapi という名前の専用ユーザーが作成されました。
ログイン資格情報は次のファイルにあります。 /root/.fastapi-creds
それらを表示するには、次を実行します。
cat /root/.fastapi-creds
パスワードを変更したい場合は、次を使用します。
passwd fastapi
3. アプリユーザーに切り替えます
fastapi ユーザー アカウントに切り替えて、アプリを管理します。
su - flask
このアカウントには、FastAPI プロジェクトと環境が含まれています。
4. プロジェクトの構造
デフォルトのディレクトリレイアウトは次のとおりです。
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. アプリケーションの管理
アプリケーション ディレクトリに移動します。
cd ~/fastapi_app
仮想環境をアクティブ化します。
source venv/bin/activate
メインアプリファイルを編集します。
nano main.py
FastAPI サービスを再起動して、変更を適用します。
sudo systemctl restart uvicorn-fastapi
6. ログの表示
次のようにして、Uvicorn と Nginx のログを確認できます。
- ユビコーンのログ:
/var/log/uvicorn/ - Nginxエラーログ:
/var/log/nginx/error.log - Nginxのアクセスログ：
/var/log/nginx/access.log
それらを表示するには:
sudo tail -f /var/log/uvicorn/*
7. API へのアクセス
サービスが実行されると、FastAPI アプリはブラウザーで次の場所から利用できるようになります。 http://<server-ip>
Nginx は、FastAPI アプリを実行している Uvicorn ソケットに HTTP リクエストを自動的に転送します。
8. ドメインまたはポートの変更
サーバー名、ポート、またはドメインを更新する場合は、次の手順を実行します。
- Nginx サイト構成を編集します。
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - テスト構成:
sudo nginx -t - Nginx をリロードします。
sudo systemctl restart nginx
9. ユビコーンサービス
FastAPI アプリは、uvicorn-fastapi という名前の systemd サービス経由で実行されます。
使用します /home/fastapi/fastapi_app/main:app アプリケーションのエントリ ポイントとして機能し、障害が発生した場合は自動的に再起動します。
サービスを管理するには:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
サービスを編集するには:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. HTTPS を有効にする (オプション)
Certbot を使用して HTTPS を有効にします。
