README.md

Eclipse JKube

Cloud-Native Java Applications without a hassle

Contents

• Introduction
  • Kubernetes Maven Plugin
  • Kubernetes Gradle Plugin
  • OpenShift Maven Plugin
  • OpenShift Gradle Plugin
• Migrating from Fabric8 Maven Plugin to Kubernetes/OpenShift Maven Plugin
• Getting Started
  • Maven Quickstarts
  • Gradle Quickstarts
  • Hello World using Eclipse JKube
    • Troubleshooting
• Rebranding Notice
• Contributing
• How to use Eclipse JKube snapshot artifacts?
• Add your organization to ADOPTERS
• FAQs

Introduction

Eclipse JKube is a collection of plugins and libraries that are used for building container images using Docker, JIB or S2I build strategies. Eclipse JKube generates and deploys Kubernetes/OpenShift manifests at compile time too.

It brings your Java applications on to Kubernetes and OpenShift by leveraging the tasks required to make your application cloud-native.

Eclipse JKube also provides a set of tools such as watch, debug, log, etc. to improve your developer experience. This project contains various building blocks for the Kubernetes Java developer toolbox.

Kubernetes Maven Plugin

• 
• 
• Add to project:

  <plugin>
    <groupId>org.eclipse.jkube</groupId>
    <artifactId>kubernetes-maven-plugin</artifactId>
    <version>${jkube.version}</version>
  </plugin>

• Run the JKube commands, for instance:

  mvn package k8s:build k8s:push k8s:resource k8s:apply

• 📺 Watch 2-minute demo on YouTube:

Kubernetes Gradle Plugin

• 
• 
• Add to project:

  plugins {
    id "org.eclipse.jkube.kubernetes" version "${jKubeVersion}"
  }

• Run the JKube commands, for instance:

  gradle build k8sBuild k8sPush k8sResource k8sApply

• 📺 Watch 2-minute demo on YouTube:

OpenShift Gradle Plugin

• 
• 
• Add to project:

  plugins {
    id "org.eclipse.jkube.openshift" version "${jKubeVersion}"
  }

• Run the JKube commands, for instance:

  gradle build ocBuild ocResource ocApply

• 📺 Watch 2-minute demo on YouTube:

OpenShift Maven Plugin

• 
• 
• Add to project:

  <plugin>
    <groupId>org.eclipse.jkube</groupId>
    <artifactId>openshift-maven-plugin</artifactId>
    <version>${jkube.version}</version>
  </plugin>

• Run the JKube commands, for instance:

  mvn package oc:build oc:resource oc:apply

• 📺 Watch 2-minute demo on YouTube:

Getting started

You can take a look at our quickstarts in quickstarts directory that contain sample maven and gradle projects using the latest version of jkube plugin.

Hello World using Eclipse JKube

• Clone repository and move to quickstart helloworld sample, build project and run JKube goals:

# 1. Clone repository
$ git clone [email protected]:eclipse/jkube.git

# 2. Move to Hello World Quickstart folder
$ cd jkube/quickstarts/maven/hello-world

# 3. Configure your local environment to re-use the Docker daemon inside the Minikube instance.

~ jkube/quickstarts/maven/hello-world : $ eval $(minikube -p minikube docker-env) 

# 4. Build Project and run JKube goals
$ mvn clean install                                                            \
  k8s:build         `# Build Docker Image`                                     \
  k8s:resource      `# Generate Kubernetes Manifests`                          \
  k8s:apply         `# Apply generated Kubernetes Manifests onto Kubernetes`

• Check created pod logs:

# Using Kubectl
$ kubectl get pods
NAME                          READY   STATUS    RESTARTS   AGE
helloworld-664bf5fdff-2bmrt   1/1     Running   0          9s
$ kubectl get svc
helloworld   NodePort    10.110.92.145   <none>        8080:32353/TCP   58m
kubernetes   ClusterIP   10.96.0.1       <none>        443/TCP          7h
$ curl `minikube ip`:32353/hello
Hello World

Troubleshooting

If you experience problems using minikube that pod's status shows 'ImagePullBackOff' and not 'Running' you must share the minikube's docker daemon environment with your shell with:

$ eval $(minikube -p minikube docker-env) 

You can remove this from your shell again with:

$ eval $(minikube docker-env -u)

If you don't want to type the command for every new terminal you open, you can add the command to your .bash_profile on mac or .zshrc.

Rebranding Notice 📢

This project is not an effort from scratch. It was earlier called Fabric8 Maven Plugin. It is just refactored and rebranded version of the project targeted towards Java developers who are working on top of Kubernetes. For more information about history, please see REBRANDING.md