AWS EC2 Mac 인스턴스에 GitLab Runner 설치하기

iOS 앱을 개발하면서 코드사이닝, 버전 및 빌드 번호 변경, 테스트하여 TestFlight 및 App Store에 배포하는 일련의 과정은 번거로운 작업일 수 있습니다. Fastlane과 GitLab CI/CD 파이프라인을 사용하면 이러한 작업을 자동화할 수 있습니다. 개발자는 새로운 기능을 개발하거나 기존 기능을 개선한 후, 코드를 커밋하고 GitLab에 Push만 하면 됩니다. GitLab CI/CD 파이프라인이 개발자를 대신해 자동으로 빌드, 테스트하고 TestFlight 및 App Store에 앱을 배포합니다.

이번 글에서는 AWS EC2 Mac 인스턴스를 시작하고 Apple Remote Desktop(ARD)을 사용하여 인스턴스에 연결한 후, GitLab macOS Runner를 설치 및 구성하는 내용을 다루겠습니다. “GitLab과 Fastlane으로 iOS 앱 빌드 및 배포 자동화하기” 시리즈의 첫 번째 포스트입니다.

GitLab에서 iOS 앱을 빌드하고 배포하기 위해서는 macOS Runner가 필요합니다. 소규모 기업이나 팀에서는 Mac mini나 MacBook에 Runner를 설치하고 사무실 한편에 두고 사용할 수 있겠으나 보안, 안정성 및 확장성 향상을 고려한다면 AWS EC2 Mac 인스턴스를 사용하는 것도 방법입니다. 다만 AWS EC2 Mac 인스턴스 사용에 대한 비용은 고려해야 할 사항입니다.

AWS EC2 Mac 인스턴스 시작

Mac1 인스턴스는 기본적으로 macOS 운영 체제를 지원합니다. Mac 미니 하드웨어에 구축되며 3.2GHz 인텔 8세대(Coffee Lake) Core i7 프로세서로 구동됩니다. 이러한 인스턴스는 iPhone, iPad, iPod, Mac, Apple Watch 및 Apple TV와 같은 Apple 디바이스용 애플리케이션의 개발, 구축, 테스트 및 서명에 적합합니다. SSH 또는 Apple Remote Desktop(ARD)을 사용하여 Mac 인스턴스에 연결할 수 있습니다.

EC2 Mac 인스턴스 상세 정보

현재는 x86 기반 EC2 Mac 인스턴스만 사용 가능하고, M1 Mac 인스턴스는 preview 상태입니다.

Instance Family	Instance Size	Processor	Physical cores	vCPUs	Memory (GiB)	Instance Storage	Network Bandwidth (Gbps)	EBS Bandwidth (Mbps)
Mac1	mac1.metal	Intel Core i7	6	12	32	EBS-Only	10	8,000
Mac2	mac2.metal	Apple M1	4 performance +4 efficiency cores	12	16	EBS-Only	10	8,000

가격

Amazon EC2 Mac 인스턴스는 온디맨드 및 Savings Plan 요금 모델을 통해 전용 호스트로 구입할 수 있습니다. EC2 Mac 인스턴스에 대한 청구는 Apple macOS 소프트웨어 라이선스 계약을 준수하기 위해 24시간의 최소 할당 기간으로 초당 청구됩니다. 온디맨드를 통해 EC2 Mac 호스트를 시작하고 몇 분 안에 가동 및 실행할 수 있습니다. 24시간의 최소 할당 기간이 끝나면 호스트는 추가 약정 없이 언제든지 해제될 수 있습니다.

온디맨드 요금

아시아 태평양(서울) : 1.332 USD (1일 : 31.968 USD)
아시아 태평양(도쿄) : 1.399 USD
미국 (버지니아 북부, 오하이오) : 1.083 USD

콘솔을 사용하여 Mac 인스턴스 시작

Mac 인스턴스는 전용 호스트에서 베어 메탈 인스턴스로만 사용할 수 있으며, 전용 호스트를 릴리스하기 전의 최소 할당 기간은 24시간입니다. 전용 호스트당 하나의 Mac 인스턴스를 시작할 수 있습니다. AWS 조직 내의 AWS 계정 또는 조직 단위나 전체 AWS 조직과 전용 호스트를 공유할 수 있습니다.

Amazon EC2 전용 호스트는 고객 전용의 EC2 인스턴스 용량을 갖춘 물리적 서버입니다.

다음 절차의 설명에 따라 AWS Management Console을 사용하여 Mac 인스턴스를 시작할 수 있습니다.

EC2 콘솔의 좌측 탐색 창에서 인스턴스 > 전용 호스트를 선택합니다.
전용 호스트 할당 버튼을 클릭합니다.
다음 항목을 입력 또는 선택한 후 할당 버튼을 클릭합니다.
- 이름 태그 : macOS GitLab Runner 입력
- 인스턴스 패밀리 : mac1 선택
- 인스턴스 유형 : mac1.metal 선택
- 가용 영역 : 전용 호스트의 가용 영역 선택 (예 : ap-northeast-1a)
- 수량 : 1 유지
목록에서 생성한 전용 호스트를 체크하고, **작업(Actions), 호스트에서 인스턴스 시작(Launch instances onto host)**을 차례로 선택합니다.
다음 항목을 입력 또는 선택한 후 인스턴스 시작 버튼을 클릭합니다.
- 이름 : macos-runner 입력
- Amazon Machine Image(AMI) : macOS Monterey 12.3.1 선택
- 인스턴스 유형 : mac1.metal 선택
- 키 페어 : 미리 생성한 키 페어 선택
- 네트워크 설정 섹션의 편집 버튼을 클릭하고 다음 항목 선택
  - VPC
  - 서브넷
  - 방화벽(보안 그룹)에서 기존 보안 그룹 선택을 체크하고 Runner 보안 그룹 선택
- 스토리지 구성 : 100 GiB, gp2
성공 메시지 확인 후, 모든 인스턴스 보기 버튼을 클릭합니다.
인스턴스 화면에서 시작 상태를 볼 수 있습니다. 인스턴스를 시작하는 데 약간 시간이 걸립니다. 인스턴스를 시작할 때 초기 상태는 대기 중(pending)입니다. 인스턴스가 시작된 후에는 상태가 실행 중(running)으로 변경되고 상태 검사를 통과하면 인스턴스가 준비됩니다.

SSH를 사용하여 인스턴스에 연결

아래 명령을 실행하여 EC2 Mac 인스턴스에 연결합니다.

bash

$ ssh -i "my-key-pair.pem" ec2-user@13.230.99.158
The authenticity of host '13.230.99.158 (13.230.99.158)' can't be established.
ED25519 key fingerprint is SHA256:J4yXPVW6l5n4WLridVLGwks/XcdpTQpe6HaUUtHuswg.
This key is not known by any other names
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '13.230.99.158' (ED25519) to the list of known hosts.

    ┌───┬──┐   __|  __|_  )
    │ ╷╭╯╷ │   _|  (     /
    │  └╮  │  ___|\___|___|
    │ ╰─┼╯ │  Amazon EC2
    └───┴──┘  macOS Monterey 12.3.1

ec2-user@ip-10-20-101-35 ~ %

system_profiler SPSoftwareDataType SPHardwareDataType 명령을 실행하면 시스템의 소프트웨어와 하드웨어 정보를 확인할 수 있습니다.

bash

% system_profiler --help
% system_profiler -listDataTypes
% system_profiler SPSoftwareDataType SPHardwareDataType
Software:

    System Software Overview:

      System Version: macOS 12.3.1 (21E258)
      Kernel Version: Darwin 21.4.0
      Boot Volume: Macintosh HD
      Boot Mode: Normal
      User Name: ec2-user (ec2-user)
      Secure Virtual Memory: Enabled
      System Integrity Protection: Disabled
      Time since boot: 26 minutes

Hardware:

    Hardware Overview:

      Model Name: Mac mini
      Model Identifier: Macmini8,1
      Processor Name: 6-Core Intel Core i7
      Processor Speed: 3.2 GHz
      Number of Processors: 1
      Total Number of Cores: 6
      L2 Cache (per Core): 256 KB
      L3 Cache: 12 MB
      Hyper-Threading Technology: Enabled
      Memory: 32 GB
      System Firmware Version: 1731.100.130.0.0 (iBridge: 19.16.14243.0.0,0)
      OS Loader Version: 540.100.7~23
      Serial Number (system): H2WFR0U5JYVY
      Hardware UUID: BAC422CE-02A5-55DD-BADD-EB7EC2E68249
      Provisioning UDID: BAC422CE-02A5-55DD-BADD-EB7EC2E68249
      Activation Lock Status: Disabled

시스템의 디스크 정보를 확인합니다.

bash

% df -h
Filesystem       Size   Used  Avail Capacity iused     ifree %iused  Mounted on
/dev/disk2s4s1  100Gi   14Gi   78Gi    16%  500637 814981080    0%   /
devfs           188Ki  188Ki    0Bi   100%     650         0  100%   /dev
/dev/disk2s6    100Gi   20Ki   78Gi     1%       0 814981080    0%   /System/Volumes/VM
/dev/disk2s2    100Gi  252Mi   78Gi     1%     770 814981080    0%   /System/Volumes/Preboot
/dev/disk2s5    100Gi  256Ki   78Gi     1%      20 814981080    0%   /System/Volumes/Update
/dev/disk2s1    100Gi  6.5Gi   78Gi     8%  156064 814981080    0%   /System/Volumes/Data
map auto_home     0Bi    0Bi    0Bi   100%       0         0  100%   /System/Volumes/Data/home

ARD를 사용하여 인스턴스에 연결

Apple Remote Desktop(ARD)을 사용하여 인스턴스에 연결합니다.

로컬 컴퓨터에 ARD 클라이언트 또는 ARD를 지원하는 VNC 클라이언트가 설치되어 있는지 확인합니다.

macOS에서는 기본 제공되는 화면 공유 애플리케이션을 활용할 수 있습니다. 그렇지 않은 경우, 운영 체제의 ARD를 검색하여 설치합니다.

SSH를 사용하여 인스턴스에 연결한 후, passwd 명령을 사용하여 ec2-user 게정의 암호를 설정합니다.

bash

$ sudo passwd ec2-user
Changing password for ec2-user.
New password:
Retype new password:

################################### WARNING ###################################
# This tool does not update the login keychain password.                      #
# To update it, run `security set-keychain-password` as the user in question, #
# or as root providing a path to such user's login keychain.                  #
###############################################################################

Apple Remote Desktop 에이전트를 시작하고 다음과 같이 원격 데스크톱 액세스를 활성화합니다.

bash

$ sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/kickstart \
  -activate -configure -access -on \
  -restart -agent -privs -all
Starting...
Screen recording might be disabled. Screen Sharing or Remote Management must be enabled from System Preferences or via MDM.
Screen control might be disabled. Screen Sharing or Remote Management must be enabled from System Preferences or via MDM.
Activated Remote Management.
Stopped ARD Agent.
ec2-user: Set user remote control privileges.
ec2-user: Set user remote access.
Done.

로컬 컴퓨터에서 아래 명령을 사용하여 인스턴스에 연결합니다.
bash
```
ssh -L 5900:localhost:5900 -i "my-key-pair.pem" ec2-user@13.230.99.158
```
Finder를 열고 화면 공유 애플리케이션을 시작합니다. (⌘cmd + k 키)
사용자 이름에 ec2-user을 입력하고 이전 단계에서 설정한 암호를 입력하여 로그인합니다.
화면 공유 애플리케이션이 시작되면 다시 패스워드를 입력하여 로그인합니다.

macOS Runner 설치 및 구성

Amazon EC2 Mac 인스턴스에 GitLab Runner를 설치하려고 할 때, SSH를 사용하여 인스턴스에 연결하여 설치하면 아래와 같은 오류가 발생할 수 있습니다. ARD로 연결한 후, GUI 상에서 Terminal을 열고 설치 및 구성을 진행해야 합니다.

bash

"launchctl" failed: exit status 112, Could not find domain for

ARD로 연결한 Amazon EC2 Mac 인스턴스에서 Terminal을 열립니다.

Terminal

이후 Runner 설치 및 등록 절차는 로컬 컴퓨터에서 진행하는 것과 동일합니다.

macOS amd64용 바이너리를 다운로드합니다.

bash

% sudo curl --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64"

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 46.9M  100 46.9M    0     0  10.6M      0  0:00:04  0:00:04 --:--:-- 10.6M

실행 권한을 부여합니다.

bash

sudo chmod +x /usr/local/bin/gitlab-runner

GitLab Admin Area에 접속한 후, Overview > Runners 페이지로 이동합니다.

Terminal에서 gitlab-runner register 명령을 실행하고 지침에 따라 아래 항목을 입력합니다.

Enter the GitLab instance URL : GitLab URL를 복사한 후, 터미널에 붙여 넣고 Enter 키를 누릅니다.
Enter the registration token : GitLab UI에서 Copy token 아이콘을 클릭하여 클립보드에 복사한 후, 터미널에 붙여 넣고 Enter 키를 누릅니다.
Enter a description for the runner : 러너에 대한 설명을 입력하고 Enter 키를 누릅니다. (예: aws-macos-runner-1)
Enter tags for the runner : amd64,monterey,ios를 입력하고 Enter 키를 누릅니다.
Enter optional maintenance note for the runner : 관리를 위한 설명을 입력합니다. (예: AWS macOS Runner)

Enter an executor : shell을 입력하고 Enter 키를 누릅니다.

bash

% gitlab-runner register
Runtime platform                                    arch=amd64 os=darwin pid=1254 revision=f761588f version=14.10.1
WARNING: Running in user-mode.
WARNING: Use sudo for system-mode:
WARNING: $ sudo gitlab-runner...

Enter the GitLab instance URL (for example, https://gitlab.com/):
https://gitlab.infograb.net/
Enter the registration token:
Hzyo3pPTE9FJgH8KpHze
Enter a description for the runner:
[ip-10-20-101-35.ap-northeast-1.compute.internal]: aws-macos-runner
Enter tags for the runner (comma-separated):
 amd64,monterey,ios
Enter optional maintenance note for the runner:
AWS macOS Runner
Registering runner... succeeded                     runner=GR1348941GJpxXCKV
Enter an executor: custom, docker, parallels, ssh, docker-ssh+machine, kubernetes, docker-ssh, shell, virtualbox, docker+machine:
shell
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

vi .gitlab-runner/config.toml 명령을 실행하고 concurrent를 1에서 8로 수정합니다.

concurrent = 8
check_interval = 0

[session_server]
  session_timeout = 1800

[[runners]]
  name = "aws-macos-runner"
  url = "https://gitlab.infograb.net/"
  token = "Hzyo3pPTE9FJgH8KpHze"
  executor = "shell"
  [runners.custom_build_dir]
  [runners.cache]
    [runners.cache.s3]
    [runners.cache.gcs]
    [runners.cache.azure]

GitLab Runner를 서비스로 설치하고 시작합니다.
bash
```
cd ~
gitlab-runner install
gitlab-runner start
```

맺음말

지금까지 AWS 전용 호스트에서 EC2 Mac 인스턴스를 시작하고 Apple Remote Desktop(ARD)을 사용하여 인스턴스에 연결한 후, GitLab macOS Runner를 설치 및 구성하는 방법을 알아보았습니다. 다음 글은 iOS 프로젝트용 GitLab CI/CD 파이프라인을 구성하기 전에, Fastlane 및 CocoaPods를 설치하고 구성하는 방법에 대한 내용을 작성할 예정입니다.
다음 포스트도 기대해 주세요.

인포그랩은 GitLab 및 DevOps에 대한 맞춤 기술 지원을 제공합니다. GitLab과 Runner 구축 관련하여 지원이 필요하시면 문의하기 로 연락 주십시오.