---
title: リリースとロールバック
description: 本番環境へのリリース手順、タグ運用、リリースノート、ロールバックの方法
---

## リリースの流れ

本番環境への反映は CI/CD による自動化を基本とします。

1. `develop` から `main` への PR を作成し、マージする
2. CI とデプロイのワークフローが成功したことを Actions タブで確認する
3. 必要に応じてタグを作成し、リリースノートを公開する

ブランチの運用は[ブランチ戦略](/git/branch#運用フロー)、デプロイの設定は[デプロイ](/deploy-release/deploy)を参照してください。

## タグ運用

タグは任意です。付ける場合は、次の命名規則に従います。
レンタルサーバーの案件など、ホスティングサービスの機能で以前のデプロイに戻せない場合は、ロールバックの基点になるため付けてください。

### タグの命名規則

セマンティックバージョニング（SemVer）に準拠します。

```sh
v<major>.<minor>.<patch>

例:
v1.0.0
v1.2.3
v2.0.0-beta.1
```

- **major**: 後方互換性のない変更
- **minor**: 後方互換性のある機能追加
- **patch**: 後方互換性のあるバグ修正

:::note
Web サイト制作など、バージョン番号に意味がないプロジェクトでは、日付ベースのタグ（例: `release-2026-01-14`）を使用しても構いません。
同じ日に複数回リリースする場合は、`release-2026-01-14.2` のように連番を付けます。
どちらを使うかはプロジェクト内で統一してください。
:::

### タグの作成

リリース管理には、作成者・日時・メッセージが記録される注釈付きタグを使用します。
タグは、`main` にマージしたリリースのマージコミットに付けます。

```sh
git switch main
git pull
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0
```

### タグの確認と削除

```sh
# タグの一覧を表示
git tag -l "v1.*"

# タグの詳細を表示
git show v1.0.0

# ローカルとリモートのタグを削除
git tag -d v1.0.0
git push origin --delete v1.0.0
```

:::warning
一度公開したタグは、他の人が使用している可能性があります。
誤って作成した場合を除き、既存のタグは削除しないでください。
:::

## リリースノート

リリースノートは任意です。作成する場合は、GitHub の自動生成を使います。

- **GitHub の自動生成**: Releases の作成画面で「Generate release notes」を使う。前回のタグ以降にマージされた PR のタイトルが一覧になり、`.github/release.yml` で PR のラベルごとに分類できる

:::note[release-please・semantic-release]
コミットメッセージからバージョンや CHANGELOG を自動で決める release-please や semantic-release は、`main` へリリース用のコミットやタグを直接作るため、本ガイドラインのブランチ戦略や保護ルールとそのままでは合いません。採用する場合は、ブランチ戦略とバイパスの設定をあわせて見直してください。
:::

## ロールバック

デプロイ後に問題が発生した場合、影響を最小限にするため速やかにロールバックします。

### git revert で取り消す（推奨）

問題のあるコミットを打ち消すコミットを作成し、通常のデプロイの流れで前の状態に戻します。
履歴を壊さずに取り消せるため、原則としてこの方法を優先してください。
`main` への直接 push は禁止しているため、[緊急修正（hotfix）](/git/branch#緊急修正hotfix)と同じ流れで PR 経由で反映します。

```sh
git switch main
git pull
git switch -c hotfix/revert-<対象>
git log --oneline
git revert -m 1 <リリースのマージコミットのハッシュ>
git push -u origin hotfix/revert-<対象>
```

1. push したブランチから `main` への PR を作成してマージし、本番へデプロイする
2. `main` から `develop` への PR を作成してマージし、取り消しを `develop` にも反映する

:::note
`-m 1` はマージコミットを取り消すときに、残す親（`main` 側）を指定するオプションです。通常のコミットを取り消す場合は不要です。
:::

:::warning[取り消した変更をリリースし直す場合]
revert のコミットが `develop` に入ると、取り消した変更は `develop` からも消えた状態になります。元のブランチを修正して再度マージしても、取り消した部分は戻りません。
修正して再リリースするときは、`develop` から作ったブランチで、先に revert のコミットを `git revert` で打ち消してから修正を加えてください。
:::

### ホスティングサービスの機能を使う

緊急時は、ホスティングサービスの機能で以前のデプロイに即座に戻します。その後、原因のコミットを `git revert` で取り消してください。

- **Cloudflare Workers**: ダッシュボードの Deployments から以前のバージョンを選んで Rollback する。または `wrangler rollback` を実行する
- **Cloudflare Pages**: Deployments から以前の本番デプロイを選んで「Rollback to this deployment」を実行する
- **Vercel**: ダッシュボードから以前のデプロイを Promote する
- **Netlify**: デプロイ履歴から以前のバージョンを公開する

:::warning
Cloudflare Workers のロールバックでは、KV や D1 などの接続先のデータは元に戻りません。
データの構造を変更したリリースでは、以前のコードで動作するかを確認してから戻してください。
:::

### レンタルサーバーの場合

レンタルサーバーには以前のデプロイに戻す機能がありません。
前回リリースのタグをチェックアウトしてビルドし、通常と同じ方法で配信し直します。
ワークフローに `workflow_dispatch` の入力でタグを指定できるようにしておくと、すぐに再デプロイできます。

:::warning
ロールバック手順は初回リリース前に確認し、リポジトリの README の「デプロイ」節に記載してください。
:::
