forked from LaconicNetwork/kompose
d0fff4c85d
Fixed typo Updated documents Updated integrations.md and maven-example.md Added output for commands and some minor updates Added coomand to access service and minor updates Fixed minor typing errors Added screenshot of output Added output image in image folder and minor typing errors Fixed typo Updated minor typos
90 lines
2.8 KiB
Markdown
90 lines
2.8 KiB
Markdown
# Fabric8 Maven Plugin + Kompose:
|
|
Lets deploy a Springboot Java application with Docker Compose file using Fabric8 Maven Plugin to Kubernetes or OpenShift.
|
|
|
|
##### Requirements
|
|
* Linux or MacOS or Windows
|
|
* JDK 1.7+ - [JDK Quick Installation Guide](http://openjdk.java.net/install/)
|
|
* Maven 3.x+ - [Maven Installation Guide](http://www.baeldung.com/install-maven-on-windows-linux-mac)
|
|
* Kompose - [Kompose Installation Guide](/docs/installation)
|
|
|
|
__1. Clone the example project from GitHub__
|
|
```bash
|
|
$ git clone https://github.com/piyush1594/kompose-maven-example.git
|
|
```
|
|
|
|
Change current directory to `kompose-maven-example` directory.
|
|
```bash
|
|
$ cd kompose-maven-example
|
|
```
|
|
|
|
__2. Add Fabric8 Maven Plugin to your project__
|
|
```bash
|
|
$ mvn io.fabric8:fabric8-maven-plugin:3.5.28:setup
|
|
```
|
|
|
|
Adds the Fabric8 Maven Plugin configuration to `pom.xml` of project. `pom.xml` is manifest or deployment descriptor file of a maven project.
|
|
|
|
__3. Install Kompose through Maven__
|
|
```bash
|
|
$ mvn fabric8:install
|
|
```
|
|
|
|
This command installs the `kompose` on the host.
|
|
|
|
__4. Configure Fabric8 Maven Plugin to use a Docker Compose file__
|
|
```bash
|
|
<plugin>
|
|
<groupId>io.fabric8</groupId>
|
|
<artifactId>fabric8-maven-plugin</artifactId>
|
|
<configuration>
|
|
<composeFile>path for docker compose file</composeFile>
|
|
</configuration>
|
|
<executions>
|
|
<execution>
|
|
<goals>
|
|
<goal>resource</goal>
|
|
<goal>build</goal>
|
|
</goals>
|
|
</execution>
|
|
</executions>
|
|
</plugin>
|
|
```
|
|
|
|
Add the `<configuration>` and `<executions>` sections to `pom.xml` as shown in above `pom.xml` snippet. Update the `<composeFile>` to provide the relative path of Docker Compose file from `pom.xml`
|
|
|
|
__5. Deploy application on Kubernetes or OpenShift__
|
|
|
|
Make sure that Kubernetes/OpenShift cluster or Minikube/minishift is running. In case, if anything of this is not running, you can run minishift to test this application by using following command.
|
|
```bash
|
|
$ minishift start
|
|
```
|
|
|
|
Below command deploys this application on Kubernetes or OpenShift.
|
|
```bash
|
|
$ mvn fabric8:deploy
|
|
```
|
|
|
|
Now that your service has been deployed, let's access it by querying `pod`, `service` from Kubernetes or OpenShift.
|
|
```bash
|
|
$ oc get pods
|
|
NAME READY STATUS RESTARTS AGE
|
|
springboot-docker-compose-1-xl0vb 1/1 Running 0 5m
|
|
springboot-docker-compose-s2i-1-build 0/1 Completed 0 7m
|
|
```
|
|
|
|
```bash
|
|
$ oc get svc
|
|
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
|
springboot-docker-compose 172.30.205.137 <none> 8080/TCP 6m
|
|
```
|
|
|
|
Lets access the Springboot service.
|
|
```bash
|
|
$ minishift openshift service --in-browser springboot-docker-compose
|
|
Created the new window in existing browser session.
|
|
```
|
|
|
|
It will open your application endpoint in default browser.
|
|
|
|
|