--- title: "AWS EC2 Mac 인스턴스에 GitLab Runner 설치하기" description: "iOS 앱을 개발하면서 코드사이닝, 버전 및 빌드 번호 변경, 테스트하여 TestFlight 및 App Store에 배포하는 일련의 과정은 번거로운 작업일 수 있습니다. Fastlane과 GitLab CI/CD 파이프라인을 사용하면 이러한 작업을 자동화할 수 있습니다. 개발자는 새로운 기능을 개발하거나 기존 기능을 개선한 후, 코드를 커밋하고 GitLab에 Push만 하면 됩니다. GitLab CI/CD 파이프라인이 개발자를 대신해 자동으로 빌드, 테스트하고 TestFlight 및 App Store에 앱을 배포하는 과정을 상세하게 알 수 있음" url: https://insight.infograb.net/blog/2022/05/31/setup-gitlab-runner-on-aws-ec2-mac/ source: content/blog/archive/2022-05-31-setup-gitlab-runner-on-aws-ec2-mac.md --- import Image from "../src/components/Image" 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 인스턴스는 [전용 호스트](https://docs.aws.amazon.com/ko_kr/AWSEC2/latest/UserGuide/dedicated-hosts-overview.html)에서 베어 메탈 인스턴스로만 사용할 수 있으며, 전용 호스트를 릴리스하기 전의 최소 할당 기간은 24시간입니다. 전용 호스트당 하나의 Mac 인스턴스를 시작할 수 있습니다. AWS 조직 내의 AWS 계정 또는 조직 단위나 전체 AWS 조직과 전용 호스트를 공유할 수 있습니다. Amazon EC2 전용 호스트는 고객 전용의 EC2 인스턴스 용량을 갖춘 물리적 서버입니다. 다음 절차의 설명에 따라 AWS Management Console을 사용하여 Mac 인스턴스를 시작할 수 있습니다. 1. [EC2 콘솔](https://console.aws.amazon.com/ec2/)의 좌측 탐색 창에서 **인스턴스 > 전용 호스트**를 선택합니다. 2. **전용 호스트 할당** 버튼을 클릭합니다. 3. 다음 항목을 입력 또는 선택한 후 **할당** 버튼을 클릭합니다. - 이름 태그 : `macOS GitLab Runner` 입력 - 인스턴스 패밀리 : `mac1` 선택 - 인스턴스 유형 : `mac1.metal` 선택 - 가용 영역 : 전용 호스트의 가용 영역 선택 (예 : `ap-northeast-1a`) - 수량 : `1` 유지 4. 목록에서 생성한 전용 호스트를 체크하고, **작업(Actions), 호스트에서 인스턴스 시작(Launch instances onto host)**을 차례로 선택합니다. 5. 다음 항목을 입력 또는 선택한 후 **인스턴스 시작** 버튼을 클릭합니다. - 이름 : `macos-runner` 입력 - Amazon Machine Image(AMI) : `macOS Monterey 12.3.1` 선택 - 인스턴스 유형 : `mac1.metal` 선택 - 키 페어 : 미리 생성한 키 페어 선택 - **네트워크 설정** 섹션의 **편집** 버튼을 클릭하고 다음 항목 선택 - VPC - 서브넷 - 방화벽(보안 그룹)에서 `기존 보안 그룹 선택`을 체크하고 Runner 보안 그룹 선택 - 스토리지 구성 : 100 GiB, gp2 6. 성공 메시지 확인 후, **모든 인스턴스 보기** 버튼을 클릭합니다. 7. **인스턴스** 화면에서 시작 상태를 볼 수 있습니다. 인스턴스를 시작하는 데 약간 시간이 걸립니다. 인스턴스를 시작할 때 초기 상태는 `대기 중(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 키) ![화면 공유 애플리케이션](/img/blog/2022-05-31-setup-macos-runner-1.webp) - 사용자 이름에  `ec2-user`을 입력하고 이전 단계에서 설정한 암호를 입력하여 로그인합니다. ![화면 공유 로그인](/img/blog/2022-05-31-setup-macos-runner-2.webp) - 화면 공유 애플리케이션이 시작되면 다시 패스워드를 입력하여 로그인합니다. ![macOS 로그인](/img/blog/2022-05-31-setup-macos-runner-3.webp) ### 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](/img/blog/2022-05-31-setup-macos-runner-4.webp) 이후 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 페이지로 이동합니다. ![Shared Runners](/img/blog/2022-05-31-setup-macos-runner-5.webp) - 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를 설치하고 구성하는 방법**에 대한 내용을 작성할 예정입니다. 다음 포스트도 기대해 주세요. ::cta:: ### 참고 [AWS Amazon EC2 Mac 인스턴스](https://docs.aws.amazon.com/ko_kr/AWSEC2/latest/UserGuide/ec2-mac-instances.html) [Amazon EC2 Mac Instances](https://aws.amazon.com/ec2/instance-types/mac/) [Install GitLab Runner on macOS](https://docs.gitlab.com/runner/install/osx.html) ::button::[iOS 앱 빌드 환경을 GitLab CI/CD로 구성하고 싶으신가요? GitLab 공식 파트너 인포그랩과 상담하세요!](https://insight.infograb.net/contact/)::