GitLabセルフマネージドサブスクリプション

GitLabにサブスクライブした後、セルフマネージドサブスクリプションの詳細を管理することができます。

セルフマネージドサブスクリプションの取得

GitLabセルフマネージドインストールのためにGitLabにサブスクライブするには：

  1. カスタマーポータルにアクセスし、GitLabセルフマネージドプランをご購入ください。
  2. 購入後、Customers Portalアカウントに関連付けられたEメールアドレスにアクティビティコードが送信されます。このコードをGitLabインスタンスに追加してください。
note
既存の無料GitLabセルフマネージドインスタンスのサブスクリプションを購入する場合は、ユーザーをカバーするのに十分なシート数を購入していることを確認してください。

サブスクリプションのシート数

GitLabセルフマネージドサブスクリプションはハイブリッドモデルを採用しています。サブスクリプションの料金は、サブスクリプション期間中に有効になる最大ユーザー数に応じて支払います。オフラインまたは閉じたネットワーク上にないインスタンスでは、GitLabセルフマネージドインストールの最大同時ユーザー数は四半期ごとにチェックされます。

インスタンスが四半期ごとの利用レポートを作成できない場合、既存のトゥルーアップモデルが使用されます。四半期ごとの使用量レポートがない場合、日割り計算はできません。

ユーザー合計の表示

ライセンスのユーザーを表示し、サブスクリプションを超過していないかどうかを確認できます。

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. ユーザーを選択します。

ユーザーのリストが表示されます。

請求可能ユーザー

請求_可能な_ユーザーは、サブスクリプションのシート数に対してカウントされます。以下の例外を除き、すべてのユーザーが請求可能ユーザーとみなされます：

/admin セクションで報告されている請求可能なユーザーは、1日1回更新されます。

最大ユーザー数

_最大ユーザー_数は、現在のライセンス期間中の課金対象ユーザー数の最高値を示します。

サブスクリプションを超えるユーザー

_サブスクリプションを超過しているユーザー_数は、サブスクリプションで許可されているユーザー数を超過しているユーザー数を示します。この数は、現在のサブスクリプション期間を反映しています。

例えば

  • サブスクリプションで100人のユーザーと
  • 最大ユーザー数は150人です、

とすると、この値は50になります。

最大ユーザー数が100以下の場合、この値は0になります。

トライアルライセンスでは、Users over subscription は常に 0 と表示されます。

GitLabインスタンスにライセンス以上のユーザーを追加した場合、更新時に追加ユーザー分の支払いが発生します。

更新手続き中にこれらのユーザーを追加しない場合、ライセンスキーは機能しません。

無料ゲストユーザー

Ultimate層では、Guestロールが割り当てられたユーザーはシートを消費しません。ユーザーはインスタンスのどの場所でも、他のロールを割り当てられてはなりません。

  • プロジェクトが非公開または内部の場合、Guestロールを持つユーザーは一連の権限を持ちます。
  • プロジェクトが公開されている場合、Guestロールを持つユーザーを含むすべてのユーザーがプロジェクトにアクセスできます。
  • ユーザーの最上位ロールは非同期で更新されるため、更新に時間がかかる場合があります。
note
ユーザーがプロジェクトを作成すると、メンテナーまたはオーナーのロールが割り当てられます。ユーザーがプロジェクトを作成できないようにするには、管理者として、そのユーザーを外部ユーザーとしてマークします。

ユーザーと購読シートの管理のヒント

サブスクリプションのシート数に対してユーザー数を管理するのは難しいことです：

  • LDAPインテグレーションが有効になっている場合、設定されたドメイン内であれば誰でもGitLabアカウントにサインアップすることができます。その結果、更新時に予期せぬ請求が発生することがあります。
  • インスタンスでサインアップが有効になっている場合、インスタンスにアクセスできる人なら誰でもアカウントにサインアップできます。

GitLabにはユーザー数を管理するのに役立つ機能がいくつかあります：

購読データの同期

GitLab 14.1で導入されました。

サブスクリプションデータは、セルフマネージドインスタンスとGitLabの間で自動的に同期することができます。サブスクリプションデータの同期を有効にするには、以下のものが必要です：

  • GitLab Enterprise Edition(EE) 、バージョン14.1以降。
  • インターネットに接続でき、オフライン環境でないこと。
  • アクティベーションコードでインスタンスをアクティベートしていること。

インスタンスがアクティベートされ、データが同期されると、以下のプロセスが自動化されます：

およそ 03:00 UTC に、毎日の同期ジョブがサブスクリプションデータをカスタマーポータルに送信します。このため、更新や更新がすぐに適用されない場合があります。

データは、暗号化された HTTPS 接続を介して、ポート443のcustomers.gitlab.com に安全に送信されます。ジョブが失敗すると、約 17 時間にわたって最大 12 回再試行されます。

購読データ

毎日の同期ジョブは、以下の情報のみをカスタマー・ポータルに送信します：

  • 日付
  • タイムスタンプ
  • ライセンスキー
    • 会社名（ライセンスキー内で暗号化）
    • ライセンシー名（ライセンスキー内で暗号化）
    • ライセンシーのEメール（ライセンスキー内で暗号化）
  • 過去の最大ユーザー数
  • 請求可能ユーザー数
  • GitLabバージョン
  • ホスト名
  • インスタンスID

ライセンス同期リクエストの例：

{
  "gitlab_version": "14.1.0-pre",
  "timestamp": "2021-06-14T12:00:09Z",
  "date": "2021-06-14",
  "license_key": "eyJkYXRhIjoiYlR2MFBPSEJPSnNOc1plbGtFRGZ6M
  Ex1mWWhyM1Y3NWFOU0Zj\nak1xTmtLZHU1YzJJUWJzZzVxT3FQRU1PXG5
  KRzErL2ZNd0JuKzBwZmQ3YnY4\nTkFrTDFsMFZyQi9NcG5DVEdkTXQyNT
  R3NlR0ZEc0MjBoTTVna2VORlVcbjAz\nbUgrNGl5N0NuenRhZlljd096R
  nUzd2JIWEZ3NzV2V2lqb3FuQ3RYZWppWVFU\neDdESkgwSUIybFJhZlxu
  Y2k0Mzl3RWlKYjltMkJoUzExeGIwWjN3Uk90ZGp1\nNXNNT3dtL0Vtc3l
  zWVowSHE3ekFILzBjZ2FXSXVQXG5ENWJwcHhOZzRlcFhr\neFg0K3d6Zk
  w3cHRQTTJMTGdGb2Vwai90S0VJL0ZleXhxTEhvaUc2NzVIbHRp\nVlRcb
  nYzY090bmhsdTMrc0VGZURJQ3VmcXFFUS9ISVBqUXRhL3ZTbW9SeUNh\n
  SjdDTkU4YVJnQTlBMEF5OFBiZlxuT0VORWY5WENQVkREdUMvTTVCb25Re
  ENv\nK0FrekFEWWJ6VGZLZ1dBRjgzUXhyelJWUVJGTTErWm9TeTQ4XG5V
  aWdXV0d4\nQ2graGtoSXQ1eXdTaUFaQzBtZGd2aG1YMnl1KzltcU9WMUx
  RWXE4a2VSOHVn\nV3BMN1VFNThcbnMvU3BtTk1JZk5YUHhOSmFlVHZqUz
  lXdjlqMVZ6ODFQQnFx\nL1phaTd6MFBpdG5NREFOVnpPK3h4TE5CQ1xub
  GtacHNRdUxTZmtWWEZVUnB3\nWTZtWGdhWE5GdXhURjFndWhyVDRlTE92
  bTR3bW1ac0pCQnBkVWJIRGNyXG5z\nUjVsTWJxZEVUTXJNRXNDdUlWVlZ
  CTnJZVTA2M2dHblc4eVNXZTc0enFUcW1V\nNDBrMUZpN3RTdzBaZjBcbm
  16UGNYV0RoelpkVk02cWR1dTl0Q1VqU05tWWlU\nOXlwRGZFaEhXZWhjb
  m50RzA5UWVjWEM5em52Y1BjU1xueFU0MDMvVml5R3du\nQXNMTHkyajN5
  b3hhTkJUSWpWQ1BMUjdGeThRSEVnNGdBd0x6RkRHVWg1M0Qz\nMHFRXG5
  5eWtXdHNHN3VBREdCNmhPODFJanNSZnEreDhyb2ZpVU5JVXo4NCtD\nem
  Z1V1Q0K1l1VndPTngyc1l0TU5cbi9WTzlaaVdPMFhtMkZzM2g1NlVXcGI
  y\nSUQzRnRlbW5vZHdLOWU4L0tiYWRESVRPQmgzQnIxbDNTS2tHN1xuQ3
  hpc29D\nNGh4UW5mUmJFSmVoQkh6eHV1dkY5aG11SUsyVmVDQm1zTXZCY
  nZQNGdDbHZL\ndUExWnBEREpDXG41eEhEclFUd3E1clRYS2VuTjhkd3BU
  SnVLQXgvUjlQVGpy\ncHJLNEIzdGNMK0xIN2JKcmhDOTlabnAvLzZcblZ
  HbXk5SzJSZERIcXp3U2c3\nQjFwSmFPcFBFUHhOUFJxOUtnY2hVR0xWMF
  d0Rk9vPVxuIiwia2V5IjoiUURM\nNU5paUdoRlVwZzkwNC9lQWg5bFY0Q
  3pkc2tSQjBDeXJUbG1ZNDE2eEpPUzdM\nVXkrYXRhTFdpb0lTXG5sTWlR
  WEU3MVY4djFJaENnZHJGTzJsTUpHbUR5VHY0\ndWlSc1FobXZVWEhpL3h
  vb1J4bW9XbzlxK2Z1OGFcblB6anp1TExhTEdUQVdJ\nUDA5Z28zY3JCcz
  ZGOEVLV28xVzRGWWtUUVh2TzM0STlOSjVHR1RUeXkzVkRB\nc1xubUdRe
  jA2eCtNNkFBM1VxTUJLZXRMUXRuNUN2R3l3T1VkbUx0eXZNQ3JX\nSWVQ
  TElrZkJwZHhPOUN5Z1dCXG44UkpBdjRSQ1dkMlFhWVdKVmxUMllRTXc5\
  nL29LL2hFNWRQZ1pLdWEyVVZNRWMwRkNlZzg5UFZrQS9mdDVcbmlETWlh
  YUZz\nakRVTUl5SjZSQjlHT2ovZUdTRTU5NVBBMExKcFFiVzFvZz09XG4
  iLCJpdiI6\nImRGSjl0YXlZWit2OGlzbGgyS2ZxYWc9PVxuIn0=\n",
  "max_historical_user_count": 75,
  "billable_users_count": 75,
  "hostname": "gitlab.example.com",
  "instance_id": "9367590b-82ad-48cb-9da7-938134c29088"
}

手動でサブスクリプションの詳細を同期します。

いつでも手動で購読の詳細を同期することができます。

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. サブスクリプションを選択します。
  4. サブスクリプションの詳細]セクションで、[サブスクリプションの詳細を同期]を選択します。

ジョブがキューに入れられます。ジョブが終了すると、サブスクリプションの詳細が更新されます。

サブスクリプションを見る

管理者であれば、購読状況を確認することができます：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. サブスクリプションを選択します。

サブスクリプションページには以下の詳細が表示されます：

  • ライセンシー
  • Plan
  • アップロード日、開始日、有効期限

また、以下の情報も表示されます：

項目説明
ライセンスユーザーシステムにロードされている現在のライセンスで支払ったユーザー数です。現在のサブスクリプション期間中にシートを追加しない限り、この数は変わりません。
請求可能ユーザーシステム上の請求可能なユーザーの日次カウント。インスタンスにユーザーをブロック、非アクティブ化、または追加すると、カウントが変更される場合があります。
最大ユーザー数ロードされたライセンスの期間中、お客様のシステムで課金可能なユーザーの最高数。
サブスクリプションを超えるユーザー現在のライセンス期間のMaximum users -Users in subscription として計算されます。この数は、更新前に支払わなければならない遡及料金が発生します。

ライセンス使用量のエクスポート

GitLab 14.2で導入されました。

管理者であれば、ライセンスの使用状況をCSVにエクスポートすることができます：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. サブスクリプションを選択します。
  4. 右上の [Export license usage file] を選択します。

このファイルには、GitLabが四半期ごとの照合や更新を手動で処理するために使用する情報がコンテナされています。インスタンスがファイヤーウォールされている場合やオフライン環境の場合は、この情報をGitLabに提供する必要があります。

License UsageCSVには以下の詳細が含まれています：

  • ライセンスキー
  • ライセンシーのメールアドレス
  • ライセンス開始日
  • ライセンス終了日
  • 会社名
  • Generated at（ファイルがエクスポートされたタイムスタンプ）
  • 期間内の各日の過去のユーザー数の表：
    • カウントが記録されたタイムスタンプ
    • 請求可能ユーザー数

注意事項

  • すべての日付のタイムスタンプはUTCで表示されます。
  • CSVファイルの日付と 時刻にはカスタムフォーマットが使用されます。

購読を更新

購読の更新は、購読期限の15日前から可能です。購読を更新するには

  1. アカウントをレビューして更新の準備をしましょう。
  2. GitLabセルフマネージドサブスクリプションを更新します。

アカウントをレビューして更新の準備をしましょう。

カスタマーポータルは、サブスクリプションを更新・変更するためのツールです。更新を行う前に、サインインして確認または更新を行ってください：

  • アカウント詳細ページの請求書連絡先詳細。
  • お支払い方法のページで登録されているクレジットカード。
note
カスタマーポータルへのアクセスにサポートが必要な場合、またはサブスクリプションを管理する担当者を変更する必要がある場合は、サポートチームにお問い合わせください。

ユーザーアカウントを定期的にレビューすることが重要です：

  • 古いユーザーアカウントは課金対象ユーザーとしてカウントされる可能性があります。多くのユーザーを更新した場合、必要以上の料金を支払う可能性があります。
  • 古いユーザーアカウントはセキュリティリスクとなる可能性があります。定期的なレビューは、このリスクを軽減するのに役立ちます。

サブスクリプションを超えるユーザー

GitLabサブスクリプションは特定のシート数に対して有効です。サブスクリプションを超えるユーザー数は、現在のサブスクリプション期間のサブスクリプションのユーザー数を超える_最大ユーザー_数です。更新前、または更新時にこのユーザー数を支払う必要があります。これを_トゥルーアップ_処理と呼びます。

サブスクリプションを超えるユーザー数を表示するには、管理エリアに移動します。

サブスクリプションを超えたユーザーの例

10ユーザー分のサブスクリプションを購入します。

イベント請求可能ユーザー最大ユーザー数
10人のユーザーが10席すべてを使用します。1010
新たに2人のユーザーが参加。1212
3人のユーザーが退会し、アカウントが削除されました。912

サブスクリプションを超えるユーザー = 12 - 10 (最大ユーザー数 - ライセンス内のユーザー数)

サブスクリプションへのシート追加

サブスクリプション期間中であればいつでも、サブスクリプションにシートを追加してライセンス数のユーザーを増やすことができます。サブスクリプション期間中に追加したシートの費用は、購入日からサブスクリプション期間終了日までの日割り計算となります。

サブスクリプションにシートを追加するには

  1. カスタマーポータルにログインしてください。
  2. Manage Purchasesページに移動します。
  3. サブスクリプションカードのシート追加を選択します。
  4. 追加ユーザー数を入力します。
  5. チェックアウトに進むを選択します。
  6. サブスクリプション・アップグレードの詳細をレビューします。システムには、システム上の全ユーザーの合計金額と、すでに支払った金額のクレジットが表示されます。請求されるのは、正味の変更分のみです。
  7. アップグレードの確認] を選択します。

支払領収書はEメールで送信され、カスタマーポータルの以下の項目からもアクセスできます。 請求書を見る.

サブスクリプションがアクティベーションコードでアクティベートされている場合、追加シートはすぐにインスタンスに反映されます。ライセンスファイルを使用している場合は、更新されたファイルを受け取ります。シートを追加するには、ライセンスファイルをインスタンスに追加します。

手動でサブスクリプションを更新

サブスクリプションの有効期限が切れる30日前から、GitLabユーザーインターフェースの管理者に有効期限のバナーが表示されます。

更新の際には、以下の手順に従ってください：

  1. 更新の前に、アクティブでないユーザーや不要なユーザーをブロックしてください。
  2. 次のサブスクリプションでユーザーを増やす必要があるかどうかを判断します。

  3. カスタマーポータルにログインし、既存のサブスクリプションの下にある更新ボタンを選択します。サブスクリプションの有効期限が切れる15日前までは、[更新]ボタンは無効（グレー表示）のままです。更新ボタンの上にマウスを置くと、そのボタンがアクティビティになる日付を確認できます。

    note
    GitLabの階層を変更する必要がある場合は、カスタマーポータルではできませんので、セールスチームまでお問い合わせください。
  4. 最初のボックスには、次年度に必要なユーザーライセンスの合計数を入力してください。この数は、更新を行う時点のシステム内の請求可能ユーザー数と同じか、それ以上であることを確認してください。
  5. 2つ目のボックスには、前回の契約期間に発生したユーザー超過分のユーザー数を入力してください。
  6. 更新の詳細をレビューし、支払い手続きを完了します。
  7. 更新期間のアクティビティコードは、該当するサブスクリプションカードの「Manage Purchases」ページで入手できます。アクティベーションコードのコピー]を選択し、コピーを取得します。
  8. アクティベーションコードをインスタンスに追加します。

更新のための請求書が作成され、請求書の表示ページで表示またはダウンロードできます。更新プロセス中に問題が発生した場合は、サポートチームまでお問い合わせください。

サブスクリプションの自動更新

サブスクリプションが自動更新に設定されている場合、利用可能なサービスに空白が生じることなく、有効期限日（UTC午前0時）に自動的に更新されます。Customers Portalで購入したサブスクリプションは、デフォルトで自動更新に設定されています。ユーザ・ライセンス数は、更新時にインスタンスの請求可能ユーザ数に合わせて調整されます。自動更新の前に、更新日の2日前までに更新の準備をしておくと、更新に間に合うように変更がGitLabに同期されます。サブスクリプションを自動更新するには、サブスクリプションデータの同期を有効にしておく必要があります。

更新の請求書は、Customers Portal のView invoicesページで確認、ダウンロードできます。お客様のアカウントにクレジットカードが保存されている場合、そのカードに請求金額が課金されます。お支払いを処理できない場合、またはその他の理由で自動更新に失敗した場合、サブスクリプションの更新には14日間の猶予があります。

メール通知

購読が自動更新される15日前に、更新に関する情報を記載したメールが送信されます。

  • クレジットカードの有効期限が切れている場合は、更新方法をお知らせします。
  • 未納の超過料金がある場合、またはその他の理由でサブスクリプションが自動更新できない場合は、営業チームに連絡するか、カスタマーポータルで更新するようEメールに記載されています。
  • イシューがない場合、メールには更新される商品の名前と数量が明記されています。このメールには、お客様のお支払総額も記載されています。更新前に使用量が増減した場合、この金額は変更される可能性があります。

購読の自動更新の有効化または無効化

サブスクリプションの自動更新（前の期間と同じティア）を表示または変更するには、カスタマー・ポータルにサインインしてください：

  • 自動更新をオンにする]ボタンが表示されている場合、サブスクリプションは以前にキャンセルされています。自動更新を再開するには、このボタンを選択します。
  • 購読をキャンセル] ボタンが表示されている場合は、購読期間の終了時に購読が自動更新されるように設定されています。自動更新をキャンセルするには、このボタンを選択します。

更新手続き中に問題が発生した場合は、サポートチームまでお問い合わせください。

購読レベルのアップグレード

GitLabのティアをアップグレードするには：

  1. カスタマーポータルにログインしてください。
  2. 購入の管理ページで、該当するサブスクリプションカードのアップグレードボタンを選択します。
  3. 必要なアップグレードを選択します。
  4. アクティブな支払い方法を確認するか、新しい支払い方法を追加します。
  5. プライバシーポリシーと利用規約に同意します。
  6. 購入を選択します。

以下のようなメールが届きます：

  • 支払領収書。この情報には、カスタマー・ポータルの以下の項目からもアクセスできます。 請求書の表示.
  • ライセンスの新しいアクティビティコード。

アクティベーションコードをインスタンスに追加します。新しいライセンスがアクティベートされると、新しいティアが有効になります。

サブスクリプションの連絡先を追加または変更します。

連絡先は、サブスクリプションの更新、サブスクリプションのキャンセル、またはサブスクリプションを別のネームスペースに転送できます。

カスタマ・ポータル・アカウントのオーナーシップを別の人に譲渡する方法については、アカウント・オーナー情報の変更を参照してください。

サブスクリプションにセカンダリ連絡先を追加するには

  1. 追加するユーザーのアカウントがCustomers Portalに存在することを確認します。
  2. サポートチームにチケットを作成します。リクエストに関連資料を含めてください。

サブスクリプションの有効期限

ライセンスの有効期限が切れると、GitLabはGitプッシュやイシュー作成のような機能をロックダウンします。その後、インスタンスは読み取り専用になり、すべての管理者に期限切れのメッセージが表示されます。

GitLabのセルフマネージドインスタンスでは、これが発生するまでに14日間の猶予期間があります。

  • アクティビティを再開するには、新しいライセンスをアクティベートしてください。
  • 無料機能に戻るには、期限切れのライセンスを削除してください。

ライセンスファイルまたはキーのアクティベート

ライセンスファイルまたはキーをお持ちの場合は、管理エリアでアクティベートできます。

サポートへのお問い合わせ

また、GitLabプロジェクトの既知のイシューや既存の機能要求をプロジェクトトラッカーで検索することをすべてのユーザーにお勧めします。

これらのイシューは、特定の製品計画に関する最新情報を得たり、関連するGitLabチームメンバーと直接連絡を取ったりするための最良の手段です。

トラブルシューティング

サブスクリプションデータの同期に失敗します

同期ジョブが機能していない場合は、GitLabインスタンスからIPアドレス172.64.146.11:443 と104.18.41.245:443 (customers.gitlab.com) へのネットワークトラフィックを許可していることを確認してください。

クレジットカードが使えません

GitLabサブスクリプションの購入時にクレジットカードが拒否された場合、以下の理由が考えられます：

  • 入力されたクレジットカード情報が間違っています。
  • クレジットカード口座の残高が不足しています。
  • バーチャルクレジットカードを使用しており、残高不足、または有効期限が切れています。
  • ご利用限度額を超えています。
  • クレジットカードの利用限度額を超えています。

これらの理由が当てはまるかどうか、金融機関に確認してください。該当しない場合は、GitLabサポートにお問い合わせください。

毎日の請求可能ユーザーと過去の請求可能ユーザーの確認

管理者は、GitLabインスタンスの日次および過去の請求可能ユーザーのリストを取得することができます。

  1. Railsコンソールセッションを開始します。

  2. インスタンスのユーザー数を数えます：

    User.billable.count

  3. 過去1年間のインスタンスの過去の最大ユーザー数を取得します：

    ::HistoricalData.max_historical_user_count(from: 1.year.ago.beginning_of_day, to: Time.current.end_of_day)

日々の請求可能ユーザー数と過去のユーザー数の更新

管理者は、GitLabインスタンスの日次および過去の請求可能ユーザーを手動で更新することができます。

  1. Railsコンソールセッションを開始します。

  2. 毎日の請求可能ユーザーを強制的に更新します：

    identifier = Analytics::UsageTrends::Measurement.identifiers[:billable_users]
::Analytics::UsageTrends::CounterJobWorker.new.perform(identifier, User.minimum(:id), User.maximum(:id), Time.zone.now)

  3. 過去の最大請求可能ユーザーを強制的に更新します：

    ::HistoricalDataWorker.new.perform