Gitlab CI/CD에 Gitlab Runner 직접 붙여서 빌드하기

지난번엔 gitlab-ci.yml에 빌드 파이프라인을 구축했다.

이젠 미뤄둔 Windows 설치파일인 msi 파일을 빌드하기 위해서 Windows Gitlab Runner 를 등록해서 msi 빌드를 할 때가 됐다.

 

1. Gitlab Runner 등록 창으로 이동

프로젝트에서 Settings>CI/CD 를 누르면 CI/CD Setting들이 나오는데 이중에서 Runners를 열면 현재 해당 프로젝트에 등록된 Gitlab Runner가 보인다. 

해당 위치에서 Available Runners 오른쪽에 작게 있는 'Create project runner' 버튼을 누르면 등록 화면으로 이동한다.

 

2. 등록할 Gitlab Runner의 정보 입력

등록할 Gitlab Runner의 정보를 입력해주어야 한다.

 

입력할 정보는 다음과 같다.

• Tags
  • gitlab-ci.yml에 작성하는 job에 이 job은 특정 태그의 Runner에서 실행 하도록 할수 있음.
  • 예시) 'windows' (Windows 환경 빌드용 태그)
• Runner description
  • Gitlab CI/CD Settings의 Runners 또는 Jobs에서 현재 실행되고 있는 Runner에 보일 설명.
  • 이름과, 환경을 적어놓음.
  • 예시) 'windows11 runner'
• Maximum job timeout
  • 실행되는 job의 최대 실행시간.
  • 이것을 짧게 넣으면 job이 실행되다가 timeout이 나서 실패 할수도 있다.

이 외의 여러개의 옵션들이 있는데, 자신에 맞게 설정하고 'Create runner' 버튼을 누르면 된다.

 

3. Gitlab Runner 설치

이젠 Gitlab Runner가 될 장치의 플랫폼을 정해주고 gitlab-runner 프로그램을 설치해야 한다.

 

화면은 아래와 같은데, 운영체제나 플랫폼에 따라 설치 방법이 달라진다.

플랫폼을 정하고, 'How do I install GitLab Runner?'를 누르면 아키텍처와 설치 방법이 나온다.

해당 방법을 따라하면 설치까진 완료된다. 

 

4. Gitlab Runner Register

'Platform' 아래를 보면 Step이 여러개 있다.

차례로 shell에서 실행시키면 된다. (powershell, bash, zsh 등)

 

gitlab-runner.exe register을 실행시키면 어떤 환경으로 runner를 실행할지 입력해야하는데, 나는 그냥 커맨드라인을 실행할 것이라 'shell'을 입력했다.

 

마지막으로 gitlab-runner run 을 실행하면 runner 등록이 완료 되었다고 뜬다.

이제 다시 위의 Gitlab CI/CD Settings의 Runners를 보면 해당 runner를 확인할수 있다

 

5. 빌드 환경 세팅

android를 shell로 빌드 할 것이기 때문에 windows에 빌드가 가능한 환경을 만들어 주어야 build job이 실패 하지 않는다.

 

환경변수를 신경쓸 환경은 다음과 같다.

• git
  • git이 깔려있어야 프로젝트를 clone받음.
• android sdk manager
  • android studio를 설치 해놨으면 깔려 있지만, android studio를 설치 안한 컴퓨터의 경우에는 안깔려있다. android studio 설치 페이지를 보면 android 커맨드 라인 툴만 따로 설치가 가능하다.
• java
  • gradle이 실행이 되고, 빌드가 되려면 설치가 되어있어야 한다.

 

위의 환경을 모두 설정해주고, build job을 windows 태그에서 실행하면 msi 파일이 빌드가 된다.