Windows에 Jenkins 설치하기

1. 테스트 환경 생성

[시나리오]

RDP(3389) 포트를 통해 외부에서 접근할 수 있는 Windows 가상 머신을 한 대 생성합니다.
해당 가상 머신에서 접근 가능한, Public IP가 없는 Window 가상 머신을 한 대 생성합니다.
두 가상 머신은 다른 가상 네트워크에 존재하며, VNet Peering을 통해 연결되어 있습니다.

 

※ 리소스 그룹 한 개에 모든 리소스를 전부 다 배포할 예정입니다.※

 

1.1 리소스 그룹 생성

• [기본] 탭 

 

• [검토 + 만들기] 버튼을 클릭하여 리소스 그룹 생성을 완료합니다. 

 

1.2 가상 네트워크 생성 - Hub

• [기본 사항] 탭

 

• [IP 주소] 탭

 

• [검토 + 만들기] 버튼을 클릭하여 Hub 가상 네트워크 생성을 완료합니다.

 

1.3 가상 네트워크 생성 - Spoke

• [기본 사항] 탭

 

• [IP 주소] 탭

 

• [검토 + 만들기] 버튼을 클릭하여 Spoke 가상 네트워크 생성을 완료합니다.

 

1.4 VNet Peering 구성

• [가상 네트워크] > [설정] > [피어링] > [+ 추가] 버튼을 클릭하여 피어링 구성을 진행합니다.

 

• 피어링 링크 이름 및 원격 가상 네트워크를 선택한 후 [추가] 버튼을 클릭하여 피어링 구성을 완료합니다.

 

 

1.5 가상 머신 생성 (Public IP O)

• [기본 사항] 탭

 

• [네트워킹] 탭

 

• [검토 + 만들기] 버튼을 클릭하여 가상 머신 생성을 완료합니다.

 

1.6 가상 머신 생성 (Public IP X)

• [기본 사항] 탭

 

• [네트워킹] 탭

 

• [검토 + 만들기] 버튼을 클릭하여 가상 머신 생성을 완료합니다.

 

2. Jenkins 설치 - Spoke 가상 머신

2.1 Spoke 가상 머신에 접근

Local PC에서 Hub 가상 머신에 붙은 Public IP를 통해 Hub 가상 머신에 접근한 후, 가상 머신 내에서 Remote Desktop Connection을 통해 Spoke 가상 머신에 접근합니다.

 

2.2 Java 설치

Jenkins를 설치하기 전에, 먼저 Spoke 가상 머신에 Java를 설치해야 합니다.

그러나 Oracle 페이지로 이동해서 Java를 다운로드 받기 위한 버튼을 누르면 Oracle에 로그인하는 페이지로 리다이렉트 됩니다. 

 

만약 계정이 없을 경우, https://www.jenkins.io/doc/book/installing/windows/에서 Open JDK를 다운로드 받을 수 있습니다.

 

해당 페이지로 이동해 하기 과정을 진행합니다.

 

• [java SE 21]을 클릭한 후 msi 파일을 다운로드 합니다.

 

• 다운 받은 파일을 압축 해제한 후 압축 해제된 폴더의 경로를 복사합니다.

 

• 시스템 환경 변수에 해당 경로를 등록하기 위해 로고 키를 눌러 시스템 환경 변수 편집 (Edit the system environment variables)를 클릭합니다.

 

• [환경 변수 (Environment Variables)] > [새로 만들기 (New)] 버튼을 클릭합니다. 

 

• 변수 이름 (Variable name)에 JAVA_HOME을, 변수 값 (Variable value)에 복사해 둔 경로를 입력합니다.

 

• Path라는 변수에 등록한 환경 변수에 대한 bin 경로를 추가해 줍니다.

 

• cmd 창에서 java -version 명령어를 입력하여 Java 버전이 정상적으로 조회되는지 확인합니다. 

 

2.3 Jenkins 설치

• https://www.jenkins.io/download/#downloading-jenkins로 이동하여 Windows용 LTS 버전을 다운로드 받습니다.

 

• 자동으로 다운로드 되는 jenkins.msi 파일을 실행하여 설치를 진행합니다.
  • Service Logon Credentials 창이 나올 때까지 Next를 누른 후 [Run service as a local or domain user :] 옵션을 사용합니다.
    (단, 해당 옵션에서 사용되는 Account는 미리 해당 가상 머신에 생성되어 있어야 합니다. [Settings] > [Accounts] > [Add account]에서 생성 가능)
    

    

 

[Troubleshooting]

만약 account가 있음에도 하기와 같은 에러가 발생할 경우,

 This account either does not have the privilege to logon as a service or the account was unable to be verified.

 

• [로컬 보안 정책 (Local Security Policy)] > [로컬 정책 (Local Policies)] > [사용자 권한 할당 (User Rights Assignment)] > [서비스로 로그온 (Log on as a service)]으로 이동합니다.

 

• [Add User or Group] 버튼을 클릭한 후 해당 account를 추가해 줍니다. 그 후 [Apply] 버튼을 클릭하여 변경 사항을 저장합니다.

 

• Port Selection 창이 나올 때까지 Next를 누른 후 사용할 Port를 입력하고 Test 합니다.

 

• Java Home Directory에 대해 default 경로를 실제 Java가 설치된 경로로 변경해 줍니다.

 

• 모든 설정이 완료되면 [Install] 버튼을 클릭하여 설치를 완료합니다.

 

2.4 Jenkins 초기 설정

• 인터넷 창에서 가상 머신 private ip:8080을 입력하여 Jenkins Admin 페이지에 접근합니다.
  초기 비밀번호를 확인하기 위해 해당 페이지에 출력된 경로를 복사하여 해당 파일을 엽니다.

 

• 복사한 비밀번호를 Jenkins Admin 페이지에 입력하여 접속합니다.

 

• 필요한 Plugin은 추후에 설치하면 되기 때문에 [Install suggested plugins]를 클릭합니다.

 

• Create First Admin User 페이지는 필요한 경우 새로 생성하거나, [Skip and continue as admin] 버튼을 클릭하여 건너뜁니다.

 

• Jenkins URL은 default 값이 맞는지 확인하고 Save and Finish를 클릭하여 Jenkins를 시작합니다.

 

모든 과정이 제대로 진행되었다면 Jenkins 설치가 완료된 것입니다 !