Skip to content

Kotlin 및 TeamCity를 사용한 지속적 통합 ​

이 페이지에서는 Kotlin 애플리케이션을 빌드하기 위해 TeamCity를 설정하는 방법을 알아봅니다. TeamCity 설치 및 기본 설정에 대한 내용은 TeamCity 문서를 참조하세요.

Kotlin은 Gradle 및 Maven과 같은 표준 빌드 도구와 직접 통합되므로, TeamCity에서 Kotlin 빌드를 구성하는 작업은 일반적인 다른 프로젝트와 동일한 워크플로를 따릅니다. 대신 IntelliJ IDEA 빌드 시스템을 사용하여 프로젝트를 컴파일하는 경우, TeamCity는 전용 러너(runner)를 제공합니다.

Gradle 및 Maven ​

Gradle이나 Maven으로 빌드할 때, 빌드 구성 파일(build.gradle.kts 또는 pom.xml)에 이미 Kotlin 의존성과 컴파일러 플러그인이 선언되어 있습니다. 따라서 TeamCity에서 별도의 Kotlin 관련 추가 설정을 구성할 필요가 없습니다.

Gradle의 경우, 빌드 구성에 Gradle 빌드 단계를 추가하고 실행하려는 Step name과 Gradle tasks를 지정하세요. Gradle Build Step

마찬가지로 Maven의 경우에도, Maven 빌드 단계를 추가하고 실행하려는 Step name과 Goals를 지정하세요.

IntelliJ IDEA 빌드 시스템 ​

IntelliJ IDEA 프로젝트 파일을 사용하여 프로젝트를 빌드하는 경우, TeamCity의 Kotlin 버전이 IDE 프로젝트에 구성된 버전과 일치해야 합니다. TeamCity 레시피(recipe)를 사용하면 Kotlin 컴파일러 다운로드 및 구성을 자동화할 수 있습니다. 레시피는 메타 러너(meta-runner)가 발전된 형태로, 동일한 용도로 사용되지만 YAML 지원 및 JetBrains Marketplace에서의 손쉬운 공유와 같은 추가적인 이점을 제공합니다.

  1. 레시피 다운로드 및 가져오기.

  2. Kotlin 컴파일러 가져오기 단계 추가.

    • 가져온 러너를 사용하여 빌드 단계를 추가합니다.
    • Step name과 필요한 Kotlin Version을 지정합니다. Setup Kotlin Compiler

빌드를 실행하기 전에 빌드 구성에 system.path.macro.KOTLIN.BUNDLED를 시스템 파라미터로 추가하세요. 임의의 플레이스홀더 값을 지정할 수 있으며, 빌드 시 러너가 확인된 컴파일러 경로로 이를 덮어씁니다.

  1. 컴파일 단계 추가. 컴파일러 가져오기 단계 뒤에 IntelliJ IDEA Project 러너 단계를 추가하여 프로젝트를 컴파일하고 빌드 아티팩트를 생성합니다. IntelliJ IDEA Project runner

기타 CI 서버 ​

TeamCity 이외의 CI 시스템을 사용하는 경우, 파이프라인 스크립트에서 표준 Gradle 또는 Maven 명령을 직접 호출하세요.

다음 단계 ​