올해 1월에 만들어놓고... 요 근래에 들어서 속도를 올리는 중이다.
이제 1.3.0 버전이 나올 예정인데... 번역은 더디기만 하다.
10월말까지 해서 번역을 완료하고, 1.3.0.BUILD-SNAPSHOT 보고 업글하여 연말에는 번역을 마치는 것을 목표로 하고 있다.
| [SpringBoot] 1.3.0 - spring-boot-actuator-docs 추가 (0) | 2015.10.08 |
|---|---|
| [SpringBoot] 스프링부트 시작하기 (0) | 2015.09.25 |
| [SpringBoot] Remote Shell 기능소개 (0) | 2015.08.28 |
| [SpringBoot] 스프링부트 소개 (0) | 2015.08.02 |
| [SpringBoot] - @ConfigurationProperties in STS (0) | 2015.07.14 |
Evolve your Database Schema easily and reliably across all your instances
데이터베이스 스키마의 변화를 손쉽게 관리
하는 기능을 가진 기술
1.1. 왜 DB Migration 을 사용하는가?
각기 다른 데이터베이스에서 동일한 DB스키마를 유지할 수 있는 기능이 필요하다. 
코드쪽에서는 꽤 괜찮은 해결책들이 있다.
그런데 데이터베이스는??
보다 많은 질문들에 대해서는: 모르겠다!!
데이터베이스 마이그레이션으로 이 무제들을 해결할 수 있다!
마이그레이션 버전 1, 버전 2가 있는 상황에서 flyway는 SCHEMA_VERSION 라는 이름의 비어있는 단독 테이블을 생성한다.
테이블이 생성되면 flyway는 즉시 파일시스템 혹은 애플리케이션의 마이그레이션을 위해 지정된 클래스패스에서 SQL 혹은 JAVA 파일을 탐색한다. 탐색된 파일들은 버전에 따라서 정렬하여 실행한다. 
마이그레이션 버전1, 버전2가 각각 실행되면 SCHEMA_VERSION 테이블에는 다음과 같이 마이그레이션 이력이 저장된다.
애플리케이션이 실행될때마다 flyway 설정에 따라서 파일과 SCHEMA_VERSION의 변동사항을 확인하나. 새로운 버전의 파일이 추가되면 실행하고 그 변경이력을SCHEMA_VERSION에 추가한다.
참 쉽죠??
스프링부트에서는 데이터베이스 마이그레이션을 지원한다. 그 중에서 Flyway를 채택했다. 이전 프로젝트에서는 Carbon5(c5-db-migration) 라고 하는 마이그레이션 도구를 사용했는데...
그러다가 발견한 것이 Flyway. 손쉽게 사용가능함.
...org.flywaydbflyway-maven-plugin3.2.1jdbc:h2:file:target/foobarsacom.h2databaseh21.3.170
buildscript {dependencies {classpath 'org.flywaydb:flyway-gradle-plugin:3.2.1'}apply plugin: 'org.flywaydb.flyway'apply plugin: 'java'flyway {user = 'sa'}
dependencies {}
application.yml(or properties) 설정DB를 초기화하는 다양한 방법들이 있다.
그보다 높은 차원에서 손쉽게할 수 있는 것들이 있는데, 그중 하나가 바로 Flyway
flyway:check-location: true # 마이그레이션 스크립트 파일이 존재하는지 여부를 확인locations: classpath:db/migration # 마이그레이션 스크립트 위치baseline-version: LATEST # 마이그레이션을 시작할 번호sql-migration-prefix: Vsql-migration-suffix: .sqlurl: jdbc:h2:file:~/.database/flywaydb;DB_CLOSE_DELAY=-1;AUTO_SERVER=TRUE;DB_CLOSE_ON_EXIT=FALSE; # Flyway 소유의 데이터소스를 생성하려고 하는 경우 사용user: sa # Flyway 소유의 데이터소스를 생성하려고 하는 경우 사용password: # Flyway 소유의 데이터소스를 생성하려고 하는 경우 사용
# FLYWAY (FlywayProperties)flyway.*= # Any public property available on the auto-configured `Flyway` objectflyway.check-location=false # check that migration scripts location existsflyway.locations=classpath:db/migration # locations of migrations scriptsflyway.schemas= # schemas to updateflyway.init-version= 1 # version to start migrationflyway.init-sqls= # SQL statements to execute to initialize a connection immediately after obtaining itflyway.sql-migration-prefix=Vflyway.sql-migration-suffix=.sqlflyway.enabled=trueflyway.url= # JDBC url if you want Flyway to create its own DataSourceflyway.user= # JDBC username if you want Flyway to create its own DataSourceflyway.password= # JDBC password if you want Flyway to create its own DataSource
어디까지나 수동.... 처음에는 수동처리가 필요함...
로컬 테스트에서 Hibernate에서 DDL 쿼리를 생성하도록 정의 생성하도록 설정
jpa:hibernate:
테스트를 실행
사용할려는 DB에 따라 생성하는 SQL 스크립트가 달라질 수 있는데, 이는H2Database 에서 제공하는 기능을 활용하여 MySQL, Oracle 등으로 변경하면 하이버네이트의 방언Dialect 에 의해 적절한 쿼리가 생성됨
쿼리를 복사하여 손질
프로젝트 내에 포함되어 있으니 모든 것을 형상관리시스템에 맡긴다.
| [eclipse] gradle multi project import invalid 발생 (0) | 2016.03.11 |
|---|---|
| [이클립스] 우분투 14.04 + AMD ATI Radeon + Eclipse (0) | 2016.03.10 |
| 이클립스 마르스 변경 후 소스 생성이 제대로 안된다면, 롬복쓰나? Lombok 해프닝 (0) | 2015.08.27 |
| ModelMapper 사용주의: 계층구조가 복잡한 객체는 사용을 주의 (0) | 2015.03.16 |
| 젠킨스 Jenkins 재가동 후 초기화상태 문제 해결 (0) | 2014.05.27 |
스프링부트가 가지고 있는 강력한 기능 중 하나가, 바로 액츄에이터 이다. 그 중에서 내가 지금까지 몰랐던 Remote Shell에 대한 기능을 살펴본다. 리모트쉘은 별다른 코딩을 하지 않아도 사용이 가능하다.
리모트쉘의 의존성은 다음과 같다.
dependencies {compile("org.springframework.boot:spring-boot-starter-remote-shell")// 생략}
org.springframework.boot:spring-boot-starter-security 을 추가하지 않으면 다음 클래과 같은 예외가 발생하며 실패한다.
Caused by: java.lang.ClassNotFoundException: org.springframework.security.config.http.SessionCreationPolicyat java.net.URLClassLoader$1.run(URLClassLoader.java:361)at java.security.AccessController.doPrivileged(Native Method)at java.net.URLClassLoader.findClass(URLClassLoader.java:360)at java.lang.ClassLoader.loadClass(ClassLoader.java:424)at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)at java.lang.ClassLoader.loadClass(ClassLoader.java:357)... 42 more:bootRun FAILED
SSH와 관련해서 필요한 것으로 보인다. 리모트쉘의 기본포트는 2000번이다. 이 부분은 다음에 있는 설정코드에서 수정가능하다. 리모트쉘에서 사용하는 속성은 다음과 같다. 자세한 내용은 레퍼런스 문서를 살펴보기 바란다.
# REMOTE SHELLshell.auth=simple # jaas, key, simple, springshell.command-refresh-interval=-1shell.command-path-patterns= # classpath*:/commands/**, classpath*:/crash/commands/**shell.config-path-patterns= # classpath*:/crash/*shell.disabled-commands=jpa*,jdbc*,jndi* # comma-separated list of commands to disableshell.disabled-plugins=false # don't expose pluginsshell.ssh.enabled= # ssh settings ...shell.ssh.key-path=shell.ssh.port=shell.telnet.enabled= # telnet settings ...shell.telnet.port=shell.auth.jaas.domain= # authentication settings ...shell.auth.key.path=shell.auth.simple.user.name=shell.auth.simple.user.password=shell.auth.spring.roles=
내가 테스트를 위해 설정한 속성은 다음과 같다. application.yml:
# @author: honeymonmanagement:shell:port: 10000port: 10001password: remote-shell
리모트쉘에 접근하는 방법은 다음과 같다.
ssh -p <port-number> <shell.auth.simple.user.name 값>@접근서버 IP 혹은 호스트명//위의 설정에 따르면 다음과 같이 접근이 가능하다.ex) $ ssh -p 10001 honeymon@localhost
텔넷으로 접근하려면 다음의 의존성을 추가해야 한다.
If you want to also enable telnet access you will additionally need a dependency on
org.crsh:crsh.shell.telnetsearch.maven.org crsh.shell.telnet 검색 telnet 접속해보려고 했더니 오류가 발생...
Caused by: java.lang.NoSuchMethodError: org.crsh.vfs.Resource.<init>(Ljava/net/URL;)Vat org.crsh.plugin.PluginManager.getPlugins(PluginManager.java:83)at org.crsh.plugin.PluginContext.start(PluginContext.java:327)at org.crsh.plugin.PluginLifeCycle.start(PluginLifeCycle.java:104)at org.springframework.boot.actuate.autoconfigure.CrshAutoConfiguration$CrshBootstrapBean.init(CrshAutoConfiguration.java:230)at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)at java.lang.reflect.Method.invoke(Method.java:483)at org.springframework.beans.factory.annotation.InitDestroyAnnotationBeanPostProcessor$LifecycleElement.invoke(InitDestroyAnnotationBeanPostProcessor.java:349)at org.springframework.beans.factory.annotation.InitDestroyAnnotationBeanPostProcessor$LifecycleMetadata.invokeInitMethods(InitDestroyAnnotationBeanPostProcessor.java:300)at org.springframework.beans.factory.annotation.InitDestroyAnnotationBeanPostProcessor.postProcessBeforeInitialization(InitDestroyAnnotationBeanPostProcessor.java:133)... 17 more
처음 접근할 경우에는 다음과 같이 인증키를 저장할지를 묻는다.
리모트쉘로 접근하면 다음과 같은 화면을 볼 수 있다.
리모트쉘에서 사용할 수 있는 명령어는 help 를 타이핑하면 다음과 같은 내용을 볼 수 있다.
> helpTry one of these commands with the -h or --help switch:NAME DESCRIPTIONautoconfig Display auto configuration report from ApplicationContextbeans Display beans in ApplicationContextcron manages the cron plugindashboard a monitoring dashboardegrep search file(s) for lines that match a patternendpoint Invoke actuator endpoints //앱에 설정된 애드포인트 목록들을 확인가능하다.env display the term envfilter a filter for a stream of mapjava various java language commandsjmx Java Management Extensionsjul java.util.logging commandsjvm JVM informationsless opposite of moremail interact with emailsman format and display the on-line manual pagesmetrics Display metrics provided by Spring Bootshell shell related commandsleep sleep for some timesort sort a mapsystem vm system properties commandsthread JVM thread commandshelp provides basic helprepl list the repl or change the current repl
리모트쉘은 CRaSH를 사용했다. 배너를 바꾸고 싶은데... 그 중에서 우와!!하면서 감탄했던 것이 대시보드!
화면크기에 따라 리사이징도 된다! +_+)b
스프링 액츄에이터SpringBoot actuator 에서 제공하는 엔드포인트 중 하나인 metrics 정보를 모니터링할 수 있는 metrics
리모트쉘로 원격접속해서 애플리케이션의 상태를 살필 수 있는 수단이 생겼다는 건 애플리케이션을 관리하는데 더욱 편해진다는 것이다. 리모트쉘로 접근해서... endpoint invoke shutdown을 실행하면!!
당신은 주금!!(애플리케이션을 켜로 터미널로 서버에 접속해야하는 번거로움이 생길 것이다).
리모트쉘에서 애플리케이션을 끄기 위해서는
리모트쉘에서 셧타운을 실행하기 위해서는 application.properties(or yml)에 다음 항목을 추가해야한다.
endpoints.shutdown.enabled=true
이렇게 가볍게 스프링부트가 제공하는 기능 중 하나인 리모트쉘Remote shell을 살펴봤다. 리모트쉘을 통해서 애플리케이션의 상태를 모니터링하고 제어하는 것이 가능해졌다. 스프링부트를 기반으로 배포하는 앱에는 반드시 넣어줘야할 녀석이었다. 바로! 추가!
| [SpringBoot] 스프링부트 시작하기 (0) | 2015.09.25 |
|---|---|
| [SpringBoot] 스프링부트 참고문서(1.2.0.BUILD-SNAPSHOT) (아직도)번역중 (0) | 2015.09.10 |
| [SpringBoot] 스프링부트 소개 (0) | 2015.08.02 |
| [SpringBoot] - @ConfigurationProperties in STS (0) | 2015.07.14 |
| SpringBoot: h2database에 접근할 수 있는 h2console 을 애플리케이션과 함께 사용하기 (0) | 2015.05.20 |
얼마 전 Eclipse Mars가 출시하고, 스프링에서는 이클립스 마르스를 얹은 STS.3.7.0 버전을 내놓았다.
나는 지금까지 개발할 때 Lombok을 많이 사용해왔다. 클래스 내 필드에 대한 Getter/Setter 생성이나 toString(), equals(), hashCode() 메서드를 오버라이드 하기 위해 클래스에 코드가 덕지덕지 붙는 것을 어노테이션들(@ToString,@EqualsAndHashCode, @Getter, @Setter, @Data 등)로 대신할 수 있기 때문이다. 자바로 개발할 때 겪게되는 반복적이고 가독성에 크게 도움되지 않는 녀석들을 컴파일과정에서 어노테이션을 기반으로 하여 자동생성해주기에 코드가 그나마 많이 간결해진다.
그런데!! 이클립스 루나까지는 크게 문제가 없던 STS(3.6.0)에서 3.7.0으로 버전업을 하고 난 이후에 몇몇 결함이 발생한다. 예를 들어,
등... 개발하는 과정에서 자주하는 일들을 할 수가 없는 것은, 가뜩이나 좋지 않은, 생산성을 뚜욱하고 떨어뜨리는 슬픈 상황을 만들었다. 그래도 투덜거리면서 쓰다가,
투걸거리지만 말고, 버그 리포팅을 해서 개선할 수 있도록 해주세요.
간단하게 Getter/Setter를 만드는 작업을 진행해보면 다음과 같은 증상이 나온다.
라고 올챙이 프로젝트(https://github.com/hangum/TadpoleForDBTools)를 지휘하고 계시는 조현종님이 말씀하시기에 '그래, 버그를 수정할 수 있도록 돕자'하는 마음에 이클립스의 'Error View'를 열고 이클립스에서 생긴 예외상황을 찾아봤다. 그리고 이 것을 SNS에 올리니까
그거 롬복 때문에 생긴 문제에요. 롬복 최신버전 받으면 정상적으로 동작해요.
라고 지인(http://sbcoba.tistory.com/)이 알려주었다. 이 때 찾아드는 허무감이란... 요 근래에 개발환경에 큰 변화가 찾아오기는 했다.
이런 변화를 간과하고 이클립스만 탓한 내가 부끄러워지는구나.... 사용하고 있던 롬복은 v1.14.8 버전이다. 현재(2015/08/27) project lombok에서 다운로드 가능한 버전은1.16.6(https://projectlombok.org/changelog.html)이다. 8월 16일에 반영된 내용을 살펴보니
이다. 이클립스 마르스와 관련해서 버그가 있었던 것이었다. 최신버전 받으면 해결된다. 혹은... 롬복을 사용하지 않으면 된다.
| [이클립스] 우분투 14.04 + AMD ATI Radeon + Eclipse (0) | 2016.03.10 |
|---|---|
| FlywayDB 소개, DB SCHEMA 관리 (0) | 2015.09.08 |
| ModelMapper 사용주의: 계층구조가 복잡한 객체는 사용을 주의 (0) | 2015.03.16 |
| 젠킨스 Jenkins 재가동 후 초기화상태 문제 해결 (0) | 2014.05.27 |
| STS - Spring Starter Project 만들기 (0) | 2014.04.16 |
@Repository 애노테이션을 사용한 곳에 예외변환 AOP를 적용해서 JPA 예외를 스프링프레임워크가 추상화한 예외로 변환하도록 처리
/**
* 스프링 JPA 예외변환기 적용 <code>@Repository</code> 사용한 곳에 예외변환 AOP를 적용
*
* @return
*/
@Bean
public PersistenceExceptionTranslationPostProcessor exceptionTranslation() {
return new PersistenceExceptionTranslationPostProcessor();
}
JPARepository(org.springframework.data.jpa.repository.JpaRepository) 인터페이스를 구현해도 적용...
