Windows CT 2024.12를 Linux 환경의 Jenkins와 연결하기

*사용 중인 Jenkins가 CT 2024.12 설치 서버와 연결되어 있는 경우 아래의 절차를 생략하고 Jenkins 빌드 환경 구성을 진행할 수 있습니다.

아래의 절차에 따라 새로운 Node를 생성합니다.

1. [Jenkins 관리] > [Nodes]에서 [New Node]를 클릭하고 원하는 Node명을 입력합니다.
   
2. [Remote root directory]에 CT 2024.12가 설치된 서버 기준으로 Jenkins 연결 관련 정보를 저장할 루트 경로를 입력합니다.
   
3. [Launch method]에서 원하는 연결 방식을 선택합니다.
   • [Launch agent by connecting it to the controller] 옵션을 선택하는 경우
     1. [Custom WorkDir path]에 CT 2024.12가 설치된 서버 기준으로 Jenkins 워크스페이스로 사용할 경로를 입력합니다.
     2. [Use WebSocket] 체크박스를 체크하고 저장합니다.
        
     3. [Jenkins 관리] > [Nodes] > [Node명]에서 표시되는 [Run from agent command line: (Windows)] 명령어를 CT 2024.12가 설치된 서버에서 실행합니다.
   • [Launch agents via SSH] 옵션을 선택하는 경우
     1. CT 2024.12가 설치된 서버의 IP를 입력합니다.
     2. [Credentials]에서 [SSH Username with private key] kind로 생성된 Credential을 선택합니다.
        
        • SSH Credential 설정 방법은 젠킨스 문서를 참조하세요. (Generating an SSH key pair)
        • 설정 과정에 문제가 없음에도 Agent 연결이 동작하지 않는다면, 아래와 같이 RSA 대신 ED25519 키 형식을 사용해 SSH 키를 재생성 후 시도합니다.
          
        • Known hosts file Verification Strategy 옵션을 사용하는 경우 Jenkins가 설치된 서버의 /home/jenkins/.ssh/known_hosts 파일에 Agent Node가 등록되어 있는지 확인합니다.
4. 성공적으로 실행이 되었다면, Jenkins을 사용할 프로젝트 설정 페이지의 [General] 영역에서 [Restrict where this project can be run] 체크박스를 체크하고 생성한 Node를 선택합니다.