大規模なコストの管理と追跡

コストセンターは、 GitHub コストを会社の財務構造にマッピングすることで追跡および制御するのに役立ちます。

このチュートリアルでは、ユーザーインターフェイスと REST API の両方を使用してコストセンターを計画、作成、管理する方法について説明します。これにより、組織のニーズに最も適したアプローチを決定できます。

1. コストセンター戦略を計画する

コストセンターを使用すると、 GitHub リソース (ユーザー、組織、リポジトリ) をグループ化して、個別のコスト追跡とレポートを作成できます。各コストセンターは、個別のエンティティとしてコストを報告または管理する会社のセグメントを表す必要があります。

Azure請求を使用する場合は、各コストセンターに異なる請求 ID を割り当てることができます。

必要なコストセンターを特定する

最適な戦略は、財務報告構造と GitHub のセットアップの両方の複雑さに依存します。最も簡単なアプローチから始めます。後でいつでもコストセンターを追加できます。

コストセンターを計画するには、次の手順に従います。

       **財務エンティティへのマップ**: 内部的に追跡する財務エンティティ (部門、部署、プロジェクト チームなど) ごとに 1 つのコスト センターを作成します。

       **ユーザーの識別**: 各財務エンティティに属するユーザーを一覧表示します。 コスト センターにユーザーを直接割り当てると、ライセンスと製品の使用状況が正しく割り当てられます。

       **組織を特定**する: 各財務エンティティに属する組織を一覧表示します。 組織をコスト センターに割り当てると、アクション、 Codespaces、パッケージ、およびその他の製品の使用状況が正しく割り当てられます。

       **複数の所有権を特定**する: 組織に異なる財務エンティティが所有するリポジトリが含まれている場合は、関連するコスト センターに個々のリポジトリを割り当て、組織の割り当てを解除する計画を立てます。

ヒント

ユーザーがコストセンター A に直接割り当てられ、組織メンバーシップによってコストセンター B の間接的な部分に割り当てられている場合、ライセンス製品のすべてのコストがコストセンター A に割り当てられます。詳細と例については、コストセンターでのさまざまな製品の割り当てを参照してください。

2. UI でコストセンターを作成する

次に、ユーザーインターフェイス (UI) を使用して最初のコストセンターを作成し、コストセンターのしくみを理解します。例として特定したコストセンターのいずれかを選択します。小規模な金融エンティティから始めるのが最善です。

企業ページに移動してください。たとえば、GitHub.com の [Enterprise] ページから。
ページの上部にある [Billing and licensing] をクリックします。

       **[コスト センター]** をクリックします。

右上隅にある [New cost center] (新しいコストセンター) をクリックします。
[名前] の下のテキストボックスに、コストを追跡する財務エンティティの名前を入力します。
必要に応じて、この財務エンティティに別のAzure サブスクリプションがある場合は、Azure サブスクリプションをコストセンターに追加して、使用量を直接課金できます。資格情報は、Azureに対して検証され、アカウントに関連付けられているAzure ID が使用可能であることを確認します。
[ リソース] で、このコストセンターの一部として追跡するユーザー、組織、リポジトリを選択します。

       **[Create cost center]** (コスト センターの作成) をクリックします。

新しいコストセンターがアクティブになり、使用量がすぐにコストセンターに属性付けされ始めます。今後の請求レポートには、このコストセンターが含まれます。このコストセンターには、割り当てられた使用量の cost_center_name 列にエントリが含まれます。また、このコストセンターで使用状況グラフをフィルター処理することもできます。

3. 予算を設定してコストを管理する

コストセンターを作成すると、さまざまな財務エンティティのコストを個別に追跡できます。コストを実際に制御するには、コストセンターに予算を適用する必要があります。

予算について

予算を使用すると、支出を制御できます。各予算:

1 つの組織、リポジトリ、コストセンター、または企業全体に適用されます
1 つの有料製品、SKU、または SKU のグループの毎月の使用量を制御します
使用量を停止するか、予算の上限に達したときにのみアラートを生成するように構成できます
予算制限に近づくと、アカウント所有者、課金マネージャー、および指名されたユーザーにアラートを送信できます

コストセンターの予算を計算する

内部財務計画で、このコストセンターの GitHub に 1 か月の予算を割り当てる場合は、このチームが使用する製品全体に配分する必要があります。

       **固定ライセンス コストを計算する**: チームが既に GitHub Enterprise、 GitHub Copilot、 GitHub Secret Protection and GitHub Code Securityに使用しているライセンスのコストを加算します。

       **変動予算の計算**: 内部予算からライセンス コストを減算します。 残りの金額は、プランに含まれるものを超えて使用量ベースの製品に割り当てることができる金額です。

コストセンターの予算を作成する

各製品、SKU、またはSKUのグループごとにコスト管理のための予算を作成してください。

[課金とライセンス] タブで、 Budgets とアラート をクリックして、既存の予算を表示します。
[ 新しい予算 ] をクリックして、[新しい毎月の予算] ページを開きます。
[予算の種類] で、 製品レベルの予算、 SKU レベルの予算、または バンドルされた Premium 要求の予算を選択します。
- 製品レベルでの支出を制限するには、[製品レベルの予算] で、ドロップダウンから製品を選択します (たとえば、 Codespaces)。
- SKU レベルでの支出を制限するには、[SKU レベルの予算] で、製品と SKU (たとえば、 Copilot と Premium 要求 Copilot ) を選択します。
- すべての Premium 要求の使用を制限するには、"バンドルされた Premium 要求の予算" を使用します。
[ 次へ]: [予算 スコープ] を表示するように予算を構成し、この予算の支出範囲を先ほど作成したコストセンターに設定します。
[予算] で、予算金額を設定します。予算の上限に達したら、使用量と追加の支出を停止するには、[予算の上限に 達したときに使用量を停止する] を選択します。これは、ライセンスベースの製品では使用できません。
使用量が予算目標の 75%、90%、100% に達したときにアラートを受信するには、[アラート] の下にある [ 予算しきい値アラートの受信 ] を選択します。アカウント所有者、課金マネージャー、および指定された追加の受信者は、電子メールで通知されます。オプトアウトはいつでも可能です。

[アラート受信者] で、アラートを受信する追加の受信者を選択します。

       **[予算の作成]** をクリックします。

競合の既存の予算を確認する

コストセンター予算を作成したら、既存のエンタープライズ全体の予算を確認して、新しいコストセンター予算と競合したり上書きしたりしないようにします。

[予算とアラート] ページに移動します。予算の 2 つの一覧が表示されます。

        **エンタープライズ予算: エンタープライズ** アカウント全体に適用される制限

        **その他の予算**: 特定のリポジトリ、組織、またはコスト センターの制限

エンタープライズ予算を確認する

エンタープライズ予算が、新しいコストセンター予算と同じ製品または SKU に適用されるかどうかを確認します。エンタープライズ予算が非常に低い場合は、コストセンターの独自の予算に達する前に、コストセンターの使用がブロックされる可能性があります。競合するエンタープライズ予算を削除または調整することを検討してください。

コストセンターの予算を表示する

その他の予算リストをフィルター処理して、 コストセンターのスコープを表示します。あなたの新しいコストセンターには、作成した各予算に対応する行が表示されるはずです。最初は使用量は 0 に近くなりますが、数日以内に、ユーザーとリポジトリがプランの許容量を超えて製品を消費するため、コストが蓄積されます。

4. REST API を使用してコストセンターを作成する

ユーザーインターフェイスでコストセンターを作成する方法を理解したら、REST API を調べて、コストセンターをプログラムで作成する方法を確認できます。 API を理解することは、自動化が組織に利益をもたらすかどうかを評価するのに役立ちます。

このセクションでは、 GitHub CLIを使用したコストセンター管理の主要な REST API エンドポイントについて説明します。 GitHub CLIのインストールとこれらのエンドポイントへのアクセスの認証の詳細については、GitHub REST API のクイックスタートを参照してください。

メモ

次の例では GitHub CLIを使用していますが、rest API 呼び出しをサポートする curl または任意の HTTP クライアントを使用するようにこれらのコマンドを調整できます。

既存のコストセンターをすべて一覧表示する

まず、企業内のすべてのコストセンターを取得して、既に存在するものを確認します。この単純な要求を使用すると、企業の課金を管理するために正しく認証されていることを確認できます。

ターミナルで次のコマンドを実行し、ENTERPRISEを企業のスラッグ（識別子）に置き換えます。

Shell

gh api \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers

gh api \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers

応答には、このチュートリアルで先ほど作成したコストセンターを含め、企業で作成されたすべてのコストセンターが含まれます。この例では、企業には 1 つのコストセンター "Octocenter" があり、組織と 2 人のユーザーが割り当てられます。

{
  "costCenters": [
    {
      "id": "33635e2c-edc0-40b8-abea-261839ff73c1",
      "name": "Octocenter",
      "state": "active",
      "resources": [
        {
          "type": "User",
          "name": "monalisa"
        },
        {
          "type": "Org",
          "name": "doctocat-org"
        },
        {
          "type": "User",
          "name": "doctocat"
        }
      ]
    }
  ]
}

新しいコストセンターを作成する

名前を指定して、新しいコストセンターを作成します。このコストセンターの管理に使用する一意の識別子を受け取ります。

ターミナルで次のコマンドを実行し、 ENTERPRISE と NAME を適切な値に置き換えます。

Shell

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers \
   -f 'name=NAME'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers \
   -f 'name=NAME'

応答には、新しいコストセンターの識別子が含まれます。このコストセンターで将来のすべての操作にこの id を使用する必要があります。

{
  "id": "3312fdf2-5950-4f64-913d-e734124059c9",
  "name": "NAME",
  "state": "active",
  "resources": []
}

コストセンターにリソースを追加する

コストセンターにユーザー、組織、リポジトリを割り当てます。この例では、複数のユーザーと組織を追加する方法を示します。

ターミナルで次のコマンドを実行し、 COST_CENTER_ID を前の手順の識別子に置き換え、 ENTERPRISE、 NAME、 ORG を適切な値に置き換えます。

Shell

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers/COST_CENTER_ID/resource \
  --input - <<< '{
  "users": [
    "NAME-1",
    "NAME-2"
  ],
  "organizations": [
    "ORG-1"
  ]
}'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers/COST_CENTER_ID/resource \
  --input - <<< '{
  "users": [
    "NAME-1",
    "NAME-2"
  ],
  "organizations": [
    "ORG-1"
  ]
}'

応答は、リソースの正常な追加を確認します。リソースが以前に別のコストセンターに割り当てられている場合は、 reassigned_resources 配列に一覧表示されます。

{
  "message": "Resources successfully added to the cost center.",
  "reassigned_resources": [
    {
      "resource_type": "User",
      "name": "monalisa",
      "previous_cost_center": "Octocenter"
    }
  ]
}

エンドポイントが Problems parsing JSONで応答する場合は、JSON 検証コントロールを使用して、 --input オプションで指定されたデータが有効であることを確認します。

5. REST API を使用して予算を設定する

予算をプログラムで作成して、作成したコストセンターに支出管理を適用できます。これは、Premium 要求などの使用量ベースのコストを大規模に管理する場合に特に便利です。

Premium 要求の予算を作成する

この例では、 Copilot Premium 要求の SKU レベルの予算を作成し、それを新しいコストセンターに適用する方法を示します。これにより、このコストセンターのリソースによる Premium 要求の使用に対する使用制限を設定できます。

ターミナルで次のコマンドを実行し、 ENTERPRISE、 COST_CENTER_ID、 USERNAME、 1000.0 を適切な値に置き換えます。

Shell

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/budgets \
  -f budget_type='SkuPricing' \
  -f budget_product_sku='copilot_premium_request' \
  -f budget_scope='cost_center' \
  -f budget_entity_name='COST_CENTER_ID' \
  -F budget_amount=1000.0 \
  -F prevent_further_usage=true \
  -f budget_alerting='{"will_alert":true,"alert_recipients":["USERNAME"]}'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/budgets \
  -f budget_type='SkuPricing' \
  -f budget_product_sku='copilot_premium_request' \
  -f budget_scope='cost_center' \
  -f budget_entity_name='COST_CENTER_ID' \
  -F budget_amount=1000.0 \
  -F prevent_further_usage=true \
  -f budget_alerting='{"will_alert":true,"alert_recipients":["USERNAME"]}'

応答は、予算が作成されたことを確認し、その構成を返します。この予算では、 prevent_further_usage と will_alert の両方が trueに設定されていることに注意してください。 octocat@github.comメールアドレスは、予算制限に近づくとアラートを受け取り、1,000 USD に達するとコストセンターリソースの使用量がブロックされます。

{
  "id": "budget-uuid-here",
  "budget_type": "SkuPricing",
  "budget_product_sku": "copilot_premium_request",
  "budget_scope": "cost_center",
  "budget_entity_name": "3312fdf2-5950-4f64-913d-e734124059c9",
  "budget_amount": 1000.0,
  "prevent_further_usage": true,
  "budget_alerting": {
    "will_alert": true,
    "alert_recipients": [
      "octocat"
    ]
  }
}

ヒント

同じコストセンターに対して複数の予算を作成して、異なる製品または SKU を個別に制御できます。たとえば、 Copilot Premium 要求、 GitHub Actions コンピューティング、および Codespaces 使用量に対して個別の予算を設定できます。「GitHub製品名とSKU番号」を参照してください。

6. 自動化するかどうかを決定する

このチュートリアルでは、コストセンターを作成するための 2 つの方法を示しました。ハンズオン管理にはユーザーインターフェイスを使用し、プログラムによる管理には REST API を使用します。両方の方法を理解することは、組織に適した方法を決定するのに役立ちます。

          **ユーザー インターフェイス**は、次の場合に最適です。

最初のいくつかのコストセンターを設定する
既存のコストセンターを随時更新する
変更の視覚的な確認を優先する

管理するコストセンターは少ない

        **REST API** は、次の場合に価値があります。

複数のコストセンターを定期的に作成または更新する必要がある
コストセンター管理を既存の財務システムと統合するか、外部データソースから構成を生成する必要がある
組織構造 (チームメンバーシップや部署構造など) を反映するためにコストセンターが必要
ユーザーがロールを変更したり、チーム間を移動したりすると、コストセンターの割り当てを自動的に維持する必要がある

自動化のオプション

自動化が組織にとって有益であると判断した場合、このチュートリアルの REST API の例では、カスタムスクリプトを構築するための基礎を提供します。その他のエンドポイントの詳細については、請求の REST API エンドポイントを参照してください。

チームメンバーシップに基づいてコストセンターを自動化する場合、または Premium 要求のコストを制御するための 2 層モデルを作成する場合、 GitHub Cost Center Automation では、ニーズに合わせて調整できるアクションワークフローを使用した完全な実装が提供されます。

次のステップ

使用状況とコストのレポートを自動化するために使用できるエンドポイントについては、 REST API を使用した使用状況レポート作成の自動化を参照してください。

すべてのアクセスをブロックする有料製品がある場合は、エンタープライズポリシーを使用して機能を無効にすることができます。「エンタープライズポリシー」を参照してください。

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

この記事で

1. コストセンター戦略を計画する

必要なコストセンターを特定する

2. UI でコストセンターを作成する

3. 予算を設定してコストを管理する

予算について

コストセンターの予算を計算する

コストセンターの予算を作成する

競合の既存の予算を確認する

エンタープライズ予算を確認する

コストセンターの予算を表示する

4. REST API を使用してコストセンターを作成する

既存のコストセンターをすべて一覧表示する

新しいコストセンターを作成する

コストセンターにリソースを追加する

5. REST API を使用して予算を設定する

Premium 要求の予算を作成する

6. 自動化するかどうかを決定する

自動化のオプション

次のステップ