Apidog Docs
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 테스트 스위트
  • Apidog 학습 센터
  • 시작하기
    • Apidog 소개
    • Apidog의 기본 개념
    • Apidog 탐색하기
    • 빠른 시작
      • 개요
      • 엔드포인트 생성하기
      • 요청 만들기
      • 어서션 추가하기
      • 테스트 시나리오 생성
      • API 문서 공유
      • 더 알아보기
    • Apidog로 마이그레이션
      • 개요
      • 수동 가져오기
      • 예약 가져오기(데이터 소스 바인딩)
      • 가져오기 옵션
      • 데이터 내보내기
      • 가져오기
        • Postman에서 가져오기
        • OpenAPI Spec 가져오기
        • cURL 가져오기
        • Markdown 가져오기
        • Insomnia에서 가져오기
        • apiDoc에서 가져오기
        • .har 파일 가져오기
        • WSDL 가져오기
  • Mock API 데이터
    • 개요
    • 스마트 목
    • 사용자 지정 목
    • 목 우선순위 순서
    • 목 스크립트
    • 클라우드 목
    • Self-Hosted Runner Mock
    • 목 언어(로케일)
  • 계정 및 환경설정
    • 계정 설정
    • OpenAPI 액세스 토큰 생성
    • 알림
    • 언어 설정
    • 단축키
    • 네트워크 프록시 구성
    • 데이터 백업
    • Apidog 업데이트
    • 계정 삭제
    • 실험적 기능
  • 요청 보내기
    • 개요
    • SSE 디버깅
    • MCP 클라이언트
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 또는 WebService
    • GraphQL
    • gRPC
    • 디버깅에 요청 프록시 에이전트 사용
    • 요청 만들기
      • 요청 기록
      • 요청 기본 사항
      • 매개변수 및 본문
      • 요청 헤더
      • 요청 설정
      • 요청 디버그
      • 요청을 엔드포인트로 저장하기
      • HTTP/2
    • 인증 및 권한 부여
      • 개요
      • CA 및 클라이언트 인증서
      • 인증 유형
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 인증
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 응답 및 쿠키
      • API 응답 보기
      • 쿠키 관리
      • 개요
  • API 개발 및 디버깅
    • 개요
    • 요청 생성
    • 요청 보내기
    • 디버깅 케이스
    • 테스트 케이스
    • 동적 값
    • 응답 검증
    • 디자인 우선 vs 요청 우선
    • 코드 생성
    • 환경 및 변수
      • 개요
      • 변수 사용하기
      • 환경 관리
    • Vault 시크릿
      • 개요
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 동적 값 모듈
      • Airline
      • 동물
      • 색상
      • Commerce
      • Company
      • 데이터베이스
      • Datatype
      • 날짜
      • 금융
      • Food
      • Git
      • Hacker
      • Helpers
      • Image
      • Internet
      • Location
      • Lorem
      • 음악
      • Number
      • Person
      • Phone
      • 과학
      • String
      • System
      • Vehicle
      • Word
    • 사전/사후 프로세서
      • 개요
      • 어서션
      • 변수 추출
      • Wait
      • 보안
      • 데이터베이스 작업
        • 개요
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 스크립트 사용
        • 개요
        • 전처리 스크립트
        • 사후 처리 스크립트
        • Public Scripts
        • Postman 스크립트 참조
        • 다른 프로그래밍 언어 호출하기
        • JS 라이브러리 사용하기
        • 응답 시각화
        • 스크립트 예제
          • 어서션 스크립트
          • 변수 사용하기
          • 요청 수정하기
          • 기타 예시
    • API 디버깅
      • AI Agent Debugger
      • A2A Debugger
  • API 설계
    • 개요
    • 새 API 프로젝트 생성
    • 엔드포인트 기본 사항
    • API 설계 지침
    • 모듈
    • 여러 요청 본문 예시 구성
    • 컴포넌트
    • 공통 필드
    • 전역 매개변수
    • 엔드포인트 변경 이력
    • 댓글
    • 엔드포인트 일괄 관리
    • 사용자 지정 프로토콜 API
    • Spec-first 모드(Beta)
    • 보안 스키마
      • 개요
      • 보안 스키마 생성
      • 보안 스키마 사용
      • 온라인 문서의 보안 스키마
    • 고급 기능
      • 사용자 지정 엔드포인트 필드
      • 연결된 테스트 시나리오
      • 엔드포인트 상태
      • 매개변수 목록의 표시 방식
      • 엔드포인트 고유 식별
    • 스키마
      • 개요
      • 새 스키마 생성
      • 스키마 구축
      • JSON 등에서 스키마 생성
      • oneOf, allOf, anyOf
      • Discriminator 사용하기
  • API 테스트
    • 개요
    • 테스트 시나리오
      • 테스트 시나리오 생성
      • 요청 간 데이터 전달
      • 흐름 제어 조건
      • 엔드포인트 및 엔드포인트 케이스에서 데이터 동기화
      • 다른 프로젝트에서 엔드포인트 및 엔드포인트 케이스 가져오기
      • 테스트 시나리오 내보내기
    • 테스트 보고서
      • 테스트 보고서
    • 테스트 시나리오 실행
      • 테스트 시나리오 실행
      • 테스트 시나리오 일괄 실행
      • 데이터 기반 테스트
      • 공유 테스트 데이터
      • 예약 작업
      • 다른 프로젝트의 API 런타임 환경 관리
    • 테스트 스위트
      • 개요
      • 테스트 스위트 생성
      • 테스트 스위트 오케스트레이션
      • 로컬에서 테스트 스위트 실행
      • CLI를 통해 테스트 스위트 실행
      • 예약 작업
    • API 테스트
      • 통합 테스트
      • 성능 테스트
      • 엔드투엔드 테스트
      • 회귀 테스트
      • 계약 테스트
    • Apidog CLI
      • 개요
      • Apidog CLI 설치 및 실행
      • Apidog CLI 옵션
    • CI/CD
      • 개요
      • Github Actions와 통합
      • Gitlab과 통합
      • Jenkins와 통합하기
      • Git 커밋으로 테스트 트리거하기
  • API 문서 게시
    • 개요
    • 지원되는 API 기술
    • Quick Share
    • API 문서 보기
    • Markdown 문서
    • 문서 사이트 게시
    • 사용자 지정 로그인 페이지
    • 사용자 지정 레이아웃
    • 사용자 지정 CSS, JavaScript, HTML
    • 사용자 지정 도메인
    • AI 기능
    • SEO 설정
    • 고급 설정
      • 문서 검색
      • CORS 프록시
      • Google Analytics 통합
      • 폴더 트리 설정
      • 가시성 설정
      • 문서 URL에 값 임베드하기
    • API 버전
      • 개요
      • API 버전 생성
      • API 버전 게시
      • API 버전별 엔드포인트 공유
  • 브랜치
    • 개요
    • 스프린트 브랜치 생성
    • 브랜치에서 API 테스트하기
    • 브랜치에서 API 설계하기
    • 스프린트 브랜치 병합
    • 스프린트 브랜치 관리
    • AI Branch(베타)
  • AI 기능
    • 개요
    • AI 기능 활성화
    • 테스트 케이스 생성
    • AI로 스키마 수정하기
    • 엔드포인트 규정 준수 검사
    • API 문서 완성도 검사
    • AI 기반 필드 명명
    • 자주 묻는 질문
  • Apidog MCP 서버
    • 개요
    • AI에 Apidog 프로젝트 연결
    • 게시된 문서를 AI에 연결하기
    • OpenAPI 파일을 AI에 연결하기
  • 모범 사례
    • API 서명 처리
    • OAuth 2.0으로 보호되는 API에 접근하기
    • 협업 워크플로
    • 인증 상태 관리
  • 오프라인 공간
    • 개요
  • Apidog Europe
    • Apidog Europe
  • 관리
    • 프로젝트 관리
      • 프로젝트 관리
      • 알림 설정
      • 프로젝트 멤버 관리
      • 프로젝트 리소스
        • 데이터베이스 연결
        • Git 연결
    • 팀 관리
      • 팀 관리
      • 팀 멤버 관리
      • 팀 활동
      • 팀 역할 및 권한
      • 팀 리소스
        • General Runner
        • 팀 변수
        • 요청 프록시 에이전트
      • 실시간 협업
        • 팀 협업
    • 온보딩 체크리스트
      • 기본 개념
      • 온보딩 가이드
    • 조직 관리
      • 조직 관리
      • 조직 역할 및 권한
      • 플랜 관리
        • 조직의 청구 관리자
      • Single Sign-On (SSO)
        • SSO 개요
        • Microsoft Entra ID 구성
        • Okta 구성하기
        • 조직에 대한 SSO 구성
        • 사용자 계정 관리
        • 그룹을 팀에 매핑하기
      • SCIM 프로비저닝
        • SCIM 프로비저닝 소개
        • Microsoft Entra ID
        • Okta
      • 조직 리소스
        • 셀프 호스팅 Runner
  • 청구
    • 개요
    • 크레딧
    • 플랜 업그레이드
    • 대체 결제 방법
    • 구독 관리
    • 유료 팀을 조직으로 이동하기
  • 애드온
    • API Hub
    • Apidog Intellij IDEA 플러그인
    • 브라우저 확장 프로그램
      • Chrome
      • Microsoft Edge
    • 요청 프록시
      • 웹에서의 요청 프록시
      • 공유 문서의 요청 프록시
      • 클라이언트의 요청 프록시
  • 데이터 및 보안
    • 데이터 저장 및 보안
    • 사용자 데이터 개인정보 보호 및 보안
    • 요청 라우팅 및 데이터 보안
  • 참조
    • API 설계 우선 접근 방식
    • Apidog OpenAPI 사양 확장
    • JSONPath
    • XPath
    • 정규 표현식
    • JSON Schema
    • CSV 파일 형식
    • Java 환경 설치
    • Runner 배포 환경
    • Apidog Markdown 구문
    • Apidog Swagger 확장
      • 개요
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 확장
      • 개요
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 지원 센터
  1. 테스트 스위트

로컬에서 테스트 스위트 실행

적합한 실행 방법 선택#

Apidog는 다양한 테스트 요구 사항에 적합한 여러 가지 테스트 스위트 실행 방법을 제공합니다.
1.
로컬 시각적 실행:
이 방법은 로컬 머신에서 시작되며, 소규모의 빠른 테스트에 적합합니다.
개발과 테스트가 동시에 이루어지는 경우 특히 효과적이며, 실시간 모니터링과 즉각적인 조정이 가능합니다.
2.
로컬 Apidog CLI 실행:
대규모 데이터 또는 반복적 시나리오를 처리하는 데 이상적이며, 이 방법은 향상된 실행 속도를 제공합니다.
오프라인 실행이 가능하므로, 리소스가 제한된 환경이나 그래픽 사용자 인터페이스가 필요하지 않은 환경에 적합합니다.
3.
CI/CD 실행:
이 실행 방식은 CI/CD 파이프라인 내에 통합되며, 자동화된 통합 및 지속적 배포 프로세스에 매우 적합한 옵션입니다.
각 코드 업데이트 후 API의 안정성을 확인하기 위해 테스트를 자주 실행하는 환경에서 특히 유용합니다.
4.
셀프 호스팅 Runner 실행:
팀은 자체 서버에 Apidog Runner를 설정하여 더 강력한 컴퓨팅 리소스를 테스트에 활용할 수 있습니다.
이 방법은 예약 작업을 지원하므로, 정기적인 테스트가 필요하거나 테스트 요구 사항이 많은 시나리오에 이상적입니다.
TIP
테스트 스위트에서 환경/전역 변수를 사용하는 경우, 선택한 실행 방법에 따라 이러한 변수의 실제 값이 달라질 수 있으며, 이로 인해 테스트 결과가 일관되지 않을 수 있습니다. 자세히 알아보기.

테스트 스위트의 실행 구성#

Apidog에서 테스트 스위트를 실행할 때, 특정 요구 사항에 따라 테스트를 실행하도록 여러 설정과 옵션을 구성할 수 있습니다.
image.png

일반 구성#

테스트 스위트 오른쪽의 실행 구성에서 다음 설정을 조정할 수 있습니다.
환경
시나리오의 요청이 전달되어야 하는 서비스(base URL)와 사용할 변수 세트를 지정합니다. 자세한 내용은 환경 관리를 참조하십시오.
실행 모드
테스트 스위트는 두 가지 실행 모드를 지원합니다.
직렬: 테스트 시나리오를 순서대로 하나씩 실행합니다. 의존성이 있는 시나리오 또는 리소스가 제한된 환경에 적합합니다.
병렬: 여러 테스트 시나리오를 동시에 실행합니다. 시스템은 사용 가능한 머신 리소스를 기반으로 최적의 동시성을 자동으로 결정합니다. 대규모 회귀 테스트에 적합하며 실행 시간을 크게 단축할 수 있습니다.
실행 위치
테스트 스위트를 실행하기 위해 실제로 하드웨어 리소스를 소비하는 머신입니다. 테스트 스위트에서 시작되는 모든 요청은 여기에서 지정한 머신에서 전송됩니다. 따라서 요청 머신의 네트워크 환경 차이로 인해 테스트 결과가 달라질 수 있습니다.
이 설정은 테스트 스위트의 실행 구성 일부로 저장되지 않습니다. 매번 기본적으로 로컬 머신이 테스트 스위트 실행에 사용됩니다. 또한 이 설정은 일괄 실행 또는 CLI 실행 중에는 적용되지 않습니다. 이러한 경우 요청은 현재 머신의 리소스를 사용하여 시작됩니다.
테스트 스위트를 실행할 머신을 지정할 때, 테스트 스위트에 파일(예: 파일 전송, 데이터베이스 연결, 외부 프로그램, SSL 인증서 등)이 포함되어 있는 경우 정상적으로 작동하려면 필요한 모든 파일이 지정된 머신의 로컬에 저장되어 있어야 합니다.
알림
이 기능을 활성화하면 수동 테스트 스위트가 완료된 후 지정된 수신자에게 알림이 전송됩니다. 알림에는 테스트 결과 개요와 상세 보고서 링크가 포함됩니다. 불필요한 알림을 최소화할 수 있도록, 테스트가 완료되는 즉시 알림을 보낼지 또는 실패가 발생한 경우에만 보낼지 구성할 수 있습니다. 더 자세한 정보는 알림 설정을 참조하십시오.

병렬 실행#

테스트 스위트의 시나리오 수가 수백 개로 증가하면 직렬 실행이 병목 현상이 됩니다. 한 시간이 걸리는 전체 회귀 테스트는 릴리스를 지연시키고 인시던트 감지를 늦출 수 있습니다.
실행 모드를 "병렬"로 전환하면 시스템이 여러 시나리오를 동시에 실행할 수 있습니다. 동시성은 머신 리소스를 기반으로 자동 관리됩니다. 원래 60분이 걸리던 테스트를 테스트 로직을 수정하지 않고도 30분 미만으로 단축할 수 있습니다.
test-suite-parallel-run.gif

의존성 격리#

병렬 실행 중에는 각 테스트 시나리오가 독립적인 컨텍스트에서 실행되어 다음을 보장합니다.
한 시나리오의 공유 변수가 다른 시나리오에 영향을 주지 않습니다.
환경 상태가 시나리오 간에 간섭하지 않습니다.
시나리오 간에 실제 의존성이 있는 경우(예: 시나리오 B가 시나리오 A에서 생성한 데이터를 필요로 하는 경우), 이를 단일 테스트 시나리오로 병합하고 순차적 단계를 사용하여 실행 순서를 구성하는 것이 좋습니다.
Modified at 2026-06-09 08:53:32
Previous
테스트 스위트 오케스트레이션
Next
CLI를 통해 테스트 스위트 실행
Built with