수년 동안 데스크톱 앱 외부에서 Postman 컬렉션을 실행하는 것은 Newman이라는 단 하나의 도구를 의미했습니다. 그 후 Postman은 자체 공식 명령줄 도구인 Postman CLI를 출시했고, 이제 거의 동일한 작업을 수행하는 두 가지 방법이 생겼습니다. 둘 다 GUI 없이 컬렉션을 실행하고, 둘 다 CI/CD 파이프라인에 적합하며, 둘 다 동일한 테스트 스크립트를 실행합니다. 그렇다면 왜 두 개의 도구가 존재하며, 어떤 것이 여러분의 파이프라인에 적합할까요?
간단히 말해, Newman은 초기부터 커뮤니티 표준이었던 오픈소스이자 계정 없이 사용할 수 있는 러너입니다. Postman CLI는 최신이며 계정과 연결되어 실행 결과를 Postman 클라우드에 연결하고 보고하는 도구입니다. 올바른 선택은 Postman 플랫폼에 결과가 저장되기를 원하는지 아니면 컬렉션 파일 외에 아무것도 필요 없는 러너를 선호하는지에 따라 달라집니다. 이 글은 여러분이 결정할 수 있도록 이들을 솔직하게 비교합니다.
Newman이란?
Newman은 Postman의 오리지널 명령줄 컬렉션 러너입니다. 오픈소스이며 npm 패키지로 배포되며 완전히 무료입니다. Postman에서 내보낸 컬렉션 파일을 실행하고, 모든 요청과 모든 pm.test 어설션을 실행하며, 종료 코드를 통해 결과를 보고합니다.
Newman의 결정적인 특징은 독립성입니다. Postman 계정, API 키 또는 Postman 서버와의 네트워크 연결이 필요하지 않습니다. JSON 컬렉션 파일을 제공하면 실행됩니다. 이는 잠금된 환경에서 예측 가능하고 이해하기 쉽습니다.
npm install -g newman
newman run checkout-api.postman_collection.json \
--environment staging.postman_environment.json
Newman은 또한 가볍고 확장 가능합니다. CLI 및 JUnit 리포터와 함께 제공되며, 커뮤니티는 풍부한 HTML 출력을 위한 newman-reporter-htmlextra와 같은 추가 리포터를 유지 관리합니다. Node.js 패키지이므로 스크립트에서 프로그래밍 방식으로 호출할 수도 있습니다. Newman과 Postman의 차이점에 대한 가이드에서 데스크톱 앱과의 관계를 다룹니다.
Postman CLI란?
Postman CLI는 Postman이 구축하고 현재 권장하는 공식 명령줄 도구입니다. npm 패키지가 아닌 스크립트를 통해 설치하는 단일 바이너리이며, API 키를 통해 Postman 계정에 연결됩니다.
# 설치 (macOS/Linux 예시)
curl -o- "https://dl-cli.pstmn.io/install/osx_64.sh" | sh
# 인증 후 실행
postman login --with-api-key YOUR_API_KEY
postman collection run checkout-api
주요 차이점은 클라우드 연결입니다. Postman CLI로 컬렉션을 실행하면 ID로 Postman 작업 공간에서 직접 컬렉션을 가져올 수 있으며, 실행 결과를 Postman 플랫폼으로 다시 푸시하여 작업 공간 기록 및 대시보드에 나타납니다. 큰 장점은 API 거버넌스 및 보안 검사입니다. Postman CLI는 파이프라인 중에 API 정의에 대해 린팅을 실행하여 스키마 및 규칙 위반을 빌드의 일부로 표시할 수 있습니다.
따라서 Postman CLI는 순수한 컬렉션 러너라기보다는 Postman 플랫폼을 위한 파이프라인 에이전트에 가깝습니다. 팀이 Postman의 클라우드 내에서 작업하고 실행 기록 및 거버넌스를 중앙 집중화하기를 원한다면, 이러한 통합이 이를 선택해야 하는 이유입니다.
상세 비교
| 측면 | Postman CLI | Newman |
|---|---|---|
| 소스 | 클로즈드 소스, Postman 공식 도구 | 오픈소스 |
| 설치 | 설치 스크립트, 단일 바이너리 | npm 패키지 |
| Postman 계정 | 필수 (API 키 로그인) | 필수 아님 |
| 컬렉션 소스 | ID로 Postman 클라우드에서 가져오거나 로컬 파일 | 로컬 JSON 파일 |
| 실행 결과 | Postman 플랫폼으로 보고됨 | 터미널 출력 및 리포터 파일 |
| API 거버넌스/린팅 | 내장됨 | 포함되지 않음 |
| 리포터 | 제한적, 결과는 Postman에 저장됨 | CLI, JUnit, 커뮤니티 HTML 리포터 |
| 오프라인 사용 | 제한적, 클라우드를 중심으로 설계됨 | 파일이 로컬에 있으면 완전히 오프라인 |
| 성숙도 | 최신 | 오랜 기간 확립된 커뮤니티 표준 |
| 비용 | 무료이지만 Postman 플랜의 제한에 묶여 있음 | 무료, 계정 불필요 |
핵심적인 차이점은 Postman 클라우드입니다. Postman CLI는 결과와 거버넌스를 Postman 플랫폼에 제공하도록 구축되었습니다. Newman은 Postman 서버에 의존하지 않고 파일을 실행하고 로컬로 보고하도록 구축되었습니다.
CI/CD에 어떻게 통합되는가
두 도구 모두 Jenkins, GitHub Actions, GitLab CI, CircleCI를 포함한 모든 CI 제공업체에서 작동합니다. 작동 방식에는 차이가 있습니다.
Newman의 경우, 컬렉션 및 환경 JSON 파일을 리포지토리에 커밋하고, 작업에서 Newman을 설치하고, 실행한 다음, 테스트 실패 시 0이 아닌 종료 코드로 빌드 실패를 허용합니다. 모든 것이 리포지토리와 파이프라인 내에 자체 포함됩니다. CI/CD에서 API 테스트 자동화 및 GitHub Actions를 사용한 API 테스트 자동화에 대한 가이드에서 이 패턴을 보여줍니다.
Postman CLI의 경우, Postman API 키를 CI 제공업체에 시크릿으로 저장하고, 인증한 다음, ID로 컬렉션을 실행합니다. 컬렉션은 리포지토리 대신 Postman 클라우드에서 가져오며, 결과는 작업 공간으로 다시 게시됩니다. 이는 진실의 원천을 Postman에 유지하며, 일부 팀은 이를 선호하고 다른 팀은 제한적이라고 생각합니다.
실질적인 차이점: Newman은 컬렉션 JSON이 리포지토리에 있기 때문에 테스트가 코드와 함께 버전이 관리됩니다. Postman CLI는 ID로 가져오기 때문에 테스트가 Postman 플랫폼에서 버전이 관리됩니다. 선택하기 전에 팀이 어떤 진실의 원천을 원하는지 결정하세요.
거버넌스 측면
두 도구를 가장 명확하게 구분하는 단일 기능은 API 거버넌스입니다. Postman CLI는 Postman 작업 공간에 저장된 API 정의에 대해 postman api lint 스타일 검사를 실행하여 이름 지정, 보안, 스키마 완전성 및 일관성에 대한 규칙을 평가할 수 있습니다. 해당 검사가 파이프라인 내에서 실행되면 규칙을 위반하는 정의는 변경 사항이 병합되기 전에 빌드를 실패시킵니다.
Newman은 이에 상응하는 기능이 없습니다. 컬렉션을 실행하고 테스트 결과를 보고하며, 이것이 작업의 경계입니다. 조직이 API 디자인 표준을 자동으로 적용하는 것에 관심이 있다면, 해당 기능은 Postman CLI에만 존재하며 이를 선택해야 하는 진정한 이유가 됩니다. 파이프라인에서 디자인 규칙을 적용하지 않는다면, 이 기능은 무관하며 Newman의 단순함이 승리합니다.
이는 비교를 재구성하기 때문에 솔직하게 말할 가치가 있습니다. Postman CLI는 단순히 "Newman의 최신 버전"이 아닙니다. 이것은 다른 종류의 도구입니다. 즉, 컬렉션 러너를 포함하는 Postman 플랫폼을 위한 파이프라인 에이전트입니다. Newman은 그저 컬렉션 러너일 뿐입니다. 이런 식으로 보면, 선택은 기능에 대한 것이 아니라 테스트를 Postman 플랫폼에 전혀 묶을 것인지에 대한 것이 됩니다.
마이그레이션 고려 사항
이미 Newman을 실행하는 팀은 Postman CLI로 전환해야 하는지 묻는 경우가 있습니다. 그럴 강력한 이유는 거의 없습니다. Newman은 여전히 유지 관리되고, 여전히 무료이며, 모든 CI 제공업체에서 여전히 작동합니다. 전환은 API 키를 CI 시크릿으로 추가하고, 컬렉션 소싱 방식을 변경하고, Postman 클라우드에 대한 종속성을 수용해야 함을 의미합니다. 중앙 집중식 실행 기록이나 거버넌스 검사를 특별히 원하지 않는 한, 마이그레이션 비용이 얻는 이점보다 큽니다.
새로 시작하는 팀은 더 흥미로운 선택에 직면합니다. 팀이 Postman을 주요 도구로 사용하기로 결정하고 유료 플랜을 사용한다면, Postman CLI는 모든 것을 하나의 에코시스템에 유지하며 자연스러운 선택입니다. 팀이 유연성, 리포지토리 버전 관리 테스트, 단일 공급업체 클라우드로부터의 자유를 원한다면 Newman 또는 Postman이 아닌 다른 도구가 더 합리적입니다. 보편적으로 올바른 답은 없으며, 팀이 이미 작업하는 방식과 일치하는 답만 있을 뿐입니다.
어떤 것을 선택해야 할까요?
계정 종속성이 없는 러너를 원하거나, 테스트를 리포지토리에서 버전 관리하고 싶거나, 커뮤니티 리포터를 통해 풍부한 HTML 보고서를 필요로 하거나, Postman 클라우드로의 호출이 허용되지 않는 제한된 환경에서 실행하는 경우 Newman을 선택하세요. Newman의 독립성과 성숙도는 대부분의 파이프라인에 안전한 기본값을 제공합니다.
팀이 Postman 플랫폼 내에서 작업하고, 실행 기록 및 대시보드를 중앙 집중화하고 싶거나, 파이프라인에서 API 거버넌스 및 정의 린팅이 중요하다면 Postman CLI를 선택하세요. 긴밀한 클라우드 통합은 Postman 중심 팀에게 진정한 이점입니다.
이 결정을 고려하고 있다면, Postman 생태계에 전혀 묶이고 싶은지 스스로에게 묻는 것이 좋습니다. 다른 접근 방식에 대해서는 Newman 없이 CI에서 Postman 컬렉션 실행에 대한 가이드와 Postman 없이 API 테스트에 대한 광범위한 내용을 참조하세요.
단일 도구 대안: Apidog
Postman CLI와 Newman 모두 Postman에서 테스트를 작성했다고 가정합니다. Apidog는 이러한 분할을 제거합니다. 하나의 애플리케이션에서 시각적 어설션으로 API를 설계하고, 요청을 디버그하고, 자동화된 테스트 시나리오를 구축한 다음, 내장된 명령줄 러너를 사용하여 CI/CD에서 해당 시나리오를 실행합니다. 테스트 정의와 실행 엔진이 동일한 제품이기 때문에 내보내기 단계나 별도의 러너 패키지가 필요 없습니다.
Apidog는 또한 API 디자인, 목 서버 및 성능 테스트를 통합하여 팀이 도구를 조합할 필요 없이 전체 API 수명 주기를 커버할 수 있도록 합니다. 파이프라인용 CLI 러너를 포함하여 Apidog의 테스트 기능을 무료로 다운로드하여 사용할 수 있습니다.
자주 묻는 질문
Postman CLI가 Newman을 대체하나요?
Postman은 Postman CLI를 공식적으로 권장하는 명령줄 도구로 포지셔닝하지만, Newman은 여전히 유지 관리되고 널리 사용됩니다. Newman은 계정이 필요 없고 리포지토리에서 버전 관리되는 러너를 원할 때 더 나은 선택으로 남아 있습니다. 둘 다 한동안 공존할 가능성이 높으므로 긴급하게 마이그레이션할 필요는 없습니다.
Postman CLI는 Postman 계정이 필요한가요?
예. Postman CLI는 Postman API 키로 인증하며, 실행 결과를 Postman 작업 공간에 다시 연결하도록 설계되었습니다. 반면 Newman은 계정이 필요 없으며 로컬 컬렉션 파일에서만 실행됩니다.
어떤 도구가 더 나은 보고서를 제공하나요?
Newman은 커뮤니티 리포터를 통해 더 유연한 보고 기능을 제공합니다. 특히 상세한 HTML 출력을 위한 newman-reporter-htmlextra와 CI 대시보드를 위한 JUnit XML이 있습니다. Postman CLI는 Postman 플랫폼 자체에 결과를 보고하며, 팀이 그곳에서 작업한다면 편리하지만 독립형 보고서 파일에는 덜 유연합니다.
Postman CLI는 로컬 컬렉션 파일을 실행할 수 있나요?
Postman CLI는 로컬 파일에서 컬렉션을 실행할 수 있지만, Postman 클라우드에서 ID로 컬렉션을 가져오고 결과를 다시 보고하는 것을 중심으로 구축되었습니다. 로컬 JSON 파일을 클라우드 개입 없이 진실의 원천으로 다루는 도구를 원한다면 Newman이 해당 모델에 더 자연스럽게 맞습니다.
CI에서 어떤 것이 더 빠를까요?
순수한 컬렉션 실행의 경우, 차이는 작고 컬렉션 크기 및 네트워크 상태에 따라 달라집니다. Newman은 더 작은 설치 공간을 가지며 클라우드 왕복이 없습니다. Postman CLI는 인증 및 플랫폼으로 결과 동기화에 대한 오버헤드를 추가합니다. 대부분의 파이프라인에서는 순수한 속도보다는 워크플로우 적합성을 기준으로 선택하세요.