# リポジトリのリリースを管理する
リリースを作成し、プロジェクトのイテレーションをバンドルしてユーザに配信できます。
## リリース管理について
リリース ノート、共同作成者の @mentions、バイナリ ファイルへのリンクを含む新しいリリースを作成したり、既存のリリースを編集または削除したりすることができます。 Releases API を使って、リリースを作成、変更、削除することもできます。 詳細については、REST API ドキュメントの「[リリースの REST API エンドポイント](/ja/rest/releases/releases)」を参照してください。
GitHub Marketplaceの特定のリリースからのアクションを発行することもできます。 詳しくは、「[GitHub Marketplaceでのアクションの公開](/ja/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace)」をご覧ください。
Git 大容量ファイルストレージ (Git LFS) オブジェクトを、リリースごとに作成GitHub ZIP ファイルと tarball に含めるかどうかを選択できます。 詳しくは、「[リポジトリのアーカイブで Git LFS オブジェクトを管理する](/ja/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository)」をご覧ください。
## リリースの作成
> \[!TIP]
> リポジトリに対して変更できないリリースを有効にしている場合は、最初に下書きとしてリリースを作成し、すべての資産をアタッチしてから発行することをお勧めします。 これにより、リリースが不変になる前にすべての資産が確実に配置されます。 詳しくは、「[変更不可リリース](/ja/code-security/concepts/supply-chain-security/immutable-releases)」をご覧ください。
1. GitHub で、リポジトリのメイン ページに移動します。
2. ファイルの一覧の右側にある **\[リリース]** をクリックします。
![リポジトリのメイン ページのスクリーンショット。 \[リリース\] というラベルの付いたリンクがオレンジ色の枠線で強調表示されています。](/assets/images/help/releases/release-link.png)
3. ページの上部にある **\[新しいリリースの下書き]** を選びます。
4. リリースのタグを選択するには、 **\[タグの選択]** ドロップダウン メニューを選択します。
* 既存のタグを使うには、そのタグを選びます。
* 新しいタグを作成するには、リリースのバージョン番号を入力し、 **\[新しいタグを作成]** を選びます。
5. 新しいタグを作成した場合は、 **\[ターゲット]** ドロップダウン メニューを選び、リリースするプロジェクトが含まれるブランチを選びます。
6. 必要に応じて、\[説明] フィールドの上にある **\[前のタグ]** ドロップダウン メニューを選び、次に前のリリースを特定するタグを選びます。
![\[新しいリリース\] フォームのスクリーンショット。 \[前のタグ: 自動\] というラベルの付いたドロップダウン メニューがオレンジ色の枠線で強調表示されています。](/assets/images/help/releases/releases-tag-previous-release.png)
7. \[リリース タイトル] フィールドに、リリースのタイトルを入力します。
8. "このリリースの説明" フィールドに、リリースの説明を入力します。
説明の中で任意のユーザーに @mention する場合、公開されるリリースには、 **\[共同作成者]** セクションと、メンションされているすべてのユーザーのアバター リストが含まれます。
または、**\[リリース ノートを生成]** をクリックすると、リリース ノートを自動的に生成することができます。
9. オプションで、コンパイルされたプログラムなどのバイナリファイルをリリースに含めるには、ドラッグアンドドロップするかバイナリボックスで手動で選択します。
10. 必要に応じて、リリースが不安定であり、運用の準備ができていないことをユーザーに通知するには、 **\[これはプレリリースです]** を選びます。
11. 必要に応じて、 **\[最新リリースとして設定する]** を選びます。 このオプションをオンにしないと、セマンティック バージョン管理に基づいて、最新のリリース ラベルが自動的に割り当てられます。
12. 必要に応じて、GitHub Discussions がリポジトリで有効になっている場合、リリースのディスカッションを作成します。
* **\[このリリースのディスカッションを作成する]** を選びます。
* **\[カテゴリ]** ドロップダウン メニューを選び、次にリリース ディスカッションのカテゴリを選びます。
13. リリースを公開する準備ができている場合は、 **\[リリースの公開]** をクリックします。 後でリリースを操作するには、\[ **下書きの保存**] をクリックします。リポジトリに対して変更できないリリースを有効にしている場合は、最初に下書きを作成すると、リリースが変更不可になる前にすべての資産をアタッチできます。
その後、リポジトリのリリース フィードで公開されたリリースまたはドラフト リリースを表示できます。 詳しくは、「[リポジトリのリリースとタグを表示する](/ja/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags)」をご覧ください。
> \[!NOTE]
> GitHub CLI の詳細については、「[GitHub CLI について](/ja/github-cli/github-cli/about-github-cli)」を参照してください。
1. リリースを作成するには、`gh release create` サブコマンドを使用します。
`tag` をリリースに必要なタグに置き換えます。
```shell
gh release create TAG
```
2. 対話型のプロンプトに従います。 または、引数を指定して、これらのプロンプトをスキップすることもできます。 使用できる引数の詳細については、[GitHub CLIマニュアルを](https://cli.github.com/manual/gh_release_create)参照してください。 たとえば、このコマンドでは、指定したタイトルとノートを含むプレリリースが作成されます。
```shell
gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a パブリック プレビュー release" --prerelease
```
説明文で任意の @mention ユーザーを GitHub すると、公開されたリリースには、メンションされたすべてのユーザーのアバター一覧が掲載された**共同作成者**セクションが含まれます。
## リリースの編集
> \[!NOTE]
> リポジトリで変更不可リリースを有効にしている場合、リリースの発行後に編集できるのはタイトルとリリース ノートのみです。 「[変更不可リリース](/ja/code-security/concepts/supply-chain-security/immutable-releases)」を参照してください。
1. リリースを編集するには、`gh release edit` サブコマンドを使用します。
`TAG` を、編集するリリースを表すタグに置き換えます。 たとえば、リリースのタイトルを編集するには、次のコードを使用して、`NEW-TITLE` を更新されたタイトルに置き換えます。
```shell
gh release edit TAG -t "NEW-TITLE"
```
使用できる引数の詳細については、[GitHub CLIマニュアルを](https://cli.github.com/manual/gh_release_edit)参照してください。
## リリースの削除
1. リリースを削除するには、`gh release delete` サブコマンドを使用します。
`tag` を削除するリリースのタグに置き換えます。 確認をスキップするには、`-y` フラグを使用します。
```shell
gh release delete TAG -y
```