グローバル構成

グローバル設定を使用すると、Qodana の設定を複数のプロジェクト間で共有できます。各グローバル設定は、 qodana.yaml 設定ファイルとインスペクションプロファイル設定（YAML および XML ファイル）で構成されるファイルセットです。

この機能は、Ultimate Plus ライセンスで利用できます。

グローバル構成の仕組み

YAML 形式の構成ファイルは、VCS リポジトリのプロジェクトディレクトリに保存されます。例: プロジェクトは、グローバル構成を作成する次の構造を持つことができます。

root/
    project-a/
        qodana.yaml
    project-b/
        qodana.yaml
        project-b-profile.yaml
    qodana-global-configurations.yaml    

この構造では、project-a ディレクトリと project-b ディレクトリに Qodana 構成ファイルが含まれています。さらに、project-b ディレクトリには、カスタムプロファイルを含む project-b-profile.yaml ファイルが含まれています。このファイルをグローバル設定に含めるには、たとえば同じディレクトリにある qodana.yaml ファイルから参照する必要があります。

qodana-global-configuraton.yaml ファイルは、特定のフィールドを使用してグローバル構成を記述します。

configurations:
    - id: project_a
      name: Project A # Displayed in Qodana Cloud UI
      description: Description for configuration project A # Displayed in Qodana Cloud UI
      qodanaYaml: project-a/qodana.yaml # Path to the config file relatively to file

    - id: project_b
      name: Project B
      description: Description for configuration project B
      qodanaYaml: project-b/qodana.yaml
        

CI/CD パイプラインはアップローダーツールと設定トークンを使用してこれらのファイルを Qodana Cloud に送信します。これにより、グローバル設定が Qodana Cloud プロジェクトに接続され、プロジェクト分析中に Qodana リンターがグローバル設定を取得して使用します。

各グローバル設定は、単一の Qodana Cloud 組織内の複数のプロジェクトで使用できます。各組織は 1 つまたは複数のグローバル設定を持つことができ、各プロジェクトは 1 つのグローバル設定またはプロジェクト設定（あるいはその両方）を使用して設定できます。

グローバル構成に含まれるファイルは、VCS リポジトリへのアクセスを使用して更新できます。

グローバルおよびプロジェクト構成

プロジェクト構成は、特定のプロジェクト用に作成され、プロジェクトリポジトリ内に格納される構成です。グローバル構成は、複数のプロジェクト間で共有できる構成です。両方の構成を 1 つの構成にマージして、1 つの YAML 形式のファイルに含めることができます。また、2 つのグローバル構成を含めることもできます。この場合、プロファイル構成も profile オプションを使用してマージされます。

プロジェクトに両方の構成タイプがあり、プロジェクト設定がグローバル設定と衝突する場合、プロジェクト設定がグローバル設定よりも優先されます。この場合、critical 構成オプションと severityThresholds 構成オプションの違いからわかるように、最終的な構成には両方の構成の設定が含まれます。

例: プロジェクト構成ファイルには次の構成が含まれています。

linter: jetbrains/qodana-jvm:2025.2

failureConditions:
    severityThresholds:
        critical: 1
        any: 10

グローバル構成ファイルには次の内容が含まれます。

failureConditions:
    severityThresholds:
        critical: 0

profile:
    name: qodana.recommended

この場合、最終的な、解決された構成は次のようになります。

linter: jetbrains/qodana-jvm:2025.2

failureConditions:
    severityThresholds:
        critical: 1
        any: 10

profile:
    name: qodana.recommended

構成のマージ

imports キーを使用すると、グローバル構成から別の構成ファイルを参照できます。

例: グローバル構成ファイルには、../base/qodana.yaml ファイルを参照するための imports キーが含まれています。

version: "1.0"

imports:
  - ../base/qodana.yaml

profile:
    name: qodana.recommended

参照される ../base/qodana.yaml ファイルには、次の Qodana 構成が含まれています。

version: "1.0"

linter: jetbrains/qodana-jvm:2025.2

この場合、マージされた構成は次のようになります。

version: "1.0"

profile:
    name: qodana.recommended

linter: jetbrains/qodana-jvm:2025.2

Qodana クラウドへのアップロード

Qodana Cloud 経由でグローバル設定を共有するには、CI/CD パイプラインの実行中に特別な設定トークンをアップロードする必要があります。このトークンは、組織設定のグローバル構成タブで生成できます。

その後、このページのグローバル構成の仕組みセクションに記載されているように、グローバル設定を Qodana Cloud に送信します。これにより、グローバル設定が Qodana Cloud UI の組織設定で利用できるようになります。

2026 年 5 月 21 日

Qodana 2026.1 ヘルプ

グローバル構成