Rust

すべての Qodana リンターは、特定のプログラミング言語とフレームワーク向けに設計された JetBrains IDE に基づいています。Rust プロジェクトを分析するには、以下の特性を持つ Qodana for Rust リンターを使用できます。

特性	説明
リンター名	`qodana-rust`
Docker イメージ	`jetbrains/qodana-rust:2026.1-eap`
ベースとなるもの	RustRover
ライセンスに基づいて利用可能	Ultimate および Ultimate Plus ライセンス
発送方法	Docker イメージ
サポートされる言語	Rust

サポートされているテクノロジーと機能のリストを表示するには、このセクションのサポートされているテクノロジーと機能の章に移動してください。

始める前に

プロジェクトの依存関係をインストールする

プロジェクトに外部依存関係がある場合は、 qodana.yaml ファイルの bootstrap キーを使用して設定できます。例:

bootstrap: rustup toolchain install nightly

コマンドは分析前に自動的に実行されます。

Qodana クラウド

Rust リンター用の Qodana では、ライセンスを識別および検証するために Qodana クラウドプロジェクトトークンが必要なので、次の手順に従って取得してください。

Qodana クラウド(英語)に移動して、そこでアカウントを作成します。
Qodana Cloud で、組織、チーム、プロジェクトを作成します。
プロジェクトカードには、このセクションで後で使用するプロジェクトトークンが記載されています。

ソフトウェアを準備する

GitHub UI の設定タブで、QODANA_TOKEN 暗号化シークレット(英語)を作成し、その値としてプロジェクトトークンを保存します。

Jenkins で、次のプラグインが稼働していることを確認します。
- Docker イメージを実行するには、Docker(英語) および Docker パイプライン(英語)が必要です
- Jenkins プロジェクトでの Git 操作には Git(英語) が必要です
Docker がインストールされており、Jenkins からアクセスできることを確認します。
該当する場合は、Docker ドキュメントの Docker を非 root ユーザーとして管理する(英語)セクションの説明に従って、jenkins ユーザーが Docker にアクセスできることを確認してください。
Jenkins で、qodana-token 資格情報(英語)を作成し、プロジェクトトークンをその値として保存します。
Jenkins で、Jenkins ドキュメントポータル(英語)の説明に従ってマルチブランチパイプラインプロジェクトを作成します。

プロジェクトリポジトリが GitLab CI/CD からアクセスできることを確認します。
GitLab CI/CD で、 QODANA_TOKEN (英語) 変数を作成し、プロジェクトトークンをその値として保存します。

TeamCity で、プロジェクトとビルド構成を作成します。

Qodana を実行するマシンに Docker をインストールします。

Linux を使用している場合は、現在の非 root ユーザー(英語)で Docker を実行できるはずです。

GitHub の Qodana CLI(英語) ページの指示に従ってください。

このコマンドを実行して、Qodana の Docker イメージをプルします。

docker pull jetbrains/qodana-rust:2026.1-eap

Qodana の実行

利用可能な Docker イメージを使用して Qodana を実行できます。

main ブランチ、リリースブランチ、Docker モードでリポジトリに届くプルリクエストを分析するには、このワークフロー構成を .github/workflows/code_quality.yml ファイルに保存します。

                            name: Qodana
                            on:
                                workflow_dispatch:
                                pull_request:
                                push:
                                    branches: # Specify your branches here
                                        - main # The 'main' branch
                                        - 'releases/*' # The release branches
                            jobs:
                                qodana:
                                    runs-on: ubuntu-latest
                                    permissions:
                                        contents: write
                                        pull-requests: write
                                        checks: write
                                    steps:
                                        - uses: actions/checkout@v3
                                          with:
                                              ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                              fetch-depth: 0  # a full history is required for pull request analysis
                                        - name: 'Qodana Scan'
                                          uses: JetBrains/qodana-action@v2026.1
                                          with:
                                              args: --linter qodana-rust
                                          env:
                                              QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                        

さらなる構成例については、GitHub アクションセクションを参照してください。

この構成を Jenkinsfile に保存します。

                            pipeline {
                              environment {
                                QODANA_TOKEN=credentials('qodana-token')
                              }
                              agent {
                                docker {
                                  args '''
                                       -v "${WORKSPACE}":/data/project
                                       --entrypoint=""
                                       '''
                                  image 'jetbrains/qodana-rust:2026.1-eap'
                                }
                              }
                              stages {
                                stage('Qodana') {
                                  steps {
                                    sh '''qodana'''
                                  }
                                }
                              }
                            }
                        

さらなる構成例については、Jenkins セクションを参照してください。

これは、Linux 上で Qodana を実行する例です。その他の例は、GitLab CI/CD のセクションに掲載されています。

プロジェクトのルートディレクトリで、このスニペットを .gitlab-ci.yml ファイルに保存します。

                          include:
                              - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                                inputs:
                                    image: jetbrains/qodana-rust:2026.1-eap
                        

さらなる構成例については、GitLab CI/CD セクションを参照してください。

TeamCity UI で、Qodana を実行するビルドの構成ページに移動します。
ビルド設定ページで、ビルドステップページに移動します。
ビルドステップページで、ビルドステップを追加ボタンをクリックしてください。
開いたページで、Qodana ランナーを選択します。
新しいビルドステップ: Qodana ページで、高度なオプションを表示をクリックし、Qodana ランナーを構成します。
- ステップ名は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ ID は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ実行は、このビルドステップをトリガーするビルド条件を構成します。
- 作業ディレクトリはビルドプロセスのディレクトリを設定します。詳細については、TeamCity のドキュメントを参照してください。バージョン管理設定タブで Checkout directory パラメーターが指定されている場合は、このフィールドを空のままにすることができます。
- レポート ID はレポートを一意に識別し、単一のビルド内で複数の分析ステップが構成されている場合に複数のレポートを区別できるようにします。
- レポートを TeamCity テストに転送するチェックボックスは、TeamCity UI の「テスト」タブで Qodana レポートの可用性を構成します。このオプションを使用すると、検出された他の問題とともにコードベースの問題を表示できます。
- リンターは Qodana リンターを構成します。
  ここで、Rust リンターの Qodana を選択します。
- バージョンはデフォルトで Latest に設定されています。
- インスペクションプロファイル: はインスペクションプロファイルを定義します:
  - qodana.starter (default) はデフォルトプロファイルの 1 つです。
  - Profile name ではプロファイルを指定できます。詳細については、既存の Qodana プロファイルセクションを参照してください。
  - Profile path を使用すると、カスタムプロファイルへのパスを指定できます。このオプションを使用するには、 qodana.yaml ファイルでもカスタムプロファイルを構成する必要があります。
- クラウドトークンは、Qodana Cloud で生成されたプロジェクトトークンを構成します。
- 追加の Docker 引数は、Docker イメージによって受け入れられる引数を設定します。詳細については、構成オプションセクションを参照してください。
- 追加の Qodana 引数を使用すると、デフォルトの Qodana 機能を拡張できます。詳細については、オプションの種類セクションを参照してください。
- Qodana CLI バージョンでは、使用する Qodana CLI(英語) バージョンを指定できます。
保存ボタンをクリックしてください。

さらなる構成例については、TeamCity セクションを参照してください。

                                    qodana scan \
                                       -e QODANA_TOKEN="<qodana-cloud-token>" \
                                       --linter qodana-rust
                                

                                    docker run \
                                       -v <source-directory>/:/data/project/ \
                                       -e QODANA_TOKEN="<cloud-project-token>" \
                                       jetbrains/qodana-rust:2026.1-eap
                                

https://qodana.cloud/ 以外の Qodana Cloud インスタンスを使用している場合は、QODANA_ENDPOINT 環境変数を宣言してそれを上書きします。

ブラウザーで Qodana クラウド(英語)を開き、分析レポートを確認して分析を再設定してください。詳細については、ドキュメントの分析レポートのセクションを参照してください。

分析レポートを参照する

以下に説明するように、Qodana Cloud から最新の Qodana レポートを RustRover にロードできます。

RustRover で、ツール | Qodana | Qodana にログインに移動します。
設定ダイアログで、ログインをクリックします。
これにより、認証ページにリダイレクトされます。
ローカルプロジェクトをリンクする Qodana クラウドプロジェクトを選択します。
常に最も関連性の高い Qodana レポートをロードするオプションをチェックすると、Qodana クラウドから最も実際的で関連性の高いレポートを受け取ることができます。
この場合、IDE は Qodana Cloud を検索し、現在のリビジョン ID (HEAD) に対応するリビジョン ID を持つレポートを取得します。このレポートが見つからない場合、IDE は現在のリビジョン ID (HEAD) に最も近いリビジョン ID を持つ以前のレポートを選択します。それ以外の場合、IDE は Qodana Cloud から利用可能な最新のレポートを取得します。
問題ツールウィンドウの Qodana タブで、分析レポートを参照してください。

Qodana がプロジェクトを分析し、分析レポートを Qodana クラウドにアップロードした後、Qodana クラウド(英語)でプロジェクトに移動し、分析レポートを確認してください。

Qodana レポート UI の詳細については、「分析レポート」セクションを参照してください。

Qodana 構成を拡張

分析範囲の調整

Qodana は、GitHub(英語) でホストされる 2 つの定義済みプロファイルをすぐに使用できます。

qodana.starter はデフォルトのプロファイルであり、より包括的な qodana.recommended プロファイルのサブセットです。
qodana.recommended は CI/CD パイプラインでの実行に適しており、主にデフォルトの RustRover プロファイルを実装しています。詳細については、RustRover のドキュメントを参照してください。

YAML および XML 形式の構成を使用して、Qodana プロファイルをカスタマイズできます。

ベースライン機能を有効にする

ベースライン機能を使用すると、特定の問題の分析をスキップできます。ベースラインに関する情報は、SARIF 形式のファイルに含まれています。

このスニペットを、SARIF 形式のベースラインファイルへのパスを指定する args: --baseline qodana.sarif.json オプションを含む .github/workflows/code_quality.yml ファイルに保存します。

                      name: Qodana
                      on:
                          workflow_dispatch:
                          pull_request:
                          push:
                              branches: # Specify your branches here
                                  - main # The 'main' branch
                                  - master # The 'master' branch
                                  - 'releases/*' # The release branches
                      jobs:
                          qodana:
                              runs-on: ubuntu-latest
                              permissions:
                                  contents: write
                                  pull-requests: write
                                  checks: write
                              steps:
                                  - uses: actions/checkout@v3
                                    with:
                                        ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                        fetch-depth: 0  # a full history is required for pull request analysis
                                  - name: 'Qodana Scan'
                                    uses: JetBrains/qodana-action@v2026.1
                                    with:
                                        args: |
                                            --baseline <path/to/qodana.sarif.json>
                                            --linter qodana-rust
                                    env:
                                        QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                  

Jenkinsfile で、SARIF 形式のベースラインファイルへのパスを指定する --baseline <path/to/qodana.sarif.json> 行を含む構成を保存します。

                        pipeline {
                          environment {
                            QODANA_TOKEN=credentials('qodana-token')
                          }
                          agent {
                            docker {
                              args '''
                                   -v "${WORKSPACE}":/data/project
                                   --entrypoint=""
                              '''
                              image 'jetbrains/qodana-rust:2026.1-eap'
                            }
                          }
                          stages {
                            stage('Qodana') {
                              steps {
                                sh '''
                                   qodana \
                                   --baseline <path/to/qodana.sarif.json>
                                '''
                              }
                            }
                          }
                        }
                    

これは、Linux 上で Qodana を実行する例です。その他の例は、GitLab CI/CD のセクションに掲載されています。

プロジェクトのルートディレクトリで、このスニペットを .gitlab-ci.yml ファイルに保存します。

                    include:
                        - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                          inputs:
                              image: jetbrains/qodana-rust:2026.1-eap
                  

TeamCity UI で、Qodana を実行するビルドの構成ページに移動します。
ビルド設定ページで、ビルドステップページに移動します。
ビルドステップページで、ビルドステップを追加ボタンをクリックしてください。
開いたページで、Qodana ランナーを選択します。
新しいビルドステップ: Qodana ページで、高度なオプションを表示をクリックし、Qodana ランナーを構成します。
- ステップ名は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ ID は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ実行は、このビルドステップをトリガーするビルド条件を構成します。
- 作業ディレクトリはビルドプロセスのディレクトリを設定します。詳細については、TeamCity のドキュメントを参照してください。バージョン管理設定タブで Checkout directory パラメーターが指定されている場合は、このフィールドを空のままにすることができます。
- レポート ID はレポートを一意に識別し、単一のビルド内で複数の分析ステップが構成されている場合に複数のレポートを区別できるようにします。
- レポートを TeamCity テストに転送するチェックボックスは、TeamCity UI の「テスト」タブで Qodana レポートの可用性を構成します。このオプションを使用すると、検出された他の問題とともにコードベースの問題を表示できます。
- リンターは Qodana リンターを構成します。
  ここで、Rust リンターの Qodana を選択します。
- バージョンはデフォルトで Latest に設定されています。
- インスペクションプロファイル: はインスペクションプロファイルを定義します:
  - qodana.starter (default) はデフォルトプロファイルの 1 つです。
  - Profile name ではプロファイルを指定できます。詳細については、既存の Qodana プロファイルセクションを参照してください。
  - Profile path を使用すると、カスタムプロファイルへのパスを指定できます。このオプションを使用するには、 qodana.yaml ファイルでもカスタムプロファイルを構成する必要があります。
- クラウドトークンは、Qodana Cloud で生成されたプロジェクトトークンを構成します。
- 追加の Docker 引数は、Docker イメージによって受け入れられる引数を設定します。詳細については、構成オプションセクションを参照してください。
- 追加の Qodana 引数を使用すると、デフォルトの Qodana 機能を拡張できます。詳細については、オプションの種類セクションを参照してください。
  このフィールドでは、--baseline <path/to/qodana.sarif.json> オプションを使用してベースラインフィーチャを指定します。
- Qodana CLI バージョンでは、使用する Qodana CLI(英語) バージョンを指定できます。
保存ボタンをクリックしてください。

コマンドラインからベースライン機能を実行する方法を選択します。

                              qodana scan \
                                  -v <path_to_baseline>:/data/base/ \
                                  -e QODANA_TOKEN="<cloud-project-token>" \
                                  --linter qodana-rust \
                                  --within-docker true
                                  --baseline /data/base/<path-relative-to-project-dir>/qodana.sarif.json
                          

                              docker run \
                                  -v <source-directory>/:/data/project/ \
                                  -v <path_to_baseline>:/data/base/ \
                                  -e QODANA_TOKEN="<cloud-project-token>" \
                                  jetbrains/qodana-rust:2026.1-eap \
                                  --baseline /data/base/<path-relative-to-project-dir>/qodana.sarif.json
                          

RustRover で、問題ツールウィンドウに移動します。
問題ツールウィンドウで、Qodana タブをクリックします。
Qodana タブで、ローカルで試すボタンをクリックします。
開いたダイアログで、詳細な構成セクションを展開し、ベースラインファイルへのパスを指定して、実行をクリックします。

品質ゲートの有効化

品質ゲートは以下に対して設定できます。

プロジェクトの問題の総数
問題の重大度に応じた複数の品質ゲート
コードカバレッジ閾値

このスニペットを qodana.yaml ファイルに保存します。

            failureConditions:
                severityThresholds:
                    any: 50 # Total number of problems in all severities
                    critical: 1 # Severities
                    high: 2
                    moderate: 3
                    low: 4
                    info: 5
                testCoverageThresholds:
                    fresh: 6 # Fresh code coverage
                    total: 7 # Total percentage
        

プルリクエストの分析

Qodana Scan GitHub アクション(英語)はすべてのプルリクエストを自動的に分析するため、追加の構成を指定する必要はありません。この構成を .github/workflows/code_quality.yml ファイルに保存します。

            name: Qodana
            on:
                workflow_dispatch:
                pull_request:
                push:
                    branches: # Specify your branches here
                        - main # The 'main' branch
                        - 'releases/*' # The release branches
            jobs:
                qodana:
                    runs-on: ubuntu-latest
                    permissions:
                        contents: write
                        pull-requests: write
                        checks: write
                    steps:
                        - uses: actions/checkout@v3
                          with:
                              ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                              fetch-depth: 0  # a full history is required for pull request analysis
                        - name: 'Qodana Scan'
                          uses: JetBrains/qodana-action@v2026.1
                          with:
                              args: --linter qodana-rust
                          env:
                              QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
        

これは、Linux 上で Qodana を実行する例です。その他の例は、GitLab CI/CD のセクションに掲載されています。

プロジェクトのルートディレクトリに、次のスニペットを含む .gitlab-ci.yml ファイルを保存します。

                  include:
                      - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                        inputs:
                            image: jetbrains/qodana-rust:2026.1-eap
                

このスニペットにより、マージリクエストの分析が可能になります。

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

コードの変更を分析するには、--diff-start オプションを使用し、比較のベースとなるコミットのハッシュを指定します。

                    qodana scan \
                       -e QODANA_TOKEN="<cloud-project-token>" \
                       --linter qodana-rust \
                       --diff-start=<GIT_START_HASH>
                

                    docker run \
                       -v $(pwd):/data/project/ \
                       -e QODANA_TOKEN="<cloud-project-token>" \
                       jetbrains/qodana-rust:2026.1-eap \
                       --diff-start=<GIT_START_HASH>
                

設定タイムアウトの設定

qd.rust.configuration.timeout.minutes プロパティを使用すると、構成ステージのタイムアウトを設定できます。例:

            name: Qodana
            on:
                workflow_dispatch:
                pull_request:
                push:
                    branches: # Specify your branches here
                        - main # The 'main' branch
                        - 'releases/*' # The release branches
            jobs:
                qodana:
                    runs-on: ubuntu-latest
                    permissions:
                        contents: write
                        pull-requests: write
                        checks: write
                    steps:
                        - uses: actions/checkout@v3
                          with:
                              ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                              fetch-depth: 0  # a full history is required for pull request analysis
                        - name: 'Qodana Scan'
                          uses: JetBrains/qodana-action@v2026.1
                          with:
                              args: |
                                  --linter qodana-rust
                                  --property qd.rust.configuration.timeout.minutes=10
                          env:
                              QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
        

これは、Linux 上で Qodana を実行する例です。その他の例は、GitLab CI/CD のセクションに掲載されています。

プロジェクトのルートディレクトリに、次のスニペットを含む .gitlab-ci.yml ファイルを保存します。

                  include:
                      - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                        inputs:
                            image: jetbrains/qodana-rust:2026.1-eap
                            args: --property qd.rust.configuration.timeout.minutes=10
                

                      qodana scan \
                         -e QODANA_TOKEN="<cloud-project-token>" \
                         --linter qodana-rust \
                         --property qd.rust.configuration.timeout.minutes=10
                    

                    docker run \
                       -v $(pwd):/data/project/ \
                       -e QODANA_TOKEN="<cloud-project-token>" \
                       jetbrains/qodana-rust:2026.1-eap \
                       --property qd.rust.configuration.timeout.minutes=10
                

サポートされているテクノロジーと機能

Rust リンター用の Qodana は、以下のテクノロジーに対してインスペクションを提供します。

プログラミング言語	Rust
マークアップ言語	Dockerfile JSON Markdown TOML XML YAML
スクリプト言語	シェルスクリプト
その他	正規表現

Rust リンター用の Qodana は、次の Qodana 機能を提供します。

機能	ライセンスに基づいて利用可能
ベースライン	Ultimate と Ultimate Plus
クオリティゲート	Ultimate と Ultimate Plus
インサイト	Ultimate Plus
シングルサインオン	Ultimate Plus

2026 年 6 月 02 日

Qodana 2026.1 ヘルプ

Rust

始める前に

プロジェクトの依存関係をインストールする

Qodana クラウド

ソフトウェアを準備する

Qodana の実行

分析レポートを参照する

Qodana 構成を拡張

分析範囲の調整

ベースライン機能を有効にする

品質ゲートの有効化

プルリクエストの分析

設定タイムアウトの設定

サポートされているテクノロジーと機能

関連ページ：