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

リリースを作成し、プロジェクトのイテレーションをバンドルしてユーザに配信できます。

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

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Tool navigation

この記事の内容

リリース管理について

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

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

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

リリースの作成

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. ファイルの一覧の右側にある [リリース] をクリックします。

    リポジトリのメイン ページのスクリーンショット。 [リリース] というラベルの付いたリンクがオレンジ色の枠線で強調表示されています。

  3. ページの上部にある [新しいリリースの下書き] を選びます。

  4. リリースのタグを選択するには、 [タグの選択] ドロップダウン メニューを選択します。

    • 既存のタグを使うには、そのタグを選びます。
    • 新しいタグを作成するには、リリースのバージョン番号を入力し、 [新しいタグを作成] を選びます。

  5. 新しいタグを作成した場合は、 [ターゲット] ドロップダウン メニューを選び、リリースするプロジェクトが含まれるブランチを選びます。

  6. 必要に応じて、[説明] フィールドの上にある [前のタグ] ドロップダウン メニューを選び、次に前のリリースを特定するタグを選びます。

    [新しいリリース] フォームのスクリーンショット。 [前のタグ: 自動] というラベルの付いたドロップダウン メニューがオレンジ色の枠線で強調表示されています。

  7. [リリース タイトル] フィールドに、リリースのタイトルを入力します。

  8. "このリリースの説明" フィールドに、リリースの説明を入力します。 説明の中で任意のユーザーに @mention する場合、公開されるリリースには、 [共同作成者] セクションと、メンションされているすべてのユーザーのアバター リストが含まれます。 または、[リリース ノートの生成] をクリックして、リリース ノートを自動的に生成することができます。

  9. オプションで、コンパイルされたプログラムなどのバイナリファイルをリリースに含めるには、ドラッグアンドドロップするかバイナリボックスで手動で選択します。

  10. 必要に応じて、リリースが不安定であり、運用の準備ができていないことをユーザーに通知するには、 [これはプレリリースです] を選びます。

  11. 必要に応じて、 [最新リリースとして設定する] を選びます。 このオプションをオンにしないと、セマンティック バージョン管理に基づいて、最新のリリース ラベルが自動的に割り当てられます。

  12. 必要に応じて、GitHub Discussions がリポジトリで有効になっている場合、リリースのディスカッションを作成します。

    • [このリリースのディスカッションを作成する] を選びます。
    • [カテゴリ] ドロップダウン メニューを選び、次にリリース ディスカッションのカテゴリを選びます。

  13. リリースを公開する準備ができている場合は、 [リリースの公開] をクリックします。 リリースの作業を後でする場合は、 [下書きの保存] をクリックします。 その後、リポジトリのリリース フィードで公開されたリリースまたはドラフト リリースを表示できます。 詳しくは、「リポジトリのリリースとタグを表示する」を参照してください。

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

  1. リリースを作成するには、gh release create サブコマンドを使用します。 tag をリリースに必要なタグに置き換えます。

    gh release create TAG

  2. 対話型のプロンプトに従います。 または、引数を指定して、これらのプロンプトをスキップすることもできます。 このコマンドの詳細については、GitHub CLI のマニュアルを参照してください。 たとえば、このコマンドでは、指定したタイトルとノートを含むプレリリースが作成されます。

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

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

リリースの編集

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. ファイルの一覧の右側にある [リリース] をクリックします。

    リポジトリのメイン ページのスクリーンショット。 [リリース] というラベルの付いたリンクがオレンジ色の枠線で強調表示されています。

  3. 編集したいリリースの横で、 を選びます。

    リリース一覧内のリリースのスクリーンショット。 鉛筆アイコンがオレンジ色の枠線で強調表示されています。

  4. フォーム内でリリースの詳細を編集し、 [リリースの更新] をクリックします。 説明内で GitHub ユーザーの @mentions を追加または削除する場合、リリースの [共同作成者] セクションのアバター リストでそのユーザーが追加または削除されます。

  1. リリースを編集するには、gh release edit サブコマンドを使用します。 TAG を編集するリリースを表すタグに置き換えます。 たとえば、リリースのタイトルを編集するには、次のコードを使用して、NEW-TITLE を更新されたタイトルに置き換えます。

    gh release edit TAG -t "NEW-TITLE"

    このコマンドの詳細については、GitHub CLI のマニュアルを参照してください。

リリースの削除

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. ファイルの一覧の右側にある [リリース] をクリックします。

    リポジトリのメイン ページのスクリーンショット。 [リリース] というラベルの付いたリンクがオレンジ色の枠線で強調表示されています。

  3. ページの右側で、削除するリリースの横にある をクリックします。

    リリース一覧内のリリースのスクリーンショット。 ごみ箱アイコンがオレンジ色の枠線で強調表示されています。

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

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

    gh release delete TAG -y