https://github.com/purplefox/vert.x/wiki/Installation-and-running

준비물

  • 현재 리눅스와 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 옵션을 사용한다.