<div id="readability-page-1" class="page"><cite>KoB</cite>
 2023. 11. 12. 18:11
 <div>
 


쿠버네티스 환경에선 ARC 를 이용하면 어렵지 않게 다양한 OS 위에 오토스케일링에 기반한 Runner 구현이 가능합니다.
Karpenter 와 함께라면 더 효율적이죠.
(Karpenter 과 궁금하다면 <a href="https://kingofbackend.tistory.com/category/DevOps/Karpenter" target="_blank" rel="noopener">여기 참고</a>, ARC 가 궁금하다면 <a href="https://kingofbackend.tistory.com/category/DevOps/Github%20Action" target="_blank" rel="noopener">여기 참고</a>)

또한 EKS 에서 Linux 와 Windows 기반의 노드를 지원해주기 때문에 띄우기만 한다면 파드 단위로 Runner 를 배포할 수 있습니다.
(EKS 에서 Windows 를 활성화 하는 방법이 궁금하다면 <a href="https://kingofbackend.tistory.com/277" target="_blank" rel="noopener">여기 참고</a>)

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

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

관리 요소가 많아지는 건 둘째치고, 가장 큰 문제는 MacOS x86 한달 비용이 약 130만원 정도 됩니다. 너무 비싸요.
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="411" data-origin-height="484">
 
 <img src="https://blog.kakaocdn.net/dn/K7A3B/btsz8rcdJUi/jGLGkqe1p7ka4wtvnaSpfk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-origin-width="411" data-origin-height="484">
 
 <figcaption>mac x86 비용</figcaption>
</figure>

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

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

렛츠두더코드~
<figure data-ke-mobilestyle="widthOrigin" data-filename="로켓-렛츠.png" data-origin-width="453" data-origin-height="395">
 
 <img src="https://blog.kakaocdn.net/dn/bvVx4F/btsAcQaaweB/KYepu89GIG24g31uccBBs1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="로켓-렛츠.png" data-origin-width="453" data-origin-height="395">
 
 
</figure>


Runner 를 등록하는 방법은 <a href="https://docs.github.com/ko/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners" target="_blank" rel="noopener">깃헙 공식 문서</a>에 너무 잘 나와 있어요.
보고 따라한다면 어렵지 않게 등록할 수 있습니다.

깃헙으로 들어가서 아래와 같은 탭을 클릭하면 OS 별 커맨드를 보여주는 데, 이걸 조금만 바꿔서 실행하면 됩니다.
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="1371" data-origin-height="933">
 
 <img src="https://blog.kakaocdn.net/dn/ca0HNd/btsAaNkBSJj/Px86AeUANwhkG3ODNqowM0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-origin-width="1371" data-origin-height="933">
 
 
</figure>

<blockquote data-ke-style="style2">MacOS, Windows, Linux 그리고 arm64, x86 이 있는데 구분 잘해서 하자! x86 에서 arm64 다운 받고 왜 안되지 라는 뻘짓은 하지 말자! (내가 그랬다..)</blockquote>


다음과 같이 작성했습니다. #Configure 부분이 바뀌었는데 그 부분에 대해서는 아래에서 설명합니다.
<pre id="code_1699779126923" data-ke-language="bash" data-ke-type="codeblock"><code>$ mkdir actions-runner &amp;&amp; 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/&lt;my-org&gt; --runnergroup "my-group" --token "my-token" --labels macos,x86,my-runner --unattended --replace # you can add --ephemeral 
$ ./svc.sh install
$ ./svc.sh start</code></pre>


--ephemeral 옵션은 오토스케일링 환경에 적합한 옵션이므로 여기선 지정해주지 않겠습니다.
참고로 ARC 에서 파드 단위의 Runner 에는 --ephemeral 옵션이 부여되어 있습니다.

또한 토큰은 1시간 뒤에 만료되서 재발급을 받아야 하는데 API 를 통해 어렵지 않게 얻을 수 있습니다.
다만 권한에 유의하시길 바랍니다. (관련 문서는 <a href="https://docs.github.com/ko/rest/actions/self-hosted-runners?apiVersion=2022-11-28#create-a-registration-token-for-an-organization" target="_blank" rel="noopener">여기 참고</a>)
<pre id="code_1699779436466" data-ke-language="bash" data-ke-type="codeblock"><code>$ curl -L \
 -X POST \
 -H "Accept: application/vnd.github+json" \
 -H "Authorization: Bearer &lt;YOUR-TOKEN&gt;" \
 -H "X-GitHub-Api-Version: 2022-11-28" \
 https://api.github.com/orgs/ORG/actions/runners/registration-token</code></pre>


그럼 이제 위위 코드 #Configure 에 명시되어 있는 명령어를 차례대로 실행해줍니다.
./config.sh 를 통해서 우선 인증을 해줍니다.
<figure data-ke-mobilestyle="widthOrigin" data-filename="스크린샷 2023-11-12 오후 5.58.55.png" data-origin-width="1981" data-origin-height="1215">
 
 <img src="https://blog.kakaocdn.net/dn/cigPoV/btsAc3mWtoT/uTBslMFb3hAOsia4JqRaT0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="스크린샷 2023-11-12 오후 5.58.55.png" data-origin-width="1981" data-origin-height="1215">
 
 
</figure>

다음은 ./svc.sh install 을 해줍니다.&nbsp;
run.sh 가 아닌 svc.sh 를 실행하는 이유는 단순히 프로세스가 아닌 데몬(서비스)로 등록하기 위함입니다.
데몬으로 등록하지 않는 다면, Mac 이 재부팅될 경우 수동으로 다시 실행시켜야 하기 때문이죠.
성공적으로 됐다면 plist 라는 파일이 생성될 것입니다.
<figure data-ke-mobilestyle="widthOrigin" data-filename="스크린샷 2023-11-12 오후 6.00.18.png" data-origin-width="1833" data-origin-height="228">
 
 <img src="https://blog.kakaocdn.net/dn/bMyX4O/btsAbazSers/kVI28KjapKwnIwXUgfaokk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="스크린샷 2023-11-12 오후 6.00.18.png" data-origin-width="1833" data-origin-height="228">
 
 
</figure>


다음은 ./svc.sh start 입니다.
이 부분에 대해서는 안되는 분들이 있을거에요.
(저 같은 경우 Root 이 아닌 Runner 라는 Mac 유저를 만들었고, Runner 유저로 실행했더니 에러가 발생했습니다.)

다행히 에러 관련해서 해결 방법이 있습니다. (<a href="https://github.com/actions/runner/issues/1056" target="_blank" rel="noopener">여기 참고</a>)
다양한 해결 방법이 많은데 저는 이 방법을 택했습니다.
<figure data-ke-mobilestyle="widthOrigin" data-filename="스크린샷 2023-11-12 오후 6.04.45.png" data-origin-width="985" data-origin-height="213">
 
 <img src="https://blog.kakaocdn.net/dn/cUjGG5/btsz91XJYuD/RbkoWpLJt6aEZNAXmDdLg1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="스크린샷 2023-11-12 오후 6.04.45.png" data-origin-width="985" data-origin-height="213">
 
 
</figure>

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

그리고 실제로도 등록이 아주 잘 되었습니다.
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="1995" data-origin-height="211">
 
 <img src="https://blog.kakaocdn.net/dn/dGZckv/btsz89B0wrd/3yNjGu6sybnPUOK8vCA8R0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-origin-width="1995" data-origin-height="211">
 
 
</figure>


그런데 여기서 문득 한가지 생각이 떠올랐습니다.. 우리는 위에서 Runner 를 데몬으로 등록했죠.
그 말은 즉슨, 하나의 호스트에 여러 개의 Runner 등록이 가능하다는 말이죠!

Runner 를 구분 짓는 폴더를 2개 더 만든 후, 위 과정을 반복했습니다.
<figure data-ke-mobilestyle="widthOrigin" data-filename="스크린샷 2023-11-12 오후 6.07.29.png" data-origin-width="1990" data-origin-height="186">
 
 <img src="https://blog.kakaocdn.net/dn/bl0Hz5/btsz8rwxdyp/59JE86xetnCpRIxR9mNbA1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="스크린샷 2023-11-12 오후 6.07.29.png" data-origin-width="1990" data-origin-height="186">
 
 
</figure>


그리고 성공적으로 2개 더 추가적인 Runner 를 등록했습니다!
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="710" data-origin-height="252">
 
 <img src="https://blog.kakaocdn.net/dn/v0IvQ/btsz82JXVbm/KBGPOHN9PfT4FZ9i0AkuG0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-origin-width="710" data-origin-height="252">
 
 
</figure>


오늘은 MacOS 에 Runner 를 여러 개 등록하는 방법에 알아봤습니다.
하면서 느낀 점이 있다면, ARC 가 훨~~~~~씬 편하다 였습니다.

그럼 오늘은 여기까지!
<figure data-ke-mobilestyle="widthOrigin" data-filename="로켓-따봉.png" data-origin-width="573" data-origin-height="388">
 
 <img src="https://blog.kakaocdn.net/dn/TS8N4/btsAba0WKFG/zq1OvAKyUpy3keICaTBSK1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="로켓-따봉.png" data-origin-width="573" data-origin-height="388">
 
 
</figure>
 
 
 </div></div>

King of Back-end

쿠버네티스 환경에선 ARC 를 이용하면 어렵지 않게 다양한 OS 위에 오토스케일링에 기반한 Runner 구현이 가능합니다.
Karpenter 와 함께라면 더 효율적이죠.
(Karpenter 과 궁금하다면 여기 참고, ARC 가 궁금하다면 여기 참고)
 
또한 EKS 에서 Linux 와 Windows 기반의 노드를 지원해주기 때문에 띄우기만 한다면 파드 단위로 Runner 를 배포할 수 있습니다.
(EKS 에서 Windows 를 활성화 하는 방법이 궁금하다면 여기 참고)
 
하지만 MacOS 는 얘기가 달라요..
EKS 에서 지원을 안해줍니다.. 그래서 만약 MacOS 기반의 워커 노드를 프로비저닝 하려고 한다면, 아마 MacOS 기반의 인스턴스를 띄운 후 거기서 수동으로 EKS 클러스터에 조인해야 할 것입니다.
 
뿐만 아니라, Runner 이미지는 Linux 만 지원되서 MacOS 기반으로 또 만들어야 하죠.
 
관리 요소가 많아지는 건 둘째치고, 가장 큰 문제는 MacOS x86 한달 비용이 약 130만원 정도 됩니다. 너무 비싸요.
 
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 가 훨~~~~~씬 편하다 였습니다.
 
그럼 오늘은 여기까지!

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

댓글