redhat-developer-demos / Quarkus Tutorial

= Quarkus Tutorial

image:https://github.com/redhat-developer-demos/quarkus-tutorial/workflows/docs/badge.svg[] image:https://github.com/redhat-developer-demos/quarkus-tutorial/workflows/price-generator/badge.svg[]

You can access the HTML version of this tutorial here: https://redhat-developer-demos.github.io/quarkus-tutorial/[window="_blank"]

== Why Quarkus?

Historically Java was able to handle the biggest enterprise problem(s) with its "Write once, run anywhere" (WORA) paradigm. With Cloud Native Applications grown to popularity, things like running applications as linux containers, serverless taking centere stage -- Java was pushed back by languages like golang, node.js as the forerunner to build Cloud Native Applications as they are smaller, quicker and argulably more nimble.

Quarkus is Kubernetes Native Java stack tailored for GraalVM & OpenJDK HotSpot, crafted from the best of breed Java libraries and standards.

In this tutorial we will start to explore how to create, build and deploy Cloud Native Java applications using Quarkus. The Java applications built this way are tiny as a subatomic particle (Quark) and tend to boot and run at supersonic speed

image::./documentation/modules/ROOT/assets/images/Developer_Joy.png[Developer Joy,400,400,align="center"]

Building the HTML locally

In the root of your git repository, run:

bin/build-site.sh

And then open your gh-pages/index.html file:

open gh-pages/index.html

Iterative local development

You can develop the tutorial docs locally using a rapid iterative cycle.

First, install the yarn dependencies:

[source,bash]

yarn install

And now start gulp. It will create the website and open your browser connected with browser-sync. Everytime it detects a change, it will automatically refresh your browser page.

[source,bash]

gulp

You can clean the local cache using:

[source,bash]

gulp clean