RSpec 테스트 시간 제한 및 관리 gem 'RspecTimeGuard' 소개

핵심 기술

이 글은 Ruby의 RSpec 테스트 프레임워크에서 발생하는 예측 불가능한 테스트 시간 초과 문제를 해결하기 위해 개발된 RspecTimeGuard라는 새로운 gem을 소개합니다. 이 gem은 개별 RSpec 테스트 또는 전체 테스트 스위트에 시간 제한을 설정하여 CI/CD 환경에서의 리소스 낭비와 피드백 지연을 방지하는 것을 목표로 합니다.

기술적 세부사항

• 문제 정의: CI 환경에서 Capybara와 같은 브라우저 기반 테스트가 응답하지 않거나 특정 조건에 영원히 대기하는 경우, 예측 불가능한 시간 초과로 인해 CI 빌드가 실패하고 리소스 낭비 및 비용 증가를 초래합니다.
• 초기 접근 방식: Ruby의 Thread#join 메소드를 사용하여 테스트를 별도의 스레드에서 실행하고, 메인 스레드에서 일정 시간 동안 스레드의 완료를 기다립니다. 시간 초과 시 스레드를 kill하여 테스트를 종료합니다.
• 개선된 구현: thread.kill 시 발생하는 불필요한 에러 메시지 출력을 막기 위해 Thread.current.report_on_exception = false 설정을 적용합니다.
• 정교한 스레드 관리: thread.kill 대신 thread.exit를 사용하여 스레드 종료를 보다 협조적으로 처리하고, 예외 발생 시 이를 스레드 로컬 변수에 저장하여 메인 스레드로 안전하게 전달하는 방식을 사용합니다. 예외가 발생하는 경우, RspecTimeGuard.terminate_thread 함수를 통해 스레드를 안전하게 종료합니다.
• 전역 설정 지원: RspecTimeGuard.configuration.max_execution_time을 통해 테스트 스위트 전체에 적용할 수 있는 전역 시간 제한 설정을 구현했습니다.
• RSpec.current_example 문제: 전역 설정 사용 시 일부 테스트에서 RSpec.current_example이 nil이 되는 문제를 발견했으며, 이는 테스트 자체에서 RSpec.current_example.metadata에 접근하기 때문입니다. 이 문제는 gem 자체의 로직보다는 테스트 코드와의 상호작용에서 발생하는 것으로 보입니다.

개발 임팩트

• CI/CD 파이프라인의 안정성 및 예측 가능성 향상
• 테스트 실행 시간 단축을 통한 개발 피드백 루프 개선
• CI/CD 리소스 사용 최적화를 통한 비용 절감
• 테스트 스위트의 전반적인 효율성 및 품질 향상

커뮤니티 반응

• 글 작성자는 첫 gem 출시이며, GitHub 저장소에 대한 'star' 참여를 독려하고 있습니다.