dockersonarqubesonarqube-ops

How to persist configuration & analytics across container invocations in Sonarqube docker image


Sonarqube official docker image, is not persisting any configuration changes like: creating users, changing root password or even installing new plugins.

Once the container is restarted, all the configuration changes disappear and the installed plugins are lost. Even the projects' keys and their previous QA analytics data is unavailable after a restart.

How can we persist the data when using Sonarqube's official docker image?


Solution

  • Since we wanted to persist the data across invocations, we need to make sure that a production grade database is setup and is linked to Sonarqube and the extensions directory is created and mounted as volume on the host machine so that all the downloaded plugins are available across container invocations and can be used by multiple containers (if required).

    Database Setup:

    create database sonar;
    grant all on sonar.* to `sonar`@`%` identified by "SOME_PASSWORD";
    flush privileges;
    
    # since we do not know the containers IP before hand, we use '%' for sonarqube host IP.
    

    It is not necessary to create tables, Sonarqube creates them if it doesn't find them.

    Starting up Sonarqube container:

    # create a directory on host
    mkdir /server_data/sonarqube/extensions
    mkdir /server_data/sonarqube/data # this will be useful in saving startup time
    
    # Start the container
    docker run -d \
        --name sonarqube \
        -p 9000:9000 \
        -e SONARQUBE_JDBC_USERNAME=sonar \
        -e SONARQUBE_JDBC_PASSWORD=SOME_PASSWORD \
        -e SONARQUBE_JDBC_URL="jdbc:mysql://HOST_IP_OF_DB_SERVER:PORT/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance" \
        -v /server_data/sonarqube/data:/opt/sonarqube/data \
        -v /server_data/sonarqube/extensions:/opt/sonarqube/extensions \
        sonarqube