Qodana
 
2024.1
You are viewing the documentation for an earlier version of Qodana.
  1. Deployment
  2. Qodana Docker images
  3. Qodana for Go

Qodana for Go

Edit pageLast modified: 07 August 2024

official JetBrains project

The Docker image for the Qodana for Go linter is provided to support different usage scenarios:

  • Running analyses on a regular basis as part of your continuous integration (CI-based execution)

  • Single-shot analyses (for example, performed locally).

If you are just starting in the field, we recommend proceeding with the default setup we provide. You will see the results of the most common checks performed on your code base. Later, you can adjust them to suit your needs better.

You can run the Qodana for Go linter using two methods. Qodana CLI is the easiest method. If necessary, check the installation page to install Qodana CLI. Alternatively, you can use the Docker commands from the Docker image tab.

Run analysis locally

note

Running analysis locally is a resource-intensive operation. If you experience issues, consider increasing the Docker Desktop runtime memory limit, which by default is set to 2 GB. See the Docker Desktop documentation for Windows and Mac.

  1. Pull the image from Docker Hub (only necessary to update to the latest version):

    $
    docker pull jetbrains/qodana-go

  2. Run the following command:

    $
    docker run \
   -v <source-directory>/:/data/project/ \
   -v <output-directory>/:/data/results/ \
   -e QODANA_TOKEN="<cloud-project-token>" \
   jetbrains/qodana-go

    where source-directory and output-directory are full local paths to, respectively, the project source code directory and the analysis results directory. The QODANA_TOKEN variable refers to the project token required by the Ultimate and Ultimate Plus linters.

This command will run the analysis on your source code and start the web server to provide a convenient view of the results. Open Qodana Cloud in your browser to examine inspection results. Here you can also reconfigure the analysis. See the Inspection report for details.

If you don't need the user interface and prefer to review raw data, use the following command:

$
docker run \
   -v <source-directory>/:/data/project/ \
   -v <output-directory>/:/data/results/ \
   -e QODANA_TOKEN="<cloud-project-token>" \
   jetbrains/qodana-go

The output-directory will contain all the necessary results. You can further tune the command as described in the technical guide.

If you run the analysis several times in a row, make sure you've cleaned the results directory before using it in docker run again.

Run analysis in CI

Use the following command as a task in a generic shell executor:

$
docker run \
   -v <source-directory>/:/data/project/ \
   -v <output-directory>/:/data/results/ \
   -e QODANA_TOKEN="<cloud-project-token>" \
   jetbrains/qodana-go

where source-directory and output-directory are full paths to, respectively, the project source code directory and the analysis results directory. The QODANA_TOKEN variable refers to the project token required by the Ultimate and Ultimate Plus linters.

Consider using the Quality gate feature to make the build fail when a certain number of problems is reached and the Baseline feature to compare each new Qodana for Go run to some initial run selected as a baseline. Running as non-root is also supported.

tip

For details on available CI integrations, see Integration with CI systems.

Configure via qodana.yaml

Qodana automatically recognizes the qodana.yaml file for the analysis configuration, so that you don't need to pass any additional parameters.

The references to the inspection profiles will be resolved in a particular order. To learn about the format, see YAML file.

Plugins management

Paid plugins are not yet supported. Each vendor must clarify licensing terms for CI usage and collaborate with us to make it work.

Any free IntelliJ platform plugins or your custom plugin can be added by mounting it to the container plugins' directory using the following command:

$
docker run \
   -v /your/custom/path/%pluginName%:/opt/idea/plugins/%pluginName% \
   -e QODANA_TOKEN="<cloud-project-token>" \
   jetbrains/qodana-go

Refer to the technical guide for more details.

Usage statistics

According to the JetBrains EAP user agreement, we can use third-party services to analyze the usage of our features to further improve the user experience. All data will be collected anonymously. You can disable the reporting of usage statistics by adjusting the options of the Docker command you use. Refer to the technical guide for details.