보조 사이트 Geo 프록시를 사용하면 gitlab-runner를 보조 사이트에 등록할 수 있습니다. 이렇게 하면 기본 인스턴스의 부하를 덜어 줍니다.

위치 인식 공개 URL(통합 URL) 환경에서 보조 러너 사용#

기능 플래그가 활성화된 상태에서 위치 인식 DNS를 사용하면 추가 구성 없이 동작합니다. 보조 사이트와 같은 위치에 러너를 설치하고 등록하면 러너가 자동으로 가장 가까운 사이트와 통신하며, 보조 사이트가 최신 상태가 아닐 때만 기본 사이트로 프록시합니다.

별도 URL 환경에서 보조 러너 사용#

보조 사이트에 별도 URL을 사용한다면 러너를 다음과 같이 구성합니다.

1. 보조 사이트의 외부 URL로 등록합니다.
2. clone_url을 보조 인스턴스의 external_url로 설정해 구성합니다.

보조 러너 환경에서 계획된 페일오버 처리#

계획된 페일오버를 수행할 때 보조 러너는 로컬 인스턴스와 계속 통신하려고 합니다. 이로 인해 러너 용량이 줄어들 수 있으므로 이를 감안해야 합니다.

위치 인식 공개 URL 사용 시#

위치 인식 DNS를 사용하면 모든 러너가 자동으로 가장 가까운 Geo 사이트에 연결됩니다.

새 기본 사이트로 페일오버할 때는 다음과 같습니다.

• 이전 기본 사이트가 DNS 레코드에 남아 있는 동안, 그 사이트에 연결되어 있던 러너는 계속 이전 기본 사이트에서 job을 가져오려 합니다. 해당 사이트에 연결할 수 없으면 러너가 이를 감지하고, 인스턴스가 복구된 뒤에도 일정 시간 동안 요청을 중단합니다.
• 보조 노드가 여러 개라면 최초 페일오버 이후 나머지 보조 사이트는 새 기본 사이트와 복제될 때까지 비정상 상태가 됩니다. 그 사이트에 연결된 러너는 체크인하지 못하고 상태 점검도 함께 작동합니다.
• 비정상 노드를 Geo DNS 항목에서 제거하면 러너가 그다음으로 가까운 인스턴스를 선택합니다. 아키텍처에 따라서는 용량이 줄어든 사이트에 과부하가 걸릴 수 있어 바람직하지 않을 수 있습니다.

이런 문제를 완화하려면 사이트가 완전히 복구될 때까지 일부 러너를 일시 중지하거나 종료할 수 있습니다.

이런 문제가 우려되지 않는다면 별도로 조치할 내용은 없습니다.

별도 URL 사용 시#

• 이전 기본 사이트를 다시 서비스에 투입할 예정이라면 복구될 때까지 이전 기본 사이트의 러너를 일시 중지할 수 있습니다. 이렇게 하면 상태 점검이 작동하지 않습니다.
• 이전 기본 사이트를 복구하지 않거나 러너 용량이 일시적으로 줄어드는 상황을 피하려면 기본 사이트 러너를 새 기본 사이트에 연결하도록 재구성합니다.
• 보조 사이트를 여러 개 사용한다면 새 기본 사이트로 복제되는 동안 러너를 일시 중지하거나 종료하거나 새 기본 사이트에 연결하도록 재구성합니다.

러너 일시 중지#

다음 방법을 사용하려면 관리자 접근 권한이 있어야 합니다.

• Admin 영역 사용:
  1. 오른쪽 위에서 Admin을 선택합니다.
  2. Settings > Runners를 선택합니다.
  3. 일시 중지할 러너를 확인합니다.
  4. 일시 중지할 러너마다 옆에 있는 pause 버튼을 선택합니다.
  5. 페일오버가 끝나면 앞 단계에서 일시 중지한 러너를 다시 활성화합니다.
• 러너 API 사용:
  1. 관리자 접근 권한이 있는 개인 액세스 토큰을 가져오거나 생성합니다.
  2. 러너 목록을 가져옵니다. API를 사용해 목록을 필터링할 수 있습니다.
  3. 일시 중지할 러너를 확인하고 해당 id를 기록해 둡니다.
  4. API 문서에 따라 러너를 하나씩 일시 중지합니다.
  5. 페일오버가 끝나면 paused=false로 설정해 API로 러너 목록을 다시 활성화합니다.