Este blog mostrará como um aplicativo Java simples pode se comunicar com um banco de dados usando a descoberta de serviços no Kubernetes.
Descoberta de serviço com aplicativo Java e banco de dados no DC/OS explica por que a descoberta de serviços é um aspecto importante para um aplicativo com vários contêineres. Esse blog também explicou como isso pode ser feito no DC/OS.
Vamos ver como isso pode ser feito no Kubernetes com uma única instância do servidor de aplicativos e do servidor de banco de dados. Este blog usará o WildFly como servidor de aplicativos e o Couchbase como banco de dados.
Este blog usará as seguintes etapas principais:
- Iniciar o cluster de um nó do Kubernetes
- Definição do aplicativo Kubernetes
- Implantar o aplicativo
- Acesse o aplicativo
Iniciar o cluster do Kubernetes
Minikube é a maneira mais fácil de iniciar um cluster Kubernetes de um nó em uma VM em seu laptop. O binário precisa ser baixado primeiro e depois instalado.
As instruções completas de instalação estão disponíveis em github.com/kubernetes/minikube.
O versão mais recente pode ser instalado no OSX da mesma forma:
|
1 2 |
curl -Lo minikube https://storage.googleapis.com/minikube/releases/v0.17.1/minikube-darwin-amd64 \ && chmod +x minikube |
Também requer kubectl a ser instalado. Instalação e configuração do kubectl fornecem instruções detalhadas sobre como configurar o kubectl. No OSX, ele pode ser instalado como:
|
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 |
Agora, inicie o cluster como:
|
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. |
O versão do kubectl mostra mais detalhes sobre o cliente kubectl e a versão do servidor minikube:
|
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"} |
Mais detalhes sobre o cluster podem ser obtidos usando o comando kubectl cluster-info comando:
|
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'. |
Definição do aplicativo Kubernetes
A definição do aplicativo é definida em github.com/arun-gupta/kubernetes-java-sample/blob/master/service-discovery.yml. Ele consiste em:
- Um serviço Couchbase
- Conjunto de réplicas do Couchbase com um único pod
- Um conjunto de réplicas do WildFly com um único pod
|
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 |
A parte principal é onde o valor do COUCHBASE_URI é o nome do serviço do Couchbase. Isso permite que o aplicativo implantado no WildFly descubra dinamicamente o serviço e se comunique com o banco de dados.
arungupta/couchbase:travel A imagem do Docker é criada usando github.com/arun-gupta/couchbase-javaee/blob/master/couchbase/Dockerfile.
arungupta/wildfly-couchbase-javaee:travel A imagem do Docker é criada usando github.com/arun-gupta/couchbase-javaee/blob/master/Dockerfile.
O aplicativo Java EE espera que a inicialização do banco de dados seja concluída antes de começar a consultar o banco de dados. Isso pode ser visto em github.com/arun-gupta/couchbase-javaee/blob/master/src/main/java/org/couchbase/sample/javaee/Database.java#L25.
Implantar aplicativo
Esse aplicativo pode ser implantado como:
|
1 |
kubectl create -f ~/workspaces/kubernetes-java-sample/service-discovery.yml |
A lista de serviços e o conjunto de réplicas podem ser exibidos com o comando 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 |
Os registros da réplica única do Couchbase podem ser obtidos com o comando kubectl registra 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 |
Os registros do conjunto de réplicas do WildFly podem ser vistos usando o comando Registros do 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) |
Aplicativo de acesso
O proxy kubectl inicia um proxy para o servidor da API do Kubernetes. Vamos iniciar um proxy do Kubernetes para acessar nosso aplicativo:
|
1 2 |
kubectl proxy Starting to serve on 127.0.0.1:8001 |
Exponha o conjunto de réplicas do WildFly como um serviço usando:
|
1 |
kubectl expose --name=wildfly-service rs/wildfly-rs |
A lista de serviços pode ser vista novamente usando kubectl get svc comando:
|
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 |
Agora, o aplicativo pode ser acessado em:
|
1 |
curl https://localhost:8001/api/v1/proxy/namespaces/default/services/wildfly-service/airlines/resources/airline |
Uma saída formatada tem a seguinte aparência:
|
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" } } ] |
Agora, novos pods podem ser adicionados como parte do serviço do Couchbase, dimensionando o conjunto de réplicas. Os pods existentes podem ser encerrados ou reprogramados. Mas o aplicativo Java EE continuará a acessar o serviço de banco de dados usando o nome lógico.
Este blog mostrou como um aplicativo Java simples pode se comunicar com um banco de dados usando a descoberta de serviços no Kubernetes.
Para obter mais informações, confira:
- Documentos do Kubernetes
- Couchbase em contêineres
- Couchbase Portal do desenvolvedor
- Faça perguntas sobre Fóruns do Couchbase ou Estouro de pilha
- Baixar Couchbase
[...] Descoberta de serviço com aplicativo Java e banco de dados no Kubernetes [...]