Skip to main content

GitHub Marketplaceでのアクションの公開

GitHub Marketplaceでアクションを公開し、作成したアクションをGitHubコミュニティと共有できます。

GitHub Marketplaceでアクションを公開するには、利用規約に同意していなければなりません。

アクションの公開について

アクションを公開できるようになるには、リポジトリ中でアクションを作成しなければなりません。 詳しくは、「自動化の共有」を参照してください。

アクションを GitHub Marketplace に公開することを計画している場合は、アクションに必要なメタデータ ファイル、コード、ファイルだけがリポジトリに含まれるようにする必要があります。 アクションのために 1 つのリポジトリを作成すれば、単一のユニットでコードのタグ付け、リリース、パッケージができます。 GitHubは、GitHub Marketplaceページ上のアクションのメタデータも利用します。

アクションはGitHub Marketplaceに即座に公開され、以下の要求を満たしていればGitHubによってレビューされません。

  • アクションはパブリック リポジトリ内に格納されている必要があります。
  • 各リポジトリには、1 つのアクションを含める必要があります。
  • 各リポジトリには、ワークフロー ファイルを含めては "なりません"。__
  • アクションのメタデータ ファイル (action.yml または action.yaml) は、リポジトリのルート ディレクトリに存在する必要があります。
  • アクションのメタデータ ファイル中の name は一意にする必要があります。
    • name は GitHub Marketplace で公開されている既存のアクション名と一致してはなりません。
    • name は、ユーザーまたは組織の所有者がアクションを公開していない限り、GitHub でユーザーまたは組織と一致してはなりません。 たとえば、GitHub 組織のみ、github という名前のアクションを発行できます。
    • name は既存の GitHub Marketplace カテゴリと一致してはなりません。
    • GitHubはGitHubの機能の名前を予約している。

アクションの公開

作成したアクションは、新しいリリースとしてタグ付けして公開することによって、GitHub Marketplaceに追加できます。

新しいリリースのドラフトを作成し、アクションをGitHub Marketplaceに公開するには、以下の指示に従ってください。

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

  2. リポジトリのアクション メタデータ ファイル (action.yml または action.yaml) に移動すると、アクションを GitHub Marketplace に公開するバナーが表示されます。 [リリースの下書き] をクリックします。

  3. [リリース アクション] の下で [このアクションを GitHub Marketplace に公開する] を選びます。

    : リポジトリを所有するアカウントが GitHub Marketplace 開発者契約をまだ受け入れていない場合、[発行] チェックボックスは無効になります。 ユーザーがリポジトリを所有している場合、または組織の所有者である場合は、[GitHub Marketplace 開発者契約に同意する] リンクをクリックして、契約に同意します。 リンクがない場合は、組織の所有者にこの [リリース アクション] ページへのリンクを送信し、契約に同意するよう依頼します。

  4. メタデータファイル内のラベルに何か問題があれば、エラーメッセージが表示されます。 これはメタデータ ファイルを更新して対処します。 完了すると、"Everything looks good!" メッセージが表示されます。 メッセージで応答します。

  5. [主なカテゴリ] ドロップダウン メニューを選び、GitHub Marketplace でユーザーがアクションを見つけやすいカテゴリをクリックします。

  6. 必要に応じて、 [もう 1 つのカテゴリ] ドロップダウン メニューを選び、2 番目のカテゴリをクリックします。

  7. タグ フィールドに、アクションのバージョンを入力します。 これで、そのリリースに含まれる変更や機能が分かりやすくなります。 このバージョンは、アクションの専用のGitHub Marketplaceページに表示されます。

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

  9. 他のすべてのフィールドに入力し、 [リリースの発行] をクリックします。 公開をするには、2要素認証を使っていなければなりません。 詳しくは、「2 要素認証を設定する」を参照してください。

GitHub Marketplaceからのアクションの削除

GitHub Marketplaceから公開されたアクションを削除するには、それぞれの公開リリースを更新しなければなりません。 以下のステップを、GitHub Marketplaceに公開したアクションの各リリースに対して行ってください。

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

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

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

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

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

  4. [このアクションを GitHub Marketplace に公開する] を選択し、ボックスのチェックを外します。

  5. ページの下部にある [リリースの更新] をクリックします。

アクション リポジトリの転送

リポジトリを別のユーザーまたは組織に転送できます。 詳しくは、「リポジトリを移譲する」を参照してください。

リポジトリ管理者がアクション リポジトリを転送すると、GitHub は、以前の URL から新しい URL へのリダイレクトを自動的に作成します。つまり、影響を受けるアクションを使用するワークフローを更新する必要はありません。

GitHub Marketplace に発行されたアクションは、一意 name 識別子によってリポジトリにリンクされます。つまり、転送されたリポジトリから同じ GitHub Marketplace リストでアクションの新しいリリースを発行できます。 アクション リポジトリが削除されると、GitHub Marketplace リストも削除され、一意の name 識別子が使用可能になります。

注: 組織の GitHub プロファイルに表示される "検証済み" バッジは、GitHub Marketplace の検証済み作成者バッジとは異なります。 アクション リポジトリを転送すると、GitHub Marketplace リストは、新しいオーナーが検証済みの作成者でない限り、検証済み作成者バッジを失いますオ。

GitHub Marketplace でのバッジについて

(検証済み作者バッジ) の付いたアクションは、GitHub がそのアクションの作者をパートナー Organization として検証済みであることを示します。 パートナーは、検証済み作者バッジを要求する電子メール partnerships@github.com を送信できます。

GitHub Actions のスクリーンショット。検証済みの作成者バッジが表示されています。