Bitbucket クラウド

Bitbucket クラウド(英語)は、チームがコードを計画、共同作業、テスト、デプロイするための 1 つの場所を提供するツールです。このセクションでは、Bitbucket クラウドパイプライン(英語)で Qodana Docker イメージを実行する方法と、品質ゲートとベースライン機能の適用について説明します。

始める前に

Qodana クラウド

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

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

プロジェクトトークンを取得したら、パイプラインまたはワークフローで識別するために QODANA_TOKEN 変数を使用できます。

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

プロジェクトを準備する

Bitbucket クラウド UI を使用して、リポジトリ(英語)を作成します。
Bitbucket クラウドリポジトリでパイプライン(英語)を作成します。

基本構成

以下は、Bitbucket クラウドパイプラインで Qodana を実行できるようにする bitbucket-pipelines.yml ファイルの基本構成スニペットです。

            image: atlassian/default-image:4

            pipelines:
              branches:
                main:
                  - step:
                      name: Qodana
                      caches:
                        - qodana
                      image: jetbrains/qodana-<image> # Specify a Qodana linter here. For example, jetbrains/qodana-jvm:latest
                      script:
                        - export QODANA_TOKEN=$QODANA_TOKEN  # Export the environment variable
                        - qodana --results-dir=$BITBUCKET_CLONE_DIR/.qodana --report-dir=$BITBUCKET_CLONE_DIR/.qodana/report --cache-dir=~/.qodana/cache
                      artifacts:
                        - .qodana/report

            definitions:
              caches:
                qodana: .qodana/cache
        

ここで、branches ブロックはどのブランチをインスペクションするかを指定します。

image ブロックは、パイプラインで呼び出される Qodana リンターを指定します。

script ブロックには、Qodana Cloud に必要なプロジェクトトークンを指定する - export QODANA_TOKEN=$QODANA_TOKEN 行が含まれており、これは $QODANA_TOKEN 変数(英語)として保存されます。このブロックの - qodana ... 行は、パイプライン実行中に使用するディレクトリを Bitbucket に指示し、Qodana オプションを含めることもできます。

この構成は、このセクションのすべての例の基礎として使用されます。

クオリティゲート

--fail-threshold オプションを使用すると、プロジェクトで受け入れられる問題の制限を構成できます。

image: atlassian/default-image:4

pipelines:
  branches:
    main:
      - step:
          name: Qodana
          caches:
            - qodana
          image: jetbrains/qodana-<linter> # Specify a Qodana linter here. For example, jetbrains/qodana-jvm:latest
          script:
            - export QODANA_TOKEN=$QODANA_TOKEN  # Export the environment variable
            - qodana --fail-threshold <number-of-problems> --results-dir=$BITBUCKET_CLONE_DIR/.qodana --report-dir=$BITBUCKET_CLONE_DIR/.qodana/report --cache-dir=~/.qodana/cache
          artifacts:
            - .qodana/report

definitions:
  caches:
    qodana: .qodana/cache

ベースライン

--baseline <path/to/qodana.sarif.json> オプションを使用して、ベースラインとして使用される SARIF 形式のファイルへのパスを指定します。

image: atlassian/default-image:4

pipelines:
  branches:
    main:
      - step:
          name: Qodana
          caches:
            - qodana
          image: jetbrains/qodana-<linter> # Specify a Qodana linter here. For example, jetbrains/qodana-jvm:latest
          script:
            - export QODANA_TOKEN=$QODANA_TOKEN  # Export the environment variable
            - qodana --baseline <path/to/qodana.sarif.json> --results-dir=$BITBUCKET_CLONE_DIR/.qodana --report-dir=$BITBUCKET_CLONE_DIR/.qodana/report --cache-dir=~/.qodana/cache
          artifacts:
            - .qodana/report

definitions:
  caches:
    qodana: ~/.qodana/cache

コードインサイトレポートを生成する

Bitbucket Cloud のプルリクエスト UI を使用すると、問題のあるコード行とその説明、改善のための推奨事項を確認できます。デフォルトでは、Qodana はコードインサイト(英語)レポートを生成し、Bitbucket Code Insights API を使用して転送します。設定は不要です。

2026 年 6 月 10 日

関連ページ：

デプロイオプション

このセクションでは、システム要件と利用可能なデプロイのオプションに関する情報を提供します。システム要件：RAM2 GB の空き RAM8 GB の総システム RAMCPU 最新の CPU マルチコア CPU。Qodana は、さまざまな操作やプロセスに対してマルチスレッドをサポートしており、使用できる CPU コアの数が増えるほど高速化します。ディスク容量 2.5 すべての依存関係とキャッシュ用の GB + スペース少なくとも 5 GB の空き容量 + すべての依存関係とキャッシュ用のスペースオペレ...

ベースライン

ベースラインとは、特定の Git ブランチに対する特定の Qodana 分析で取得されたコードベースの問題点のスナップショットであり、ファイルに格納されています。ベースライン機能を使用すると、現在のコードとベースラインの状態を比較し、新規の問題、変更されていない問題、解決済みの問題を確認できます。たとえば、ブランチのベースラインを設定・更新することで、プルリクエストやマージリクエストのマージ後の変更を監視できます。必要に応じて、新しいファイルを生成し、Qodana の実行中に使用することで、ベー...

クイックスタート

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

プロジェクト

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

Azure パイプライン

Qodana スキャンは、Qodana Azure パイプライン拡張内にパックされた Azure パイプラインタスクであり、Qodana を使用して既存のパイプライン内のコードを分析します。始める前に：このセクションのすべての構成例では、Qodana Cloud によって生成されたプロジェクトトークンを使用します。このトークンは、有料の Qodana リンターでは必須であり、コミュニティリンターで使用する場合はオプションです。Qodana Cloud UI でプロジェクトトークンを生成する方法に...