https://github.com/piomin/sample-micronaut-kubernetes

Sample repository for showing micronaut kubernetes module with microservices and mongodb
https://github.com/piomin/sample-micronaut-kubernetes

jib-maven-plugin kubernetes micronaut micronaut-kubernetes micronautfw microservices minikube mongo skaffold

Last synced: 3 months ago
JSON representation

Sample repository for showing micronaut kubernetes module with microservices and mongodb

• Host: GitHub
• URL: https://github.com/piomin/sample-micronaut-kubernetes
• Owner: piomin
• Created: 2020-01-03T14:03:35.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2025-06-24T20:38:20.000Z (3 months ago)
• Last Synced: 2025-06-24T21:40:08.303Z (3 months ago)
• Topics: jib-maven-plugin, kubernetes, micronaut, micronaut-kubernetes, micronautfw, microservices, minikube, mongo, skaffold
• Language: Java
• Homepage: https://piotrminkowski.com/
• Size: 166 KB
• Stars: 25
• Watchers: 3
• Forks: 12
• Open Issues: 2
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

          
# Guide to Micronaut Kubernetes Demo Project [![Twitter](https://img.shields.io/twitter/follow/piotr_minkowski.svg?style=social&logo=twitter&label=Follow%20Me)](https://twitter.com/piotr_minkowski)

[![CircleCI](https://circleci.com/gh/piomin/sample-micronaut-kubernetes.svg?style=svg)](https://circleci.com/gh/piomin/sample-micronaut-kubernetes)

[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-black.svg)](https://sonarcloud.io/dashboard?id=piomin_sample-micronaut-kubernetes)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-micronaut-kubernetes&metric=bugs)](https://sonarcloud.io/dashboard?id=piomin_sample-micronaut-kubernetes)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-micronaut-kubernetes&metric=coverage)](https://sonarcloud.io/dashboard?id=piomin_sample-micronaut-kubernetes)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=piomin_sample-micronaut-kubernetes&metric=ncloc)](https://sonarcloud.io/dashboard?id=piomin_sample-micronaut-kubernetes)

In this project I'm demonstrating you the most interesting features of [Micronaut Kubernetes Project](https://micronaut-projects.github.io/micronaut-kubernetes/snapshot/guide/) for integration between Micronaut and Kubernetes API.

## Getting Started 

Currently you may find here some examples of microservices implementation using different projects from Micronaut. All the examples are divided into the branches and described in a

 separated articles on my blog. Here's a full list of available examples:

1. Using **Micronaut Kubernetes** for integration with Kubernetes discovery, `ConfigMaps` and `Secrets`. A source code is available in

 the branch [master](https://github.com/piomin/sample-micronaut-kubernetes/tree/master). A detailed guide may be find in the following article: [Guide to Micronaut Kubernetes

 ](https://piotrminkowski.com/2020/01/07/guide-to-micronaut-kubernetes/)

 

### Usage

To successfully run example applications you need to have:

1. JDK11+ as a default Java on your machine

2. Maven 3.5+ available under PATH

3. Minikube (I tested on version `1.6.1`)

4. Skaffold available under PATH

## Architecture

Our sample microservices-based system consists of the following modules:

- **employee-service** - a module containing the first of our sample microservices that allows to perform CRUD operation on Mongo repository of employees

- **department-service** - a module containing the second of our sample microservices that allows to perform CRUD operation on Mongo repository of departments. It communicates with employee-service. 

- **organization-service** - a module containing the third of our sample microservices that allows to perform CRUD operation on Mongo repository of organizations. It communicates with both employee-service and organization-service.

The following picture illustrates the architecture described above including Kubernetes objects.