테스트 가져오기 프로젝트

테스트를 위해 우리는 qa-perf-testing이라는 그룹 아래에 gitlabhq라는 이름의 GitLab CE 프로젝트를 가져올 수 있습니다. 테스트에 사용할 수 있는 프로젝트 tarball은 performance-data 프로젝트에서 찾을 수 있습니다. 필요에 따라 다른 프로젝트를 사용할 수 있습니다.

다양한 방법으로 GitLab 환경에 프로젝트를 가져올 수 있습니다. 이는 추천 그룹 qa-perf-testing과 프로젝트 gitlabhq가 설정되어 있다고 가정하고 자세히 설명됩니다.

프로젝트 가져오기

다음 방법 중 하나를 사용하여 테스트 프로젝트를 가져오세요.

UI를 사용하여 가져오기

첫 번째 옵션은 GitLab UI를 사용하여 프로젝트 tarball 파일을 가져오는 것입니다:

  1. 그룹 qa-perf-testing을 만듭니다.
  2. 그룹에 GitLab FOSS 프로젝트 tarball을 가져옵니다.

프로젝트가 완전히 가져오려면 최대 15분이 소요됩니다. 현재 상태를 보려면 프로젝트의 메인 페이지로 이동할 수 있습니다.

이 방법은 모든 오류를 조용히 무시합니다(특히 GITALY_DISABLE_REQUEST_LIMITS와 관련된 오류 포함) 및 GitLab 사용자에 의해 사용됩니다. 개발 및 테스트를 위해서는 아래의 다른 방법을 확인하세요.

import-project 스크립트를 사용하여 가져오기

편리한 스크립트인 bin/import-project가 performance 프로젝트와 함께 제공되어 API를 통해 터미널에서 GitLab 환경으로 프로젝트 tarball을 가져올 수 있습니다.

이미 사용하지 않았다면 스크립트를 사용하기 위해 일부 준비가 필요합니다:

  1. 먼저 Ruby와 Ruby Bundler를 설정합니다.
  2. 다음으로, bundle install 명령어로 Bundler를 통해 필요한 Ruby Gems를 설치합니다.

bin/import-project를 사용하는 방법에 대한 자세한 내용은 다음을 실행하세요:

bin/import-project --help

프로젝트가 완전히 가져오는 데 최대 15분이 소요됩니다. 스크립트는 주기적으로 상태를 확인하며 가져오기가 완료된 후 종료됩니다.

GitHub를 사용하여 가져오기

GitHub를 통해 프로젝트를 가져오는 옵션도 있습니다:

  1. 그룹 qa-perf-testing을 만듭니다.
  2. UI를 통해 그룹에 GitHub에서 미러링된 GitLab FOSS 리포지토리를 가져옵니다.

이 방법은 다른 방법에 비해 가져오는 데 더 오랜 시간이 걸리며 여러 요인에 따라 다릅니다. 다른 방법을 사용하는 것이 좋습니다.

GitHub Enterprise(GHE)에서 GitLab로 가져오는 테스트를 하려면 GHE 인스턴스가 필요합니다. GitHub Enterprise Server 평가판을 요청하고 Google Cloud Platform에 설치할 수 있습니다.

Rake 작업을 사용한 가져오기

Rake 작업을 사용하여 테스트 프로젝트를 가져오려면 대규모 프로젝트 가져오기를 참조하세요.

Rails 콘솔을 사용한 가져오기

마지막 옵션은 Rails 콘솔을 사용하여 프로젝트를 가져오는 것입니다:

  1. Ruby on Rails 콘솔을 시작합니다:

    # Omnibus GitLab
gitlab-rails console

# 소스에서 설치한 경우
sudo -u git -H bundle exec rails console -e production

  2. 프로젝트를 생성하고 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

  3. 저장소도 필요한 경우, 다음을 사용하여 복원할 수 있습니다:

    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 권한이 있어야 합니다.

각 유형의 테스트에 액세스 토큰을 사용하는 방식에 대한 세부 정보는 해당 문서에서 확인할 수 있습니다.