Jenkins Agent 연결의 종류 및 JNLP 끊김 해결 (JNLP -> WebSocket 연결로 전환)

Jenkins Agent와 Master가 연결하는데에는 크게 (1)JNLP 방식과 (2)WebSocket 방식이 있습니다.

Jenkins의 Master - Agent 연결 방식의 종류

1. JNLP (Java Network Launch Protocol) 방식
   • master와 agent가 연겨하는 데에 별도의 포트를 사용하여 master - agent 통신을 위한 독립적인 채널을 사용하는 방식
   • Jenkins 초기 버전부터 사용되어 온 방식
   • 장점 : Jenkins에서 웹 트래픽과 Agent 통신 트래픽을 분리하여 관리할 수 있음.
   • 단점 : 방화벽 설정이나 네트워크 정책에 따라 연결 문제를 일으킬 수 있음.
2. WebSocket 방식
   • HTTP 연결을 업그레이드하여 양방향 통신 채널을 제공하는 방식으로, 웹 표준 기술이며 대부분의 현대 웹 브라우저와 호환됨.
   • 장점
     • 단일 포트 사용이 가능함. Jenkins 웹서버가 사용하는 동일한 HTTP/HTTPS 포트 (예: 8080/443)을 사용하기 때문에 별도의 포트를 열어두지 않아도 됨.
     • websocket은 지속적인 연결을 유지하므로 연결에 따른 오버헤드가 줄어들고 네트워크 리소스 사용이 최적화 됨
   • 단점 : 전통적인 JNLP방식과 달라졌기 때문에 일부 jenkins 플러그인에서 호환성 문제가 발생할 수 있음. websocket 트래픽을 특별히 관리하거나 필터링 해야하는 경우 추가적인 작업이 필요할 수 있음.

 

WebSocket 방식으로 Jenkins Agent를 추가하는 방법

1. Jenkins > Jenkins 관리 > System Configuration > 노드관리 > 연결하고자 하는 agent 클릭 > 설정 클릭

2. 아래 구성 설정 중 "Use Websocket" 설정 체크 표시

3. 연결되어 있지 않으면 아래와 같이 나오는데, 여기서 agent.jar 를 클릭하여 다운로드

4. 다운로드 한 agent.jar 파일을 Jenkins Agent 서버로 옮김

• Jenkins Agent가 실행되는 위치에 agent.jar 파일 위치시킴
• 아래와 같이 shell script 작성

• 쉘 스크립트 실행

5. 연결 완료 및 연결 확인