준비물
- 현재 리눅스와 Mac OSX에서만 동작한다. 윈도 사용자는 버철박스나 VMWare로 리눅스를 깔고 사용할 수 있다.
- JDK 1.7.0 이상
현재 Java와 Ruby API 지원
https://github.com/purplefox/vert.x/downloads 여기서 내려받고 압축을 푼 다음에 bin 디렉토리를 PATH에 추가하면 설치 끝.
실행
vertx 명령어 사용
고유 vertx 인스턴스에서 싱글 애플리케이션 실행하기
vertx run 사용
옵션
- 언어 옵션: -java(기본값), -ruby, -groovy, -js
- (필수 옵셥) 엔트리 포인트: -main 진입점 (자바의 경우 VertxApp 인터페이스 구현체를 설정하고 다른 언어는 진입점에 해당하는 스크립트 이름 설정)
- (필수 옵션) 클래스패스: -cp 클래스패스 (클래스나 스크립트가 들어있는 곳)
- 인스턴스 갯수: -instances 인스턴스갯수 (기본값은 코어 갯수)
자바 예제
vertx run -main org.acme.myapp.MyMain -cp myapp/classes
루비 예제
vertx run -ruby -main my_app.rb -cp lib
그루비 예제
서버 모드로 실행하기
멀티 태넌트 컨테이너 형태로 여러 vertx 인스턴스로 여러 애플리케이션을 실행할 수 있다. 각각의 애플리케이션은 별도의 클래스로더를 사용하기 때문에 다른 애플리케이션 인스턴스에 독립적이다.
서버 실행
vertx start
서버 종료
vertx stop
vertx 서버는 기본 포트로 25571을 사용하는데, vertx 서버를 여러개 띄울 때 이 포트를 설정할 수 있다. -port 옵션을 사용하면 된다.
포트 번호 주면서 서버 실행
vertx start -port 1234
특정 포트에 띄운 서버 종료
vertx stop -port 1234
서버에 애플리케이션 배포하기
vertx deploy 사용
옵션
- vertx run에서 사용하던 옵션 전부 사용 가능
- -name: 애프리케이션 이름
- -port: 애플리케이션을 배포할 vertx의 포트
서버에 애플리케이션 내리기
vertx undeploy
클러스터 모드로 실행하기
vertx run이나 vertx start에 -cluster 옵션을 추가한다.
클러스터 모드로 실행하면 vertx가 글로벌 이벤트 버스를 형성한다. 기본으로 클러스터가 된 vertx는 25500 포트를 사용해서 클러스터의 다른 노드와 연결을 맺는다. 한 호스트에 클러스터를 여러개 띄울떄는 cluster-port 옵션을 사용한다.
출처 - http://whiteship.me/?tag=vertx
