Running on Kubernetes
Now that we have our application built, let's move it into containers and into the cloud.
Installing the Kubernetes Extension
Quarkus offers the ability to automatically generate Kubernetes resources based on sane defaults and user supplied configuration. We'll also need the Jib extension to build the image for us.
Run the following command to add the Kubernetes extension to the project:
mvn quarkus:add-extension -Dextensions="kubernetes,jib"
Updating the Application Properties
Before building and deploying the container image, we need to update the application properties for our configuration. Edit
src/main/resources/application.properties and enter the following values:
quarkus.container-image.registry=
quarkus.container-image.group=
quarkus.container-image.name=getting-started
quarkus.container-image.tag=1.0
quarkus.kubernetes.image-pull-policy=never
quarkus.kubernetes.service-type=NodePort
Note: These values are specific to a minikube installation. Consult the extension documentation for more information on other possible configuration values and how to adapt them for your cluster.
Preparing for Deployment
The container image needs to be available to the Kubernetes cluster in order for a pod to be created from it. It's possible to use the extensions to push to a hosted repository such as Docker Hub or Quay.io. However, for simplicity when using a minikube installation, we'll simply push it directly into the minikube Docker daemon.
Minikube provides a command to export the necessary configuration to use its Docker daemon. You'll need to add that information to your environment before running the build commands. This can be done by running:
eval $(minikube docker-env)
Building & Deploying the Container Image
An extra flag is necessary to the
package goal to trigger the image build and deployment:
mvn clean package -Dquarkus.kubernetes.deploy=true
You'll see output similar to the following to indicate the image build took place:
[INFO] [io.quarkus.container.image.jib.deployment.JibProcessor] Starting container image build
[WARNING] [io.quarkus.container.image.jib.deployment.JibProcessor] Base image 'fabric8/java-alpine-openjdk11-jre' does not use a specific image digest - build may not be reproducible
[INFO] [io.quarkus.container.image.jib.deployment.JibProcessor] The base image requires auth. Trying again for fabric8/java-alpine-openjdk11-jre...
[INFO] [io.quarkus.container.image.jib.deployment.JibProcessor] Using base image with digest: sha256:b459cc59d6c7ddc9fd52f981fc4c187f44a401f2433a1b4110810d2dd9e98a07
[INFO] [io.quarkus.container.image.jib.deployment.JibProcessor] Container entrypoint set to [java, -Djava.util.logging.manager=org.jboss.logmanager.LogManager, -jar, quarkus-run.jar]
[INFO] [io.quarkus.container.image.jib.deployment.JibProcessor] Created container image getting-started:1.0 (sha256:79b5aca19a9f23cd48cd8e6401df88886364e929560d0b8f2b47c1a0b6d5575d)
[INFO] [io.quarkus.kubernetes.deployment.KubernetesDeployer] Deploying to kubernetes server: https://192.168.39.10:8443/ in namespace: default.
[INFO] [io.quarkus.kubernetes.deployment.KubernetesDeployer] Applied: Service getting-started.
[INFO] [io.quarkus.kubernetes.deployment.KubernetesDeployer] Applied: Deployment getting-started.
[INFO] [io.quarkus.deployment.QuarkusAugmentor] Quarkus augmentation completed in 13998ms
Verifying the Deployment
Once the deployment has finished, you can see that the container has been created by looking for the pod in your cluster:
kubectl get pods
You should see output similar to the following (the exact name of the pod will vary):
getting-started-6cc5b7f575-kszx8 1/1 Running 0 47m
If you're using minikube, you can find the application URL by running:
minikube service list
The URL will be the entry with the name getting-started. For example:
|-------------|-----------------|--------------|----------------------------|
| NAMESPACE | NAME | TARGET PORT | URL |
|-------------|-----------------|--------------|----------------------------|
| default | getting-started | http/8080 | http://192.168.39.10:31487 |
| default | kubernetes | No node port | |
| kube-system | kube-dns | No node port | |
|-------------|-----------------|--------------|----------------------------|
Using that URL, use the same endpoint as before to test that the application is running:
curl http://192.168.39.10:31487/hello
