{"id":71,"date":"2019-04-08T17:35:24","date_gmt":"2019-04-08T17:35:24","guid":{"rendered":"http:\/\/boernig.de\/wordpress\/?p=71"},"modified":"2019-04-08T17:35:24","modified_gmt":"2019-04-08T17:35:24","slug":"quarkus-openshift-quickstart-a-bonuslab-for-the-cloud-native-developer-workshop","status":"publish","type":"post","link":"http:\/\/boernig.de\/wordpress\/2019\/04\/08\/quarkus-openshift-quickstart-a-bonuslab-for-the-cloud-native-developer-workshop\/","title":{"rendered":"Quarkus OpenShift Quickstart – A Bonuslab for the Cloud Native Developer Workshop"},"content":{"rendered":"

Quarkus (https:\/\/quarkus.io\/<\/a>) – A Supersonic Subatomic Java has recently been announced from some Red Hat Developers. The idea is to build a Java runtime that is native to Kubernetes and small and fast so it can also used in serverless scenarios or on very small edge devices.<\/p>\n

With Quarkus it is possible to create a “native” build that produces a small self-contained binary that can run in any container image.<\/p>\n

The goal of this blog post is to provide a simple hands-on lab for Openshift to get started with Quarkus and to do something useful.<\/p>\n

I must admit that I shamelessly build upon work done by my great colleagues, namely from Karsten Gresch from this post\u00a0https:\/\/medium.com\/@gresch\/quarkus-native-builds-with-openshift-s2i-9474ed4386a1<\/a><\/p>\n

The source code and the application code I got from\u00a0 \u00a0http:\/\/www.mastertheboss.com\/soa-cloud\/quarkus\/getting-started-with-quarkus<\/a><\/p>\n

Ok, lets get our hands dirty with it!<\/p>\n

Importing the source code<\/h2>\n

I put the code in my github repository “quarkus-demo”:\u00a0https:\/\/github.com\/iboernig\/quarkus-demo<\/a><\/p>\n

If you are working with the Eclipse Che based cloud native workshop, make sure you are in the \/projects\/labs\/ directory:<\/p>\n

$ cd \/projects\/labs<\/pre>\n
Then clone the git repository:<\/p>\n
$ git clone\u00a0\u00a0https:\/\/github.com\/iboernig\/quarkus-demo.git<\/pre>\n
The quarkus-demo directory should now show up in the project explorer on the left.<\/p>\n
Here you can left-click on that repository and convert to a maven project (same as for the other projects). This is not a necessary step, since we will not use the local maven but will use OpenShift s2i to build and deploy the application.<\/p>\n
Examining the source code<\/h2>\n
In the src\/main\/java\/org.acme.quickstart directory we at first the simple REST Endpoint example. It contains the class GreetingResource.java:<\/p>\n
package org.acme.quickstart;\r\n\r\n\r\nimport javax.inject.Inject;\r\nimport javax.ws.rs.GET;\r\nimport javax.ws.rs.Path;\r\nimport javax.ws.rs.PathParam;\r\nimport javax.ws.rs.Produces;\r\nimport javax.ws.rs.core.MediaType;\r\n\r\n@Path(\"\/hello\")\r\npublic class GreetingResource {\r\n\r\n    @Inject\r\n    GreetingService service;\r\n\r\n    @GET\r\n    @Produces(MediaType.TEXT_PLAIN)\r\n    @Path(\"\/greeting\/{name}\")\r\n    public String greeting(@PathParam(\"name\") String name) {\r\n        return service.greeting(name);\r\n    }\r\n\r\n    @GET\r\n    @Produces(MediaType.TEXT_PLAIN)\r\n    public String hello() {\r\n        return \"hello\";\r\n    }\r\n}<\/pre>\n
and the simple GreetingService.java:<\/p>\n
package org.acme.quickstart;\r\n\r\nimport javax.enterprise.context.ApplicationScoped;\r\n\r\n@ApplicationScoped\r\npublic class GreetingService {\r\n\r\n   public String greeting(String name) {\r\n      return \"hello \" + name;\r\n   }\r\n}<\/pre>\n
This will produce a simple “hello” output on the \/hello URL and a short greeting with a name on \/hello\/greeting\/<name> .<\/p>\n
Something useful<\/h2>\n
But now we look at a little more interesting example. Lets do a simple user registration. Something that is missing in our Coolstuff store.<\/p>\n
Lets start with the Class Person.java:<\/p>\n
package com.sample;\r\n \r\nimport java.util.Objects;\r\n \r\npublic class Person {\r\n \r\n    String name;\r\n    String surname;\r\n \r\n    public Person( ) {  }\r\n \r\n    public String getName() {\r\n        return name;\r\n    }\r\n    public String getSurname() {  return surname;  }\r\n    public void setName(String name) {\r\n        this.name = name;\r\n    }\r\n    public void setSurname(String surname) {\r\n        this.surname = surname;\r\n    }\r\n    @Override\r\n    public String toString() {\r\n        return \"Person{\" +\r\n                \"name='\" + name + '\\'' +\r\n                \", surname='\" + surname + '\\'' +\r\n                '}';\r\n    }\r\n \r\n    @Override\r\n    public boolean equals(Object o) {\r\n        if (this == o) return true;\r\n        if (o == null || getClass() != o.getClass()) return false;\r\n        Person person = (Person) o;\r\n        return Objects.equals(name, person.name) &&\r\n                Objects.equals(surname, person.surname);\r\n    }\r\n \r\n    @Override\r\n    public int hashCode() {\r\n        return Objects.hash(name, surname);\r\n    }\r\n}<\/pre>\n
And an endpoint to safe this into a collection. RESTEndpoint.java:<\/p>\n
package com.sample;\r\n \r\nimport java.util.Collections;\r\nimport java.util.LinkedHashMap;\r\nimport java.util.Set;\r\n \r\nimport javax.ws.rs.Consumes;\r\nimport javax.ws.rs.DELETE;\r\nimport javax.ws.rs.GET;\r\nimport javax.ws.rs.POST;\r\nimport javax.ws.rs.Path;\r\nimport javax.ws.rs.Produces;\r\nimport javax.ws.rs.core.MediaType;\r\n \r\n@Path(\"\/persons\")\r\n@Produces(MediaType.APPLICATION_JSON)\r\n@Consumes(MediaType.APPLICATION_JSON)\r\npublic class RESTEndpoint {\r\n \r\n    private Set<Person> persons = Collections.newSetFromMap(Collections.synchronizedMap(new LinkedHashMap<>()));\r\n \r\n    @GET\r\n    public Set<Person> list() {\r\n        return persons;\r\n    }\r\n \r\n    @POST\r\n    public Set<Person> add(Person person) {\r\n        System.out.println(\"Saving: \" +person);\r\n        persons.add(person);\r\n        return persons;\r\n    }\r\n \r\n}<\/pre>\n
Note: The files are already in the repository. This is just for a review.<\/p>\n
\u00a0Adding an UI<\/h2>\n
Adding HTML UI is also quite easy with quarkus. Lets turn to the src\/main\/resources\/META-INF\/resources\/ directory. Here you can find the following HTML code (with AngularJS for displaying the data) in the index.html:<\/p>\n
\u00a0<!doctype html>\r\n<html>\r\n<head>\r\n    <meta charset=\"utf-8\"\/>\r\n    <title>Quarkus REST service<\/title>\r\n    <link rel=\"stylesheet\" href=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/wingcss\/0.1.8\/wing.min.css\"\/>\r\n    <!-- Load AngularJS -->\r\n    <script src=\"\/\/ajax.googleapis.com\/ajax\/libs\/angularjs\/1.4.8\/angular.min.js\"><\/script>\r\n    <script type=\"text\/javascript\">\r\n      var app = angular.module(\"PersonManagement\", []);\r\n \r\n      \/\/Controller Part\r\n      app.controller(\"PersonManagementController\", function ($scope, $http) {\r\n \r\n        \/\/Initialize page with empty data\r\n        $scope.persons = [];\r\n \r\n        $scope.form = {\r\n          name: \"\",\r\n          surname: \"\"\r\n        };\r\n \r\n        \/\/Now load the data from server\r\n        _refreshPageData();\r\n \r\n        \/\/HTTP POST methods for add data\r\n        $scope.add = function () {\r\n          var data = { \"name\": $scope.form.name, \"surname\": $scope.form.surname };\r\n \r\n          $http({\r\n            method: \"POST\",\r\n            url: '\/persons',\r\n            data: angular.toJson(data),\r\n            headers: {\r\n              'Content-Type': 'application\/json'\r\n            }\r\n          }).then(_success, _error);\r\n        };\r\n \r\n \r\n        \/\/HTTP GET- get all persons collection\r\n        function _refreshPageData() {\r\n          $http({\r\n            method: 'GET',\r\n            url: '\/persons'\r\n          }).then(function successCallback(response) {\r\n            $scope.persons = response.data;\r\n          }, function errorCallback(response) {\r\n            console.log(response.statusText);\r\n          });\r\n        }\r\n \r\n        function _success(response) {\r\n          _refreshPageData();\r\n          _clearForm();\r\n        }\r\n \r\n        function _error(response) {\r\n          alert(response.data.message || response.statusText);\r\n        }\r\n \r\n        \/\/Clear the form\r\n        function _clearForm() {\r\n          $scope.form.name = \"\";\r\n          $scope.form.surname = \"\";\r\n        }\r\n      });\r\n    <\/script>\r\n<\/head>\r\n<body ng-app=\"PersonManagement\" ng-controller=\"PersonManagementController\">\r\n \r\n<div class=\"container\">\r\n    <h1>Quarkus REST Service<\/h1>\r\n \r\n    <form ng-submit=\"add()\">\r\n        <div class=\"row\">\r\n            <div class=\"col-6\"><input type=\"text\" placeholder=\"Name\" ng-model=\"form.name\" size=\"60\"\/><\/div>\r\n        <\/div>\r\n        <div class=\"row\">\r\n            <div class=\"col-6\"><input type=\"text\" placeholder=\"Surname\" ng-model=\"form.surname\" size=\"60\"\/><\/div>\r\n        <\/div>\r\n        <input type=\"submit\" value=\"Save\"\/>\r\n    <\/form>\r\n \r\n    <h3>Person List<\/h3>\r\n    <div class=\"row\">\r\n        <div class=\"col-4\">Name<\/div>\r\n        <div class=\"col-8\">Surname<\/div>\r\n    <\/div>\r\n    <div class=\"row\" ng-repeat=\"person in persons\">\r\n        <div class=\"col-4\">{{ person.name }}<\/div>\r\n        <div class=\"col-8\">{{ person.surname }}<\/div>\r\n    <\/div>\r\n<\/div>\r\n \r\n<\/body>\r\n<\/html><\/pre>\n
Now its time to get it running!<\/p>\n
Let OpenShift do its work!<\/h2>\n
First of all, make sure that you are still logged in with the right user into OpenShift:<\/p>\n
$ oc whoami\r\nuser1<\/pre>\n
Now check that you are in the right project<\/p>\n
$ oc project\r\ncoolstore-01<\/pre>\n
(If you trying this outside the cloud native workshop, simple make sure that you have a project and are logged in into OpenShift).<\/p>\n
The Quarkus S2i (Source-to-image) builder image is not yet a part of OpenShift by default, but it is available as a builder image on quay.io and needs to be called directly:<\/p>\n
$ oc new-app quay.io\/quarkus\/centos-quarkus-native-s2i~https:\/\/github.com\/iboernig\/quarkus-demo.git --name=quarkdemo<\/pre>\n
Now OpenShift starts a build process and you can follow the progress here:<\/p>\n
$ oc logs -f bc\/quarkdemo<\/pre>\n
This is progressing quite slow and in the normal workshop scenario it finally stops and fails. Can you tell why?<\/p>\n
Compiling to native needs a lot of resources and each project has limits. Either increase the limit yourself (if you are a cluster-admin) or talk to you instructor. He can help with increasing or removing the limit.<\/p>\n
Ok, lets go for the next try. Restart the build:<\/p>\n
$ oc start-build bc\/quarkdemo<\/pre>\n
Now it progresses much faster and the ready built image is pushed to the local registry.<\/p>\n
look for the upcoming pods:<\/p>\n
$ oc get pods \r\nNAME                READY     STATUS      RESTARTS   AGE\r\nquarkdemo-1-626xd   1\/1       Running     0          2s\r\nquarkdemo-1-build   0\/1       OOMKilled   0          5m\r\nquarkdemo-2-build   0\/1       Completed   0          5s<\/pre>\n
Its running! And you also can see, why the first build failed!<\/p>\n
Now expose the service and get a route:<\/p>\n
$ oc expose svc quarkdemo\r\nroute.route.openshift.io\/quarkdemo exposed\r\n$ oc get routes\r\nNAME        HOST\/PORT                                                   PATH      SERVICES    PORT       TERMINATION   WILDCARD\r\nquarkdemo   quarkdemo-<project>-<serverurl>   quarkdemo  8080-tcp                 None<\/pre>\n
Now you can look at the URL in your browser:<\/p>\n
\"\"<\/p>\n
You can add names ad see what happens!<\/p>\n
Also the simple rest service works with this binary:<\/p>\n
$ curl http:\/\/<route>\/hello\r\nhello\r\n$ curl http:\/\/<route>\/hello\/greeting\/ingo\r\nhello ingo<\/pre>\n
Very nice. But what makes Quarkus so special?<\/p>\n
\"\"<\/p>\n
Its very small. Only 19 MB. And it doesn’t use a JVM to run: its just a simple binary:<\/p>\n
$ oc get pods\r\nNAME                READY     STATUS      RESTARTS   AGE\r\nquarkdemo-1-626xd   1\/1       Running     0          2h\r\nquarkdemo-1-build   0\/1       OOMKilled   0          3h\r\nquarkdemo-2-build   0\/1       Completed   0          2h\r\n$ oc rsh quarkdemo-1-626xd\r\nsh-4.2$ ls -lh\r\ntotal 22M\r\n-rwxr-xr-x. 1 quarkus    root 22M Apr  8 14:38 quarkus-quickstart-1.0-SNAPSHOT-runner\r\n-rw-r--r--. 1 1000660000 root 337 Apr  8 14:39 quarkus.log<\/pre>\n
All in one 22 MB binary. Also impressive:<\/p>\n
sh-4.2$ cat quarkus.log \r\n2019-04-08 14:39:02,410 quarkdemo-1-626xd quarkus-quickstart-1.0-SNAPSHOT-runner[7] INFO  [io.quarkus] (main) Quarkus 0.12.0 started in 0.009s. Listening on: http:\/\/[::]:8080\r\n2019-04-08 14:39:02,410 quarkdemo-1-626xd quarkus-quickstart-1.0-SNAPSHOT-runner[7] INFO  [io.quarkus] (main) Installed features: [cdi, resteasy, resteasy-jsonb]<\/pre>\n
That’s a startup time in the ms range! So it makes difference!\u00a0 Hope you enjoyed that lab!<\/p>\n
 <\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Quarkus (https:\/\/quarkus.io\/) – A Supersonic Subatomic Java has recently been announced from some Red Hat Developers. The idea is to build a Java runtime that is native to Kubernetes and small and fast so it can also used in serverless scenarios or on very small edge devices. With Quarkus it is possible to create a … Continue reading “Quarkus OpenShift Quickstart – A Bonuslab for the Cloud Native Developer Workshop”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[8,12,5,4,10,13],"tags":[],"_links":{"self":[{"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/posts\/71"}],"collection":[{"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/comments?post=71"}],"version-history":[{"count":3,"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/posts\/71\/revisions"}],"predecessor-version":[{"id":76,"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/posts\/71\/revisions\/76"}],"wp:attachment":[{"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/media?parent=71"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/categories?post=71"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/boernig.de\/wordpress\/wp-json\/wp\/v2\/tags?post=71"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}