새로운 러너 등록 워크플로우로 마이그레이션

러너 인증 토큰을 사용하는 새 러너 생성 워크플로우로 마이그레이션하는 방법을 설명합니다.

Disclaimer 이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. 이 정보는 참고 목적으로만 제공되며, 구매 또는 계획 시 이 정보에 의존하지 마십시오. GitLab 16.0은 러너 인증 토큰을 사용하여 러너를 등록하는 새로운 러너 생성 워크플로우를 도입했습니다. 등록 토큰을 사용하는 레거시 워크플로우는 권장되지 않습니다. 대신 러너 생성 워크플로우 를 사용하세요. 새 워크플로우의 현재 개발 상태에 대한 자세한 내용은 에픽 7663 을 참조하세요. 새 아키텍처의 기술적 설계 및 이유에 대한 자세한 내용은 차세대 GitLab Runner 토큰 아키텍처 를 참조하세요. 새 러너 등록 워크플로우에 문제가 있거나 우려 사항이 있거나 더 많은 정보가 필요한 경우 피드백 이슈 에 알려주세요. 새로운 러너 등록 워크플로우 # 새로운 러너 등록 워크플로우에서: GitLab UI에서 직접 또는 프로그래밍 방식으로 러너를 생성 합니다. 러너 인증 토큰을 받습니다. 이 구성으로 러너를 등록할 때 등록 토큰 대신 러너 인증 토큰을 사용합니다. 여러 호스트에 등록된 러너 매니저는 GitLab UI에서 동일한 러너 아래에 나타나지만 식별 시스템 ID가 있습니다. 새로운 러너 등록 워크플로우의 이점은 다음과 같습니다: 러너에 대한 소유권 기록 보존 및 사용자에 대한 영향 최소화. 고유한 시스템 ID 추가로 여러 러너에서 동일한 인증 토큰을 재사용할 수 있습니다. 자세한 내용은 GitLab Runner 구성 재사용 을 참조하세요. 계획된 변경 사항의 예상 일정 # GitLab 15.10 이상에서 새 러너 등록 워크플로우를 사용할 수 있습니다. 러너 등록 워크플로우가 중단되는 것을 방지 # GitLab 16.11 이하에서는 레거시 러너 등록 워크플로우를 사용할 수 있습니다. GitLab 17.0 이상에서는 인스턴스 관리자 또는 그룹 소유자가 레거시 러너 등록 워크플로우를 비활성화할 수 있습니다. 자세한 내용은 GitLab 17.0 이후 등록 토큰 사용 을 참조하세요. 새 워크플로우로 마이그레이션하지 않고 러너를 등록하면 러너 등록이 중단되고 gitlab-runner register 명령은 410 Gone - runner registration disallowed 오류를 반환합니다. 끊어진 워크플로우를 방지하려면: 러너를 생성 하고 인증 토큰을 얻습니다. 러너 등록 워크플로우에서 등록 토큰을 인증 토큰으로 교체합니다. GitLab 17.0 이후 등록 토큰 사용 # GitLab 17.0 이후 등록 토큰을 계속 사용하려면: GitLab.com에서 최상위 그룹 설정에서 레거시 러너 등록 프로세스를 수동으로 활성화 할 수 있습니다. GitLab Self-Managed에서 Admin 영역 설정에서 레거시 러너 등록 프로세스를 수동으로 활성화 할 수 있습니다. 기존 러너에 대한 영향 # 기존 러너는 GitLab 17.0으로 업그레이드한 후에도 정상적으로 계속 작동합니다. 이 변경 사항은 새 러너 등록에만 영향을 미칩니다. GitLab Runner Helm