이 블로그에서는 간단한 Java 애플리케이션이 Kubernetes의 서비스 검색을 사용하여 데이터베이스와 통신하는 방법을 보여드립니다.
DC/OS에서 Java 및 데이터베이스 애플리케이션을 사용한 서비스 검색 에서 서비스 검색이 멀티 컨테이너 애플리케이션에 중요한 이유를 설명합니다. 이 블로그에서는 DC/OS에서 이를 수행하는 방법도 설명합니다.
애플리케이션 서버와 데이터베이스 서버의 단일 인스턴스를 사용하여 Kubernetes에서 이를 어떻게 수행할 수 있는지 알아보겠습니다. 이 블로그에서는 애플리케이션 서버에는 WildFly를, 데이터베이스에는 Couchbase를 사용합니다.
이 블로그에서는 다음과 같은 주요 단계를 사용합니다:
- 쿠버네티스 원노드 클러스터 시작하기
- 쿠버네티스 애플리케이션 정의
- 애플리케이션 배포
- 애플리케이션에 액세스
쿠버네티스 클러스터 시작
미니큐브 는 노트북의 가상 머신에서 단일 노드 Kubernetes 클러스터를 시작하는 가장 쉬운 방법입니다. 바이너리를 먼저 다운로드한 다음 설치해야 합니다.
전체 설치 지침은 다음에서 확인할 수 있습니다. github.com/kubernetes/minikube.
그리고 최신 릴리스 로 OSX에 설치할 수 있습니다:
|
1 2 |
curl -Lo minikube https://storage.googleapis.com/minikube/releases/v0.17.1/minikube-darwin-amd64 \ && chmod +x minikube |
또한 다음이 필요합니다. kubectl 를 설치해야 합니다. kubectl 설치 및 설정하기 에서 kubectl을 설치하는 방법에 대한 자세한 지침을 제공한다. OSX에서는 다음과 같이 설치할 수 있다:
|
1 2 |
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl \ && chmod +x ./kubectl |
이제 클러스터를 다음 이름으로 시작합니다:
|
1 2 3 4 5 6 7 8 9 10 11 |
minikube start Starting local Kubernetes cluster... Starting VM... Downloading Minikube ISO 88.71 MB / 88.71 MB [==============================================] 100.00% 0s SSH-ing files into VM... Setting up certs... Starting cluster components... Connecting to cluster... Setting up kubeconfig... Kubectl is now configured to use the cluster. |
그리고 kubectl 버전 명령은 kubectl 클라이언트 및 미니큐브 서버 버전에 대한 자세한 정보를 보여줍니다:
|
1 2 3 |
kubectl version Client Version: version.Info{Major:"1", Minor:"5", GitVersion:"v1.5.4", GitCommit:"7243c69eb523aa4377bce883e7c0dd76b84709a1", GitTreeState:"clean", BuildDate:"2017-03-07T23:53:09Z", GoVersion:"go1.7.4", Compiler:"gc", Platform:"darwin/amd64"} Server Version: version.Info{Major:"1", Minor:"5", GitVersion:"v1.5.3", GitCommit:"029c3a408176b55c30846f0faedf56aae5992e9b", GitTreeState:"clean", BuildDate:"1970-01-01T00:00:00Z", GoVersion:"go1.7.3", Compiler:"gc", Platform:"linux/amd64"} |
클러스터에 대한 자세한 내용은 다음을 사용하여 얻을 수 있습니다. kubectl 클러스터 정보 명령을 사용합니다:
|
1 2 3 4 5 |
Kubernetes master is running at https://192.168.99.100:8443 KubeDNS is running at https://192.168.99.100:8443/api/v1/proxy/namespaces/kube-system/services/kube-dns kubernetes-dashboard is running at https://192.168.99.100:8443/api/v1/proxy/namespaces/kube-system/services/kubernetes-dashboard To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'. |
쿠버네티스 애플리케이션 정의
애플리케이션 정의는 다음에서 정의됩니다. github.com/arun-gupta/kubernetes-java-sample/blob/master/service-discovery.yml. 다음으로 구성됩니다:
- 카우치베이스 서비스
- 단일 포드가 포함된 Couchbase 복제본 세트
- 단일 포드가 포함된 WildFly 복제본 세트
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 |
apiVersion: v1 kind: Service metadata: name: couchbase-service spec: selector: app: couchbase-rs-pod ports: - name: admin port: 8091 - name: views port: 8092 - name: query port: 8093 - name: memcached port: 11210 --- apiVersion: extensions/v1beta1 kind: ReplicaSet metadata: name: couchbase-rs spec: replicas: 1 template: metadata: labels: app: couchbase-rs-pod spec: containers: - name: couchbase image: arungupta/couchbase:travel ports: - containerPort: 8091 - containerPort: 8092 - containerPort: 8093 - containerPort: 11210 --- apiVersion: extensions/v1beta1 kind: ReplicaSet metadata: name: wildfly-rs labels: name: wildfly spec: replicas: 1 template: metadata: labels: name: wildfly spec: containers: - name: wildfly-rs-pod image: arungupta/wildfly-couchbase-javaee:travel env: - name: COUCHBASE_URI value: couchbase-service ports: - containerPort: 8080 |
핵심 부분은 COUCHBASE_URI 환경 변수는 Couchbase 서비스의 이름입니다. 이를 통해 WildFly에 배포된 애플리케이션이 서비스를 동적으로 검색하고 데이터베이스와 통신할 수 있습니다.
arungupta/couchbase:travel 도커 이미지는 다음을 사용하여 생성됩니다. github.com/arun-gupta/couchbase-javaee/blob/master/couchbase/Dockerfile.
arungupta/wildfly-couchbase-javaee:travel 도커 이미지는 다음을 사용하여 생성됩니다. github.com/arun-gupta/couchbase-javaee/blob/master/Dockerfile.
Java EE 애플리케이션은 데이터베이스 쿼리를 시작하기 전에 데이터베이스 초기화가 완료될 때까지 기다립니다. 이는 다음에서 확인할 수 있습니다. github.com/arun-gupta/couchbase-javaee/blob/master/src/main/java/org/couchbase/sample/javaee/Database.java#L25.
애플리케이션 배포
이 애플리케이션은 다음과 같이 배포할 수 있습니다:
|
1 |
kubectl create -f ~/workspaces/kubernetes-java-sample/service-discovery.yml |
서비스 및 복제본 세트 목록은 다음 명령을 사용하여 표시할 수 있습니다. kubectl get svc,rs:
|
1 2 3 4 5 6 7 8 |
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE svc/couchbase-service 10.0.0.97 <none> 8091/TCP,8092/TCP,8093/TCP,11210/TCP 27m svc/kubernetes 10.0.0.1 <none> 443/TCP 1h svc/wildfly-rs 10.0.0.252 <none> 8080/TCP 21m NAME DESIRED CURRENT READY AGE rs/couchbase-rs 1 1 1 27m rs/wildfly-rs 1 1 1 27m |
Couchbase의 단일 복제본에 대한 로그는 다음 명령을 사용하여 얻을 수 있습니다. kubectl 로그 rs/couchbase-rs:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
++ set -m ++ sleep 25 ++ /entrypoint.sh couchbase-server Starting Couchbase Server -- Web UI available at https://<ip>:8091 and logs available in /opt/couchbase/var/lib/couchbase/logs ++ curl -v -X POST https://127.0.0.1:8091/pools/default -d memoryQuota=300 -d indexMemoryQuota=300 . . . {"storageMode":"memory_optimized","indexerThreads":0,"memorySnapshotInterval":200,"stableSnapshotInterval":5000,"maxRollbackPoints":5,"logLevel":"info"}[]Type: ++ echo 'Type: ' ++ '[' '' = WORKER ']' ++ fg 1 /entrypoint.sh couchbase-server |
WildFly 복제본 세트에 대한 로그는 다음 명령을 사용하여 확인할 수 있습니다. kubectl 로그 RS/WILDFLY-RS:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
========================================================================= JBoss Bootstrap Environment JBOSS_HOME: /opt/jboss/wildfly . . . 06:32:08,537 INFO [com.couchbase.client.core.node.Node] (cb-io-1-1) Connected to Node couchbase-service 06:32:09,262 INFO [com.couchbase.client.core.config.ConfigurationProvider] (cb-computations-3) Opened bucket travel-sample 06:32:09,366 INFO [stdout] (ServerService Thread Pool -- 65) Sleeping for 3 secs ... 06:32:12,369 INFO [stdout] (ServerService Thread Pool -- 65) Bucket found! 06:32:14,194 INFO [org.jboss.resteasy.resteasy_jaxrs.i18n] (ServerService Thread Pool -- 65) RESTEASY002225: Deploying javax.ws.rs.core.Application: class org.couchbase.sample.javaee.MyApplication 06:32:14,195 INFO [org.jboss.resteasy.resteasy_jaxrs.i18n] (ServerService Thread Pool -- 65) RESTEASY002200: Adding class resource org.couchbase.sample.javaee.AirlineResource from Application class org.couchbase.sample.javaee.MyApplication 06:32:14,310 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 65) WFLYUT0021: Registered web context: /airlines 06:32:14,376 INFO [org.jboss.as.server] (ServerService Thread Pool -- 34) WFLYSRV0010: Deployed "airlines.war" (runtime-name : "airlines.war") 06:32:14,704 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0060: Http management interface listening on https://127.0.0.1:9990/management 06:32:14,704 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0051: Admin console listening on https://127.0.0.1:9990 06:32:14,705 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Full 10.1.0.Final (WildFly Core 2.2.0.Final) started in 29470ms - Started 443 of 691 services (404 services are lazy, passive or on-demand) |
애플리케이션 액세스
그리고 kubectl 프록시 명령은 쿠버네티스 API 서버에 대한 프록시를 시작합니다. 애플리케이션에 액세스하기 위해 Kubernetes 프록시를 시작해 보겠습니다:
|
1 2 |
kubectl proxy Starting to serve on 127.0.0.1:8001 |
다음을 사용하여 WildFly 복제본 세트를 서비스로 노출합니다:
|
1 |
kubectl expose --name=wildfly-service rs/wildfly-rs |
서비스 목록은 다음을 사용하여 다시 볼 수 있습니다. kubectl get svc 명령을 사용합니다:
|
1 2 3 4 5 |
kubectl get svc NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE couchbase-service 10.0.0.97 <none> 8091/TCP,8092/TCP,8093/TCP,11210/TCP 41m kubernetes 10.0.0.1 <none> 443/TCP 1h wildfly-service 10.0.0.169 <none> 8080/TCP 5s |
이제 애플리케이션은 다음 주소에서 액세스할 수 있습니다:
|
1 |
curl https://localhost:8001/api/v1/proxy/namespaces/default/services/wildfly-service/airlines/resources/airline |
형식이 지정된 출력은 다음과 같습니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
[ { "travel-sample": { "country": "United States", "iata": "Q5", "callsign": "MILE-AIR", "name": "40-Mile Air", "icao": "MLA", "id": 10, "type": "airline" } }, { "travel-sample": { "country": "United States", "iata": "TQ", . . . "name": "Airlinair", "icao": "RLA", "id": 1203, "type": "airline" } } ] |
이제 복제본 세트를 확장하여 새 파드를 Couchbase 서비스의 일부로 추가할 수 있습니다. 기존 파드는 종료되거나 일정이 변경될 수 있습니다. 그러나 Java EE 애플리케이션은 논리적 이름을 사용하여 데이터베이스 서비스에 계속 액세스합니다.
이 블로그에서는 간단한 Java 애플리케이션이 Kubernetes의 서비스 검색을 사용하여 데이터베이스와 통신하는 방법을 보여드렸습니다.
자세한 내용은 여기에서 확인하세요:
[...] Kubernetes의 Java 및 데이터베이스 애플리케이션을 사용한 서비스 검색 [...]