GitHub Connect を使用した GitHub.com アクションへの自動アクセスの有効化

企業内の GitHub Actions が GitHub.comからのアクションを使用できるようにするには、エンタープライズ インスタンスを GitHub Enterprise Cloudに接続します。

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

Enterprise owners can enable access to public GitHub.com actions.

この記事で

メモ

GitHub Enterprise Server ホステッド ランナーは、現在 GitHub ではサポートされていません。

GitHub.com アクションへの自動アクセスについて

既定では、GitHub Actions上のGitHub Enterprise Serverワークフローでは、GitHub.comまたはGitHub Marketplaceから直接アクションを使用することはできません。 GitHub.comからのパブリック アクションをエンタープライズ インスタンスで使用できるようにするには、GitHub Connectを使用してGitHub Enterprise ServerをGitHub Enterprise Cloudと統合できます。

クラウドデプロイが GHE.comされている場合でも、 GitHub Connect は GitHub.comからパブリック アクションを解決できます。 これには GitHub Enterprise Server バージョン 3.20.6 以降、または 3.21.0 からの機能リリースが必要です。

GitHub.comからのアクションを使用するには、とGitHub Enterprise Server両方のセルフホステッド ランナーがGitHub.comへの送信接続を確立できる必要があります。 GitHub.comからの受信接続は必要ありません。 詳しくは、「セルフホステッド ランナー リファレンス」をご覧ください。

または、Enterprise 内で許可されるアクションをより厳密に制御する場合は、actions-sync ツールを使ってパブリック アクションを手動でダウンロードし、Enterprise インスタンスに同期することができます。 詳しくは、「GitHub.com からアクションを手動で同期する」をご覧ください。

GitHub Connect を使用したアクションの解決について

ワークフローが、アクションが格納されているリポジトリを参照してアクションを使用する場合、GitHub Actions は最初に お使いの GitHub Enterprise Server インスタンス でリポジトリを検索します。 リポジトリが お使いの GitHub Enterprise Server インスタンス に存在せず、GitHub.com への自動アクセスが有効になっている場合、GitHub Actions は GitHub.com でリポジトリを検索します。

ユーザーが、 GitHub.com上の組織とリポジトリ名に一致する組織とリポジトリを既に企業に作成している場合は、 GitHub.com リポジトリではなく、エンタープライズ上のリポジトリが使用されます。 詳細については、「GitHub.com でアクセスされるアクションの名前空間の自動廃止」を参照してください。

パブリック GitHub.com アクションへの自動アクセスの有効化

企業の GitHub.com からのパブリック アクションへのアクセスを有効にする前に、次の操作を行う必要があります。

  1. GitHub Enterprise Server の右上隅にあるプロフィール画像をクリックしてから、[Enterprise settings] をクリックします。
  2. ページの上部にある [ GitHub Connect] をクリックします。
  3. [ユーザーはワークフローの実行で GitHub.com からのアクションを利用できます]で、ドロップダウン メニューを使用して Enabled を選択します。
  4. GitHub Connectを有効にすると、ポリシーを使用して、企業内のリポジトリで使用できるパブリック アクションを制限できます。 詳しくは、「企業でGitHub Actionsのポリシーを適用する」をご覧ください。

GitHub.com でアクセスされるアクションの名前空間の自動廃止

GitHub Connectを有効にすると、GitHub Actionsはお使いの GitHub Enterprise Server インスタンスにフォールバックする前に各アクションのGitHub.comを検索するため、既存のワークフローの動作に変化はありません。 これにより、企業が作成したアクションのカスタム バージョンが、 GitHub.comで対応するアクションに優先して使用されるようになります。

ワークフローで意図したアクションを確実に使用し、悪用の可能性を防ぐために、GitHub.com のアクションが初めて使用されると、そのアクションに関連付けられている名前空間はエンタープライズで廃止されます。 これにより、GitHub.com のアクションの名前空間に一致する organization やリポジトリを、ユーザーがエンタープライズに作成できなくなります。

GitHub.comからのアクションを使用した後、同じ名前のお使いの GitHub Enterprise Server インスタンスでアクションを作成する場合は、まず、その組織とリポジトリの名前空間を使用できるようにする必要があります。

  1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅にある をクリックします。

  2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。

  3. 左側のサイドバーの [サイト管理者] で、 [廃止された名前空間] をクリックします。

  4. お使いの GitHub Enterprise Server インスタンスで使用する名前空間の右側にある [リタイア] をクリックします。

  5. 関連する組織に移動し、新しいリポジトリを作成します。

    ヒント

    名前空間の廃止を取り消す場合は、できるだけ早くその名前の新しいリポジトリを必ず作成してください。 ローカル リポジトリを作成する前に、ワークフローが GitHub.com に関連付けられたアクションを呼び出すと、名前空間は再び廃止されます。 頻繁に実行されるワークフローで使用されるアクションの場合、ローカル リポジトリを作成する前に名前空間が再び廃止される場合があります。 この場合、新しいリポジトリを作成するまで、関連するワークフローを一時的に無効にすることができます。