업로드 파티션의 Geo 복제 테스트
GitLab v19.6요약
GitLab Development Kit(GDK) 또는 레퍼런스 환경에서 모든 업로드 파티션의 테스트 데이터를 만들고 파티션 리플리케이터를 처음부터 끝까지 실행해 봅니다. 이 페이지는 개발 지침이 아니라 수동 테스트 절차입니다.
GitLab Development Kit(GDK) 또는 레퍼런스 환경에서 모든 업로드 파티션의 테스트 데이터를 만들고 파티션 리플리케이터를 처음부터 끝까지 실행해 봅니다.
이 페이지는 개발 지침이 아니라 수동 테스트 절차입니다.
GitLab 19.5 이하에서는 geo_upload_replication 기능 플래그가 켜져 있으므로
기존 Geo::UploadReplicator가 기본적으로 uploads 테이블 전체를 복제하고 검증합니다.
GitLab 19.6 이상에서는 이 플래그가 기본적으로 꺼져 있으며, 기본적으로 활성화된 파티션 리플리케이터가
uploads 테이블의 각 파티션을 별도로 복제하고 검증합니다.
자세한 내용은 이슈 628308을 참고합니다.
실행되는 리플리케이터를 변경하려면 레거시 리플리케이터와 파티션 리플리케이터 간 전환을 참고합니다.
파티션당 업로드 하나 시딩#
gitlab:seed:geo_uploads Rake 작업은 각 업로드 파티션에 실제 Upload를 하나씩 만듭니다.
기존 프로젝트를 기준으로 부모 레코드를 만들고 각 모델의 업로더를 통해 작은 파일을 첨부하므로,
행이 올바른 파티션에 들어가고 검증 가능한 실제 블롭이 저장됩니다.
기본 사이트에서 작업을 실행합니다.
# Uses the first project it finds
bundle exec rake gitlab:seed:geo_uploads
# Or target a specific project (recommended: use a project in a group namespace so
# the namespace_uploads partition is covered)
bundle exec rake "gitlab:seed:geo_uploads[group/project]"
작업은 파티션별 결과와 model_type별 업로드 수 요약을 출력합니다.
이 수는 이번 실행에서 만든 행만이 아니라 기존 데이터를 포함한 파티션의 전체 행 수입니다.
레시피가 레코드를 만들지 않고 오류를 일으키면 파티션이 FAILED로 보고됩니다.
이유는 요약 위의 해당 FAIL 줄에서 확인합니다.
레거시 리플리케이터와 파티션 리플리케이터 간 전환#
레거시 리플리케이터와 파티션 리플리케이터는 상호 배타적입니다.
geo_upload_replication 플래그가 켜져 있는 동안에는 파티션 리플리케이터가 이벤트를
내보내지 않으며, 파티션 레지스트리 일관성 백필도 억제됩니다.
기본 플래그 상태에서는 파티션 리플리케이터가 활성화되어 있습니다. 환경에 이러한 플래그의 저장된 값이 있다면 모든 파티션 플래그를 먼저 켠 다음 레거시 플래그를 끕니다. 레거시 플래그를 끌 때 어떤 플래그가 비활성화되어 있으면 해당 파티션은 복제를 중단합니다.
기본 사이트의 Rails 콘솔에서 다음 명령을 실행합니다.
Gitlab::Geo.blob_replicator_classes.select { |replicator| replicator.model < ::Upload }.each do |replicator|
Feature.enable(replicator.replication_enabled_feature_key)
end
Feature.disable(:geo_upload_replication)
레거시 리플리케이터를 테스트하려면 geo_upload_replication을 켭니다.
기본 사이트에서 검증 확인#
기본 사이트는 각 블롭의 체크섬을 계산하여 파티션
*_upload_states 테이블에 저장합니다.
Geo::VerificationCronWorker는 매분 실행되며, 직접 실행할 수도 있습니다.
Geo::VerificationCronWorker.new.perform
단일 레코드의 체크섬이 올바르게 계산되는지 확인하려면 리플리케이터 하나를 직접 검증합니다.
upload = Upload.where(model_type: 'Project').last
record = Geo::ProjectUpload.find(upload.id)
record.replicator.verify
record = Geo::ProjectUpload.find(upload.id)
record.verification_state # 2 means succeeded
record.verification_checksum # populated when verification succeeds
보조 사이트에서 복제 및 검증 확인#
보조 사이트에서는 복제 이벤트와
Geo::Secondary::RegistryConsistencyWorker 백필로 레지스트리가 생성됩니다.
두 cron 워커 모두 매분 실행되며, 직접 실행할 수도 있습니다.
Geo::Secondary::RegistryConsistencyWorker.new.perform
Geo::VerificationBatchWorker.new.perform_work('project_upload')
Rake 작업으로 전체 상태를 확인합니다.
bundle exec rake gitlab:geo:check_replication_verification_status
단일 파티션 레지스트리를 직접 조사합니다.
Geo::ProjectUploadRegistry.synced.count
Geo::ProjectUploadRegistry.failed.count
더 넓은 관점에서는 Geo 관리 영역에서 데이터 유형별 복제 및 검증 수를 볼 수 있습니다.
레퍼런스 또는 스테이징 환경에서 테스트#
스테이징 같은 레퍼런스 환경은 프로덕션처럼 동작하므로 Rake 작업은 의존성이 없으며 테스트 팩토리를 사용하지 않습니다.
- 시드 작업이 포함된 브랜치를 배포하거나 기존 체크아웃에서 실행합니다.
- 기본 사이트에서 Rails 러너나 콘솔로
gitlab:seed:geo_uploads를 실행합니다. 오브젝트 스토리지가 활성화된 경우 업로드가 오브젝트 스토리지에 저장되는지 확인합니다. - 환경에 기능 플래그의 저장된 값이 있다면 ChatOps로 설정합니다. 예를 들어 각 파티션에
/chatops run feature set geo_project_upload_replication true를 실행한 다음/chatops run feature set geo_upload_replication false를 실행합니다. - cron 워커가 실행될 때까지 기다린 다음
gitlab:geo:check_replication_verification_status와 Geo 관리 영역을 확인합니다.
시딩된 데이터 정리#
작업은 생성하는 리프 레코드의 이름이나 메시지에 geo-seed 접두사를 붙이므로,
테스트 후에 찾아서 제거할 수 있습니다.
프로젝트, 그룹, 사용자처럼 재사용되는 레코드에 설정한 아바타는 행을 추가하지 않고
이전 아바타를 대체합니다.
자동화된 테스트 범위#
리플리케이터별 계약은 공유 예제로 다뤄지므로, 대부분의 정확성 검사에는 실행 중인 보조 사이트가 필요하지 않습니다. 자세한 내용은 Geo 셀프 서비스 프레임워크의 블롭 리플리케이터 전략을 참고합니다.