아피독 CLI 대 인소 (인썸니아 CLI): CI를 위한 최고의 API 테스트 러너는?

파이프라인을 위한 CLI 테스트 러너를 선택하는 것은 간단한 질문으로 귀결됩니다. 개발 단계에서 API를 이미 실행하는 도구는 무엇이며, CI에서 무엇을 자동화해야 하는가? 팀이 Insomnia를 주로 사용한다면 inso가 명확한 동반자입니다. 설계, 목업, 문서화, 테스트를 모두 지원하는 하나의 플랫폼을 원한다면 Apidog CLI는 상황을 바꿉니다.

각 도구는 무엇인가

inso는 Kong의 오픈 소스 API 클라이언트인 Insomnia의 명령줄 동반 도구입니다. 이 도구는 터미널과 CI에 세 가지 기능을 제공합니다: 요청 컬렉션 실행, 단위 테스트 스위트 실행, OpenAPI 사양 린팅. Insomnia 데스크톱 앱이 사용하는 것과 동일한 데이터에서 읽어오므로, GUI에서 요청을 빌드하면 inso가 헤드리스로 실행합니다.

Apidog CLI는 하나의 작업 공간에서 설계, 디버깅, 목업, 문서화 및 테스트를 모두 다루는 올인원 API 플랫폼인 Apidog의 터미널 러너입니다. 이 CLI는 프로젝트에서 테스트 시나리오와 컬렉션을 실행하고, 데이터 기반 실행을 지원하며, 여러 형식으로 보고서를 출력합니다. 또한 OpenAPI를 가져올 수 있고 엔드포인트, 스키마, 브랜치와 같은 API 리소스를 코드로 관리할 수 있습니다.

핵심적인 차이점은 단일 테스트를 실행하기도 전에 나타납니다. inso는 Insomnia 생태계를 위한 집중적인 러너이자 린터입니다. Apidog CLI는 더 넓은 플랫폼의 테스트 표면입니다.

Apidog CLI vs inso: 비교 표

이 표는 요약 버전입니다. 아래 섹션에서는 둘 중 하나를 CI에 연결할 때 실제로 중요한 차이점을 설명합니다.

설치: brew 및 Docker 대 Apidog 설치 프로그램

inso는 여러 공식 채널을 통해 배포됩니다. 일반적인 방법은 다음과 같습니다:

# Homebrew
brew install inso

# Docker
docker pull kong/inso:latest

Windows, Linux 및 macOS용 직접 다운로드도 있습니다. 과거에는 inso가 npm에 `insomnia-inso`로 있었지만, 오늘날 Kong이 문서화하는 경로는 Homebrew, Docker 및 직접 다운로드입니다. Docker 이미지는 Node 툴체인을 관리하고 싶지 않은 CI 러너에게 유용합니다.

Apidog CLI는 Apidog 다운로드 페이지에서 설치되며 Apidog 프로젝트에 있는 시나리오를 실행합니다. 테스트가 프로젝트에 연결되어 있기 때문에, CLI는 수동으로 동기화해야 하는 로컬 폴더를 읽는 대신 최신 정의를 가져옵니다. 전체 가이드를 원하시면 Apidog CLI 설치 가이드와 완전한 CLI 가이드에서 설정의 모든 과정을 다룹니다.

각 도구가 무엇을 실행하고 어디에서 읽어오는지

이것이 **Apidog CLI 대 Insomnia CLI** 결정에서 가장 큰 실질적인 차이점입니다.

inso는 스위트와 사양을 **이름으로** 참조합니다. 표시 이름으로 디자인 문서나 컬렉션을 지정하면, 작업 디렉토리의 `.insomnia` 디렉토리(Insomnia의 Git 동기화로 생성됨) 또는 앱이 설치된 경우 Insomnia 앱의 데이터 디렉토리에서 정의를 찾습니다. `--workingDir` 또는 `--src`로 위치를 재정의할 수 있습니다.

inso run test "Smoke Suite" --env "CI"
inso run collection "User API" --env "Staging"
inso script seed-data --env env_staging

이름 기반 모델은 팀이 `.insomnia` 폴더를 커밋하고 이를 진실의 원천으로 간주한다면 깔끔합니다. 이는 CI 체크아웃에 해당 폴더가 있어야 하며, 이름은 안정적으로 유지되어야 한다는 것을 의미합니다.

Apidog CLI는 Apidog 프로젝트에 있는 **테스트 시나리오**를 실행합니다. 로그인 또는 액세스 토큰으로 인증한 다음, 선택한 환경에 대해 시나리오 또는 컬렉션을 실행합니다. 정의는 프로젝트에서 가져오므로, 팀이 GUI에서 구축한 동일한 시나리오가 CI에서 실행되며, 커밋하고 정렬할 폴더가 없습니다.

apidog run -t <scenario-or-collection> -e <environment>

어떤 모델도 틀리지 않습니다. inso는 Git에 커밋된 로컬 폴더를 선호합니다. Apidog는 동기화된 기록 프로젝트를 선호합니다. 팀이 이미 API 정의를 공유하는 방식에 맞는 것을 선택하세요.

데이터 기반 테스트

여러 입력 행에 대해 동일한 시나리오를 실행해야 하는 경우, 이것이 중요합니다.

Apidog CLI는 CSV 또는 JSON 데이터셋을 가리키는 `-d` 옵션을 사용하여 데이터 기반 테스트를 직접 지원합니다. 각 행은 고유한 변수를 가진 반복이 되므로, 하나의 시나리오로 수십 가지 케이스를 다룰 수 있습니다.

apidog run -t "Checkout Flow" -e "Staging" -d ./datasets/orders.csv

변수가 열에 매핑되는 방법을 포함한 전체 패턴은 Apidog CLI를 사용한 데이터 기반 테스트에서 확인할 수 있습니다.

inso는 실행 명령에서 데이터 기반 플래그를 노출하지 않습니다. 환경을 통해 파라미터화할 수 있고, CI 작업에서 inso를 중심으로 스크립팅하여 반복을 구동할 수 있지만, 행별 CSV/JSON 반복은 Apidog에서처럼 일급 CLI 기능이 아닙니다. 데이터셋에 대한 반복이 스위트의 핵심이라면, 이는 고려해야 할 중요한 차이입니다.

리포터: 얻을 수 있는 결과

보고서는 CI가 어떤 일이 일어났는지 알려주는 방식입니다. 두 도구 모두 어설션 실패 시 빌드를 실패시키지만, 출력 형식이 다릅니다.

Apidog CLI는 **CLI**, **HTML**, **JSON** 형식으로 보고서를 생성합니다. CLI 형식은 빠른 로그 스캔에 좋고, HTML은 공유 가능한 아티팩트를 제공하며, JSON은 대시보드나 다운스트림 도구에 데이터를 제공합니다. 또한 `--upload-report`를 사용하여 결과를 클라우드로 푸시하여 호스팅되고 링크 가능한 보고서를 얻을 수 있습니다. Apidog CLI 테스트 보고서 가이드는 각 형식을 설명합니다.

inso는 테스트 결과를 콘솔에 출력하고 종료 코드를 통해 통과/실패를 알립니다. 이는 대부분의 CI 시스템이 중요하게 여기는 부분입니다. 이는 핵심적인 요구 사항을 충족합니다. 추가 도구 없이 풍부한 HTML 아티팩트 또는 호스팅된 보고서를 원한다면, Apidog가 더 많은 것을 제공합니다.

린팅: 솔직한 비교

이것은 inso가 진정한 강점을 가진 부분이며, 그렇지 않은 척하는 것은 옳지 않습니다.

inso는 `inso lint spec`으로 OpenAPI 사양을 린팅하며, 내부 린터는 Stoplight의 잘 알려진 OpenAPI 린터인 Spectral입니다. 이는 테스트를 실행하는 동일한 CLI에서 스타일 가이드를 강제하고, 계약 문제를 발견하고, 사양 품질에 따라 병합을 제한할 수 있음을 의미합니다.

inso lint spec "Payments API"
inso export spec "Payments API" --output openapi.yaml

사양 우선 설계를 실천하고 CI에서 린트 규칙을 강제하고 싶은 팀에게 이것은 inso를 선택할 강력하고 실제적인 이유입니다.

이제 Apidog의 솔직한 대조군입니다. **Apidog CLI에는 독립형 OpenAPI 린터, 스타일 가이드, 분할, 병합 또는 번들 명령이 없습니다.** Apidog는 사양을 가져올 때 유효성을 검사하여 구조적 문제를 포착하지만, 이는 가져올 때의 유효성 검사이지, CI에서 스타일 가이드에 대해 실행하는 `lint` 명령이 아닙니다. Apidog CLI가 Spectral을 대체할 것이라고 기대하지 마세요. 파이프라인에서 계약 린팅이 필수 요구 사항이고 별도의 Spectral 단계가 없다면, inso는 이를 다루지만 Apidog는 그렇지 않습니다.

대신 Apidog가 그 자리를 차지하는 곳은 통합 및 리소스 관리이며, 이는 다음 섹션입니다.

코드로 리소스 및 브랜치 관리

Apidog CLI는 inso가 할 수 없는 일을 할 수 있습니다: API 리소스를 코드로 관리하는 것입니다. 터미널에서 OpenAPI를 가져와 엔드포인트, 스키마, 환경, 브랜치 및 병합 요청을 작업할 수 있습니다. 이를 통해 API 설계 변경 사항을 스크립팅하고 테스트를 실행하는 동일한 자동화에 연결할 수 있습니다.

inso는 러너이자 린터로서 제 역할을 합니다. 사양을 내보낼 수 있지만, 엔드포인트를 편집하거나 브랜치를 관리하기 위한 리소스 관리 CLI는 아닙니다.

API 정의와 테스트 실행이 동일한 CLI에 의해 관리되기를 원하는 팀에게 Apidog의 코드로 리소스 관리 기능은 의미 있는 이점입니다. 이는 **inso 대 Apidog** 선택이 러너 질문이라기보다는 플랫폼 질문으로 바뀌는 이유의 일부입니다.

플랫폼 통합, 오픈 소스 및 가격

inso는 오픈 소스 생태계의 일부입니다. Insomnia 자체는 오픈 소스이며, 이는 도구를 검사하거나 자체 호스팅하려는 팀에게 매력적입니다. 계획을 위해 솔직히 언급할 가치가 있습니다: 2023년 Insomnia 8은 반발을 불러일으킨 필수 클라우드/로그인 계정을 도입했으며, 그 시기에 마이그레이션 및 데이터 손실 사고가 있었습니다. 팀이 그러한 사건들을 고려한다면, Insomnia 데이터 손실 복구 및 마이그레이션과 Insomnia 데이터 복구 및 내보내기 방법에 대한 우리의 글에서 세부 사항을 다룹니다. 이 모든 것이 CLI인 inso가 Spectral 린팅이 내장된 견고하고 무료 러너라는 사실을 바꾸지는 않습니다.

Apidog는 무료 등급이 있는 상용 플랫폼입니다. 핵심은 통합입니다: 한 곳에서 설계, 목업, 문서화, 디버깅 및 테스트를 수행하며, CLI는 해당 작업 공간의 자동화 표면입니다. 별도의 디자인 도구, 목업 서버 및 러너를 함께 엮을 필요가 없습니다. 더 넓은 제품 관점을 원하시면 Apidog 대 Insomnia 및 Insomnia 대 Apidog를 참조하세요. 먼저 실제 API에 대해 러너를 사용해 보고 싶다면, Insomnia를 사용하여 API 테스트 방법 및 명령줄에서 REST API 테스트 가이드가 좋은 시작점입니다.

CI 연결, 간략하게

두 도구 모두 동일한 방식으로 파이프라인에 통합됩니다: 설치, 데이터 인증 또는 지정, 실행, 그리고 종료 코드를 통해 빌드를 제어합니다.

# CI에서의 inso
- run: brew install inso
- run: inso run test "Smoke Suite" --env "CI"

# CI에서의 Apidog CLI
- run: apidog run -t "Smoke Suite" -e "CI" -r html,json

이를 구축한다면, Apidog CLI CI/CD 파이프라인 가이드와 GitHub Actions 가이드에서 인증, 캐싱 및 보고서 업로드를 다룹니다. 러너에 대한 인증 세부 정보는 Apidog CLI 인증 가이드에 있습니다.

결론

단일한 승자는 없습니다. 솔직한 판단은 팀의 작업 방식에 따라 달라집니다.

이미 Insomnia를 주로 사용하고, `.insomnia` 폴더를 커밋하며, 테스트를 실행하는 동일한 도구에서 CI에 Spectral 사양 린팅을 강제하고 싶다면 **inso**를 선택하세요. 오픈 소스 생태계와 내장된 린터는 진정한 강점이며, 무료의 이름 참조 러너는 Insomnia 우선 팀에 깔끔하게 적합합니다.

설계, 목업, 문서화 및 테스트를 위한 하나의 플랫폼을 원하고, `-d`를 통한 데이터 기반 실행, 더 풍부한 리포터 (CLI, HTML, JSON, 호스팅 보고서 포함), 코드로 리소스 및 브랜치 관리를 원한다면 **Apidog CLI**를 선택하세요. 독립형 CLI 린터를 포기하지만, 설계한 것이 곧 테스트하는 것이 되는 통합된 워크플로를 얻게 됩니다. 기존 설정을 마이그레이션하는 것은 간단합니다. inso (Insomnia CLI)에서 Apidog CLI로 마이그레이션을 참조하세요.

직접 비교할 준비가 되셨나요? Apidog를 다운로드하고 자체 API에 대해 시나리오를 실행해보세요.