263 lines
6.4 KiB
Markdown
263 lines
6.4 KiB
Markdown
# 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` の値を、コピーしたトークンに置き換える
|
|
```bash
|
|
# 変更前
|
|
GITEA_TOKEN=YOUR_GITEA_TOKEN_HERE
|
|
|
|
# 変更後 (実際のトークンを貼り付け)
|
|
GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
```
|
|
|
|
3. 保存する
|
|
|
|
---
|
|
|
|
### **Step 5: 設定確認**
|
|
|
|
`.env` ファイルの内容を確認:
|
|
|
|
```bash
|
|
# 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で確認**
|
|
|
|
```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. 動作確認スクリプトの作成
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 **自動化フロー (完成後)**
|
|
|
|
```bash
|
|
# 1回のコマンドで全て完了
|
|
.\build_all_apks.ps1
|
|
|
|
# ↓ 自動実行される処理
|
|
# 1. APK 4本をビルド
|
|
# 2. Gitea にリリース作成 (例: v1.0.16)
|
|
# 3. APK 4本をリリースにアタッチ
|
|
# 4. リリースノートを自動生成
|
|
# 5. Vercel ダウンロードページが自動更新
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 **関連ドキュメント**
|
|
|
|
- [DISTRIBUTION_SUMMARY_2026-02-23.md](./DISTRIBUTION_SUMMARY_2026-02-23.md) - 配布パッケージサマリー
|
|
- [FUTURE_DEVELOPMENT_STRATEGY_2026.md](./FUTURE_DEVELOPMENT_STRATEGY_2026.md) - 今後の開発構想
|
|
- [../web/download/DEPLOYMENT_GUIDE.md](../web/download/DEPLOYMENT_GUIDE.md) - Vercel配布ページガイド
|
|
|
|
---
|
|
|
|
## ❓ **トラブルシューティング**
|
|
|
|
### **問題1: トークンが見つからない**
|
|
|
|
**症状**: Gitea設定画面にトークンが表示されない
|
|
|
|
**解決策**:
|
|
```bash
|
|
# .env ファイルの内容を確認
|
|
cat .env
|
|
|
|
# GITEA_TOKEN が空の場合は、再度トークン生成
|
|
```
|
|
|
|
### **問題2: 権限エラー**
|
|
|
|
**症状**: `403 Forbidden` エラー
|
|
|
|
**原因**: トークンの権限不足
|
|
|
|
**解決策**:
|
|
- Gitea設定画面でトークンを確認
|
|
- `repository: 書き込み` が有効か確認
|
|
- 無効な場合は、トークンを削除して再発行
|
|
|
|
### **問題3: .env が読み込まれない**
|
|
|
|
**症状**: ビルドスクリプトでトークンが見つからない
|
|
|
|
**解決策**:
|
|
```powershell
|
|
# .env ファイルの場所を確認
|
|
Get-Location
|
|
# → C:\Users\maita\posimai-project\ponshu_room_lite であるべき
|
|
|
|
# .env ファイルの存在確認
|
|
Test-Path .env
|
|
# → True が返ってくるべき
|
|
```
|
|
|
|
---
|
|
|
|
**設定完了後、Antigravityに実装を依頼してください!** 🚀
|