Newer
Older
PixelPaintWar / docs / 02_ENV / ENV_09_Renderデプロイ手順.txt
========================================================================
Render デプロイ手順 (Render Deployment Guide)
========================================================================

1. 概要 (Overview)
------------------------------------------------------------------------

1-1. 目的
    本ドキュメントは,Pixel Paint War を Render にデプロイする手順を記す.
    環境変数の詳細については ENV_08_環境変数設定.txt を参照すること.

1-2. 構成
    Render 上で以下の2サービスを運用する.

    ・client サービス: Vite でビルドした静的ファイルを配信
    ・server サービス: Node.js バックエンドを動作させる Web Service


2. 環境変数の設定 (Environment Variables)
------------------------------------------------------------------------

2-1. client サービスへの設定
    VITE_PROD_SERVER_URL はビルド時に埋め込まれるため,
    server サービスではなく client サービス側で設定すること.

    1. Render ダッシュボードで client サービスを開く
    2. 「Environment」タブを開く
    3. 以下の環境変数を追加する
        Key: VITE_PROD_SERVER_URL
        Value: https://<your-server-domain>
    4. 保存後に「Manual Deploy」または自動デプロイで再ビルドする

    ※ 値を変更した場合は必ず再デプロイ(再ビルド)すること


3. デプロイ手順 (Deployment Steps)
------------------------------------------------------------------------

3-1. server サービスの設定
    1. Render ダッシュボードで「New +」→「Web Service」を選択する
    2. リポジトリを接続する
    3. 以下の設定を行う
        ・Environment: Node
        ・Build Command: pnpm --filter @repo/shared build && pnpm --filter server build
        ・Start Command: node apps/server/dist/index.js
    4. 「Create Web Service」で作成する

3-2. client サービスの設定
    1. Render ダッシュボードで「New +」→「Static Site」を選択する
    2. リポジトリを接続する
    3. 以下の設定を行う
        ・Build Command: pnpm --filter @repo/shared build && pnpm --filter client build
        ・Publish Directory: apps/client/dist
    4. 2章の手順で環境変数 VITE_PROD_SERVER_URL を設定する
    5. 「Create Static Site」で作成する

3-3. 動作確認
    1. server サービスのログで起動エラーがないことを確認する
    2. client サービスの URL にブラウザからアクセスしてゲーム画面を確認する


4. 再デプロイ手順 (Redeployment)
------------------------------------------------------------------------

4-1. コード変更時
    main ブランチへのマージを契機に自動デプロイが走る(Auto-Deploy 有効時).
    手動で行う場合は各サービスの「Manual Deploy」ボタンを押す.

4-2. 環境変数変更時
    client サービスの環境変数を変更した場合は,
    変更後に必ず再デプロイ(再ビルド)を実施すること.