GitHub Actions で Azure コストを毎朝 Teams に自動通知してみたー手順と解説ー

はじめに

こんにちは！最近 Azure のコスト管理を自動化するのにはまっている横浜情報機器株式会社インターン生のロホマンシャヒンです。

ロホマンシャヒン

Microsoft Student Ambassador
GitHub Copilot User Group Japan 運営
Azure Solutions Architect Expert 取得

「Azure のコスト、今月いくらかかってるんだっけ？」と毎朝ポータルを開いて確認するのが地味に面倒で、何とかしたいと思っていました。Azure Cost Management の REST API と GitHub Actions を組み合わせたら、毎朝 Teams に Adaptive Card で届くようになったので、その手順をまとめます。

コードはほぼゼロから書いて、外部ライブラリも不要な構成にしました。Python 標準ライブラリだけで動きます。

1. 全体構成と仕組み

正直、最初は「GitHub Actions でコスト取得なんてできるの？」と思っていました。やってみたら思ったよりシンプルで、構成はこんな感じです。

Azure Cost Management REST API — サブスクリプションの月累計コストとサービス別 Top 7 を取得
GitHub Actions — 毎朝 9:00 JST（UTC 00:00）にスケジュール実行
Python スクリプト — 標準ライブラリだけで API 呼び出しと Adaptive Card の組み立て
Teams Incoming Webhook — Power Automate 経由で Adaptive Card を Teams チャンネルに投稿
API（任意）— コストデータを AI 分析して推奨事項を付記

GitHub Secrets に Azure の認証情報と Teams の Webhook URL を登録しあわせておくだけで動きます。CI/CD パイプラインと同じリポジトリで管理できるのが地味に便利で、「どこで動いてるんだっけ」問題が起きません。

GitHub Actions → Azure Cost Management → Teams の全体フロー図

2. リポジトリの構成を確認する

今回作成したリポジトリ azure-cost-daily-report は以下の構成です。

azure-cost-daily-report/
├── .github/
│   └── workflows/
│       └── daily-cost-report.yml    # GitHub Actions ワークフロー
├── scripts/
│   └── daily_cost_report.py         # メインスクリプト
└── README.md

ワークフローファイル（.github/workflows/daily-cost-report.yml）：

name: Daily Azure Cost Report → Teams

on:
  schedule:
    # 毎朝 9:00 JST (= UTC 00:00) に実行
    - cron: "0 0 * * *"
  workflow_dispatch: # 手動実行も可能

jobs:
  cost-report:
    runs-on: ubuntu-latest
    permissions:
      contents: read

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Send daily cost report to Teams
        env:
          AZURE_TENANT_ID: ${{ secrets.AZURE_TENANT_ID }}
          AZURE_CLIENT_ID: ${{ secrets.AZURE_CLIENT_ID }}
          AZURE_CLIENT_SECRET: ${{ secrets.AZURE_CLIENT_SECRET }}
          AZURE_SUBSCRIPTION_ID: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
          TEAMS_WEBHOOK_URL: ${{ secrets.TEAMS_WEBHOOK_URL }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
        run: python scripts/daily_cost_report.py

cron: "0 0 * * *" が UTC の 0 時、つまり JST の朝 9 時に実行されます。workflow_dispatch を入れておくと GitHub の Actions タブから手動実行もできて、テスト時に便利でした。

3. サービスプリンシパルを作成する（Entra ID App Registration）

GitHub Actions から Azure API を叩くには、サービスプリンシパル（アプリ登録）が必要です。

Azure Portal を開き、「Microsoft Entra ID」 → 「アプリの登録」 → 「新規登録」 をクリック
名前を入力（例：azure-cost-daily-reports）して登録

登録が完了すると、アプリケーション (クライアント) ID と ディレクトリ (テナント) ID が表示されます。この 2 つは後で GitHub Secrets に使うので、画面を閉じる前に必ずコピーしておいてください。ちなみに「テナント ID ってどこだっけ」と迷ったら、ここの概要ページに両方あります。

4. クライアントシークレットを取得する

アプリ登録の左メニューから 「証明書とシークレット」 を開き、「新しいクライアントシークレット」 を作成します。

説明と有効期限を入力して「追加」をクリック。

作成直後だけシークレットの 「値」 が表示されます。この画面を離れると二度と確認できないので、必ずここでコピーしてください。

⚠️ 注意：シークレット値はこの画面を閉じると見えなくなります。コピー漏れに注意。

5. Teams Incoming Webhook を設定する

Teams でコストレポートを受け取るチャンネルに Incoming Webhook を追加します。

Teams のチャンネル右上「…」→ 「コネクタ」 または 「ワークフロー」 を開く
「Incoming Webhook」を選択して設定を進める
Webhook の名前（例：Azure Cost Report）を入力
生成された Webhook URL をコピー

Webhook 設定完了 ─「Webhook リンクをコピー」で URL を取得

メモ：Teams の「ワークフロー」で作成した場合、Power Automate 経由の Webhook になります。このスクリプトでは Power Automate 形式（attachments でラップする形式）に対応済みです。

6. GitHub Secrets を登録する

リポジトリの 「Settings」→「Secrets and variables」→「Actions」 を開き、以下の 5 つのシークレットを追加します。

GitHub Settings サイドバーの「Secrets and variables」を展開

シークレット名	値
`AZURE_TENANT_ID`	Entra ID のテナント ID
`AZURE_CLIENT_ID`	アプリ登録のクライアント ID
`AZURE_CLIENT_SECRET`	作成したクライアントシークレットの値
`AZURE_SUBSCRIPTION_ID`	対象サブスクリプションの ID
`TEAMS_WEBHOOK_URL`	Teams の Webhook URL