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) に移動すると、アクションを 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がパートナー組織としてアクションの作成者を検証したことを示します。 パートナーは、検証済み作者バッジを要求する電子メール partnerships@github.com を送信できます。