ikieEngineeringGet started
All posts

CIGitHub Actions개발 도구

CI를 Mac Studio 한 대로 옮겼어요

PR 푸시가 하루 100번을 넘자 GitHub Actions가 하루 약 2,900분을 쓴 날이 생겼어요. 모든 작업을 Mac Studio 한 대의 러너 넷으로 옮겨 GitHub 러너 사용을 0으로 만들고, 그 컴퓨터를 iOS 빌드·시뮬레이터와 나눠 쓰며 부딪힌 것들을 적어요.

English

ikie는 작은 팀이 Claude Code 세션 여럿과 함께 만들어요. 세션마다 PR을 올리니 PR 푸시가 하루 100번을 넘었어요. 2026년 10월 16일 하루에 워크플로 실행 582번, 작업 1,382개가 GitHub 러너에서 돌았고, GitHub이 작업마다 분 단위로 올려 세는 방식으로 약 2,900분이었어요.

한편 iOS 빌드와 시뮬레이터 때문에 늘 켜 두는 Mac Studio가 한 대 있었어요. 그래서 CI를 모두 그 Mac으로 옮겼어요. 지금 GitHub 러너에서 도는 작업은 없어요.

먼저 덜 돌리기

옮기기 전에 도는 양부터 줄였어요.

  • main에 합칠 때는 빌드만 돌려요. 시험은 PR에서 이미 돌았고, 합친 뒤 깨지는 것은 main 빌드와 다음 PR이 잡아요.
  • 화면 비교(screens)도 main에서는 빼요.
  • 코드 그래프(온톨로지)가 바뀐 점을 PR에 댓글로 다는 작업은 PR마다 따로 돌며 약 2분을 썼어요. 이 일을 빌드 작업 안으로 넣었어요.

Mac 한 대로 옮기기

같은 Mac에 러너 넷을 띄우고, 시험과 빌드를 runs-on: [self-hosted, ikie-ci]로 옮겼어요. Mac에서는 작업 사이에 남는 것을 일부러 써요.

  • node_modules(1GB, 파일 4만 개)를 지우지 않고 둬요. 지우고 다시 설치하면 작업마다 약 45초였어요. Node 버전과 lockfile의 해시가 같으면 npm ci를 건너뛰어요.
  • 캐시는 Mac의 디스크에 두고 APFS 복제(cp -c)로 꺼내요. 내용을 실제로 복사하지 않고 같은 블록을 가리키게 해서 거의 공짜예요.
  • 린트, 타입 검사, 온톨로지 검사는 next build가 도는 동안 뒤에서 함께 돌려요.

GitHub 러너에서 쓰던 시험 나누기(측정한 파일별 시간으로 고르게 세 조각)는 지우지 않고 남겨 뒀어요. 언젠가 되돌릴 때를 위해서예요. 같은 Mac에서는 오히려 나누지 않는 쪽이 빨랐어요. 세 조각이 70–107초씩 걸렸는데, 한 작업으로 돌리면 51초였어요. 조각마다 같은 준비를 되풀이하고, 같은 코어를 서로 다투었거든요. 필수 검사도 test (1)(2)(3)에서 test 하나로 바꿨어요.

한 컴퓨터를 나눠 쓰기

옮기고 나서 부딪힌 것은 대부분 "같은 컴퓨터를 누가 함께 쓰나"였어요.

  • 개발 세션도 같은 Mac이에요. Mac의 부하(load average)가 260–430까지 오른 적이 있어요. 대부분 Mac의 세션들이 올리기 전에 전체 검사를 돌린 몫이었어요. 지금 세션은 바뀐 곳에 닿는 검사(check:quick)만 돌리고, 전체는 CI에 맡겨요.
  • iOS 빌드가 먼저예요. 러너는 iOS 빌드보다 낮은 우선순위(nice 10)로 돌아요. 그래서 시험 제한 시간을 120초로 넉넉히 뒀어요.
  • 시험 파일이 모듈을 나눠 써요. 모듈을 가짜로 바꾸지(vi.mock) 않는 시험 파일들은 격리하지 않고 같은 모듈을 나눠 쓰게 했어요. 전체 시험이 145초에서 121초로, CPU 시간은 약 16% 줄었어요.

화면 비교는 Docker의 브라우저로

화면 비교 시험은 정해 둔 그림과 픽셀로 견줘요. 글꼴 렌더링이 운영체제마다 달라서, Mac의 브라우저로 찍으면 Linux에서 찍어 둔 그림과 맞지 않아요. 그래서 앱(Next)은 Mac에서 띄우고, 브라우저만 Docker 안의 Linux Playwright 이미지로 띄워 원격으로 붙여요. 시험 DB도 Docker의 Postgres예요.

여기서도 몇 번 부딪혔어요. Docker의 기본 자격 증명 저장소가 러너 서비스 아래서 이미지 받기를 멈춰 세웠어요. 자격 증명 없는 설정으로 바꿨어요. Docker Desktop이 꺼져 있으면 3분을 기다리다 실패했는데, 지금은 바로 까닭을 말하고 실패해요. 바쁜 러너에서는 시트가 내용을 덜 받은 채 찍히기도 해서, 상세를 다 받은 뒤 찍게 했어요.

지금 걸리는 시간

숫자로 보기
작업가운데 값
시험(잠금 기다림 포함)106초
PR 빌드104초
main 빌드75초
화면 비교148초
10월 17일 작업마다 걸린 시간의 가운데 값이에요.

GitHub 러너에서 도는 작업은 10월 17일 낮부터 없어요.

대신 받아들인 것도 있어요. Mac이 잠들거나 꺼지면 검사는 통과하지 않고 기다려요. 오래 비울 때는 PR 하나로 runs-on을 GitHub 러너로 되돌리면 돼요. 그때를 위해 시험 나누기를 남겨 둔 거고요. 그리고 같은 컴퓨터를 나눠 쓰니, Mac이 바쁠 때는 CI도 두 배쯤 느려져요.

배운 것

CI를 옮기는 일은 러너를 바꾸는 일보다 "한 컴퓨터를 누가 언제 쓰나"를 정하는 일이었어요. 시험은 한 번에 하나, iOS 빌드가 먼저, 세션은 바뀐 곳만. 그리고 작업 사이에 남는 것(설치한 패키지, 캐시)을 버리지 않는 것이 GitHub 러너에서는 할 수 없던 가장 큰 이득이었어요.

The ikie teamikie is a calendar for your events and to-dos in one place. Here we write about the problems we run into while building it, and how we solve them.