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

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 Marketplace でのバッジについて

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