Deploy
Quick Start
bash
# 1. developブランチに切り替え git checkout develop # 2. 変更をコミット git add <files> git commit -m "feat: 変更内容" # 3. lint確認（必須） ruff check . --select=E,F,W --ignore=E501 --exclude=venv # 4. developにpush git push origin develop # 5. PRを作成してmainにマージ gh pr create --base main --head develop
重要: featureブランチは作成しない。すべての開発はdevelopブランチで直接行う。
Workflow
ブランチ戦略
| ブランチ | 用途 | CI | デプロイ |
|---|---|---|---|
develop | 開発用 | lint/構文チェック | なし |
main | 本番用 | lint/構文チェック | OCI自動デプロイ |
デプロイフロー
code
developで開発
|
ruff check . でlint確認
|
git push origin develop
|
CI成功を確認
|
gh pr create --base main
|
PRマージ
|
GitHub Actionsが自動デプロイ
|
rsync → /opt/minecraft/bot/
|
systemctl restart discord-bot
|
Discordに通知
Important Notes
- •mainへの直接pushは禁止 - 必ずdevelop経由でPRを作成する
- •lint必須 - CIで同じチェックが走るため、ローカルで通らないコードはpushしない
- •mainへのpushはサーバー再起動を伴う - Minecraftサーバーも一時停止する（auto-start機能で自動復旧）
Related Files
- •
.github/workflows/deploy.yml- デプロイワークフロー（main push時） - •
.github/workflows/pr-merged.yml- PRマージ通知（コミット一覧付き） - •
.github/workflows/ci.yml- CI設定 - •
CLAUDE.md- コード規約・チェックリスト - •
.agent/development.md- ブランチ戦略詳細
Discord通知
| イベント | ワークフロー | 内容 |
|---|---|---|
| main push | deploy.yml | デプロイ成功/失敗 + コミットメッセージ |
| PRマージ | pr-merged.yml | PRタイトル + コミット一覧（階層表示） |
| develop push（CI失敗時） | ci.yml | CI失敗通知 |
Troubleshooting
CI失敗時
bash
# エラー内容を確認 gh run view --log-failed # ローカルでlint実行 ruff check . --select=E,F,W --ignore=E501 --exclude=venv # 自動修正 ruff check . --fix
デプロイ失敗時
bash
# GitHub Actions ログ確認 gh run list --limit 5 gh run view <run_id> --log # リモートでサービス状態確認 ssh ubuntu@<OCI_IP> "sudo systemctl status discord-bot" ssh ubuntu@<OCI_IP> "sudo journalctl -u discord-bot -n 50"
デプロイ後にボットが起動しない
- •
.envファイルの存在確認 - •
DISCORD_TOKENの有効性確認 - •Python依存関係の確認:
pip install -r requirements.txt