[Jenkins] Remote Access API로 Job 호출

Remote Access API

• Jenkins는 그 기능에 기계적으로 사용할 수 있는 Remote Access API를 제공한다.
• 현재 세 가지 유형이 있다.
  • XML
  • JSON with JSONP support
  • Python
• Remote Access API는 REST와 유사한 스타일로 제공된다. 
• 즉, 모든 기능에 대한 단일 진입점이 없으며 대신 ".../api/" URL의 "..." 부분에 (the data that it acts on)를 넣어 사용할 수 있다.

 

Remote Access API로 할 수 있는 일

• programmatic consumption을 위해 젠킨스에서 정보를 검색
• 새로운 빌드를 trigger
• jobs 생성/카피

 

Submitting jobs

• 파라미터 없는 jobs의 경우
  • "JENKINS_URL/job/JOBNAME/build"에 HTTP POST만 하면 됨
• 파라미터 필요한 jobs의 경우
  • 예: string 파라미터 보내기

curl JENKINS_URL/job/JOB_NAME/buildWithParameters \
  --user USER:TOKEN \
  --data id=123 --data verbosity=high

• 예: file 파라미터 보내기
  • '@' 중요!
  • 파일 경로는 절대 경로
  • Jenkins job 설정에서 파일 위치 필드를 --form 옵션의 key와 일치하도록 Jenkins 작업을 구성해야 한다.

curl JENKINS_URL/job/JOB_NAME/buildWithParameters \
  --user USER:PASSWORD \
  --form FILE_LOCATION_AS_SET_IN_JENKINS=@PATH_TO_FILE

 

 

 

출처:

- www.jenkins.io/doc/book/using/remote-access-api/

-