💬
목차
< 뒤로가기
인쇄

개발 환경 구성 가이드

목적

본 문서는 캐모마일3.0 고도화 프로젝트 개발을 위한 표준을 제시하는데 목적이 있습니다.

범위

본 문서는 목표 시스템 구축을 위한 신규 개발되는 시스템을 범위로 하며 솔루션 및 라이브러리는 대상에서 제외됩니다.

개발환경 구성

주요 S/W 목록

구분 버전 용도 비고
캐모마일IDE(SpringToolSuite4) 4.19 Backend 개발툴
Amazon Corretto 11.0.x Java (API 서버)
Spring boot 2.7.12 Base Framework
Tomcat 9.0.75
Nexus Repository Manager OSS 3.36.0-01 Java library repository
Jenkins 2.395 CI
GitLab(Community Edition) 12.3.4 형상관리

Backend 개발 환경 구성

Untitled

다운로드

참고 : 가이드 3.0 > 개발 환경 가이드 > 다운로드 > 개발 도구(STS)

개발환경 (chamomile.zip) 파일의 압축을 해제

  • 압축 해제 시 폴더 주요 구성은 아래와 같습니다:
  • Chamomile.zip 압축해제
  • 압축 해제 경로는 C:아래로 올 수 있도록한다 (C:\Chamomile)
    • Apache-maven-3.8.6: maven (개발 라이브러리 관리 툴)
    • jdk-11.0.20: java
    • software: 개발 시에 필요한 소프트웨어 모음(Spring tool suite, Apache Maven, Open JDK)
    • Database : 기본 DDL, DML
  • amazon-corretto-11.0.20.9 압축을 해제한 후 JAVA_HOME 및 PATH를 설정합니다.

Apache Maven 구성

  • ./maven/setting.xml 파일을 열어 localRepository와 mirror을 설정을 확인 합니다.
C:\Chamomile\repository


    chamomile
    chamomile
    Human Readable Name for this Mirror.
    https://chamomile.lotteinnovate.com/nexus/repository/maven-public/

캐모마일 IDE 설정

  • maven repository 설정

    • window> preferences >maven > User Settings

  • Untitled

  • 데이터 베이스 설정

    • window> preferences > Chamomile > datasource > Add
    • Untitled

  • 프로젝트 생성

    • 프로젝트 생성(3.0.0)

    • 캐모마일 IDE가 3.0으로 버전업되면서 프로젝트 생성 절차가 새로운 방식으로 변경되었습니다. 아래 가이드를 참고하여 새로운 캐모마일 프로젝트를 생성해주세요.

    • 필수 체크 사항

    • 설치 경로: IDE 압축 파일은 C 드라이브에서 압축풀어주세요. : 최종경로 C:\chamomile

    • maven 설정 : Preferences > User Settings
      img_1.png

    • User Settings 설정에서 Global Settings에 C:\Chamomile\maven\settings.xml 경로를 설정한 후 Update Settings 버튼을 클릭합니다. 다음 Apply 버튼을 클릭합니다.

  1. File > New > Maven Project

    • img_2.png

  2. 아래 화면에서 Next 클릭

    • img_3.png

  3. Catalog Selectbox – maven-releases 선택

    • img_5.png

    • 선택한 카탈로그(catalog)에 따라 출력되는 아티팩트(artifact) 리스트를 선택하는 절차를 설명드리겠습니다. 아티팩트 리스트가 정상적으로 표시되는 경우, 3.1과 3.2 단계는 건너뛰어도 됩니다.

      • 단계 1: 카탈로그 선택

      • 카탈로그를 선택하는 드롭다운(selectbox)을 찾습니다.
        원하는 카탈로그를 선택합니다.

      • 단계 2: 아티팩트 선택

      • 선택한 카탈로그에 따라 아티팩트 리스트가 표시됩니다.
        원하는 아티팩트를 선택합니다.
        만약 아키타입 리스트가 나오지 않는 경우 아래 3.1, 3.2 설명을 참고해주세요.
        참고
        Show the last version of Archetype only 버튼 클릭시 아키 마지막 버전만 확인가능 합니다. 다른 버전도 확인하고 싶은 경우 버튼을 해제해주세요.

      3.1 아티팩트 리스트가 표시되지 않는 경우

      • 문제 해결 (아티팩트 리스트가 표시되지 않을 때)
      • 아티팩트 리스트가 나오지 않는 경우, 카탈로그를 다시 확인하고 올바른 카탈로그를 선택했는지 확인하세요.
        catalog에 maven-releases 가 없는 경우 local-archetype 선택 바랍니다.
        local-archetype도 없는 경우 아래의 3.2 절차를 수행합니다.
        3.2 카탈로그(catalog)에 local-archetype 없는 경우
        img_7.png
      • "Add Local Catalog" 버튼을 선택하세요.
        img_8.png
      • 아래와 같이 입력하세요:
      • Catalog File: C:\Chamomile\maven\archetype-catalog.xml (browse 버튼을 선택하여 파일을 추가하세요.)
        Description: local-archetype

  4. Group Id, Artifact Id, Package 입력 후 Finish

    • img.png
    • 프로젝트 정보입력
      • Group ID : net.lotte
      • Artifact ID : sample(project name으로 설정됨)
      • Version : 0.0.1-SNAPSHOT
      • package : net.lotte.sample (Group ID, Artifact ID 변경 시 자동 변경)

    프로젝트가 생성되면 발급받은 라이선스 파일을 \resources 폴더로 복사한다.

캐모마일 라이센스

라이선스 요구사항

  • v2.2 버전 이후로, 캐모마일은 라이선스를 필요로 합니다.

적용 대상

  • 캐모마일 프레임워크를 사용하는 경우 라이선스가 필요합니다. 주요 대상은 아래와 같습니다.

    • 사용자 어플리케이션
    • 어드민 어플리케이션 (웹, 배치)

라이선스 종류

  • 캐모마일의 라이선스 종류는 다음과 같습니다.

    1. 정식 라이선스
      • 정식 라이선스 체결 후 배포되는 라이선스입니다.
      • 운영 환경에서 사용이 가능합니다.
    2. 개발 라이선스
      • 개발 시 사용하기 위한 라이선스로, 특정 기간 동안 발급됩니다.
      • 로컬 개발 및 개발 서버 구성에 사용 가능합니다.
      • 유효 기간: 2개월 (로컬 및 개발 서버에 적용 가능)
    3. 체험 라이선스
      • 초기 체험을 위한 라이선스로, 짧은 기간 동안 사용 가능합니다.
      • 유효 기간: 2주 (기간 만료 시 동작하지 않음)

  • 참고: 체험 및 개발 라이선스의 경우, 기간이 만료되면 동작하지 않습니다.

적용 방법

  • 캐모마일 라이선스는 해당 어플리케이션의 클래스패스 내에 발급된 chamomile.license 파일을 로드하여 라이선스의 유효성을 검증합니다.
    단, 배치 어드민 어플리케이션의 경우 배포된 압축 파일의 conf 폴더를 우선하여 로드합니다.

  • 위의 정보를 기반으로, 적절한 라이선스를 발급받아 캐모마일 프레임워크를 사용하시기 바랍니다.

이전 캐모마일 개발 표준 가이드