Qodana Cloud を組織で購入する場合のフローとアクティブコントリビューター数のカウント方法を説明いたします。
Qodana Cloud は契約終了日の直近90日間のアクティブコントリビューター数が、次回更新時に少なくとも必要になります。（例えば契約終了日の直近90日間のアクティブコントリビューター数が20の場合、次回更新時には20以上の契約が必要になります。）このためアクティブコントリビューター数を把握しておく必要があります。
目次
購入時のフロー
- サムライズムの Qodana ページより必要なアクティブコントリビューター数分の見積もりをご依頼ください。
- ご発注/ご購入いただきましたら、購入した Qodana にアクセスするための Activation Link (URL) が JetBrains 社より届きます。
- Qodana の操作をするオーガニゼーション管理者様が Activation Link を選択して Qodana の利用を開始してください。
- 購入前に組織で Qodana トライアル版を利用していた場合：
Continue with selected と Create new organization の2つの選択肢が表示されます（selected の箇所にはトライアルで利用していた組織名が表示されます）。前者の Continue with selected を選択しますと、トライアル環境から購入した Qodana に置き換えることができます。 - 購入した Qodana を正しく利用できているかを確認するには、Qodana 右上の歯車アイコンの先にあるページの Subscription タブ配下をご参照ください。Qodana の製品名（Qodana Ultimate または Qodana Ultimate Plus） および License ID が購入したライセンスと一致していれば問題ありません。
購入した製品名と License ID は JetBrains Console の 左側のメニューより Licensing | Products and services を選択した画面の Team Tools and Services(n) タブ配下の Qodana エリアでご確認いただけます。
アクティブコントリビューター数のカウント方法
アクティブコントリビューター数の取得方法は2通りあります。
- JetBrains 社が直近 90 日間のアクティブなコントリビューターの一覧を確認し、そのメールアドレスを共有する。この方法をご希望の場合は弊社までご依頼ください。
- お客様ご自身で Qodana CLI を使用して次のコマンドを実行する。
Qodana CLI のインストール方法はこちらの Instllation 欄に記載があります。
ローカルのリポジトリに移動してターミナルでqodana contributorsを実行すると、該当リポジトリの直近90日間にコミットした ユーザー名/メールアドレス/コミット回数を取得できます。
複数のリポジトリをまとめて確認したい場合は、以下の例にあるように--project-dir以降にリポジトリのパスを記載し、それをリポジトリの数だけ記載してください。
例）qodana contributors --project-dir path/to/repo-a --project-dir path/to/repo-b
アクティブコントリビューター数に関する注意と対策
同一人物でも異なる環境からコミットした場合、別のメールアドレスとして登録される場合があります。この場合、アクティブコントリビューター数はメールアドレスの数だけカウントされます。
このことを防ぐために gitmailmap を使って複数のメールアドレスを1人のユーザーにマッピングすることができます。.mailmap ファイルは Qodana で使用しているすべてのリポジトリに作成する必要があり、コントリビューターの計算時に反映されます。
本件に関する Qodana のドキュメントは以下が該当します。
- The .mailmap file support
- .mailmap ファイルのサポート（参考：サードパーティによる日本語翻訳ドキュメント）
よくある質問
Q: Qodana Cloud のアクティブコントリビューター数が契約数を超えた場合はどのようになります
A: Qodana Cloud は契約終了日の直近90日間のアクティブコントリビューター数が次回更新時に少なくとも必要になりますが、それ以前は契約数を超えても何も影響はありません。
Q: Qodana の契約数とオーガニゼーションのメンバー（Qodana cloud -> オーガニゼーション選択 -> Setting -> Members）に登録されている人数には関連はありますか？
A: 現在の契約数と Qodana オーガニゼーションのメンバー数および登録されているユーザーとの関係は一切ありません。また、コードをコミットできるユーザーと Qodana オーガニゼーションのメンバーに登録されているユーザーとの関係も一切ありません。Qodana オーガニゼーションのメンバーには制限はなく無料で何人でもご登録いただけます。
Q: Qodana Cloud のアクティブコントリビューター数を制限する方法はありますか？
A: GitHub などのバージョン管理システムは JetBrains 社の管理配下にはないため、コミットするユーザー数を制限するといった仕組みはありません。
Q: Qodana Cloud でコントリビューター数を減らす場合、管理者が実施すべきことはありますか？
A: ライセンス費用にかかわるのは契約終了日の直近90日間のアクティブコントリビューター数になり、この計算は自動的に行われます。管理者様が何か削除をするという作業はありません。