[Jenkins] 원결 빌드 유발

 

| 개요

젠킨스를 사용하다 보면 원격으로 빌드를 유발이 필요한 경우가 생기는데, 다행히도 해당 기능을 제공하고 있다.

원격 빌드를 유발하는 방법에 대해 간단히 서술하고자 한다.

 

| JOB 설정

우선 원격 빌드를 유발할 잡 설정(Configure)으로 들어가서 `Build Triggers` 섹션으로 가면 `Trigger builds remotely (e.g., from scripts)` 토글을 켜면 Token을 입력할 수 있다.

 

• JOB 설정 > 빌드 유발(Build Triggers) > 빌드 원격으로 유발 (Trigger build remotly) > Authentication Token

 

 

| 호출 URL

위에서 설정한 TOKEN은 query string형태로 함께 넘겨주면 되고, paramerter가 있을 경우에도 함께 넘겨 주면 된다. URL 아래와 같다.

// 파라미터가 없는 경우
{JENKINS_URL}/job/{JOB_NAME}/build?token={TOKEN_NAME}

// 파라미터가 있는 경우
{JENKINS_URL}/job/{JOB_NAME}/buildWithParameters?&token={TOKEN}&{KEY1}={VALUE1}&{KEY2}={VALUE2}

 

| API Token 생성 및 설정

보안 설정에 따라서 로그인 인증이 필요한 경우가 있다. 로그인 인증을 위해선 우선 API Token 발급이 필요하다.

 

※로그인 인증 과정을 생략해주는 플러그인도 있다.

 

• People > {USER_ID} > Configure > API Token 섹션 > Add new Token

({JENKINS_URL}/user/{USER_ID}/configure)

 

이제 발급된 API Token과 함께 URL을 호출해주면 된다.

// 파라미터가 없는 경우
http://{USER_ID}:{API_TOKEN}@{JENKINS_URL}/job/{JOB_NAME}/build?token={TOKEN_NAME}

// 파라미터가 있는 경우
http://{USER_ID}:{API_TOKEN}@{JENKINS_URL}/job/{JOB_NAME}/buildWithParameters?&token={TOKEN}&{KEY1}={VALUE1}&{KEY2}={VALUE2}

 

| 참고

• https://wiki.jenkins.io/display/JENKINS/Remote+access+API