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

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

새로운 러너 등록 워크플로우로 마이그레이션 # - Tier: Free, Premium, Ultimate - Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated 러너 생성 워크플로우는 러너 인증 토큰을 사용하여 러너를 등록합니다. 등록 토큰을 사용하는 레거시 워크플로우는 권장되지 않습니다. 대신 러너 생성 워크플로우 를 사용하세요. 새로운 러너 등록 워크플로우 # 새로운 러너 등록 워크플로우에서: GitLab UI에서 직접 또는 프로그래밍 방식으로 러너를 생성 합니다. 러너 인증 토큰을 받습니다. 이 구성으로 러너를 등록할 때 등록 토큰 대신 러너 인증 토큰을 사용합니다. 여러 호스트에 등록된 러너 매니저는 GitLab UI에서 동일한 러너 아래에 나타나지만 식별 시스템 ID가 있습니다. 새로운 러너 등록 워크플로우의 이점은 다음과 같습니다: 러너에 대한 소유권 기록 보존 및 사용자에 대한 영향 최소화. 고유한 시스템 ID 추가로 여러 러너에서 동일한 인증 토큰을 재사용할 수 있습니다. 자세한 내용은 GitLab Runner 구성 재사용 을 참조하세요. 러너 등록 워크플로우가 중단되는 것을 방지 # 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 차트 는 job이 실행될 때마다 새 러너 포드를 생성합니다. 이러한 러너의 경우 등록 토큰을 사용하려면 레거시 러너 등록을 활성화 하세요. gitlab-runner register 명령 구문 변경 # gitlab-runner register 명령은 등록 토큰 대신 러너 인증 토큰을 허용합니다. Admin 영역의 러너 페이지에서 토큰을 생성할 수 있습니다. 러너 인증 토큰은 glrt- 접두사로 식별됩니다. GitLab UI에서 러너를 만들 때 이전에 gitlab-runner register 명령으로 프롬프트된 명령줄 옵션이