InfoGrab DocsInfoGrab Docs

Docker executor에서 Windows 버전 지원 추가

GitLab Runner Docker executor에서 새로운 Windows 버전을 지원하기 위한 헬퍼 이미지 빌드 및 인프라 설정 절차를 설명합니다.

GitLab은 특정 버전의 Windows 를 지원합니다. Docker executor 에서 새로운 Windows 버전을 지원하려면, 동일한 Windows 버전의 헬퍼 이미지 를 릴리스해야 합니다. 그런 다음 Windows 호스트 OS에서 헬퍼 이미지를 실행할 수 있습니다. 해당 버전의 헬퍼 이미지를 빌드하려면 해당 Windows 버전에 GitLab Runner가 설치되어 있어야 합니다. Windows는 호스트 OS와 컨테이너 OS 버전이 일치해야 하기 때문입니다. 인프라 # 사용자 작업에 사용될 헬퍼 이미지를 빌드해야 합니다. 인프라용 기본 이미지 생성 # 새 Windows 버전을 지원하려면 새 헬퍼 이미지를 생성해야 할 수 있습니다. Windows 버전은 이전 헬퍼 이미지를 사용할 수도 있고(하위 호환성), 새로 빌드된 헬퍼 이미지가 필요할 수도 있습니다. 호환성 상세 내용은 Windows 컨테이너 버전 호환성 을 참조하세요. GitLab Runner 헬퍼 이미지는 runner-tools/base-images 프로젝트에서 게시한 기본 이미지로부터 빌드됩니다. dockerfiles/runner-helper/docker-bake.hcl 의 windows 타깃이 빌드 구성을 정의합니다. 새 Windows 버전이나 아키텍처를 지원하려면, 해당 프로젝트가 먼저 일치하는 runner-helper:<version>-servercore-ltsc<year>[-<arch>] 기본 이미지를 게시해야 합니다. 예를 들어 머지 리퀘스트 88 은 ltsc2025 , ltsc2025-arm64 , servercore , nanoserver 기본 이미지를 추가했습니다. windows-containers 리포지터리는 공유 Windows 러너 플릿을 위한 GCP 호스트 VM 이미지를 빌드합니다. autoscaler 가 이를 프로비저닝합니다. 예를 들어, Windows Server 2025 지원을 추가할 때는 하위 호환성 덕분에 기존 2022 헬퍼 이미지를 재사용할 수 있었습니다. 그러나 Windows Server 2022 지원을 추가할 때는 Windows Server 2019 헬퍼 이미지가 프로세스 격리와 호환되지 않아 새 이미지가 필요했습니다. 일부 GCP 기본 이미지는 빌드 프로세스 중 Docker 설치가 필요합니다. 새 이미지를 위한 CI/CD 환경을 업데이트하려면 다음 파일을 업데이트하세요: .gitlab-ci.yml .gitlab/ci/build.gitlab-ci.yml 생성된 이미지 테스트 # dev 단계에서 생성된 이미지를 테스트하는 것을 권장합니다. 이미지 이름은 dev xxx 형식이며 xxx 는 Windows 서버 버전을 나타냅니다. 이미지를 테스트하려면 다음 단계를 수행하세요: GitLab Runner 프로젝트 에서 새로운 Windows 서버 버전에 대한 지원을 추가하고 gitlab-runner-helper.x86_64-windows.exe 바이너리(ARM64 호스트의 경우 gitlab-runner-helper.arm64-