example project

This is a showcase project.

Table of Contents

• example project
• Table of Contents
  • Running the application in dev mode
  • Packaging and running the application
  • Creating a native executable
  • Start production mode with docker-compose
  • Start production mode with minikube
  • Guids & miscellanies
    • commands
    • links
  • TODO for future

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

./gradlew quarkusDev

NOTE: for develop - quarkusDev - only the database is needed. So just use the docker-compose.db.yml file or another postgres.

Packaging and running the application

The application can be packaged using:

./gradlew build

Creating a native executable

You can create a native executable using:

./gradlew build -Dquarkus.package.type=native

Start production mode with docker-compose

First, take sure that you already have generated a jar for the docker build.

build the container

docker-compose -f docker-compose.yml build --no-cache

start both containers

docker-compose -f docker-compose.db.yml -f docker-compose.yml up -d   

NOTE: in this example, the swagger-ui is always available at http://localhost:8080/q/swagger-ui .

Start production mode with minikube

For using the project with minikube.

minikube yml via kompose (just as a template)

kompose convert -f docker-compose.db.yml -f docker-compose.yml --out minikube.template.yaml

deploy service to minikube

kubectl apply -f minikube.yaml

The endpoint for the swagger-ui is: http://{IPAddress}:30080/q/swagger-ui/

Guids & miscellanies

commands

get all pods

kubectl get pods -A

links

quarkus - Rest json

quarkus PostgreSQL Example

reactive sql clients

testing with in-memory databases

example for postgres

quarkus - postgres - ORM Panache

implement health check

example kubernetes config

NOTE: the ReadinessCheck for the datasource is allready implemented by the quarkus-smallrye-health datasource-health-check

TODO for future

• quarkus - Kubernetes Extension

  • automatically provide a kubernetes.yml

• infrastructure as code

  • shall provide the infrastructure needed, e.g. docker, minikube etc.