The purpose of workshop is to review some of the features of the library and use cases

In the first exercise we will get the config server up and running.

• Go to https://start.spring.io/
• Select gradle project and version 1.4.5 of Spring boot
• Assign a group and artifact, for example: com.ns.configws:config-server
• Add dependencies for: Config Server
• Download and unpack
• In build.gradle change the cloud release to Camden.SR4

• Fork the properties repository https://github.com/blzb/jvm-mx-server-configurations
• Add the following configurations to the application.properties

server.port=8888
spring.cloud.config.server.git.uri=[your fork url]
spring.cloud.config.server.git.searchPaths=simple

• Add the @EnableConfigServer annotation to the main class.

@SpringBootApplication
@EnableConfigServer
public class ConfigServerApplication {

	public static void main(String[] args) {
		SpringApplication.run(ConfigServerApplication.class, args);
	}
}

• Run the application

gradle bootRun

• Request a simple properties file like : http://localhost:8888/reader-dev.properties
• Try different structures

/{application}/{profile}[/{label}]
/{application}-{profile}.yml
/{label}/{application}-{profile}.yml
/{application}-{profile}.properties
/{label}/{application}-{profile}.properties

• Change the searchPath property to searchPaths=dir-per-env/{profile}
• Reboot
• Check how although the endpoint is the same the location of the files is different
• change the searchPath property to searchPaths=dir-per-app/{application}
• Check how although the endpoint is the same the location of the files is different

• Change or add a property to one of the properties file
• Commit and push the changes
• Request the file using the config server endpoint
• Check how the value is updated

• Go to https://start.spring.io/
• Select gradle project and version 1.4.5 of Spring boot
• Assign a group and artifact, for example: com.ns.configws:reader
• Add dependencies for: Config Client, Web
• Download and unpack
• In build.gradle change the cloud release to Camden.SR4

• Add a bootstrap.properties file next to the application.properties
• Add the following properties to the bootstrap.properties

spring.application.name=reader
spring.cloud.config.uri=http://localhost:8888
spring.profiles.active=dev

• Add a Controller that uses @Value annotation

@Controller
@RequestMapping("app")
public class RepeatController {
    @Value("${app.repeat: 1}")
    Long repeat;
    @Value("${app.label}")
    String label;

    @RequestMapping(value = "/repeat", method = RequestMethod.GET)
    @ResponseBody String getName() {
        StringBuilder stringBuilder = new StringBuilder();
        for(int i=0;i<repeat; i++){
          stringBuilder.append(label).append("<br/>");
        }
        return stringBuilder.toString();
    }
}

• Run the app
• Do a get request to /app/repeat

• Change a properties file for the reader, commit and push the change.
• Do a get request to the config server and verify it has changed.
• Check the reader endpoint, it should have change .... but it hasn't
• To unable auto update we need to add another anotation to the controller, add @RefreshScope annotation.
• Add org.springframework.boot:spring-boot-starter-actuator dependency to reader app
• If you are using IntelliJ refresh your gradle project
• Add the following properties to the application.properties

management.port=8081
management.security.enabled=false

• Restart the reader app and verify the property value is set.
• Change the property, commit and push the change.
• Do a POST to the refresh endpoint

curl -d{} http://localhost:8081/refresh

• Verify the value is updated.

• Add spring-cloud-config-monitor dependency to both apps
• Add spring-cloud-starter-bus-amqp dependency to the reader service
• Restart both apps, if you are using IntelliJ refresh gradle projects
• Start an ngrok process pointing to the config server
• Add a webhook on github to push changes to the ngrok url
• Change a property in the reader properties file
• Push and commit the changes.
• Go a get to the reader endpoint, it should have the new value

• Change the rabbitmq configuration on the reader for point to the cloudamqp service.

spring.rabbitmq.host=fox.rmq.cloudamqp.com
spring.rabbitmq.virtual-host=qghlygtg
spring.rabbitmq.port=5672
spring.rabbitmq.username=qghlygtg
spring.rabbitmq.password=F_VLCcr8BPMmVZRLJGu_H3QCsOX1_bSr

• Restart the reader app.
• The instructor will start the the config server and push a change to the repo.
• What how all the services update the property.

• Download JCE from http://www.oracle.com/technetwork/java/javase/downloads/index.html
• Make a back up of $JAVA_HOME/jre/lib/security files.
• Copy local_policy.jar and US_export_policy.jar into $JAVA_HOME/jre/lib/security
• Create a keystore with the following command changing the * for a value

keytool -genkeypair -alias * -keyalg RSA \
  -dname "CN=Web Server,OU=Unit,O=Organization,L=City,S=State,C=US" \
  -keypass * -keystore server.jks -storepass *

• Add the following properties to the application.properties

encrypt.key-store.location=file://${user.home}/server.jks
encrypt.key-store.password=
encrypt.key-store.alias=
encrypt.key-store.secret=

• Or use System variables

ENCRYPT_KEY_STORE_PASSWORD=
ENCRYPT_KEY_STORE_ALIAS=
ENCRYPT_KEY_STORE_SECRET=

• Start the config server
• Test the encryption with a curl

curl localhost:8888/encrypt -d 'Hello Spring Boot!'

• Add the following dependency to th reader app

org.springframework.security:spring-security-rsa

• Use the encrypt endpoint to add a cypher value to the properties file
• Restart the reader app

• Add the following dependency to the reader app

compile('org.springframework.security:spring-security-rsa')

• Add the following property to the application.properties file of the config server

spring.cloud.config.server.encrypt.enabled=false

• Restart the config server
• Build the reader jar and run it with the following command

java -Dencrypt.keyStore.location=file:///[route]/server.jks -Dencrypt.keyStore.password= -Dencrypt.keyStore.alias= -Dencrypt.keyStore.secret= -jar build/libs/reader-0.0.1-SNAPSHOT.jar