[Github Action] MacOS.. 넌 왜 ARC 지원이 안되서... - Runner with MacOS

 

 

 

쿠버네티스 환경에선 ARC 를 이용하면 어렵지 않게 다양한 OS 위에 오토스케일링에 기반한 Runner 구현이 가능합니다.

Karpenter 와 함께라면 더 효율적이죠.

(Karpenter 과 궁금하다면 여기 참고, ARC 가 궁금하다면 여기 참고)

 

또한 EKS 에서 Linux 와 Windows 기반의 노드를 지원해주기 때문에 띄우기만 한다면 파드 단위로 Runner 를 배포할 수 있습니다.

(EKS 에서 Windows 를 활성화 하는 방법이 궁금하다면 여기 참고)

 

하지만 MacOS 는 얘기가 달라요..

EKS 에서 지원을 안해줍니다.. 그래서 만약 MacOS 기반의 워커 노드를 프로비저닝 하려고 한다면, 아마 MacOS 기반의 인스턴스를 띄운 후 거기서 수동으로 EKS 클러스터에 조인해야 할 것입니다.

 

뿐만 아니라, Runner 이미지는 Linux 만 지원되서 MacOS 기반으로 또 만들어야 하죠.

 

관리 요소가 많아지는 건 둘째치고, 가장 큰 문제는 MacOS x86 한달 비용이 약 130만원 정도 됩니다. 너무 비싸요.

mac x86 비용

 

AWS 인스턴스는 선택의 여지 없이 포기해야 합니다.

 

그래서 결국 MacBook Intel 에 직접 Runner 를 실행 시키고자 합니다. 오늘은 그 방법에 대해 한번 알아보고자 합니다.

 

렛츠두더코드~

 

 

Runner 를 등록하는 방법은 깃헙 공식 문서에 너무 잘 나와 있어요.

보고 따라한다면 어렵지 않게 등록할 수 있습니다.

 

깃헙으로 들어가서 아래와 같은 탭을 클릭하면 OS 별 커맨드를 보여주는 데, 이걸 조금만 바꿔서 실행하면 됩니다.

 

MacOS, Windows, Linux 그리고 arm64, x86 이 있는데 구분 잘해서 하자! x86 에서 arm64 다운 받고 왜 안되지 라는 뻘짓은 하지 말자! (내가 그랬다..)

 

 

다음과 같이 작성했습니다. #Configure 부분이 바뀌었는데 그 부분에 대해서는 아래에서 설명합니다.

$ mkdir actions-runner && cd actions-runner 
$ curl -o actions-runner-osx-x64-2.311.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.311.0/actions-runner-osx-x64-2.311.0.tar.gz 
$ echo "f4d8d1dd850fd0889e0d250c82fa587b0e21934f8441143ee6772284b2ae6211  actions-runner-osx-x64-2.311.0.tar.gz" | shasum -a 256 -c 
$ tar xzf ./actions-runner-osx-x64-2.311.0.tar.gz

#Configure
$ ./config.sh --name runner-macos-x86-01 --url https://github.com/<my-org> --runnergroup "my-group" --token "my-token" --labels macos,x86,my-runner --unattended --replace # you can add --ephemeral 
$ ./svc.sh install
$ ./svc.sh start

 

 

--ephemeral 옵션은 오토스케일링 환경에 적합한 옵션이므로 여기선 지정해주지 않겠습니다.

참고로 ARC 에서 파드 단위의 Runner 에는 --ephemeral 옵션이 부여되어 있습니다.

 

또한 토큰은 1시간 뒤에 만료되서 재발급을 받아야 하는데 API 를 통해 어렵지 않게 얻을 수 있습니다.

다만 권한에 유의하시길 바랍니다. (관련 문서는 여기 참고)

$ curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  https://api.github.com/orgs/ORG/actions/runners/registration-token

 

 

그럼 이제 위위 코드 #Configure 에 명시되어 있는 명령어를 차례대로 실행해줍니다.

./config.sh 를 통해서 우선 인증을 해줍니다.

 

다음은 ./svc.sh install 을 해줍니다. 

run.sh 가 아닌 svc.sh 를 실행하는 이유는 단순히 프로세스가 아닌 데몬(서비스)로 등록하기 위함입니다.

데몬으로 등록하지 않는 다면, Mac 이 재부팅될 경우 수동으로 다시 실행시켜야 하기 때문이죠.

성공적으로 됐다면 plist 라는 파일이 생성될 것입니다.

 

 

다음은 ./svc.sh start 입니다.

이 부분에 대해서는 안되는 분들이 있을거에요.

(저 같은 경우 Root 이 아닌 Runner 라는 Mac 유저를 만들었고, Runner 유저로 실행했더니 에러가 발생했습니다.)

 

다행히 에러 관련해서 해결 방법이 있습니다. (여기 참고)

다양한 해결 방법이 많은데 저는 이 방법을 택했습니다.

 

./svc.sh start 가 문제 없이 실행됐다면, 이제 ./svc.sh status 를 통해 상태 확인을 해줍니다.

 

그리고 실제로도 등록이 아주 잘 되었습니다.

 

 

그런데 여기서 문득 한가지 생각이 떠올랐습니다.. 우리는 위에서 Runner 를 데몬으로 등록했죠.

그 말은 즉슨, 하나의 호스트에 여러 개의 Runner 등록이 가능하다는 말이죠!

 

Runner 를 구분 짓는 폴더를 2개 더 만든 후, 위 과정을 반복했습니다.

 

 

그리고 성공적으로 2개 더 추가적인 Runner 를 등록했습니다!

 

 

오늘은 MacOS 에 Runner 를 여러 개 등록하는 방법에 알아봤습니다.

하면서 느낀 점이 있다면, ARC 가 훨~~~~~씬 편하다 였습니다.

 

그럼 오늘은 여기까지!