110 lines
3.0 KiB
Markdown
110 lines
3.0 KiB
Markdown
---
|
|
layout: default
|
|
permalink: /maven-example/
|
|
title: Maven Example
|
|
redirect_from:
|
|
- /docs/maven-example.md/
|
|
- /docs/maven-example/
|
|
---
|
|
|
|
# Fabric8 Maven Plugin + Kompose:
|
|
|
|
Let's deploy a Springboot Java application with 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](/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
|
|
```
|
|
|
|
Add 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 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 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 the 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-compose-1-xl0vb 1/1 Running 0 5m
|
|
springboot-compose-s2i-1-build 0/1 Completed 0 7m
|
|
```
|
|
|
|
```bash
|
|
$ oc get svc
|
|
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
|
springboot-compose 172.30.205.137 <none> 8080/TCP 6m
|
|
```
|
|
|
|
Let's access the Springboot service.
|
|
|
|
```bash
|
|
$ minishift openshift service --in-browser springboot-compose
|
|
Created the new window in existing browser session.
|
|
```
|
|
|
|
It will open your application endpoint in default browser.
|
|
|
|
|