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. 테스트 스위트

CLI를 통해 테스트 스위트 실행

적합한 실행 방법 선택#

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

Apidog CLI 실행#

Apidog CLI를 사용하여 테스트 스위트를 실행하려면 먼저 테스트 스위트를 생성하고 구성해야 합니다. 그런 다음 Apidog CLI를 사용하여 명령줄에서 테스트 스위트를 실행하고 테스트 결과 및 테스트 보고서를 확인할 수 있습니다.
1
테스트 스위트에서 CI/CD 탭으로 전환하십시오.
2
실행 환경 및 알림 방법과 같은 매개변수를 구성하십시오. 인터페이스의 각 구성은 아래에 생성되는 CLI 명령에 실시간으로 반영됩니다.
3
CI/CD 제공자 섹션에서 CLI 명령줄 또는 다른 플랫폼을 선택하십시오.
4
CLI 호출 인증을 위해 "Add access token" 버튼을 클릭한 다음 "Generate token"을 클릭하십시오. 자세히 알아보기.
5
명령을 클릭하여 복사한 뒤 명령줄에 붙여넣고 실행하면 테스트 실행 과정과 테스트 보고서를 확인할 수 있습니다.
CleanShot 2026-01-13 at 15.48.13@2x.png
참고: 명령을 성공적으로 실행하려면 먼저 Apidog CLI를 설치해야 합니다. 이미 설치되어 있는 경우 최신 버전으로 업데이트해야 합니다.

변수 및 로컬 구성 파일 정보(선택 사항)#

일부 시나리오에서는 CLI 실행에 로컬 구성 파일이 필요합니다.
환경 / 전역 변수
"Export current values for use"를 선택하는 경우, 내보낸 변수 파일을 CLI 실행 머신에 배치하고 --variables <path>를 통해 파일 경로를 지정해야 합니다.
"Use initial Values"와 "Export current values for use"의 차이점은 다음을 참조하십시오. 서로 다른 실행 방법에서 환경/전역 변수를 사용하는 규칙.
데이터베이스 연결
테스트에서 로컬에 저장된 "database connections"를 사용하는 경우, 인터페이스가 구성 파일을 내보내고 CLI에서 --database-connection <path>를 통해 사용하도록 안내합니다.
"database connection" 세부 정보를 변수 형태로 저장하는 것을 권장합니다. 이렇게 하면 CLI 실행 시 추가적인 --database-connection <path>가 필요하지 않으며, 협업과 유지 관리에도 더 편리합니다. 자세히 알아보기.

CLI 테스트 보고서#

CLI를 실행한 후에는 테스트 스위트의 실행 통계와 실패한 요청에 대한 검증 및 어서션 정보를 포함하는 명령줄 테스트 보고서를 받을 수 있습니다.
CleanShot 2026-01-13 at 15.52.03@2x.png
CLI가 실행된 폴더에서는 HTML 형식의 CLI 테스트 보고서가 포함된 /apidog-reports/ 폴더도 확인할 수 있습니다.

명령 옵션#

Apidog CLI는 테스트 스위트 실행을 사용자 지정할 수 있는 풍부한 구성 옵션을 제공합니다. 자세한 내용은 CLI 명령 옵션을 참조하십시오.

CI/CD에서 Apidog CLI 사용#

Apidog CLI는 Jenkins, GitLab, GitHub Actions 등 다양한 파이프라인 도구와의 통합을 지원합니다. 자세히 알아보려면 CI/CD 통합을 참조하십시오.
Modified at 2026-06-09 08:53:32
Previous
로컬에서 테스트 스위트 실행
Next
예약 작업
Built with