Giter VIP home page Giter VIP logo

jkube's Introduction

Eclipse JKube

Cloud-Native Java Applications without a hassle

Circle CI Integration Tests Maintainability Rating Coverage Gitter Twitter KataCoda

Eclipse JKube

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

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

Maven Central Documentation

Sample Demo KMP

OpenShift Maven Plugin

Maven Central Documentation

Sample Demo OMP

JKube Kit

JKube Kit is the core engine powering our Maven plugins.

The main difference between Fabric8 Maven Plugin and JKube is the extraction and decoupling of the core components from Maven. This enables other projects and frameworks to reuse all of JKube's functionality by exposing it through a public API.

  • Generator framework for automatically generating Docker images by examining project information.
    Maven Central Javadocs
  • Enricher framework for creating and enhancing Kubernetes and OpenShift resources.
    Maven Central Javadocs
  • Profile combining the configuration for generators and enrichers.
    Maven Central Javadocs
  • Resource configuration model objects for a simplified configuration of Kubernetes and OpenShift resources.
    Maven Central Javadocs
  • Image configuration model objects for modeling Docker image configuration as used in docker-maven-plugin.
    Maven Central Javadocs

Some thin adapter Maven specific modules like jkube-kit-enricher-maven and jkube-kit-generator-maven are provided as glue to get to the Maven specific build information like the project's coordinates.

Getting started

Want to test drive JKube? check our getting started Katacoda course to see what JKube can do for you and your project directly from your browser.

Check out our Maven quickstarts to see how JKube fits with the Java framework of your choice.https://github.com/eclipse/jkube/tree/master/quickstarts/maven

Hello World using Eclipse JKube

  • Clone repository and move to quickstart helloworld sample, build project and run JKube goals:
# 1. Clone repository and move to Hello World Quickstart
$ git clone [email protected]:eclipse/jkube.git && cd jkube/quickstarts/maven/hello-world

# 2. 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-7c4665f464-xwskj                0/1     Completed     2          27s
$ kubectl logs jkube-sample-helloworld-7c4665f464-xwskj
Hello World!
# Using JKube
$ mvn k8s:log
[INFO] k8s:  [NEW] helloworld-7c4665f464-xwskj status: Running 
[INFO] k8s:  [NEW] Tailing log of pod: helloworld-587dfff745-2kdpq
[INFO] k8s:  [NEW] Press Ctrl-C to stop tailing the log
[INFO] k8s:  [NEW] 
[INFO] k8s: Hello World!
[INFO] k8s:  [NEW] helloworld-7c4665f464-xwskj status: Running 

Troubleshooting

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

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

jkube's People

Contributors

abhijeetshuklaoist avatar alexdeveng avatar anandrkskd avatar anyulled avatar cary205 avatar codezork avatar danipiario avatar deboer-tim avatar dengliming avatar dependabot[bot] avatar dev-gaur avatar hboutemy avatar jfdenise avatar jwcarman avatar mad6300 avatar manusa avatar mtrejo avatar ohbus avatar phantomjinx avatar rdruss avatar rnetuka avatar robinroos avatar rohankanojia avatar sejacobsen avatar shivkumar13 avatar sshark avatar sullis avatar survivant avatar tuedissingwork avatar zebu avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.