Jenkins CLI 구성 방법

작성일: 2026. 3. 30.

Jenkins CLI는 웹 UI 없이 잡 실행, 설정 덤프, 플러그인 목록 확인 등을 자동화할 때 씁니다. 핵심은 접속 URL, 인증, JRE 세 가지를 맞추는 것입니다.

1. 준비물

• Jenkins 베이스 URL(예: https://jenkins.example.com)
• 사용자 계정과 API 토큰(User → Configure → API Token)
• Java 런타임(서버와 TLS 버전 호환되는 JRE 권장)

2. CLI JAR 받기

브라우저에서 {JENKINS_URL}/jnlpJars/jenkins-cli.jar 로 내려받거나, 배포 스크립트에서 curl로 고정 버전을 캐시해 씁니다.

3. 인증 방식

-auth user:token 형식이 가장 흔합니다. 토큰은 비밀번호와 동급으로 취급하고, 스크립트에는 환경변수나 비밀 저장소(Credentials, Vault 등)로 주입합니다.

java -jar jenkins-cli.jar -s https://jenkins.example.com \
  -auth "$JENKINS_USER:$JENKINS_TOKEN" who-am-i

4. 자주 쓰는 명령

# 잡 목록
java -jar jenkins-cli.jar -s "$JENKINS_URL" -auth "$U:$T" list-jobs

# 빌드 트리거(대기·로그)
java -jar jenkins-cli.jar -s "$JENKINS_URL" -auth "$U:$T" build my-job -s -v

# Groovy 콘솔은 권한이 매우 강하므로 운영 정책에 맞게만 사용합니다.

5. 프록시·SSL

• 사내 프록시가 있으면 JVM 옵션 -Dhttps.proxyHost=... 등을 맞춥니다.
• 사설 CA를 쓰면 truststore에 CA를 넣거나(권장), 운영 표준에 맞는 인증서를 Jenkins에 적용합니다.

6. 보안 체크리스트

• CLI용 계정에는 필요한 잡 권한만 부여합니다.
• 토큰 로테이션·폐기 절차를 둡니다.
• CI 스크립트에 토큰 평문 커밋 금지

원문: Jenkins CLI 구성 방법

목록으로