WJAX 2015 Boot your own Infrastructure - Spring Boot erweitern

Im Zuge des Hypethemas Microservices ist auch Spring Boot zum Gesprächsthema geworden. Dabei ist Spring Boot viel mehr als nur ein Microservices-Framework. In dieser Session wird in fünf Schritten gezeigt, wie man einen eigenen Spring Boot Starter schreibt, um genau die Infrastruktur zu booten, die der eigene Typ Anwendung benötigt – ein sehr nützliches Werkzeug auch im Enterprise-Umfeld, in dem man üblicherweise viele Anwendungen eines bestimmten Typs hat und proprietäre Technologien verwendet werden.

Transcript

1. Tobias Flohre | codecentric AG Dennis Schulte | codecentric AG Boot your own Infrastructure Spring Boot erweitern
2. Tobias Flohre Düsseldorf @TobiasFlohre www.github.com/tobiasflohre blog.codecentric.de/en/author/tobias.flohre tobias.flohre@codecentric.de www.codecentric.de
3. Dennis Schulte Düsseldorf @denschu www.github.com/denschu blog.codecentric.de/en/author/dsc dennis.schulte@codecentric.de www.codecentric.de
4. Agenda Intro Spring Boot Eigener Spring Boot Starter – Warum? Eigener Spring Boot Starter – Wie? Client-Server-Architektur Erweiterbarkeit von Spring Boot Komponenten Fazit 4
5. Agenda Intro Spring Boot Eigener Spring Boot Starter – Warum? Eigener Spring Boot Starter – Wie? Client-Server-Architektur Erweiterbarkeit von Spring Boot Komponenten Fazit 5
6. Intro Spring Boot Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can "just run".
7. Intro Spring Boot Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can "just run". Spring Boot Starter liefern Dependencies liefern Konfiguration einfach erweiterbar
8. Intro Spring Boot Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can "just run". Embedded Servlet Container Start per main-Methode Startfähiges Fat-Jar java –jar app.jar
9. Intro Spring Boot Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can "just run". Monitoring Properties Remote Shell CRaSH
10. Agenda Intro Spring Boot Eigener Spring Boot Starter – Warum? Eigener Spring Boot Starter – Wie? Client-Server-Architektur Erweiterbarkeit von Spring Boot Komponenten Fazit 10
11. Eigener Spring Boot Starter – Warum? Ja, warum eigentlich? Viele Anwendungen gleichen Typs • Intranet-Web • Kundenportal-Web • Batch • App-Rest Default-Stacks 11
12. Eigener Spring Boot Starter – Warum? Und warum eigentlich nicht? Share nothing? Microservices vs. Microservices, but Autonomie vs. Wiederverwendung Keine Fachlichkeit in Frameworks! Veröffentlichung auf github 12
13. Eigener Spring Boot Starter – Warum? Fehlende Unterstützung für eine offen verfügbare Technologie Fehlende Unterstützung für eine eigene, proprietäre Technologie / ein eigenes Framework Eigene Vorgaben / Defaults Automatische Konfiguration von Infrastruktur- / Businesslogik 13
14. Eigener Spring Boot Starter – Warum? Unser persönlicher Anwendungsfall: Batch 14 Servlet Container Anwendung Batch Application HTTP Endpoint Scheduler Job- Metadaten Logs Cron-Job Workflow-System
15. Eigener Spring Boot Starter – Warum? HTTP-Endpoints Job-Start Status Job-Stop Logfile / Protokoll Laufende Jobs Deployed Jobs Job-Execution- Details Logging Logfile pro Job- Execution Thread-Local Protokoll Einheitliches Format Kerndaten des Joblaufs Revisionssichere Ablage Metrics Test- Unterstützung Test-Ressourcen In-Memory Zähler Summen Transaktionssicher
16. Eigener Spring Boot Starter – Warum? https://github.com/codecentric/spring-boot-starter-batch-web <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-starter-batch-web</artifactId> <version>1.3.6.RELEASE</version> </dependency>
17. Agenda Intro Spring Boot Eigener Spring Boot Starter – Warum? Eigener Spring Boot Starter – Wie? Client-Server-Architektur Erweiterbarkeit von Spring Boot Komponenten Fazit 17
18. Eigener Spring Boot Starter – Wie? 1. Wähle eine Basis aus existierenden Spring Boot Startern spring-boot-starter-web spring-boot-starter-batch spring-boot-starter-jdbc spring-boot-starter-actuator
19. Eigener Spring Boot Starter – Wie? 2. Eigene Konfiguration und Auto-Configuration META-INF/spring.factories org.springframework.boot.autoconfigure.EnableAutoConfiguration= de.codecentric.batch.configuration.BatchWebAutoConfiguration
20. Eigener Spring Boot Starter – Wie? 3. Konfigurierbarkeit durch Properties @Value("${batch.max.pool.size:5}") private int maxPoolSize; @Bean public TaskExecutor taskExecutor() { ThreadPoolTaskExecutor taskExecutor = new ThreadPoolTaskExecutor(); taskExecutor.setMaxPoolSize(maxPoolSize); taskExecutor.afterPropertiesSet(); return taskExecutor; }
21. Eigener Spring Boot Starter – Wie? 4. Erweiterbarkeit durch überschreibbare Default-Implementierungen @ConditionalOnMissingBean(BatchConfigurer.class) @Configuration public class TaskExecutorBatchConfigurer implements BatchConfigurer {} public interface BatchConfigurer { JobRepository getJobRepository() throws Exception; PlatformTransactionManager getTransactionManager() throws Exception; JobLauncher getJobLauncher() throws Exception; JobExplorer getJobExplorer() throws Exception; }
22. Eigener Spring Boot Starter – Wie? 5. Abhängigkeit von Klassenpfad und Ressourcen @ConditionalOnClass(name = "javax.persistence.EntityManagerFactory") @ConditionalOnMissingBean(BatchConfigurer.class) @Configuration protected static class JpaBatchConfiguration {} @ConditionalOnMissingClass @ConditionalOnResource @ConditionalOnWebApplication @ConditionalOnExpression @ConditionalOnProperty
23. 23 Client-Server-Architektur mit Spring Boot
24. Client-Server-Architektur 24 Verteilte Architektur Server Spring Boot Application Spring Boot Application Spring Boot Application Mögliche Use Cases: Service Registry Zentrales Monitoring Zentrale Authentifizierung/ Autorisierung usw.
25. Client-Server-Architektur Unser persönlicher Anwendungsfall: Monitoring von Spring Boot Anwendungen •  REST Actuator Endpoints 25
26. 26 Demo
27. Spring Boot Admin 27 Actuator Endpoints (z.B. Health) { "status" : "UP", "diskSpace" : { "status" : "UP", "free" : 26665549824, "threshold" : 10485760 }, "db" : { "status" : "UP", "batchDataSource" : { "status" : "UP", "database" : "Oracle", "hello" : 1 }, } }
28. Spring Boot Admin 28
29. Spring Boot Admin 29
30. Spring Boot Admin 30 Architektur (Service Registrierung) Spring Boot Admin Server Spring Boot Application GUI HTTP Spring Boot Application Spring Boot Application register
31. Spring Boot Admin 31 Architektur (Client Kommunikation) Spring Boot Admin Server Spring Boot Application GUI HTTP Spring Boot Application Spring Boot Application check Health Zuul
32. Spring Boot Admin 32 Server @Configuration @EnableAutoConfiguration @EnableAdminServer public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }
33. Spring Boot Admin 33 /** * @author Dennis Schulte */ @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Import(AdminServerImportSelector.class) public @interface EnableAdminServer { }
34. Spring Boot Admin 34 public class AdminServerImportSelector implements DeferredImportSelector { @Override public String[] selectImports(AnnotationMetadata importingClassMetadata) { return new String[] { MailNotifierConfiguration.class.getCanonicalName(), HazelcastStoreConfiguration.class.getCanonicalName(), AdminServerWebConfiguration.class.getCanonicalName(), DiscoveryClientConfiguration.class.getCanonicalName(), RevereseZuulProxyConfiguration.class.getCanonicalName() }; } }
35. Spring Boot Admin 35 @Configuration public class AdminServerWebConfiguration extends WebMvcConfigurerAdapter implements ApplicationContextAware { /** * @return Default registry for all registered application. */ @Bean public ApplicationRegistry applicationRegistry() { return new ApplicationRegistry(applicationStore); } [...] }
36. Spring Boot Admin 36 Registrierung des Clients <dependency> <groupId>de.codecentric</groupId> <artifactId>spring-boot-admin-starter-client</artifactId> <version>1.2.4</version> </dependency> spring.boot.admin.url=http://monitoring:8083
37. Spring Boot Admin 37 Registrierung des Clients META-INF/spring.factories: org.springframework.boot.autoconfigure.EnableAutoConfiguration= de.codecentric.boot.admin.config.SpringBootAdminClientAutoConfiguration Warum nicht @EnableAdminClient?
38. Spring Boot Admin 38 Architektur mit Eureka Spring Boot Admin Server Spring Boot Application GUI Spring Boot Application Spring Boot Application register Eureka
39. Spring Boot Admin 39 Eureka: Discovery durch Server @Configuration @EnableAutoConfiguration @EnableDiscoveryClient @EnableAdminServer public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } eureka.instance.client.serviceUrl=http://service-registry:8761/eureka
40. 40 Health
41. Health • Basisinterface public interface HealthIndicator { Health health(); } 41
42. Health • Eigene Implementierung 42 Database Client DB DiskSpace Health Endpoint External File system Backend Service
43. Health • Eigene Implementierung public class BackendHealthIndicator extends AbstractHealthIndicator{ @Override protected void doHealthCheck(Health.Builder builder) { if(isBackendAvailable(url)){ builder.up(); }else{ builder.down(); } } } 43
44. Health • Eigene Implementierung @Bean public HealthIndicator backendHealthIndicator() { return new BackendHealthIndicator(url); } 44
45. 45 Metrics
46. Metrics public interface CounterService { void increment(String metricName); void decrement(String metricName); void reset(String metricName); } 46
47. Metrics public interface GaugeService { /** * Set the specified gauge value * @param metricName the name of the gauge to set * @param value the value of the gauge */ void submit(String metricName, double value); } 47
48. Metrics 48 Unser Use Case: Java Batch - Datenmigration •  Joblaufzeiten vergleichen •  Langläufer? •  Wo geht die Zeit verloren?
49. Metrics @Aspect public class ReaderProcessorWriterMetricsAspect { @Around("execution(* org.springframework.batch.item.ItemReader.read(..))") public Object profileReadMethods(ProceedingJoinPoint pjp) { StopWatch stopWatch = startStopWatch(); try { return pjp.proceed(); } finally { gaugeService.submit(getIdentifier(), getMillis(stopWatch)); } } } 49
50. Metrics @ConditionalOnProperty("batch.metrics.profiling.enabled") @Bean public ReaderProcessorWriterMetricsAspect batchMetricsAspects() { return new ReaderProcessorWriterMetricsAspect(gaugeService()); } 50
51. Metrics Job- und Step-Laufzeiten Metric [name=timer.batch.example-job.duration, value=2592.0, timestamp=Wed Oct 28 07:56:35 CET 2015] Metric [name=timer.batch.example-job.step1.duration, value=2519.0, timestamp=Wed Oct 28 07:56:35 CET 2015] Aspects Metric [name=timer.batch.example-job.step1.DummyItemReader.read, value=10.0, timestamp=Wed Oct 28 07:56:35 CET 2015] Metric [name=timer.batch.example- job.step1.ExampleService.callExternalRemoteService, value=569.0, timestamp=Wed Oct 28 07:56:35 CET 2015] Metric [name=timer.batch.example-job.step1.LogItemProcessor.process, value=569.0, timestamp=Wed Oct 28 07:56:35 CET 2015] Metric [name=timer.batch.example-job.step1.LogItemWriter.write, value=41.0, timestamp=Wed Oct 28 07:56:35 CET 2015] 51
52. Metrics 52
53. Metrics Eigene Exporter public interface Exporter { /** * Export metric data. */ void export(); } 53
54. Metrics Eigene Exporter @Bean @ConditionalOnProperty("batch.metrics.export.console.enabled") @ConditionalOnClass(ConsoleReporter.class) public Exporter consoleExporter() { return new ConsoleMetricsExporter(metricRegistry); } @Bean @ConditionalOnProperty("batch.metrics.export.graphite.enabled") @ConditionalOnClass(name="com.codahale.metrics.graphite.GraphiteReporter") public Exporter graphiteExporter() { return new GraphiteMetricsExporter(metricRegistry, metricReader, server, port); } 54
55. RESSOURCEN https://github.com/codecentric/spring-boot-starter-batch-web https://github.com/codecentric/spring-boot-admin https://blog.codecentric.de/en/2014/11/extending-spring-boot-five- steps-writing-spring-boot-starter/
56. 56 Fragen?