TeamCity

Navigate to your build configuration.

On the build configuration page, select Build Steps from the Edit configuration list.

On the Build steps page, click the Add build step button.

From the Runner type list, select Qodana as a runner. On the New Build Step page, you can configure the Qodana runner using the basic options. Otherwise, click Show advanced options to expand the list of configuration options.

Fill in the fields using this description.

Step name uniquely identifies this step among other build steps.

Execute step configures the build condition that will trigger this build step.

Working directory sets the directory for the build process. For more information, see the TeamCity documentation. You can leave this field empty if the Checkout directory parameter is specified on the Version Control Settings tab.

Report ID uniquely identifies the report to let you distinguish between multiple reports when several inspection steps are configured within a single build.

The Forward reports to TeamCity tests checkbox configures Qodana report availability in the Test tab of TeamCity UI. Using this option, you can overview codebase problems along with other problems detected.

Linter configures the Qodana Linter.

Version is by default set to Latest.

Inspection profile defines the inspection profile. For more information, see the Configure profile section. The available values are:

• Recommended (default) is the default profile containing a preselected set of IntelliJ inspections

• Embedded profile lets you select from any available profiles, see the Default profiles section for details

• Path to the IntelliJ profile lets you specify the path to a custom profile. Make sure that the .idea directory containing the profile file is added to your working directory.

You can disable certain inspections later using the qodana.yaml file or Profile settings in your HTML report.

Additional arguments for 'docker run' configures the arguments accepted by a Docker image. For example, they can be the -d or -changes parameters. For more information about arguments, see the Examples of execution tuneup section.

Additional Qodana arguments lets you extend the default Qodana functionality, see the Configuration options for details.

Click Save. Now you can run Qodana in the build.

Navigate to your build configuration.

On the build configuration page, select Build Steps from the Edit configuration list.

On the Build steps page, click the Add build step button.

From the Runner type list, select Command Line. On the New Build Step page, you can configure the Command Line runner using the basic options. Otherwise, click Show advanced options to expand the list of configuration options.

Fill in the fields using the Command Line runner description from the TeamCity documentation portal.

In the Custom script editor, paste a script that adds a custom qodana.yaml to the working directory. In the example below, the script appends the following inspection exclusions to the configuration file:

#!/bin/sh

FILE="./qodana.yaml"

/bin/cat <<EOM >$FILE
exclude:
- name: Annotator
- name: AnotherInspectionId
  paths:
    - relative/path
    - another/relative/path
- name: ProhibitedDependencyLicense

EOM

In the TeamCity UI, create the QODANA_TOKEN environment variable of the password type, and save the Qodana Cloud project token as its value.

Open the build step that will run Qodana.

In the Additional arguments for 'docker run' field, add this line to employ the QODANA_TOKEN variable:

-e QODANA_TOKEN=%env.QODANA_TOKEN%

Navigate to the project build page. In the Overview tab, click the build entry.

On the build page, navigate to the Qodana tab to find the inspection report. To learn more about Qodana reports, see the User interface overview section of this documentation.