Qodana 2026.1 ヘルプ

TeamCity

Qodana は、TeamCity で Qodana ビルドランナーとして使用できます。使用を開始するには、次の前提条件を満たす必要があります。

  • TeamCity をプロジェクトのビルドサーバーとして使用します。そうでない場合は、TeamCity のドキュメントでその方法を学習してください。

  • プロジェクト言語は、完全にサポートされているテクノロジのリストに含まれています。

  • Qodana の Docker イメージを使用して独自の TeamCity エージェントを実行する場合は、エージェントマシンに Docker がインストールされ、TeamCity を実行しているユーザーがアクセスできることを確認してください。JetBrains でホストされている TeamCity エージェントは、すでにこの条件を満たしています。

Qodana クラウド

Qodana は、Qodana Cloud によって生成されたプロジェクトトークンを使用します。このトークンは、有料の Qodana リンターでは必須であり、コミュニティリンターで使用する場合はオプションです。Qodana Cloud UI でプロジェクトトークンを生成する方法については、次のセクションを参照してください。

  • プロジェクト設定セクションでは、Qodana Cloud を初めて使用する際にプロジェクトトークンを生成する方法について説明します。

  • プロジェクトを管理するセクションでは、既存の Qodana Cloud 組織内でプロジェクトトークンを作成する方法について説明します。

基本構成

  1. TeamCity UI で、Qodana を実行するビルドの構成ページに移動します。

  2. ビルド設定ページで、ビルドステップページに移動します。

  3. ビルドステップページで、ビルドステップを追加ボタンをクリックしてください。

  4. 開いたページで、Qodana ランナーを選択します。

  5. 新しいビルドステップ: Qodana ページで、高度なオプションを表示をクリックし、Qodana ランナーを構成します。

    • ステップ名は、他のビルドステップの中でこのステップを一意に識別します。

    • ステップ ID は、他のビルドステップの中でこのステップを一意に識別します。

    • ステップ実行は、このビルドステップをトリガーするビルド条件を構成します。

    • 作業ディレクトリはビルドプロセスのディレクトリを設定します。詳細については、TeamCity のドキュメントを参照してください。バージョン管理設定タブで Checkout directory パラメーターが指定されている場合は、このフィールドを空のままにすることができます。

    • レポート ID はレポートを一意に識別し、単一のビルド内で複数の分析ステップが構成されている場合に複数のレポートを区別できるようにします。

    • レポートを TeamCity テストに転送するチェックボックスは、TeamCity UI の「テスト」タブで Qodana レポートの可用性を構成します。このオプションを使用すると、検出された他の問題とともにコードベースの問題を表示できます。

    • リンターQodana リンターを構成します。

      ここで、実行するリンターを指定します。

    • バージョンはデフォルトで Latest に設定されています。

    • インスペクションプロファイル:インスペクションプロファイルを定義します:

    • クラウドトークンは、Qodana Cloud で生成されたプロジェクトトークンを構成します。

    • 追加の Docker 引数は、Docker イメージによって受け入れられる引数を設定します。詳細については、構成オプションセクションを参照してください。

    • 追加の Qodana 引数を使用すると、デフォルトの Qodana 機能を拡張できます。詳細については、オプションの種類セクションを参照してください。

    • Qodana CLI バージョンでは、使用する Qodana CLI(英語) バージョンを指定できます。

    Configuring the Qodana runner
  6. 保存ボタンをクリックしてください。

品質ゲートとベースライン

Qodana ランナー構成の追加の Qodana 引数フィールドを使用して、品質ゲートベースライン機能を構成できます。

  • 品質ゲートを構成するための --fail-threshold <number> オプション

  • ベースラインを構成するための --baseline <path/to/qodana.sarif.json> オプション

両方のオプションを設定するには、追加の Qodana 引数フィールドでスペース文字を使用して区切ります。

--fail-threshold <number> --baseline <path/to/qodana.sarif.json>

プルリクエストと特定のブランチを分析する

プルリクエストとマージリクエストを分析するための TeamCity の構成に関する情報は、TeamCity ドキュメントポータルで入手できます。

特定のブランチを分析する方法については、TeamCity ドキュメントのトリガー設定セクションを参照してください。

設定スクリプトを追加する

Qodana リンターのカスタムプロファイル構成は、 qodana.yaml ファイルに保存されます。CI システムを使用する場合は、このファイルを手動で作業ディレクトリに配置する必要があります。または、自動的にそれを実行するスクリプトを作成することもできます。

  1. TeamCity UI で、Qodana を実行するビルドの構成ページに移動します。

  2. ビルド設定ページで、ビルドステップページに移動します。

  3. ビルドステップページで、ビルドステップを追加ボタンをクリックしてください。

  4. 開いたページで、Command line ランナーを選択します。

  5. TeamCity ドキュメントポータルの説明に従って、Command line ランナーを構成します。

    Expanding all configuration options of the Command Line runner
  6. カスタムスクリプトフィールドに、作業ディレクトリにカスタム qodana.yaml ファイルを追加するスクリプトを貼り付けます。以下の例では、スクリプトによって次のインスペクション除外が構成ファイルに追加されます。

    #!/bin/sh FILE="./qodana.yaml" /bin/cat <<EOM >$FILE exclude: - name: Annotator - name: AnotherInspectionId paths: - relative/path - another/relative/path - name: ProhibitedDependencyLicense EOM

分析結果の検証

ビルドを構成して実行したため、Qodana クラウドで分析結果を調べることができます。

または、TeamCity UI を使用して分析結果を表示することもできます。次の手順に従います。

  1. プロジェクトビルドページに移動します。概要タブで、ビルドエントリをクリックします。

    Navigating to the build entry
  2. ビルドページで「Qodana」タブに移動すると、分析レポートが表示されます。Qodana レポートの詳細については、このドキュメントの「分析レポート」セクションを参照してください。

    Navigating to the Qodana tab
2026 年 3 月 20 日

関連ページ:

TeamCity ドキュメントホーム

CI サーバー TeamCity の使い方や高等テクニック満載の JetBrains 日本語公式ヘルプ。最新の英語版ヘルプ内容が随時反映されます。

プロジェクトトークン

一般に利用可能な有料リンターでは、Qodana の実行中に変数を使用してプロジェクトトークンを提供する必要があります。例:qodana scan \ -e QODANA_TOKEN=

クイックスタート

現行バージョンの Qodana(2026.1)では、様々なプログラミング言語や技術を用いたソフトウェアを解析できます。また、利用可能な機能を使って、デフォルトの Qodana 設定を拡張することも可能です。例として、このセクションでは、以下を使用して Qodana の操作をすぐに開始できる方法について説明します。JetBrains IDE、コマンドラインインターフェース、GitHub アクション、Gradle プラグインとして、前提条件:Qodana Cloud でプロジェクトを設定する Qod...

プロジェクト

プロジェクトは Qodana レポートを蓄積します。各プロジェクトはプロジェクトトークンによって一意に識別されます。プロジェクトの作成:新しい組織を作成する際、Qodana Cloud は最初のプロジェクトの設定を支援するため、これらの手順は追加のプロジェクトを作成する場合にのみ関連します。チームページで、ボタンをクリックします。プロジェクトのセットアップ段階を完了します。この段階の詳細については、前提条件セクションを参照してください。プロジェクトを管理する:プロジェクトが作成された後、その...

ビルド構成の作成と編集

ビルド構成とパイプラインは、実際の CI/CD ルーチンを表します。ビルド構成には、一連のビルドステップ(ビルド実行中に実行される基本操作)と、これらのステップの実行に必要な設定が格納されます。これらの設定には以下が含まれます。構成の動作をすばやく変更できるパラメーター。特定の条件が満たされたときに TeamCity が自動的に新しいビルドを開始できるようにするトリガー。構成の機能を拡張する機能を構築します。特定のビルドエージェントで構成ビルドを実行できるようにするエージェント要件。その他。ビル...

ビルドステップの設定

ビルドステップは、CI/CD ワークフローの最小単位です。ビルドステップは、全体として実行される一連のアクションを定義します。ビルドステップは、ビルド構成とパイプラインジョブに属します。構成とパイプラインのビルドステップ:TeamCity は、.NET、Maven、NAnt、Xcode などの特定のビルドツール用に設計された幅広いビルドステップを提供します。現在、ビルド構成ではすべてのステップが利用可能です。バージョン 2025.07 で導入された