프로젝트 가져오기 테스트
테스트를 위해 우리 자신의 GitLab CE 프로젝트(이 경우 이름은 gitlabhq
)를 qa-perf-testing
라는 그룹에 가져올 수 있습니다. 테스트에 사용할 수있는 프로젝트 tar볼은 performance-data 프로젝트에서 찾을 수 있습니다. 필요한 경우 다른 프로젝트를 사용할 수 있습니다.
테스트 프로젝트를 가져오는 여러 가지 방법이 있습니다. 권장 그룹 qa-perf-testing
및 프로젝트 gitlabhq
가 설정되고 있다는 전제 하에 세부 내용은 다음과 같습니다.
프로젝트 가져오기
테스트 프로젝트를 가져오는 데에는 다음 중 하나의 방법을 사용하십시오.
UI를 사용하여 가져오기
첫 번째 옵션은 GitLab UI를 사용하여 프로젝트 tar볼 파일을 가져오는 것입니다:
-
qa-perf-testing
그룹을 만듭니다. - GitLab FOSS 프로젝트 tar볼을 그룹에 가져옵니다.
프로젝트가 완전히 가져올 때까지 최대 15분이 소요될 수 있습니다. 현재 상태를 확인하려면 프로젝트의 주요 페이지로 이동할 수 있습니다.
이 방법은 모든 오류를 무시합니다(특히 GITALY_DISABLE_REQUEST_LIMITS
와 관련된 오류 포함) 그리고 GitLab 사용자에 의해 사용됩니다. 개발 및 테스트를 위해서는 아래의 다른 방법을 확인하십시오.
import-project
스크립트를 사용하여 가져오기
performance 프로젝트에 제공되는 편리한 스크립트인 bin/import-project
를 사용하여 프로젝트 tar볼을 터미널을 통해 GitLab 환경으로 가져올 수 있습니다.
스크립트를 사용하려면 이미 준비가 되어 있지 않다면 다음 절차를 따르십시오:
- 먼저, 머신에 이미 사용 가능하지 않다면
Ruby
및Ruby Bundler
를 설치합니다. - 다음으로,
bundle install
로 번들러를 통해 필요한 Ruby Gems를 설치합니다.
bin/import-project
사용 방법에 대한 자세한 내용은 다음을 실행하십시오:
bin/import-project --help
프로젝트가 완전히 가져올 때까지 최대 15분이 소요될 수 있습니다. 스크립트는 정기적으로 상태를 확인하고 가져오기가 완료되면 종료합니다.
GitHub를 사용하여 가져오기
또한 GitHub를 통해 프로젝트를 가져오는 옵션이 있습니다:
-
qa-perf-testing
그룹을 만듭니다. - GitHub에서 미러링된 GitLab FOSS 리포지터리를 UI를 통해 그룹에 가져옵니다.
이 방법은 다른 방법보다 가져오는 데 더 많은 시간이 소요되며 여러 가지 요소에 의존합니다. 다른 방법을 사용하는 것이 권장됩니다.
GitHub Enterprise (GHE)에서 GitLab로 가져오기를 테스트하려면 GHE 인스턴스가 필요합니다. GitHub Enterprise Server 체험판을 요청하여 Google Cloud Platform에 설치할 수 있습니다.
- GitLab 팀 구성원은 이를 위해 Sandbox Cloud Realm을 사용할 수 있습니다.
- 다른 사용자들은 Google Cloud Platforms 무료 체험판을 요청할 수 있습니다.
Rake 작업을 사용하여 가져오기
Rake 작업을 사용하여 테스트 프로젝트를 가져오려면 대규모 프로젝트 가져오기를 참조하십시오.
Rails 콘솔을 사용하여 가져오기
마지막 옵션은 Rails 콘솔을 사용하여 프로젝트를 가져오는 것입니다:
-
Ruby on Rails 콘솔을 시작합니다:
# Omnibus GitLab gitlab-rails console # 소스에서 설치하는 경우 sudo -u git -H bundle exec rails console -e production
-
프로젝트를 생성하고
Project::TreeRestorer
를 실행합니다:shared_class = Struct.new(:export_path) do def error(message) raise message end end user = User.first shared = shared_class.new(path) project = Projects::CreateService.new(user, { name: name, namespace: user.namespace }).execute begin # 요청 리포지터리 사용 RequestStore.begin! Gitlab::ImportExport::Project::TreeRestorer.new(user: user, shared: shared, project: project).restore ensure RequestStore.end! RequestStore.clear! end
-
필요한 경우 리포지터리도 복원할 수 있습니다:
repo_path = File.join(shared.export_path, Gitlab::ImportExport.project_bundle_filename) Gitlab::ImportExport::RepoRestorer.new(path_to_bundle: repo_path, shared: shared, importable: project).restore
모든 가져오기 실패는
import_failures
데이터 테이블에 저장됩니다.프로젝트 가져오기가 어떠한 문제없이 완료되었는지 확인하려면:
project.import_failures.all
성능 테스트
성능 테스트를 위해 우리는:
- 상당히 큰 프로젝트,
gitlabhq
를 가져와야 합니다. -
Project::TreeRestorer
의 실행 시간을 메트릭해야 합니다. - 복원하는 동안 실행된 SQL 쿼리 수를 계산해야 합니다.
- 발생하는 GC 주기 수를 관찰해야 합니다.
https://gitlab.com/gitlab-org/gitlab/snippets/1924954
(로그인해야 함)이라는 스니펫을 사용하여 프로젝트를 복원하고, Project::TreeRestorer
의 실행 시간, SQL 쿼리 수, GC 주기 수를 메트릭할 수 있습니다.
다음과 같이 gdk/gitlab
디렉터리에서 스크립트를 실행할 수 있습니다:
bundle exec rails r /path_to_script/script.rb project_name /path_to_extracted_project request_store_enabled
액세스 토큰 설정
테스트 중에 많은 경우 GitLab 개인 액세스 토큰이 필요합니다. 왜냐하면 다양한 엔드포인트가 인증을 요구하기 때문입니다.
GitLab 설명서에서 이 토큰을 생성하는 방법에 대해 자세히 설명되어 있습니다.
테스트는 이 토큰이 관리자에 의해 생성되었으며 API
및 read_repository
권한을 가지고 있어야 합니다.
각 유형의 테스트에 액세스 토큰을 사용하는 방법에 대한 자세한 내용은 해당 문서에서 찾을 수 있습니다.