작성자 : 권영민
목표 : 게임 개발에 필요한 시스템들을 자동화해보자!(패치, 빌드)
개요
게임 제작 과정에서 업데이트, 패치, 빌드 작업을 지속적으로 수행하는 것은 중요한 요소입니다. 이러한 과정을 CI/CD 과정이라고 하는데, 이번에 25L 프로젝트를 개발하면서 필요한 CI/CD 환경을 직접 구축해보면서 배워보고자 합니다. 퍼포스(Perforce), AWS, 그리고 젠킨스(Jenkins)를 활용하여 패치 자동화, 빌드 자동화 등의 CI/CD 환경을 구축할 예정입니다.
저는 안쓰는 게이밍 노트북을 따로 젠킨스 머신으로 두어, 해당 노트북에서 빌드 자동화, 패치 자동화를 수행하도록 하였습니다.
젠킨스 설치
1. Java 설치
저는 아래 링크에서 JDK 21.0.5+11 LTS 버전을 설치했습니다.
https://adoptium.net/
2. Jenkins 다운로드
저는 아래 링크에서 Window 환경Jenkins 2.479.3 LTS버전을 다운로드 받았습니다.
https://www.jenkins.io/download/
3. Jenkins 설치
다운로드한 설치 파일을 실행하여 Jenkins를 설치합니다. 설치 과정에서 계정을 등록합니다.
- 젠킨스 포트는 기본값(8080) 에서 3000으로 변경했습니다.
설치 후, Java와의 호환성을 위해 Java 설치 경로와 Jenkins 설정을 확인합니다. Jenkins는 JVM에서 실행되기 때문에 Java 버전과 경로 설정이 올바르게 구성되어야 문제 없이 작동합니다.
젠킨스 외부 접속 설정
내부 및 외부에서 젠킨스에 접속해야하는 팀원들을 위한 접속 시스템 구축에 대한 내용입니다.
1. IP 주소 고정하기
제가 사용한 젠킨스 머신은 노트북이기 때문에, IP를 고정해주는 작업이 필요했습니다. 이는 내부 네트워크에서 IP 주소가 변경되지 않도록 하기 위해서 입니다. DHCP를 사용하는 경우 IP가 변경되면 포트 포워딩이 작동하지 않으므로, 고정 IP 설정이 필수적입니다.
(처음에는 이 사실을 몰라서... 조금 헤맸습니다 ;; 하하)
먼저 LAN 선 연결을 합니다. 그리고 ipconfig 명령어를 사용해 게이트웨이, 서브넷, IP 주소 정보를 확인합니다. 제어판 > 네트워크 상태 및 작업 보기 > 어댑터 설정 변경 > 이더넷 > 속성 > 인터넷 프로토콜 버전4(TCP/IPv4) > 속성 로 이동합니다. 다음 IP 주소 사용을 선택하고 확인한 정보를 입력합니다. 이를 통해서, IP 주소를 고정하고 네트워크 접속의 안정성을 보장할 수 있습니다.
2. 포트포워딩 설정
공유기 설정 페이지에서 포트 포워딩을 구성해 외부 네트워크에서도 젠킨스에 접근할 수 있도록 합니다. 포트 포워딩은 외부에서 특정 포트(예: 3000)로 들어온 요청을 내부 네트워크의 젠킨스 서버로 전달하는 과정입니다.
먼저, ipconfig 명령어를 통해 받은 게이트웨이를 인터넷 브라우저 주소창에 입력하여 공유기 관리 페이지에 접속합니다. 공유기 관리 페이지의 아이디와 비밀번호를 입력합니다. (저는 SK 브로드 밴드여서 무선 MAC 끝 6자리 + “_admin”이 초기 비밀번호 였어요. )
포트포워드 설정 메유에 들어가서, 외부 포트 시작/ 끝, 사설 IP, 내부 포트 시작/ 끝 설정해줍니다.
3. 인바운드 규칙 설정하기
인바운드 규칙이란 방화벽이나 네트워크 보안 그룹에서 외부에서 내부로 들어오는 트래픽을 제어하는 규칙입니다. 이를 통해 특정 포트, 프로토콜, IP 주소 범위 등을 기반으로 허용 또는 차단할 수 있습니다. Jenkins 설치 시, 기본적으로 포트가 열리지만, 포트를 변경하거나 방화벽 규칙이 누락된 경우 수동으로 설정해야 할 수도 있습니다.
방화벽 - 고급 설정 - 인바운드 규칙에서 새 규칙을 추가하고 설정한 Jenkins 서비스 포트를 허용하여 외부에서 요청이 처리되도록 합니다.
4. (옵션) 젠킨스 URL 설정
Jenkins의 기본 URL은 localhost:포트번호 로 설정되어 있습니다. 이를 사용자가 원하는 URL로 변경할 수도 있습니다. 하지만 이 URL은 내부 젠킨스 머신에서만 동작하는 URL 입니다. 외부 접속용 URL과는 구별됩니다.
5. 접속 확인하기
- 내부 네트워크
- 같은 공유기 내부에서는 http://사설IP:포트로 접속합니다. - 외부 네트워크
- 외부에서는 http://공용IP:포트로 접속합니다.
마무리
저는 네트워크에 대한 지식이 많지 않아서, 포트포워딩 전에 무선 와이파이로 연결하게 되면 IP가 고정적이지 않다는 사실을 몰랐습니다…ㅎㅎ
그래서 처음에 조금 헤맸습니다. 또 젠킨스 URL은 젠킨스 머신에서만 동작하는 URL 같습니다…!
