Kotlin과 TeamCity를 사용한 지속적 통합

이 페이지에서는 TeamCity를 설정하여 Kotlin 프로젝트를 빌드하는 방법을 알아봅니다. TeamCity에 대한 더 많은 정보 및 기본 사항은 설치, 기본 구성 등에 대한 정보를 포함하는 문서 페이지를 확인하십시오.

Kotlin은 다양한 빌드 도구와 함께 작동하므로, Ant, Maven 또는 Gradle과 같은 표준 도구를 사용하는 경우 Kotlin 프로젝트 설정 프로세스는 이러한 도구와 통합되는 다른 언어 또는 라이브러리와 다르지 않습니다. 약간의 요구 사항과 차이점이 있는 경우는 TeamCity에서도 지원되는 IntelliJ IDEA의 내부 빌드 시스템을 사용할 때입니다.

Gradle, Maven, 및 Ant

Ant, Maven 또는 Gradle을 사용하는 경우 설정 과정은 간단합니다. 필요한 것은 빌드 단계(Build Step)를 정의하는 것뿐입니다. 예를 들어, Gradle을 사용하는 경우, 러너 타입(Runner Type)에 필요한 단계 이름(Step Name)과 실행해야 할 Gradle 작업을 정의하기만 하면 됩니다.

Kotlin에 필요한 모든 의존성(dependencies)이 Gradle 파일에 정의되어 있으므로, Kotlin이 올바르게 실행되도록 특별히 구성할 다른 것은 없습니다.

Ant 또는 Maven을 사용하는 경우에도 동일한 구성이 적용됩니다. 유일한 차이점은 러너 타입(Runner Type)이 각각 Ant 또는 Maven이 된다는 점입니다.

IntelliJ IDEA 빌드 시스템

TeamCity와 함께 IntelliJ IDEA 빌드 시스템을 사용하는 경우, IntelliJ IDEA에서 사용되는 Kotlin 버전이 TeamCity에서 실행되는 버전과 동일한지 확인하십시오. 특정 버전의 Kotlin 플러그인(plugin)을 다운로드하여 TeamCity에 설치해야 할 수도 있습니다.

다행히도 대부분의 수동 작업을 처리하는 메타 러너(meta-runner)가 이미 존재합니다. TeamCity 메타 러너(meta-runner) 개념에 익숙하지 않다면 문서를 확인하십시오. 이들은 플러그인을 작성할 필요 없이 사용자 지정 러너(Runner)를 도입하는 매우 쉽고 강력한 방법입니다.

메타 러너 다운로드 및 설치

Kotlin용 메타 러너는 GitHub에서 사용할 수 있습니다. 해당 메타 러너를 다운로드하여 TeamCity 사용자 인터페이스에서 가져오십시오.

Kotlin 컴파일러 가져오기 단계 설정

기본적으로 이 단계는 단계 이름(Step Name)과 필요한 Kotlin 버전을 정의하는 것으로 제한됩니다. 태그를 사용할 수 있습니다.

러너는 IntelliJ IDEA 프로젝트의 경로 설정에 따라 system.path.macro.KOTLIN.BUNDLED 속성 값을 올바르게 설정합니다. 그러나 이 값은 TeamCity에서 정의되어야 합니다(그리고 어떤 값으로든 설정할 수 있습니다). 따라서 이를 시스템 변수(system variable)로 정의해야 합니다.

Kotlin 컴파일 단계 설정

마지막 단계는 표준 IntelliJ IDEA 러너 타입(Runner Type)을 사용하는 프로젝트의 실제 컴파일을 정의하는 것입니다.

이를 통해 이제 프로젝트가 빌드되고 해당 아티팩트(artifacts)가 생성되어야 합니다.

다른 CI 서버

TeamCity와 다른 지속적 통합(continuous integration) 도구를 사용하는 경우에도, 빌드 도구 중 하나를 지원하거나 명령줄 도구를 호출할 수 있다면, Kotlin을 컴파일하고 CI 프로세스(CI process)의 일부로 작업을 자동화하는 것이 가능해야 합니다.