Jkube Maven :: Generator :: WebApp


License

License

https://www.eclipse.org/legal/epl-2.0/
Categories

Categories

Maven Build Tools CLI User Interface
GroupId

GroupId

org.eclipse.jkube
ArtifactId

ArtifactId

jkube-maven-generator-webapp
Last Version

Last Version

0.1.0
Release Date

Release Date

Type

Type

jar
Description

Description

Jkube Maven :: Generator :: WebApp
Jkube Maven :: Generator :: WebApp
Project URL

Project URL

https://projects.eclipse.org/projects/ecd.jkube/jkube-maven-generator-webapp

Download jkube-maven-generator-webapp

How to add to project

<!-- https://jarcasting.com/artifacts/org.eclipse.jkube/jkube-maven-generator-webapp/ -->
<dependency>
    <groupId>org.eclipse.jkube</groupId>
    <artifactId>jkube-maven-generator-webapp</artifactId>
    <version>0.1.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.eclipse.jkube/jkube-maven-generator-webapp/
implementation 'org.eclipse.jkube:jkube-maven-generator-webapp:0.1.0'
// https://jarcasting.com/artifacts/org.eclipse.jkube/jkube-maven-generator-webapp/
implementation ("org.eclipse.jkube:jkube-maven-generator-webapp:0.1.0")
'org.eclipse.jkube:jkube-maven-generator-webapp:jar:0.1.0'
<dependency org="org.eclipse.jkube" name="jkube-maven-generator-webapp" rev="0.1.0">
  <artifact name="jkube-maven-generator-webapp" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.eclipse.jkube', module='jkube-maven-generator-webapp', version='0.1.0')
)
libraryDependencies += "org.eclipse.jkube" % "jkube-maven-generator-webapp" % "0.1.0"
[org.eclipse.jkube/jkube-maven-generator-webapp "0.1.0"]

Dependencies

compile (1)

Group / Artifact Type Version
org.eclipse.jkube : jkube-maven-generator-api jar 0.1.0

test (1)

Group / Artifact Type Version
junit : junit jar 4.11

Project Modules

There are no modules declared in this project.

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.

org.eclipse.jkube

Eclipse Foundation

Versions

Version
0.1.0