deep-stack/kompose
7
0
Fork 0
forked from LaconicNetwork/kompose
Code Pull Requests Activity
d0fff4c85d
kompose/docs/maven-example.md
Piyush d0fff4c85d Added Fabric8 Maven Plugin in Integration 
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
2017-10-09 18:09:06 +05:30

2.8 KiB
Raw Blame History

Fabric8 Maven Plugin + Kompose:

Lets deploy a Springboot Java application with Docker Compose file using Fabric8 Maven Plugin to Kubernetes or OpenShift.

Requirements

1. Clone the example project from GitHub

$ git clone https://github.com/piyush1594/kompose-maven-example.git

Change current directory to kompose-maven-example directory.

$ cd kompose-maven-example

2. Add Fabric8 Maven Plugin to your project

$ 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

$ mvn fabric8:install

This command installs the kompose on the host.

4. Configure Fabric8 Maven Plugin to use a Docker Compose file

<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.

$ minishift start

Below command deploys this application on Kubernetes or OpenShift.

$ mvn fabric8:deploy

Now that your service has been deployed, let's access it by querying pod, service from Kubernetes or OpenShift.

$ 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

$ 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.

$ 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.

Output-Diagram