GitHub Actions self-hosted runner를 구성하는 과정에 대해 설명드립니다. 제가 직접 경험해본 바로는, 자주 사용하지 않는 runner를 선택할 경우, 관리 측면에서 불편함이 발생할 수 있지만, 기술적으로 더 효율적인 환경을 구성할 수 있는 기회가 주어집니다. 특히 팀 내에서 설정을 개인의 요구에 맞게 수정하고 싶다면, self-hosted runner 구성은 실질적으로 도움을 주는 방식이라고 느꼈어요. 아래를 읽어보시면, 제가 직접 체크해본 내용을 통해 Ubuntu에서 self-hosted runner를 어떻게 설정하는지 자세히 설명드리겠습니다.
- 1. self-hosted runner 설정을 위한 첫 단계
- 1.2 validate
- 2. runner 실행하기
- 2.1 run.sh 파일 실행
- 2.2 상태 확인
- 3. Docker 설치
- 3.1 Ubuntu에 Docker 설치
- 3.2 non-root 유저 설정
- 4. GitHub Actions 스크립트 설정 변경
- 4.1 runs-on 설정
- 5. self-hosted runner 확인
- 5.1 action 실행
- 공지사항 및 추가 정보
- 자주 묻는 질문 (FAQ)
- self-hosted runner 정책은 어떻게 되나요?
- Docker를 반드시 설치해야 하나요?
- self-hosted runner의 장점은 무엇인가요?
- self-hosted runner 구성에 따르는 단점은 무엇인가요?
- 함께보면 좋은글!
1. self-hosted runner 설정을 위한 첫 단계
self-hosted runner를 구성하기 위해서는 먼저 GitHub의 리포지토리에서 Settings > Runners 메뉴로 이동하여 New self-hosted runner 버튼을 클릭해야 해요. 이 과정은 매우 직관적이며, 사용자가 필요한 구성 요소를 신속하게 접근할 수 있도록 도와줍니다.
1.1 환경 선택 및 스크립트 실행
환경을 선택하고 아래에 제공된 스크립트를 그대로 실행하면 됩니다.
bash
$ ./config.sh --url https://github.com/your_username/your_repository --token your_token
이 단계에서 주의가 필요한 것은 토큰을 안전하게 관리하는 것입니다.
1.2 validate
이런 스크립트를 실행하면 아래와 같은 인터페이스가 나타나면서 설정을 단계별로 안내합니다.
여기서 주의할 점은 각 단계에서 입력하는 정보가 중요하다는 것입니다. 예를 들어, runner의 이름이나 그룹을 설정하는 것이지요. 이러한 설정을 거쳐 Runner successfully added 메시지가 나오면 성공적으로 설정된 것입니다.
2. runner 실행하기
self-hosted runner를 설정하고 나면, 다음 단계로 이동해 실행해야 해요.
2.1 run.sh 파일 실행
./run.sh 커맨드를 실행하여 runner를 활성화해줍니다.
bash
$ ./run.sh
이 과정을 통해, GitHub과의 연결이 성공적으로 이루어짐을 확인할 수 있습니다. 이 단계에서 Listening for Jobs 메시지가 보인다면 정상적으로 실행된 것입니다.
2.2 상태 확인
이런 상태에서 GitHub 페이지의 runner 목록을 보면, 방금 설정한 runner의 Status가 Idle로 변경된 것을 확인할 수 있습니다. 이는 runner가 준비가 완료된 상태라는 의미에요.
3. Docker 설치
self-hosted runner는 기본적으로 Docker를 사용하므로, Docker가 설치되지 않았다면 설치가 필요해요.
3.1 Ubuntu에 Docker 설치
Docker 설치는 아래의 공식 문서를 참조하여 진행해주세요.
– Unbuntu에서 Docker 설치
3.2 non-root 유저 설정
non-root 유저가 Docker를 사용할 수 있도록 설정하는 것도 잊지 말아야 해요.
– non-root 유저 Docker 관리
4. GitHub Actions 스크립트 설정 변경
이제 self-hosted runner가 준비되었으니, GitHub Actions 스크립트에서 job 설정을 변경해서 runner를 사용해야 해요.
4.1 runs-on 설정
GitHub의 actions script에서 runs-on 부분에 self-hosted runner의 label을 지정해주면 됩니다. 예를 들어,
yaml
jobs:
build:
runs-on: [my-runner]
5. self-hosted runner 확인
마지막으로 action을 실행해봄으로써 self-hosted runner가 정상적으로 작동하는지 확인하면 됩니다.
5.1 action 실행
action을 트리거하여 self-hosted runner에서 job이 실행되는지 확인하는 단계예요. 정상적으로 실행된다면, self-hosted runner의 구성은 성공적으로 완료된 것이에요.
공지사항 및 추가 정보
이와 같은 self-hosted runner 구성을 통해 GitHub 사용의 유연성과 속도가 향상될 것입니다. 그러나 구성 전 사용자의 필요와 팀의 요구에 맞는지 충분히 고려해야 해요.
자주 묻는 질문 (FAQ)
self-hosted runner 정책은 어떻게 되나요?
self-hosted runner는 GitHub Actions의 요금에 영향을 미칠 수 있으며, 사용하는 컴퓨팅 리소스에 따라 가산금액이 발생할 수 있습니다.
Docker를 반드시 설치해야 하나요?
예, self-hosted runner는 GitHub Action을 실행할 때 기본적으로 Docker를 사용하므로, Docker 설치는 필수입니다.
self-hosted runner의 장점은 무엇인가요?
팀의 요구에 맞는 리소스를 커스터마이징할 수 있으며, 빌드 및 테스트 속도를 향상시킬 수 있다는 장점이 있습니다.
self-hosted runner 구성에 따르는 단점은 무엇인가요?
설치 및 유지 관리에 추가적인 노력이 필요하며, GitHub-hosted runner와 같은 즉각적인 지원을 받지 못할 수 있습니다.
GitHub Actions의 self-hosted runner는 특정한 상황에서는 비용 효율성을 높이고 개발 속도를 개선할 수 있는 확실한 솔루션이 될 수 있더라구요. 그러니 직접 적용해보시고 효과를 확인해보세요!
키워드: GitHub Actions, self-hosted runner, Ubuntu, Docker 설치, CI/CD 환경, GitHub 설정, 개발자 팁, DevOps 구축, 오픈 소스 도구, 컨테이너화, 사용자 정의 러너.