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に公開するには、以下の指示に従ってください。
-
GitHub で、リポジトリのメイン ページに移動します。
-
リポジトリのアクション メタデータ ファイル (
action.yml
またはaction.yaml
) に移動すると、アクションを GitHub Marketplace に公開するバナーが表示されます。 [リリースの下書き] をクリックします。 -
[リリース アクション] の下で [このアクションを GitHub Marketplace に公開する] を選びます。
注: リポジトリを所有するアカウントが GitHub Marketplace 開発者契約をまだ受け入れていない場合、[発行] チェックボックスは無効になります。 ユーザーがリポジトリを所有している場合、または組織の所有者である場合は、[GitHub Marketplace 開発者契約に同意する] リンクをクリックして、契約に同意します。 リンクがない場合は、組織の所有者にこの [リリース アクション] ページへのリンクを送信し、契約に同意するよう依頼します。
-
メタデータファイル内のラベルに何か問題があれば、エラーメッセージが表示されます。 これはメタデータ ファイルを更新して対処します。 完了すると、"Everything looks good!" メッセージが表示されます。 メッセージで応答します。
-
[主なカテゴリ] ドロップダウン メニューを選び、GitHub Marketplace でユーザーがアクションを見つけやすいカテゴリをクリックします。
-
必要に応じて、 [もう 1 つのカテゴリ] ドロップダウン メニューを選び、2 番目のカテゴリをクリックします。
-
タグ フィールドに、アクションのバージョンを入力します。 これで、そのリリースに含まれる変更や機能が分かりやすくなります。 このバージョンは、アクションの専用のGitHub Marketplaceページに表示されます。
-
[タイトル] フィールドにリリースのタイトルを入力します。
-
他のすべてのフィールドに入力し、 [リリースの発行] をクリックします。 公開をするには、2要素認証を使っていなければなりません。 詳しくは、「2 要素認証を設定する」を参照してください。
GitHub Marketplaceからのアクションの削除
GitHub Marketplaceから公開されたアクションを削除するには、それぞれの公開リリースを更新しなければなりません。 以下のステップを、GitHub Marketplaceに公開したアクションの各リリースに対して行ってください。
-
GitHub で、リポジトリのメイン ページに移動します。
-
ファイルの一覧の右側にある [リリース] をクリックします。
-
編集したいリリースの横で、 を選びます。
-
[このアクションを GitHub Marketplace に公開する] を選択し、ボックスのチェックを外します。
-
ページの下部にある [リリースの更新] をクリックします。
アクション リポジトリの転送
リポジトリを別のユーザーまたは組織に転送できます。 詳しくは、「リポジトリを移譲する」を参照してください。
リポジトリ管理者がアクション リポジトリを転送すると、GitHub は、以前の URL から新しい URL へのリダイレクトを自動的に作成します。つまり、影響を受けるアクションを使用するワークフローを更新する必要はありません。
GitHub Marketplace に発行されたアクションは、一意 name
識別子によってリポジトリにリンクされます。つまり、転送されたリポジトリから同じ GitHub Marketplace リストでアクションの新しいリリースを発行できます。 アクション リポジトリが削除されると、GitHub Marketplace リストも削除され、一意の name
識別子が使用可能になります。
注: 組織の GitHub プロファイルに表示される "検証済み" バッジは、GitHub Marketplace の検証済み作成者バッジとは異なります。 アクション リポジトリを転送すると、GitHub Marketplace リストは、新しいオーナーが検証済みの作成者でない限り、検証済み作成者バッジを失いますオ。
GitHub Marketplace でのバッジについて
(検証済み作者バッジ) の付いたアクションは、GitHub がそのアクションの作者をパートナー Organization として検証済みであることを示します。 パートナーは、検証済み作者バッジを要求する電子メール partnerships@github.com を送信できます。