リポジトリのリリースを管理する

リリース管理について

リリースノート、共同作成者の @mentions、バイナリファイルへのリンクを含む新しいリリースを作成したり、既存のリリースを編集または削除したりすることができます。 Releases API を使って、リリースを作成、変更、削除することもできます。詳細については、REST API ドキュメントの「リリースの REST API エンドポイント」を参照してください。

特定のリリースのアクションを GitHub Marketplace で公開することもできます。詳しくは、「GitHub Marketplaceでのアクションの公開」をご覧ください。

Git Large File Storage（Git LFS）オブジェクトを、GitHub がリリースごとに作成する ZIP ファイルと tarball に含めるかどうかを選択できます。詳しくは、「リポジトリのアーカイブで Git LFS オブジェクトを管理する」をご覧ください。

リリースの作成

ヒント

リポジトリに対して変更できないリリースを有効にしている場合は、最初に下書きとしてリリースを作成し、すべての資産をアタッチしてから発行することをお勧めします。これにより、リリースが不変になる前にすべての資産が確実に配置されます。詳しくは、「変更不可リリース」をご覧ください。

GitHub で、リポジトリのメインページに移動します。1. ファイルの一覧の右側にある [リリース] をクリックします。

1. ページの上部にある [新しいリリースの下書き] を選びます。
リリースのタグを選択するには、 [タグの選択] ドロップダウンメニューを選択します。
- 既存のタグを使うには、そのタグを選びます。
- 新しいタグを作成するには、リリースのバージョン番号を入力し、 [新しいタグを作成] を選びます。
新しいタグを作成した場合は、 [ターゲット] ドロップダウンメニューを選び、リリースするプロジェクトが含まれるブランチを選びます。1. 必要に応じて、[説明] フィールドの上にある [前のタグ] ドロップダウンメニューを選び、次に前のリリースを特定するタグを選びます。

1. [リリースタイトル] フィールドに、リリースのタイトルを入力します。
"このリリースの説明" フィールドに、リリースの説明を入力します。説明の中で任意のユーザーに @mention する場合、公開されるリリースには、 [共同作成者] セクションと、メンションされているすべてのユーザーのアバターリストが含まれます。または、[リリースノートを生成] をクリックすると、リリースノートを自動的に生成することができます。
オプションで、コンパイルされたプログラムなどのバイナリファイルをリリースに含めるには、ドラッグアンドドロップするかバイナリボックスで手動で選択します。
必要に応じて、リリースが不安定であり、運用の準備ができていないことをユーザーに通知するには、 [これはプレリリースです] を選びます。
必要に応じて、 [最新リリースとして設定する] を選びます。このオプションをオンにしないと、セマンティックバージョン管理に基づいて、最新のリリースラベルが自動的に割り当てられます。
必要に応じて、GitHub Discussions がリポジトリで有効になっている場合、リリースのディスカッションを作成します。 * [このリリースのディスカッションを作成する] を選びます。 * [カテゴリ] ドロップダウンメニューを選び、次にリリースディスカッションのカテゴリを選びます。
リリースを公開する準備ができている場合は、 [リリースの公開] をクリックします。後でリリースを操作するには、[ 下書きの保存] をクリックします。リポジトリに対して変更できないリリースを有効にしている場合は、最初に下書きを作成すると、リリースが変更不可になる前にすべての資産をアタッチできます。その後、リポジトリのリリースフィードで公開されたリリースまたはドラフトリリースを表示できます。詳しくは、「リポジトリのリリースとタグを表示する」をご覧ください。

リリースを作成するには、gh release create サブコマンドを使用します。 tag をリリースに必要なタグに置き換えます。
```
gh release create TAG
```
対話型のプロンプトに従います。または、引数を指定して、これらのプロンプトをスキップすることもできます。このコマンドの詳細については、GitHub CLI のマニュアルを参照してください。たとえば、このコマンドでは、指定したタイトルとノートを含むプレリリースが作成されます。

gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a パブリック プレビュー release" --prerelease

ノートで GitHub ユーザーに @mention した場合、公開されるリリースには、[共同作成者] セクションと、メンションされているすべてのユーザーのアバターリストが含まれます。

リリースの編集

メモ

リポジトリで変更不可リリースを有効にしている場合、リリースの発行後に編集できるのはタイトルとリリースノートのみです。「変更不可リリース」を参照してください。

GitHub で、リポジトリのメインページに移動します。1. ファイルの一覧の右側にある [リリース] をクリックします。

1. 編集したいリリースの横で、を選びます。
フォーム内でリリースの詳細を編集し、 [リリースの更新] をクリックします。説明に含まれるGitHubユーザーの @mentions を追加または削除すると、それらのユーザーはリリースの Contributors セクションのアバターリストに追加または削除されます。

リリースを編集するには、gh release edit サブコマンドを使用します。 TAG を、編集するリリースを表すタグに置き換えます。たとえば、リリースのタイトルを編集するには、次のコードを使用して、NEW-TITLE を更新されたタイトルに置き換えます。
```
gh release edit TAG -t "NEW-TITLE"
```
このコマンドの詳細については、GitHub CLI のマニュアルを参照してください。

リリースの削除

GitHub で、リポジトリのメインページに移動します。1. ファイルの一覧の右側にある [リリース] をクリックします。
ページの右側で、削除するリリースの横にあるをクリックします。

       **[このリリースを削除]** をクリックします。

リリースを削除するには、gh release delete サブコマンドを使用します。 tag を削除するリリースのタグに置き換えます。確認をスキップするには、-y フラグを使用します。
```
gh release delete TAG -y
```

この機能を使用できるユーザーについて

Tool navigation

この記事で

リリース管理について

リリースの作成

リリースの編集

リリースの削除