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

リリース管理について

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

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

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

リリースの作成

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

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

リリースを作成するには、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 beta release" --prerelease
```

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

リリースの編集

GitHub.com で、リポジトリのメインページへ移動します。
ファイルの一覧の右側にある [リリース] をクリックします。
編集したいリリースの横で、を選びます。
フォーム内でリリースの詳細を編集し、 [リリースの更新] をクリックします。説明内で GitHub ユーザーの @mentions を追加または削除する場合、リリースの [共同作成者] セクションのアバターリストでそのユーザーが追加または削除されます。

現在、リリースは GitHub CLI では編集できません。

リリースの削除

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

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

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

この記事の内容

Tool navigation

リリース管理について

リリースの作成

リリースの編集

リリースの削除