Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

속도 제한 구성

관리 콘솔을 사용하여 GitHub Enterprise Server에 대한 속도 제한을 설정할 수 있습니다.

이 기능을 사용할 수 있는 사용자

Site administrators can configure rate limits for a GitHub Enterprise Server instance.

GitHub Enterprise Server에 대한 속도 제한 정보

모든 사용자의 인스턴스 가용성 또는 성능에 영향을 줄 수 있는 GitHub Enterprise Server 인스턴스에서 리소스를 과도하게 사용하지 않도록 속도 제한을 구성할 수 있습니다. 속도 제한은 GitHub Enterprise Server APIs 및 GitHub Actions에 대해 구성할 수 있습니다.

속도 제한을 신중하게 구현하고 제한을 조정할 때 사용자와 자주 통신합니다. 사용자의 작업이 중단되는 것을 방지하기 위해 GitHub은 허용 속도 제한으로 시작하고 사용자 환경에 맞게 제한을 점진적으로 조정하는 것이 좋습니다.

관리 콘솔에 대한 인증 시도에 대한 속도 제한을 구성할 수도 있습니다. 자세한 내용은 "관리 콘솔에 대한 액세스 관리"을 참조하세요.

GitHub Enterprise Server APIs에 대한 속도 제한 사용

GitHub Enterprise Server APIs에 대한 과도한 요청 수는 인스턴스의 가용성 및 성능에 영향을 줄 수 있습니다. API에 대한 속도 제한이 사용자에게 미치는 영향에 대한 자세한 내용은 "REST API의 리소스 참조하세요.

관리 셸의 ghe-config 유틸리티를 사용하여 API 속도 제한에서 사용자 목록을 제외할 수 있습니다. 자세한 내용은 "명령줄 유틸리티"을 참조하세요.

참고: 관리 콘솔은 각 속도 제한에 대한 기간(분당 또는 시간당)을 나열합니다.

  1. GitHub Enterprise Server의 관리 계정에서 페이지의 오른쪽 위 모서리에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다. 1. " 사이트 관리자" 사이드바에서 관리 콘솔를 클릭합니다.

  3. “속도 제한”에서 HTTP API 속도 제한 사용 설정을 선택합니다.

  4. API마다 인증 및 인증되지 않은 요청에 대한 제한을 입력하거나 미리 채워진 기본 제한을 수락합니다.

  5. "설정" 사이드바에서 설정 저장을 클릭합니다.

    참고: 관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

  6. 구성 실행이 완료될 때까지 기다립니다.

보조 속도 제한 사용 설정

보조 속도 제한을 설정하면 GitHub Enterprise Server 인스턴스의 전체 서비스 수준이 보호됩니다.

  1. GitHub Enterprise Server의 관리 계정에서 페이지의 오른쪽 위 모서리에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다. 1. " 사이트 관리자" 사이드바에서 관리 콘솔를 클릭합니다.

  3. “속도 제한”에서 보조 속도 제한 사용 설정을 선택합니다.

  4. 총 요청에 대한 제한, CPU 제한 및 검색에 대한 CPU 제한을 입력하거나 미리 채워진 기본 제한을 적용합니다.

  5. "설정" 사이드바에서 설정 저장을 클릭합니다.

    참고: 관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

  6. 구성 실행이 완료될 때까지 기다립니다.

Git에 대한 속도 제한 사용

GitHub의 직원이 권장한 경우 리포지토리 네트워크 또는 사용자 ID당 Git 속도 제한을 적용할 수 있습니다. Git 속도 제한은 분당 동시 작업으로 표현되며 현재 CPU 부하에 따라 적응형으로 적용됩니다.

경고: GitHub의 직원이 직접 권장하지 않는 한 이 설정을 사용하지 않도록 설정하는 것이 좋습니다. Git 작업은 CPU 및 RAM 사용량의 주요 동인은 거의 없습니다. 이 기능을 사용하도록 설정하면 높은 부하 조건에서 Git 작업이 실패할 가능성이 높아질 수 있지만 이러한 조건의 근본 원인을 해결하지는 못합니다.

  1. GitHub Enterprise Server의 관리 계정에서 페이지의 오른쪽 위 모서리에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다. 1. " 사이트 관리자" 사이드바에서 관리 콘솔를 클릭합니다.

  3. “속도 제한”에서 Git 속도 제한 사용 설정을 선택합니다.

  4. "리포지토리 네트워크 제한"에서 각 리포지토리 네트워크에 대한 제한을 입력합니다.

  5. "사용자 ID 제한"에서 각 사용자 ID에 대한 제한을 입력합니다.

  6. "설정" 사이드바에서 설정 저장을 클릭합니다.

    참고: 관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

  7. 구성 실행이 완료될 때까지 기다립니다.

GitHub Actions에 대한 속도 제한 설정

GitHub Actions 워크플로 실행에 속도 제한을 적용할 수 있습니다. GitHub Actions에 대한 자세한 내용은 "엔터프라이즈용 GitHub Actions 정보.

GitHub Actions에 대한 속도 제한 정보

GitHub Enterprise Server 인스턴스는 각 GitHub Actions 워크플로 작업을 실행기에게 할당합니다. 인스턴스가 사용 가능한 실행기에 작업을 즉시 할당할 수 없는 경우 실행기를 사용할 수 있을 때까지 작업이 큐에서 대기합니다. GitHub Actions에 높은 부하가 지속되면 큐가 백업될 수 있으며 GitHub Enterprise Server 인스턴스의 성능이 저하될 수 있습니다.

이 성능 저하를 방지하려면 GitHub Actions에 대한 속도 제한을 구성하면 됩니다. 이 속도 제한은 분당 작업 실행으로 표시됩니다. GitHub Enterprise Server은 인스턴스에서 모든 작업 실행의 합계에 대한 속도 제한을 계산하고 적용합니다. 실행이 속도 제한을 초과하면 큐를 입력하는 대신 추가 실행이 실패합니다. 다음 오류가 실행의 주석에 표시됩니다.

워크플로 실행 요청에 대한 속도 제한을 초과했습니다. 실행을 다시 시도하기 전에 기다려 주세요.

적절한 속도 제한은 일상적인 작업을 방해하지 않고 GitHub Actions의 비정상적인 사용으로부터 GitHub Enterprise Server 인스턴스을(를) 보호합니다. 정확한 임계값은 인스턴스의 사용 가능한 리소스와 전체 부하 프로필에 따라 달라집니다. GitHub Actions의 하드웨어 요구 사항에 대한 자세한 내용은 "GitHub Enterprise Server용 GitHub Actions 시작.

기본적으로 GitHub Actions에 대한 속도 제한은 사용하지 않도록 설정됩니다. GitHub Enterprise Server은 성능 저하 없이 일시적인 사용량 급증을 처리할 수 있으므로 이 속도 제한은 지속적인 높은 부하로부터 보호하기 위한 것입니다. 성능 문제가 발생하지 않는 한 속도 제한을 비활성화된 상태로 두는 것이 좋습니다. 경우에 따라 GitHub 지원에서 GitHub Actions에 대한 속도 제한을 사용하도록 권장할 수 있습니다.

GitHub Actions에 대한 속도 제한 활성화 또는 비활성화

  1. GitHub Enterprise Server 인스턴스에 SSH합니다. 인스턴스가 여러 노드로 구성된 경우(예: 고가용성 또는 지역 복제가 구성된 경우) 주 노드에 대한 SSH를 수행합니다. 클러스터를 사용하는 경우 임의 노드에 대해 SSH를 수행할 수 있습니다. SSH 액세스에 대한 자세한 내용은 "AUTOTITLE"을 참조하세요.

    $ ssh -p 122 admin@HOSTNAME
  2. 속도 제한을 사용하도록 설정하고 구성하려면 다음 두 명령을 실행하여 RUNS-PER-MINUTE를 선택한 값으로 바꿉니다.

    ghe-config actions-rate-limiting.enabled true
    ghe-config actions-rate-limiting.queue-runs-per-minute RUNS-PER-MINUTE
  3. 속도 제한을 활성화한 후 비활성화하려면 다음 명령을 실행합니다.

    ghe-config actions-rate-limiting.enabled false
    
  4. 구성을 적용하려면 다음 명령을 실행합니다.

    ghe-config-apply
    
  5. 구성 실행이 완료될 때까지 기다립니다.