테스트 시나리오를 구성한 후에는 이를 실행하여 테스트 보고서를 생성할 수 있습니다.적합한 실행 방법 선택#
Apidog는 다양한 테스트 요구 사항에 적합한 여러 테스트 시나리오 실행 방법을 제공합니다.이 방법은 로컬 머신에서 시작되며, 소규모의 빠른 테스트에 적합합니다. 개발과 테스트가 동시에 진행되는 경우 특히 효과적이며, 실시간 모니터링과 즉각적인 조정이 가능합니다.대규모 데이터 또는 반복 시나리오를 처리하는 데 이상적인 이 방법은 더 빠른 실행 속도를 제공합니다. 오프라인 실행이 가능하므로, 리소스가 제한된 환경이나 그래픽 사용자 인터페이스가 필요하지 않은 환경에 적합합니다.이 실행 방식은 CI/CD 파이프라인에 통합되어 자동화된 통합 및 지속적 배포 프로세스에 적합한 옵션입니다. 각 코드 업데이트 후 API의 안정성을 확인하기 위해 테스트가 자주 실행되는 환경에서 특히 유용합니다.팀은 자체 서버에 Apidog Runner를 설정하여 더 강력한 컴퓨팅 리소스를 테스트에 활용할 수 있습니다. 이 방법은 예약 작업을 지원하므로, 정기적인 테스트가 필요한 시나리오나 테스트 요구량이 큰 경우에 이상적입니다.테스트 시나리오에서 환경/전역 변수를 사용하는 경우, 선택한 실행 방법에 따라 이러한 변수의 실제 값이 달라질 수 있으며, 이로 인해 테스트 결과가 일관되지 않을 수 있습니다. 자세히 알아보기. 시작하기#
1
원하는 테스트 시나리오로 이동하고, 요청을 실행할 환경을 선택합니다.
3
현재 실행에 대한 통과율, 실행 시간 및 기타 데이터와 같은 정보를 표시하는 테스트 보고서가 표시됩니다. 각 요청을 펼쳐 유효성 검사 및 어서션을 확인할 수 있습니다.
4
실제 요청 및 응답 세부 정보를 확인하려면 "more"를 클릭합니다.
테스트 시나리오의 실행 옵션#
Apidog에서 테스트 시나리오를 실행할 때, 특정 요구 사항에 맞게 테스트 실행을 조정할 수 있도록 여러 설정과 옵션을 구성할 수 있습니다.아래에서는 이러한 설정의 핵심 측면을 살펴봅니다.시나리오의 요청이 전달될 서비스(기본 URL)와 사용할 변수 세트를 지정합니다. 자세한 내용은 환경 및 서비스를 참조하십시오.사용자 지정 요청은 자체 전체 URL을 가지며, 가져온 단계와 달리 이 컨텍스트에서 설정된 환경으로 전달되지 않습니다.테스트 데이터#
테스트 시나리오는 외부 테스트 데이터 세트 가져오기를 지원합니다. 테스트 시나리오가 실행되면 시스템은 데이터 파일의 모든 데이터 세트를 반복하고 데이터 세트의 데이터를 해당 변수에 할당합니다. 자세한 내용은 데이터 기반 테스트를 참조하십시오.시나리오 내 모든 단계가 루프에서 실행될 횟수를 구성합니다.처리할 데이터가 많은 경우 성능을 최적화하기 위해 Apidog 클라이언트 대신 Apidog CLI를 사용하여 실행하는 것이 좋습니다.스레드#
여러 스레드에서 모든 단계를 실행하며, 스레드 간 데이터는 간섭을 방지하기 위해 격리된 상태로 유지됩니다.이 기능은 Beta 상태이며 추가적인 성능 최적화가 필요할 수 있습니다. 엄격한 부하 테스트의 경우 대신 성능 테스트 기능을 사용하는 것이 좋습니다.
CLI에서는 스레드가 지원되지 않습니다.실행 위치#
테스트 시나리오를 실행하기 위해 실제로 하드웨어 리소스를 소비하는 머신입니다. 테스트 시나리오에서 시작된 모든 요청은 여기에 지정된 머신에서 전송됩니다. 따라서 요청을 보내는 머신의 네트워크 환경 차이로 인해 테스트 결과가 달라질 수 있습니다.이 설정은 테스트 시나리오의 실행 구성 일부로 저장되지 않습니다. 매번 기본적으로 로컬 머신이 테스트 시나리오 실행에 사용됩니다. 또한 이 설정은 일괄 실행 또는 CLI 실행 중에는 적용되지 않습니다. 이러한 경우 요청은 현재 머신의 리소스를 사용하여 시작됩니다.
공유됨#
Advanced Settings 오른쪽에 있는 "Share" 옵션을 활성화하면 각 테스트 시나리오 실행 후 생성된 테스트 보고서가 프로젝트의 다른 멤버와 자동으로 공유됩니다. 팀 내에서 공유된 모든 테스트 보고서는 Test Reports 섹션의 Shared 탭에서 확인할 수 있습니다. 자세한 내용은 테스트 보고서를 참조하십시오.고급 설정#
오류 발생 시#
어서션 실패, 데이터 형식 유효성 검사 실패, 서버 오류 등을 포함할 수 있는 오류를 테스트에서 처리하는 방식을 구성합니다. 옵션은 다음과 같습니다.무시: 오류가 발생하 면 다음 단계를 계속 실행합니다(기본 설정).
계속: 오류가 발생하면 현재 반복을 종료하고 다음 반복을 시작합니다.
실행 종료: 오류가 발생하면 전체 실행을 중지합니다.
요청/응답 저장#
기본적으로 Apidog는 모든 요청과 응답을 저장합니다. 요청 또는 응답이 매우 큰 경우(잠재적으로 수 MB) 상당한 디스크 공간을 차지할 수 있습니다. 이 옵션을 활성화하면 모든 요청과 응답 을 저장하지 않고 어서션 및 유효성 검사 결과만 저장할 수 있습니다.또는 공간을 절약하기 위해 실패한 요청과 응답만 저장하도록 선택할 수 있습니다.변수 값 유지#
이 옵션은 기본적으로 활성화되어 있으며, 테스트 중에 전역 및 환경 변수가 수정되는 경우 현재 값이 마지막으로 수정된 결과를 유지하도록 보장합니다. 이 옵션을 비활성화하면 테스트 실행 후 전역 및 환경 변수는 변경되지 않으며, 실행 전의 값을 유지합니다.로컬 변수는 이 설정의 영향을 받지 않으며 각 실행 후 지워집니다.저장된 쿠키로 실행#
Apidog의 오른쪽 하단에서 Cookies 아이콘을 통해 쿠키 관리로 이동할 수 있습니다. Apidog는 API 요청 시 쿠키를 자동으로 저장합니다. 테스트 시나리오 실행 중 저장된 쿠키를 사용하려면 이 옵션을 활성화하십시오.실행 후 쿠키 저장#
위와 유사하게, 테스트 시나리오 실행 후 저장된 쿠키를 업데이트하려면 이 옵션을 활성화하십시오.Apidog에서 이러한 고급 설정을 구성하면 특정 테스트 요구 사항에 맞게 테스트 실행을 세부적으로 조정하여 효율적이고 정확한 테스트 실행을 보장할 수 있습니다.테스트 시나리오 설계 모드의 런타임 설정#
테스트 시나리오 설계 모드에 있는 경우 관련 런타임 구성은 "Run" 버튼 오른쪽에 접힌 상태로 표시됩니다. 이 설정 버튼 위에 마우스를 올리면 해당 테스트 시나리오의 자세한 런타임 구성을 확인할 수 있습니다.기능 테스트 실행#
기능 테스트를 실행한 후에는 테스트 시나리오 실행 페이지로 이동합니다. 아래 이미지의 원형 차트는 테스트 결과의 개요를 제공하며, 테스트 시나리오가 실행되는 동안 실시간으로 업데이트됩니다. 원형 차트 아래에는 실행 중인 상세 테스트 단계가 표시되며, 실행 중 각 단계의 상태가 표시됩니다.기능 테스트 실행이 완료되면 관련 엔드포인트를 클릭하여 테스트 중 해당 엔드포인트의 메트릭과 상태를 확인할 수 있습니다. 여기에는 엔드포인트 이름, 요청 메서드, 요청 URL, 응답 상태 코드, 응답 시간, 응답 콘텐츠, 데이터 유효성 검사 및 어서션 결과가 포함됩니다. 자세한 내용은 테스트 보고서를 참조하십시오.서로 다른 실행 방법에서 환경/전역 변수를 사용하는 규칙#
환경 변수와 전역 변수는 영구적이므로 여러 실행 또는 서로 다른 테스트 시나리오에서 장기간 사용하도록 저장할 수 있습니다. 그러나 사용되는 실제 변수 값은 선택한 실행 방법에 따라 달라질 수 있습니다. 예를 들면 다음과 같습니다.테스트 시나리오에서 환경 변수 Token을 사용하는 경우, 클라이언트 내에서 실행하면 성공할 수 있지만 셀프 호스팅 Runner를 사용하여 실행하면 Token 값이 올바르지 않아 실패할 수 있습니다.이러한 불일치는 실행 중 환경 변수 Token의 실제 값이 클라이언트 내에 로컬로 저장된 값에서 가져오기 때문에 발생할 수 있습니다. 그러나 셀프 호스팅 Runner에서 실행할 때 Runner에는 동일하게 로컬로 저장된 Token이 없으므로 실패가 발생합니다.이 문제를 해결하기 위해 Apidog는 서로 다른 실행 방법에서 환경/전역 변수 값을 관리하기 위한 일련의 규칙을 제공합니다.| 실행 방법 | 환경/전역 변수 사용 | 변수 저장 위치 |
|---|
| 로컬(클라이언트, 웹) | 실행 시 환경/전역 변수의 현재 값을 사용합니다. | 로컬에 저장됩니다. 수동으로 수정하거나 전/후처리기를 통해 업데이트할 수 있습니다. Environment Management > Environment/Global Variables > Current Values에서 표시됩니다. |
| CLI, CI/CD | 실시간 온라인 실행의 경우:- 실행 시 환경/전역 변수의 초기 값을 사용합니다 (기본값).
- 테스트 시나리오를 실행하는 머신의 파일에 저장된 환경/전역 변수 값을
--variables path 옵션을 통해 사용하도록 지정합니다. 자세히 알아보기.
- 실행 시 내보낸 파일에 포함된 환경/전역 변수 값을 사용합니다.
| - 초기 값은 Apidog Cloud에 저장되며 클라이언트 내에서만 수동으로 수정할 수 있습니다.
--variables path 옵션으로 지정된 파일에 저장되며, 수동 수정 또는 전/후처리기를 통한 업데이트가 가능합니다.- 내보낸 파일에 저장됩니다. 수동으로 수정하거나 전/후처리기를 통해 업데이트할 수 있습니다.
|
| 셀프 호스팅 Runner | - 실행 시 환경/전역 변수의 초기 값을 사용합니다 (기본값).
- 실행 시 Runner 내에 로컬로 저장된 값을 사용합니다. 자세히 알아보기.
| - 초기 값은 Apidog Cloud에 저장되며 클라이언트 내에서만 수동으로 수정할 수 있습니다.
- 지정된 Runner 내에 저장됩니다. 수동으로 수정하거나 전/후처리기를 통해 업데이트할 수 있습니다. 제품 사용자 인터페이스를 통해 표시되거나 Runner 내 파일의
/opt/runner/variables에서 확인할 수 있습니다.
|
다른 프로젝트의 엔드포인트가 포함된 테스트 시나리오 실행#
테스트 시나리오에 다른 프로젝트에서 가져온 엔드포인트가 포함된 경우, 실행 중 이러한 엔드포인트의 요청 URL은 Environment associations에서 설정한 구성에 따라 결정됩니다.현재 프로젝트의 "Develop Env"가 다른 프로젝트의 "Prod Env"와 연결되어 있는 경우, "Develop Env"를 사용하여 테스트 시나리오를 실행하면 가져온 엔드포인트는 "Prod Env"의 URL로 전송됩니다. 다른 모든 엔드포인트는 현재 프로젝트의 "Develop Env" URL을 사용합니다.다양한 테스트 구현#
언급된 단계는 테스트 시나리오의 기본 실행을 나타냅니다. 테스트 시나리오를 설정할 때 다양한 고급 설정을 통합하여 여러 테스트 요구 사항을 충족할 수 있습니다.데이터 기반 테스트: 다양한 데이터 세트를 사용하여 테스트를 수행하고 여러 시나리오에서 시스템 동작을 검증합니다. 성능 테스트: 다양한 부하 조건에서 시스템 성능을 평가하여 확장성과 응답성을 판단합니다. 예약 작업: 테스트 활동의 범위, 접근 방식 및 일정을 자세히 설명하는 구조화된 계획을 수립합니다. CI/CD 통합: 빌드, 테스트 및 배포 프로세스를 자동화하여 안정적이고 빈번한 소프트웨어 릴리스를 보장합니다. 
