How to externalize application.properties in Tomcat webserver for Spring?

Question

SpringApplication will load properties from application.properties files in the following locations and add them to the Spring Environment:

Answer 1

Using Tomcat 9.0.27

Running Spring boot 2.2.1

I did setup setenv.sh and added the line

export spring_config_location=/<PATH_TO_CONF_DIR>/application.properties

and got it to work..

Answer 2

You can set a spring_config_location environment variable pointing to the folder that contains your application.properties file.

In the case of Tomcat you can do this by adding the following line to your <TOMCAT_HOME>/bin/setenv.sh file (create the file if missing):

export spring_config_location=/usr/local/tomcat/conf/

Place the properties file in that folder. In case you have multiple apps you can set the name of the properties file of each app to be unique. For a Spring Boot App I have done it like this:

@SpringBootApplication
public class MyApplication {

    public static void main(String[] args) {
        System.setProperty("spring.config.name", "my-app");
        SpringApplication.run(MyApplication.class, args);
    }
}

This will pick the new name when run with BOOT. To have the name configured when deployed on Tomcat too, overwrite configure of SpringBootServletInitializer like so:

public class ServletInitializer extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(MyApplication.class).properties("spring.config.name: my-app");
    }

}

Then name your properties file like: my-app.properties. Instead of the default name Spring will look for that. You can put all your apps properties files in the specified folder, /usr/local/tomcat/conf/ in our sample. Your external properties will get precedence. See here for priorities: https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-external-config.html

UPDATE

Since Spring Boot 2 the behavior of spring_config_location has changed (from the migration guide):

it previously added a location to the list of default ones, now it replaces the default locations. If you were relying on the way it was handled previously, you should now use spring.config.additional-location instead.

So based on your use case you should consider which of the properties to set as an environment variable. The new one should look like spring_config_additional-location in setenv.sh. Where files are looked up from is described in the reference documentation too.

Answer 3

In tomcat/bin create setenv.sh file and in file you need to give below line in file for default properties for all the wars, And save it and restart tomcat.

export SPRING_PROFILES_ACTIVE=dev

Answer 4

I finally added the following property to externalize eg secure properties:

spring.config.additional-location=/etc/tomcat/<appname>/application-production.properties

Answer 5

I had to do it several times and the best approach I found is to configure an external directory as classpath resource in the container:

Then, in the directory place the resources you want to externalize and everything will run fine. To load the resource in spring, you could do this way:

<beans:bean id="externalProperties" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
            <beans:property name="location" value="classpath:[my-application-name]/applicationProperties.properties" />
            <beans:property name="placeholderPrefix" value="!applicationProperties{" />
            <beans:property name="placeholderSuffix" value="}" />
        </beans:bean>

You can see that, as you said that you might want to have multiple applications deployed in each tomcat, you could simply create a directory structure in the folder you set in classpath, to maintain different application.properties for each of your war applications

In case you want to maintain dinamically the application name section in your Spring configuration, you could do it in several ways, during packaging stage in maven or even using the application context path

Answer 6

for tomcat 9 on Ubuntu 18.04 and spring boot 2, create setenv.sh file under $CATALINA_HOME/bin/ working for me:

#!/bin/bash

export spring_config_additional_location="/opt/tomcat/latest/conf/application.properties"

don't forget to set file permission if needed