KHipster, Kotlin으로 JHipster 프로젝트 생성하기

개요

• JHipster는 Java 진영에서 모놀리스 또는 마이크로서비스를 제작하기 위한 만물상자라고 할 수 있다. JHipster의 커맨드 도구를 이용하여 프로젝트를 생성하면 순식간에 최신 모던 기술 스택 기반의 모든 기술을 총망라한 프로젝트를 제작할 수 있다. 개발자는 순전히 선택한 모던 기술 스택을 숙지하기만 하면, 곧바로 비지니스 로직 구현에 집중할 수 있는 장점이 있다.
• 한편, JHipster는 공식적으로 여러 Blueprint를 제공하는데 KHipster라 불리는 블루프린트를 이용하면 Kotlin 언어로도 프로젝트를 생성할 수 있다. (생성된 프로젝트 내에서는 Java, Kotlin 언어의 동시 사용이 가능하다.) 이번 글에서는 KHipster를 이용한 프로젝트 생성, 실행, 빌드 방법을 설명하고자 한다.

주요 이력

• v7.3.0부터 Java 17을 공식 지원한다.

KHipster 프로젝트 생성

# Java 11 설치
https://jsonobject.tistory.com/580

# Node.js LTS 설치
https://nodejs.org/en/

# JHipster 설치
$ npm i -g generator-jhipster

# KHipster 설치
$ npm i -g install yo
$ npm i -g generator-jhipster-kotlin

# Kotlin 프로젝트 생성
$ mkdir kotlinApp && cd kotlinApp
$ khipster

KHipster 프로젝트 실행

# dev 프로파일 실행
$ mvnw spring-boot:run -Pdev

# prod 프로파일 실행
$ mvnw spring-boot:run -Pprod

# prod 프로파일 빌드
# 백엔드와 프론트엔드가 통합 빌드된 /target/{appname}-0.0.1-SNAPSHOT.jar 생성
$ mvnw -Pprod -DskipTests clean verify

# prod 프로파일 도커 이미지 빌드
# 빌드되는 로컬 이미지 이름은 pom.xml의 <to><image>{local-image-name}</image></to>에서 확인 가능
$ mvnw -Pprod -DskipTests clean verify jib:dockerBuild

# 빌드된 도커 이미지에 태그 생성
$ docker tag {local-image-name} {remote-image-name}

# 빌드된 도커 이미지를 원격 저장소에 푸시
$ docker push {remote-image-name}

KHipster 프로젝트 업그레이드

# KHipster 프로젝트 버전 업그레이드
$ jhipster upgrade --target-blueprint-versions kotlin@1.13.0

트러블슈팅: Amazon ECS on AWS Fargate 배포 이슈

• JHipster로 생성한 모든 애플리케이션은 Netflix Eureka의 클라이언트이기도 하다. 문제는 Amazon ECS에서 AWS Fargate 인스턴스로 배포할 경우인데, hostname으로 인스턴스 자신의 프라이빗 IP 주소를 획득하지 못하는 문제가 있다. [관련 링크 1] [관련 링크 2] 이 문제를 해결하기 위해서는 인위적으로 hostname에 대응하는 프라이빗 IP 주소를 도커 이미지 내의 /etc/hosts 파일에 추가해주는 작업이 필요하다.
• 먼저 프로젝트 루트에 entrypoint.sh 파일을 아래와 같이 작성한다. (WIndows 환경에서는 반드시 CR+LF가 아닌 LF 방식으로 저장해야 하는 것에 유의한다. 애플리케이션 기동시 스크립트 실행에 문제가 발생할 수 있다.)

$ nano entrypoint.sh
#!/bin/sh
export ECS_INSTANCE_IP_TASK=$(curl --retry 5 -connect-timeout 3 -s ${ECS_CONTAINER_METADATA_URI})
export ECS_INSTANCE_HOSTNAME=$(cat /proc/sys/kernel/hostname)
export ECS_INSTANCE_IP_ADDRESS=$(echo ${ECS_INSTANCE_IP_TASK} | python3.9 -c "import sys, json; print(json.load(sys.stdin)['Networks'][0]['IPv4Addresses'][0])")
echo "${ECS_INSTANCE_IP_ADDRESS} ${ECS_INSTANCE_HOSTNAME}" | sudo tee -a /etc/hosts
echo "ECS_INSTANCE_HOSTNAME: " ${ECS_INSTANCE_HOSTNAME}
echo "ECS_INSTANCE_IP_ADDRESS: " ${ECS_INSTANCE_IP_ADDRESS}
exec java ${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom -jar /app.jar

• 다음으로 Dockerfile을 아래와 같이 작성한다.

$ nano Dockerfile
FROM adoptopenjdk:11-jre-hotspot
ENV SPRING_OUTPUT_ANSI_ENABLED=ALWAYS \
      JAVA_OPTS="" \
      SPRING_PROFILES_ACTIVE=prod
EXPOSE 8080
USER root
RUN apt update -y
RUN apt install sudo -y
RUN apt install curl -y
RUN apt install software-properties-common -y
RUN add-apt-repository ppa:deadsnakes/ppa -y
RUN apt install python3.9 -y
COPY target/*.jar /app.jar
COPY entrypoint.sh /
USER 0
ENTRYPOINT ["sh", "/entrypoint.sh"]

• 마지막으로 아래와 같이 도커 이미지를 빌드하고 원격지에 업로드하면 된다.

$ mvnw -Pprod -DskipTests clean verify

$ docker build -t {local-image-name} .

$ docker tag {local-image-name}:{tag} {remote-image-name}:{tag}

$ docker push {remote-image-name}:{tag}

참고 글

• KHipster