jhipster-docker-k8s

Docker & Kubernetes for JHipster Microservices

Deploy JHipster microservices using Docker Compose for local development and Kubernetes/K3s for production.

When to Use

• When setting up local development environment
• When containerizing a microservice
• When deploying to Kubernetes/K3s
• When scaling services
• When troubleshooting container issues

Available Operations

1. Generate Docker Compose with JHipster
2. Build Docker images with Jib
3. Generate Kubernetes manifests with JHipster
4. Deploy to K3s cluster
5. Scale and manage services

Multi-Step Workflow

Step 1: Generate Docker Compose

# Generate docker-compose via JHipster (from project root)
jhipster docker-compose

# Or use JDL deployment block
jhipster import-jdl jhipster-jdl.jdl

Step 2: Configure Docker Compose for Dev

# docker-compose/docker-compose.yml
services:
  gateway:
    image: gateway:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - SPRING_CLOUD_CONSUL_HOST=consul

  demand-service:
    image: demand-service:latest
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - SPRING_CLOUD_CONSUL_HOST=consul
      - SPRING_DATASOURCE_URL=jdbc:postgresql://demand-db:5432/demand
    depends_on:
      - demand-db
      - consul
      - kafka

  demand-db:
    image: postgres:16
    environment:
      POSTGRES_DB: demand
      POSTGRES_USER: demand
      POSTGRES_PASSWORD: demand

  consul:
    image: consul:1.15
    ports:
      - "8500:8500"
    command: agent -server -bootstrap -ui -client=0.0.0.0

  kafka:
    image: confluentinc/cp-kafka:7.5.0
    depends_on:
      - zookeeper
    ports:
      - "9092:9092"
    environment:
      KAFKA_BROKER_ID: 1
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:29092,PLAINTEXT_HOST://localhost:9092
      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT
      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1

  zookeeper:
    image: confluentinc/cp-zookeeper:7.5.0
    environment:
      ZOOKEEPER_CLIENT_PORT: 2181

  keycloak:
    image: quay.io/keycloak/keycloak:23.0
    ports:
      - "9080:8080"
    environment:
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: admin
    command: start-dev