2025年個人開発のリリースフロー
自動化と人的制御のバランス
フルオートメーションのCI/CDは魅力的だが、本番環境へのデプロイには最後の確認ポイントが欲しい。かといって手動オペレーションだらけではミスのリスクが高まる。
本記事では、Changesetsによるバージョン管理の自動化と、デプロイ前の手動トリガーを組み合わせたデプロイフローを、個人用メモがてら紹介する。このフローは、実際に運用中の「AC6 Assemble Tool」で採用している構成である。
構成要素
ブランチ戦略:main一本
複雑なブランチ管理を避け、mainブランチのみで運用。trunk-based developmentの考え方に近い。
- ブランチ管理コストの削減
- マージ競合の最小化
- デプロイ可能状態の明確化(main = デプロイ可能)
Changesetsによるバージョン管理
バージョン管理にはchangesetsを使用(詳細な使い方は公式ドキュメントを参照)。
開発者が修正またはchangesets コマンドを使って、変更履歴ファイルを作成できる。
changesets 用のGitHub Actionも用意されている。
これを使うと、以下の処理を自動で行ってくれる。
- 変更履歴ファイルがある -> バージョン更新PRを自動作成
- 変更履歴ファイルがない -> 何もしない
2種類のリリースフロー
変更内容によって、「サクッと or 速やかにデプロイしたい」ものと「しっかり確認してからデプロイ」するものとがある。今回のケースでは、renovateによる依存更新が前者、普段の開発による変更内容が後者だった。
そこで、以下のような使い分けをした。
- renovate更新では「PRをマージしたらバージョン更新もスキップしてすぐにリリース」
- 普段の開発では「手動確認とバージョン更新を挟んで確実にリリース」
renovateによる依存更新のリリースフロー
実際のGithub Actionは .github/workflows/web-auto-deploy-deps.ymlを参照。
なぜ依存更新だけ自動化するのか
1. 頻度の高さ
依存パッケージの更新は週に数回〜十数回発生する。毎回手動リリースの手順を踏むのは現実的でない。
2. セキュリティ対応の迅速性
脆弱性修正を含むパッケージ更新は、できるだけ早く本番に反映したい。手動承認を待つことでセキュリティリスクが延びるのは避けたい。
3. リスクの低さ
依存パッケージの更新は、アプリケーションのビジネスロジックに直接影響しない。自動テスト(単体テスト、E2Eテストなど)がパスしていれば、リリースしてOKという判断。
開発による機能追加・変更時のリリースフロー
実際のGithub Actionは以下を参照。
なぜ手動トリガーか
- リリースタイミングのコントロール:
- リリース後の監視時間を確保できる時間帯、障害対応後など、適切なタイミングで実行できる
- 最終確認の機会:
- previe環境での動作確認後など、最後の安全確認ができる
- 複数PRのまとめリリース:
- 複数の変更をまとめて一度にリリースする柔軟性
この方式のトレードオフ
メリット
- 確実性:
- 本番リリース前に必ず人間の判断が入る
- 柔軟性:
- リリースタイミングを自由にコントロールできる
- 適度な自動化:
- バージョン管理とCHANGELOGは
changesetsで自動更新・生成
- バージョン管理とCHANGELOGは
- セキュリティ:
- 依存パッケージの脆弱性対応を素早く反映
デメリット
- 手順の多さ:
- Changeset追加 → PR → マージ → バージョンPR → マージ → 手動リリースの5段階
- 即座のリリース不可:
- hotfix時も手動トリガー待ち
- 心理的負荷:
- 「今リリースして大丈夫か」の判断を毎回行う必要がある
バージョン表示の工夫
アプリケーション内でバージョンとコミットハッシュを表示し、どの変更が本番に反映されているかを特定可能にしている(例:v3.2.6-a2bc949)。
これにより、どの変更が本番へ反映されているか、バージョン更新によらず特定可能としている。
以下は vite.config.ts からの抜粋。
const pkg = (() => {
const raw = fs.readFileSync('package.json', { encoding: 'utf-8' })
return JSON.parse(raw)
})()
const shortHash = (() => {
try {
if (process.env.GITHUB_SHA) return process.env.GITHUB_SHA.slice(0, 7)
const out = execSync('git rev-parse --short HEAD', {
encoding: 'utf-8',
stdio: ['ignore', 'pipe', 'ignore'],
})
return out.trim()
} catch {
return 'dev'
}
})()
export default defineConfig({
define: {
__APP_VERSION__: JSON.stringify(`${pkg.version}-${shortHash}`),
},
// 中略
}
まとめ
このフローは、「なまじ全自動より安心」という思想で設計している。
- Changesets = バージョン管理の自動化
- 手動トリガー = リリースタイミングの制御
- 依存更新の自動化 = セキュリティとスピードの両立
手順は多いが、各段階で確認が入る。個人開発で実際に運用して効果を実感しており、小規模チームでも有効な構成だと考えている。
完全自動化ではなく、適切な箇所に人間の判断を残すことで、自動化と制御のバランスを取る。それがこのフローの設計意図である。
参考リンク
Discussion