mai
/
ponshu-room-lite
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 31 Wiki Activity
ponshu-room-lite/docs/GITEA_SETUP_GUIDE.md

6.4 KiB
Raw Blame History

Gitea API トークン設定ガイド

作成日: 2026-02-23 対象: Ponshu Room APK自動配布システム

🎯 目的

Gitea APIトークンを発行し、APKビルド後に自動でGiteaリリースを作成する仕組みを構築する。

📋 設定手順

Step 1: Gitea設定画面を開く

  1. ブラウザで http://100.76.7.3:3000 にアクセス
  2. ログイン (maita)
  3. 右上のアイコンをクリック → 「設定」
  4. 左サイドバーから 「アプリケーション」 をクリック

Step 2: 新しいトークンを生成

アクセストークンの管理 セクションで:

1. トークン名を入力

トークン名: ponshu-deploy

理由:

  • 既存の cursor-deploy とは別に管理
  • 日本酒アプリ専用のトークン
  • セキュリティの原則: 最小権限

2. リポジトリと組織へのアクセス

● すべて（公開、プライベート、限定）

選択理由:

  • ponshu_room_lite リポジトリにアクセスするため
  • 今後、プライベートリポジトリに変更する可能性があるため

3. 許可の選択

「▶ 許可の選択」をクリックして展開

以下の権限のみを有効化:

カテゴリ 権限 理由
repository 読み取り・書き込み ✅ リリース作成・APKアップロードに必須
issue なし ❌ 不要
package なし ❌ 不要
organization なし ❌ 不要
notification なし ❌ 不要
user なし ❌ 不要
misc なし ❌ 不要

セキュリティ上の理由:

  • repository: 書き込み だけで、以下が可能:
    • リリースの作成
    • APKファイルのアップロード
    • リリースノートの編集
  • 他の権限は不要 → 最小権限の原則

Step 3: トークンを生成してコピー

  1. 「トークンを生成」ボタンをクリック

  2. 画面に表示されるトークンをコピー

    例: gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 重要:

  • このトークンは一度しか表示されません
  • 必ずコピーしてください
  • 紛失した場合は、トークンを削除して再発行が必要

Step 4: トークンを .env に保存

  1. プロジェクトルートの .env ファイルを開く

    C:\Users\maita\posimai-project\ponshu_room_lite\.env

  2. GITEA_TOKEN の値を、コピーしたトークンに置き換える

    # 変更前
GITEA_TOKEN=YOUR_GITEA_TOKEN_HERE

# 変更後 (実際のトークンを貼り付け)
GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

  3. 保存する

Step 5: 設定確認

.env ファイルの内容を確認:

# Gitea API トークン
GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  # ← 実際のトークン

# Gitea サーバー設定
GITEA_URL=http://100.76.7.3:3000
GITEA_OWNER=maita
GITEA_REPO=ponshu_room_lite

# APKビルド設定
MAITA_API_KEY=AIzaSyDjPZGOHy-xAstpLks081SIbUdTyb_iJpU
EIJI_API_KEY=AIzaSyBEwmTa9_2aiRrwr1mXE7Qriw8mIg1xr0U

🔒 セキュリティ注意事項

1. .env ファイルの取り扱い

✅ 安全:

  • .env は .gitignore に登録済み
  • Gitにコミットされません
  • ローカルPCにのみ保存

❌ 絶対にやってはいけないこと:

  • .env をGitにコミット
  • トークンをSlack/メールで共有
  • スクリーンショットに含める

2. トークンの管理

トークンを再発行する場合:

  1. Gitea → 設定 → アプリケーション
  2. 古いトークンを削除
  3. 新しいトークンを生成
  4. .env を更新

トークンが漏洩した場合:

  1. 即座に削除 (Gitea設定画面から)
  2. 新しいトークンを再発行
  3. .env を更新
  4. 全てのビルドスクリプトを再実行

🧪 動作確認

PowerShellで確認

# .env ファイルが存在するか確認
Test-Path .env

# .env の内容を確認 (トークンが設定されているか)
Get-Content .env | Select-String "GITEA_TOKEN"

期待される出力:

GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

📦 次のステップ

トークン設定が完了したら、Antigravityに実装を依頼してください:

トークンを .env に保存しました。

次の実装をお願いします:
1. build_all_apks.ps1 にGitea API連携を追加
2. ビルド完了後、自動でGiteaリリース作成
3. APKファイルを自動アップロード
4. 動作確認スクリプトの作成

🔄 自動化フロー (完成後)

# 1回のコマンドで全て完了
.\build_all_apks.ps1

# ↓ 自動実行される処理
# 1. APK 4本をビルド
# 2. Gitea にリリース作成 (例: v1.0.16)
# 3. APK 4本をリリースにアタッチ
# 4. リリースノートを自動生成
# 5. Vercel ダウンロードページが自動更新

📚 関連ドキュメント

❓ トラブルシューティング

問題1: トークンが見つからない

症状: Gitea設定画面にトークンが表示されない

解決策:

# .env ファイルの内容を確認
cat .env

# GITEA_TOKEN が空の場合は、再度トークン生成

問題2: 権限エラー

症状: 403 Forbidden エラー

原因: トークンの権限不足

解決策:

  • Gitea設定画面でトークンを確認
  • repository: 書き込み が有効か確認
  • 無効な場合は、トークンを削除して再発行

問題3: .env が読み込まれない

症状: ビルドスクリプトでトークンが見つからない

解決策:

# .env ファイルの場所を確認
Get-Location
# → C:\Users\maita\posimai-project\ponshu_room_lite であるべき

# .env ファイルの存在確認
Test-Path .env
# → True が返ってくるべき

設定完了後、Antigravityに実装を依頼してください! 🚀