{"id":16119867,"url":"https://github.com/piomin/sample-quarkus-microservice","last_synced_at":"2025-03-17T19:31:03.558Z","repository":{"id":72152158,"uuid":"591485261","full_name":"piomin/sample-quarkus-microservice","owner":"piomin","description":"Quarkus demo app illustrating how to implement and test a REST-based, simple microservice","archived":false,"fork":false,"pushed_at":"2024-04-30T13:29:33.000Z","size":259,"stargazers_count":9,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-01T13:54:29.519Z","etag":null,"topics":["postgresql","quarkus","quarkus-resteasy"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piomin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-20T21:50:37.000Z","updated_at":"2024-05-08T21:39:50.622Z","dependencies_parsed_at":"2024-02-20T19:28:52.998Z","dependency_job_id":"980a0ad6-be27-42d3-bccf-4d6ac4ab0a5b","html_url":"https://github.com/piomin/sample-quarkus-microservice","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piomin%2Fsample-quarkus-microservice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piomin%2Fsample-quarkus-microservice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piomin%2Fsample-quarkus-microservice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piomin%2Fsample-quarkus-microservice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piomin","download_url":"https://codeload.github.com/piomin/sample-quarkus-microservice/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243878439,"owners_count":20362432,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["postgresql","quarkus","quarkus-resteasy"],"created_at":"2024-10-09T20:55:19.517Z","updated_at":"2025-03-17T19:31:03.212Z","avatar_url":"https://github.com/piomin.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quarkus Microservice Demo Project [![Twitter](https://img.shields.io/twitter/follow/piotr_minkowski.svg?style=social\u0026logo=twitter\u0026label=Follow%20Me)](https://twitter.com/piotr_minkowski)\n\n[![CircleCI](https://circleci.com/gh/piomin/sample-quarkus-microservice.svg?style=svg)](https://circleci.com/gh/piomin/sample-quarkus-microservice)\n\n[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-black.svg)](https://sonarcloud.io/dashboard?id=piomin_sample-quarkus-microservice)\n[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-quarkus-microservice\u0026metric=bugs)](https://sonarcloud.io/dashboard?id=piomin_sample-quarkus-microservice)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-quarkus-microservice\u0026metric=coverage)](https://sonarcloud.io/dashboard?id=piomin_sample-quarkus-microservice)\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-quarkus-microservice\u0026metric=ncloc)](https://sonarcloud.io/dashboard?id=piomin_sample-quarkus-microservice)\n\nThis project uses Quarkus, the Supersonic Subatomic Java Framework.\nIf you want to learn more about Quarkus, please visit its website: https://quarkus.io/ .\n\n## Running the application in dev mode\n\nFirst run your Docker Daemon. The following command should be succeeded:\n```shell\ndocker ps\n```\n\nYou can run your application in dev mode that enables live coding using:\n```shell script\nmvn compile quarkus:dev\n```\n\n\u003e **_NOTE:_**  Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.\n\n## Packaging and running the application\n\nThe application can be packaged using:\n```shell script\nmvn clean package\n```\nIt produces the `quarkus-run.jar` file in the `target/quarkus-app/` directory.\nBe aware that it’s not an _über-jar_ as the dependencies are copied into the `target/quarkus-app/lib/` directory.\n\nThe application is now runnable using `java -jar target/quarkus-app/quarkus-run.jar`.\n\nIf you want to build an _über-jar_, execute the following command:\n```shell script\n./mvnw package -Dquarkus.package.type=uber-jar\n```\n\nThe application, packaged as an _über-jar_, is now runnable using `java -jar target/*-runner.jar`.\n\n## Creating a native executable\n\nYou can create a native executable using: \n```shell script\nmvn package -Pnative\n```\n\nOr, if you don't have GraalVM installed, you can run the native executable build in a container using: \n```shell script\nmvn package -Pnative -Dquarkus.native.container-build=true\n```\n\nYou can then execute your native executable with: `./target/sample-quarkus-microservice-1.0.0-SNAPSHOT-runner`\n\n## Running on Kubernetes\n\nFirst, you need to install Postgres on Kubernetes, e.g. with Helm:\n```shell\n$ helm install person-db bitnami/postgresql -n sample-quarkus --set auth.username=quarkus  --set auth.database=quarkus --set fullnameOverride=person-db --create-namespace\n```\n\nThen, you can build and deploy the app within one step with Maven by activating the `kubernetes` profile:\n```shell\n$ QUARKUS_JIB_BASE_JVM_IMAGE=registry.access.redhat.com/ubi8/openjdk-17-runtime:latest  mvn clean package -DskipTests -Pkubernetes\n```\n\nOr, with the `minikube` profile for running on Minikube.\n\n\nIf you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.\n\n## Related Guides\n\n- OpenShift ([guide](https://quarkus.io/guides/deploying-to-openshift)): Generate OpenShift resources from annotations\n- Micrometer Registry Prometheus ([guide](https://quarkus.io/guides/micrometer)): Enable Prometheus support for Micrometer\n- SmallRye OpenAPI ([guide](https://quarkus.io/guides/openapi-swaggerui)): Document your REST APIs with OpenAPI - comes with Swagger UI\n- Hibernate ORM with Panache ([guide](https://quarkus.io/guides/hibernate-orm-panache)): Simplify your persistence code for Hibernate ORM via the active record or the repository pattern\n- SmallRye Health ([guide](https://quarkus.io/guides/microprofile-health)): Monitor service health\n- JDBC Driver - PostgreSQL ([guide](https://quarkus.io/guides/datasource)): Connect to the PostgreSQL database via JDBC\n\n## Provided Code\n\n### RESTEasy JAX-RS\n\nEasily start your RESTful Web Services\n\n[Related guide section...](https://quarkus.io/guides/getting-started#the-jax-rs-resources)\n\n### SmallRye Health\n\nMonitor your application's health using SmallRye Health\n\n[Related guide section...](https://quarkus.io/guides/smallrye-health)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiomin%2Fsample-quarkus-microservice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiomin%2Fsample-quarkus-microservice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiomin%2Fsample-quarkus-microservice/lists"}