mirror of https://github.com/k3s-io/k3s
Squashing commits
adding a Java EE sample, fixing #11477 adding location to the source adding partial review comments from #12110 adding syncer macros and fixing linkspull/6/head
arun-gupta
parent
5f36c07111
commit
fe25b18573
|
|
@ -0,0 +1,167 @@
|
|||
<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
|
||||
|
||||
<!-- BEGIN STRIP_FOR_RELEASE -->
|
||||
|
||||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
||||
width="25" height="25">
|
||||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
||||
width="25" height="25">
|
||||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
||||
width="25" height="25">
|
||||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
||||
width="25" height="25">
|
||||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
|
||||
width="25" height="25">
|
||||
|
||||
<h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
|
||||
|
||||
If you are using a released version of Kubernetes, you should
|
||||
refer to the docs that go with that version.
|
||||
|
||||
<strong>
|
||||
The latest 1.0.x release of this document can be found
|
||||
[here](http://releases.k8s.io/release-1.0/examples/javaee/README.md).
|
||||
|
||||
Documentation for other releases can be found at
|
||||
[releases.k8s.io](http://releases.k8s.io).
|
||||
</strong>
|
||||
--
|
||||
|
||||
<!-- END STRIP_FOR_RELEASE -->
|
||||
|
||||
<!-- END MUNGE: UNVERSIONED_WARNING -->
|
||||
|
||||
## Java EE Application using WildFly and MySQL
|
||||
|
||||
The following document describes the deployment of a Java EE application using [WildFly](http://wildfly.org) application server and MySQL database server on Kubernetes. The sample application source code is at: https://github.com/javaee-samples/javaee7-simple-sample.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/user-guide/prereqs.md
|
||||
|
||||
### Start MySQL Pod
|
||||
|
||||
In Kubernetes a [_Pod_](../../docs/user-guide/pods.md) is the smallest deployable unit that can be created, scheduled, and managed. Its a collocated group of containers that share an IP and storage volume.
|
||||
|
||||
Here is the config for MySQL pod: [mysql-pod.yaml](mysql-pod.yaml)
|
||||
|
||||
<!-- BEGIN MUNGE: mysql-pod.yaml -->
|
||||
<!-- END MUNGE: EXAMPLE -->
|
||||
|
||||
Create the MySQL pod:
|
||||
|
||||
```sh
|
||||
kubectl create -f examples/javaee/mysql-pod.yaml
|
||||
```
|
||||
|
||||
Check status of the pod:
|
||||
|
||||
```sh
|
||||
kubectl get -w po
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
mysql-pod 0/1 Pending 0 4s
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
mysql-pod 0/1 Running 0 44s
|
||||
mysql-pod 1/1 Running 0 44s
|
||||
```
|
||||
|
||||
Wait for the status to `1/1` and `Running`.
|
||||
|
||||
### Start MySQL Service
|
||||
|
||||
We are creating a [_Service_](../../docs/user-guide/services.md) to expose the TCP port of the MySQL server. A Service distributes traffic across a set of Pods. The order of Service and the targeted Pods does not matter. However Service needs to be started before any other Pods consuming the Service are started.
|
||||
|
||||
In this application, we will use a Kubernetes Service to provide a discoverable endpoints for the MySQL endpoint in the cluster. MySQL service target pods with the labels `name: mysql-pod` and `context: docker-k8s-lab`.
|
||||
|
||||
Here is definition of the MySQL service: [mysql-service.yaml](mysql-service.yaml)
|
||||
|
||||
<!-- BEGIN MUNGE: mysql-service.yaml -->
|
||||
<!-- END MUNGE: EXAMPLE -->
|
||||
|
||||
Create this service:
|
||||
|
||||
```sh
|
||||
kubectl create -f examples/javaee/mysql-service.yaml
|
||||
```
|
||||
|
||||
Get status of the service:
|
||||
|
||||
```sh
|
||||
kubectl get -w se
|
||||
NAME LABELS SELECTOR IP(S) PORT(S)
|
||||
kubernetes component=apiserver,provider=kubernetes <none> 10.247.0.1 443/TCP
|
||||
mysql-service context=docker-k8s-lab,name=mysql-pod context=docker-k8s-lab,name=mysql-pod 10.247.63.43 3306/TCP
|
||||
```
|
||||
|
||||
If multiple services are running, then it can be narrowed by specifying labels:
|
||||
|
||||
```sh
|
||||
kubectl get -w po -l context=docker-k8s-lab,name=mysql-pod
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
mysql-pod 1/1 Running 0 4m
|
||||
```
|
||||
|
||||
This is also the selector label used by service to target pods.
|
||||
|
||||
When a Service is run on a node, the kubelet adds a set of environment variables for each active Service. It supports both Docker links compatible variables and simpler `{SVCNAME}_SERVICE_HOST` and `{SVCNAME}_SERVICE_PORT` variables, where the Service name is upper-cased and dashes are converted to underscores.
|
||||
|
||||
Our service name is ``mysql-service'' and so ``MYSQL_SERVICE_SERVICE_HOST'' and ``MYSQL_SERVICE_SERVICE_PORT'' variables are available to other pods. This host and port variables are then used to create the JDBC resource in WildFly.
|
||||
|
||||
### Start WildFly Replication Controller
|
||||
|
||||
WildFly is a lightweight Java EE 7 compliant application server. It is wrapped in a Replication Controller and used as the Java EE runtime.
|
||||
|
||||
In Kubernetes a [_Replication Controller_](../../docs/user-guide/replication-controller.md) is responsible for replicating sets of identical pods. Like a _Service_ it has a selector query which identifies the members of it's set. Unlike a service it also has a desired number of replicas, and it will create or delete pods to ensure that the number of pods matches up with it's desired state.
|
||||
|
||||
Here is definition of the MySQL service: [wildfly-rc.yaml](wildfly-rc.yaml).
|
||||
|
||||
<!-- BEGIN MUNGE: wildfly-rc.yaml -->
|
||||
<!-- END MUNGE: EXAMPLE -->
|
||||
|
||||
Create this controller:
|
||||
|
||||
```sh
|
||||
kubectl create -f examples/javaee/wildfly-rc.yaml
|
||||
```
|
||||
|
||||
Check status of the pod inside replication controller:
|
||||
|
||||
```sh
|
||||
kubectl get po
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
mysql-pod 1/1 Running 0 1h
|
||||
wildfly-rc-w2kk5 1/1 Running 0 6m
|
||||
```
|
||||
|
||||
### Access the application
|
||||
|
||||
Get IP address of the pod:
|
||||
|
||||
```sh
|
||||
kubectl get -o template po wildfly-rc-w2kk5 --template={{.status.podIP}}
|
||||
10.246.1.23
|
||||
```
|
||||
|
||||
Log in to minion and access the application:
|
||||
|
||||
```sh
|
||||
vagrant ssh minion-1
|
||||
Last login: Thu Jul 16 00:24:36 2015 from 10.0.2.2
|
||||
[vagrant@kubernetes-minion-1 ~]$ curl http://10.246.1.23:8080/employees/resources/employees/
|
||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><collection><employee><id>1</id><name>Penny</name></employee><employee><id>2</id><name>Sheldon</name></employee><employee><id>3</id><name>Amy</name></employee><employee><id>4</id><name>Leonard</name></employee><employee><id>5</id><name>Bernadette</name></employee><employee><id>6</id><name>Raj</name></employee><employee><id>7</id><name>Howard</name></employee><employee><id>8</id><name>Priya</name></employee></collection>
|
||||
```
|
||||
|
||||
### Delete resources
|
||||
|
||||
All resources created in this application can be deleted:
|
||||
|
||||
```sh
|
||||
kubectl delete -f examples/javaee/mysql-pod.yaml
|
||||
kubectl delete -f examples/javaee/mysql-service.yaml
|
||||
kubectl delete -f examples/javaee/wildfly-rc.yaml
|
||||
```
|
||||
|
||||
|
||||
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
|
||||
[]()
|
||||
<!-- END MUNGE: GENERATED_ANALYTICS -->
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
apiVersion: v1
|
||||
kind: Pod
|
||||
metadata:
|
||||
name: mysql-pod
|
||||
labels:
|
||||
name: mysql-pod
|
||||
context: docker-k8s-lab
|
||||
spec:
|
||||
containers:
|
||||
-
|
||||
name: mysql
|
||||
image: mysql:latest
|
||||
env:
|
||||
-
|
||||
name: "MYSQL_USER"
|
||||
value: "mysql"
|
||||
-
|
||||
name: "MYSQL_PASSWORD"
|
||||
value: "mysql"
|
||||
-
|
||||
name: "MYSQL_DATABASE"
|
||||
value: "sample"
|
||||
-
|
||||
name: "MYSQL_ROOT_PASSWORD"
|
||||
value: "supersecret"
|
||||
ports:
|
||||
-
|
||||
containerPort: 3306
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: mysql-service
|
||||
labels:
|
||||
name: mysql-pod
|
||||
context: docker-k8s-lab
|
||||
spec:
|
||||
ports:
|
||||
# the port that this service should serve on
|
||||
- port: 3306
|
||||
# label keys and values that must match in order to receive traffic for this service
|
||||
selector:
|
||||
name: mysql-pod
|
||||
context: docker-k8s-lab
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
apiVersion: v1
|
||||
kind: ReplicationController
|
||||
metadata:
|
||||
name: wildfly-rc
|
||||
labels:
|
||||
name: wildfly
|
||||
context: docker-k8s-lab
|
||||
spec:
|
||||
replicas: 1
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
name: wildfly
|
||||
spec:
|
||||
containers:
|
||||
- name: wildfly-rc-pod
|
||||
image: arungupta/wildfly-mysql-javaee7:k8s
|
||||
ports:
|
||||
- containerPort: 8080
|
||||
Loading…
Reference in New Issue