はじめに

筆者は現在、社内のGitリポジトリ基盤として GitHub Enterprise Server の導入検証をしています
その中で、ライセンスの同期を主な目的として GitHub Connect などの調査や設定を進めており、その結果を基に情報をまとめています

構成

大まかな構成としては以下。

EMU（Enterprise Managed User）でCloud版のユーザを発行
Cloud版を Server版と GitHub Connect で連携し、ライセンス利用状況を同期できる状態に
- 主に開発面で利用するのは Server版の予定

ユーザについて

Cloud版へのアクセス管理方法として、

個人用アカウントにアクセス権を付与する方法
EMU（Enterprise Managed User）を、IdP経由で発行する方法

などがありますが、今回の話は後者を前提としています。

なお、「ユーザーの発行方法」と「ライセンス数の管理」は独立した仕組みです。どちらの方式であろうと、ライセンスキー発行やseat数のカウントにおける影響はありません。（ライセンスキーやseat数に関しては後述）

ライセンスモデルについて

GitHub Enterprise のライセンスモデルには、

GHE（従量課金制）
GHE（ボリューム/サブスクリプション、GHE Unified）

という2種類がありますが、今回の話は前者を前提としています。

後者の場合は、Cloud版のコンソールからではなく、GitHubセールスからライセンスキーを頂く形となります。

GitHub Connect とは何か？

そもそも、GitHub Connect についてご存じない方も多いと思います。

GitHub Connect を使用することで、Cloud版とServer版を連携することができます。

GitHub Connect を有効にしたら、どの機能を有効にするかを選べます。たとえば、次のようなことができます。

環境間でライセンスの利用状況を自動的に同期する

検索結果とユーザーコントリビューションデータを統合する

GitHub.com に依存する機能を有効にする。これには、GitHub Advisory Database で追跡されるセキュリティの脆弱性に対する Dependabot alerts などが含まれます。

実際に困ったことやポイントの紹介

ライセンス管理で発生した課題

GitHub Enterpriseでは、ユーザーを「seat数」という単位で管理しています。当初は「Server版でユーザ発行をして、Cloud版とGitHub Connectで繋げるだけ（Cloud版ではユーザを発行する必要はない）」という理解でしたが、実際には以下の手順が必要であることが判明しました

Cloud版でユーザ発行（Server版と同様のユーザ数）
そのユーザ数（seat数）に基づいた、Server版用のライセンスキーの発行
ライセンスキーをServer版に適用

という手順が必要であることが判明しました。

具体的なライセンスキーのダウンロード方法については、以下ドキュメントに記載があります。

なお、ライセンスの仕様に関しては以下ドキュメントが参考になります。

Cloud版でのライセンスキーの発行について

ライセンスキーを発行する際には、1つ注意点があります。

Cloud版でライセンスキーを発行する際には、お使いのCloud版にOrganizationの作成が必要という点です。

これは、Organizationが存在しない場合、Enterprise所属のユーザーが存在しないためライセンスキーを発行できない仕様と考えられます。

もし「Cloud版はライセンス数把握を目的として使うので、Cloud版側での手間を増やしたくない」といった場合は、Server版からファイルアップロードする手段もあります。

GitHub Connectを有効化したくない場合は、GitHub Enterprise ServerからファイルをGitHub.comにアップロードすることによって、手動でライセンスの利用状況を同期できます。

参考文献

その他、GitHub Connect や EMU に関しては以下の記事も参考にさせていただきました。