Docker Machine을 사용한 자동 확장을 위한 GitLab Runner 설치 및 등록

Docker Machine executor를 사용하여 GitLab Runner의 자동 확장을 구성하는 방법을 설명합니다. GitLab 17.5에서 지원 중단 예정.

Note Docker Machine executor는 GitLab 17.5에서 지원 중단되었으며 GitLab 20.0(2027년 5월)에 제거될 예정입니다. GitLab 20.0까지 Docker Machine executor를 계속 지원하지만, 새 기능을 추가할 계획은 없습니다. CI/CD 작업 실행을 방해하거나 실행 비용에 영향을 줄 수 있는 치명적인 버그만 처리할 것입니다. Amazon Web Services(AWS) EC2, Microsoft Azure Compute 또는 Google Compute Engine(GCE)에서 Docker Machine executor를 사용하고 있다면 GitLab Runner 오토스케일러 로 마이그레이션해야 합니다. 자동 확장 아키텍처 개요는 자동 확장에 관한 종합 문서 를 참조하세요. Docker Machine 포크 버전 # Docker는 Docker Machine을 지원 중단 했습니다. 그러나 GitLab은 Docker Machine executor에 의존하는 GitLab Runner 사용자를 위해 Docker Machine 포크 를 유지 관리합니다. 이 포크는 다음 버그에 대한 추가 패치가 적용된 docker-machine 의 최신 main 브랜치를 기반으로 합니다: DigitalOcean 드라이버를 RateLimit 인식으로 만들기 Google 드라이버 작업 확인에 백오프 추가 머신 생성을 위한 --google-min-cpu-platform 옵션 추가 Google 드라이버에 캐시된 IP 사용 AWS 드라이버에 캐시된 IP 사용 Google Compute Engine에서 GPU 사용 지원 추가 IMDSv2로 AWS 인스턴스 실행 지원 Docker Machine 포크 의 목적은 실행 비용에 영향을 미치는 치명적인 이슈와 버그만 수정하는 것입니다. 새 기능을 추가할 계획은 없습니다. 환경 준비 # 자동 확장 기능을 사용하려면 Docker와 GitLab Runner가 동일한 머신에 설치되어야 합니다: Docker가 새 머신을 생성하는 배스천 서버 역할을 할 수 있는 새 Linux 기반 머신에 로그인합니다. GitLab Runner를 설치 합니다. Docker Machine 포크 에서 Docker Machine을 설치합니다. 선택 사항이지만 권장되는 방법으로, 자동 확장 러너와 함께 사용할 프록시 컨테이너 레지스트리와 캐시 서버 를 준비합니다. GitLab Runner 구성 # gitlab-runner 와 함께 docker-machine 을 사용하는 핵심 개념을 숙지합니다: GitLab Runner 자동 확장 읽기 GitLab Runner MachineOptions 읽기 Docker Machine을 처음 사용할 때는 Docker Machine 드라이버 와 함께 docker-machine create ... 명령을 수동으로 실행하는 것이 좋습니다. [runners.machine] 섹션의 MachineOptions 에서 구성하려는 옵션과 함께 이 명령을 실행하세요. 이 방법은 Docker Machine 환