| name | github-pages-deploy |
| description | WebGL ビルド成果物を StatiCrypt で暗号化し、GitHub Pages にデプロイする。「デプロイ」「GitHub Pages」「公開して」「アップロード」といったリクエスト時に使用。パスワードは Build/ 内で管理し、リポジトリ作成からプッシュまでを自動化する。 |
GitHub Pages Deploy
WebGL ビルド成果物を StatiCrypt でパスワード保護し、GitHub Pages に公開する。
前提条件
Build/WebGL/ にビルド成果物が存在すること（unity-webgl-builder スキルで生成）gh CLI がインストール・認証済みであること
ワークフロー
Step 1: リポジトリ名の確認
Build/deploy/ 内に既存のデプロイフォルダ（git リポジトリ）があるか確認する。
- 既存フォルダがある場合 → そのフォルダ名をリポジトリ名として自動採用し、ユーザーへの確認はスキップする
- 既存フォルダがない場合 → プロジェクトのフォルダ名をリポジトリ名として提案し、ユーザーに確認する
公開 URL: https://<ユーザー名>.github.io/<リポジトリ名>/
Step 2: パスワード管理
Build/deploy/.staticrypt.json を確認する。
- 存在する → 前回と同じパスワードで暗号化（StatiCrypt が自動管理）
- 存在しない → 16文字の英数字パスワードを自動生成（大文字・小文字・数字混在）
Step 3: リポジトリ作成・ファイルコピー
gh repo create <ユーザー名>/<リポジトリ名> --public でリポジトリ作成（既存ならスキップ）Build/deploy/<リポジトリ名>/ にクローン（既存ならプル）Build/WebGL/ の中身をデプロイディレクトリにコピー- assets/deploy.yml を
.github/workflows/deploy.yml としてコピー
Step 4: StatiCrypt で暗号化（デプロイディレクトリ内で実行）
重要: Build/WebGL/ 内では暗号化しない。必ずデプロイディレクトリ内で実行すること。Build/WebGL/ を汚すと次回の Unity ビルドで index.html が上書きされず競合する。
cd Build/deploy/<リポジトリ名> && npx staticrypt index.html -p "<パスワード>" --short
暗号化後、encrypted/index.html → index.html に置き換える。
.staticrypt.json は Build/deploy/ に保存して次回のパスワード再利用に備える:
cp Build/deploy/<リポジトリ名>/.staticrypt.json Build/deploy/.staticrypt.json
- GitHub Pages を workflow モード で有効化する:
gh api repos/<ユーザー名>/<リポジトリ名>/pages -X POST --input - <<'EOF'
{"build_type":"workflow","source":{"branch":"main","path":"/"}}
EOF
既に Pages が有効な場合は -X PUT で更新する。
- コミット・プッシュする
- ワークフロー完了を確認する:
gh api repos/<ユーザー名>/<リポジトリ名>/actions/runs --jq '.workflow_runs[0] | {status, conclusion}'
conclusion: "success" になるまで待つ（通常 30-60 秒）。
重要: build_type: "legacy" は使わない。デプロイが発動しない場合がある。必ず build_type: "workflow" + GitHub Actions ワークフローを使う。
Step 6: 結果の報告
公開 URL とパスワードをユーザーに伝える。
トラブルシューティング
| 症状 | 原因 | 対処 |
|---|
| 404 "There isn't a GitHub Pages site here" | build_type: "legacy" を使っている | build_type: "workflow" に切り替え、deploy.yml を追加して再プッシュ |
ワークフローが queued のまま | Pages の environment 未設定 | gh api repos/.../pages で Pages 有効か確認。無効なら再作成 |
ワークフローが failure | permissions 不足 or Pages 未有効化 | YAML に pages: write, id-token: write があるか確認。Settings → Pages で source が "GitHub Actions" か確認 |
| パスワード画面が出ない | 暗号化前の index.html がプッシュされた | encrypted/index.html → index.html 置き換えを確認し再プッシュ |
