개발, 라이브 배포 문의

[HO]

어떤 제품을 사용하나요?

• 제품: POS 플러그인
• SDK 또는 API 버전: @tossplace/pos-plugin-sdk 0.0.27
• 환경: 개발

무엇이 궁금한가요?

저희는 플러그인을 개발(dev) / 스테이징(stg) / 운영(prd) 3개 환경으로 나눠 배포하려고 합니다.
환경마다 플러그인이 붙는 서버 주소와 오류 수집(Sentry) 설정이 달라서, 빌드 파일도 환경별로 따로 만듭니다.
그런데 개발자센터에는 애플리케이션 하나에 "개발 배포 / 라이브 배포" 두 곳만 있고, ACL(URL)도 하나만 등록할 수 있어 아래 내용을 여쭙니다.

1. 스테이징(stg) 환경 운영 방법
   -현재의 어플리케이션은 개발-스테이징을 사용예정인데, 운영용으로 애플리케이션을 하나 더 등록해서 쓰는 게 맞을까요? (애플리케이션을 추가로 등록할 수 있는지도 궁금합니다.)

   • 아니면 개발 배포 하나로 개발배포와 운영배포를 같이 운영하는 걸 권장하시나요?

2. 개발 배포와 테스트 단말기

   • 개발 배포를 하면 등록한 테스트 단말기 전체에 같은 버전이 적용되나요?
   • 단말기마다 다른 버전을 깔 수 있나요? (예: A 단말기는 dev 빌드, B 단말기는 stg 빌드)
   • 테스트 가맹점이나 단말기 단위로 나눌 수 있는 방법이 있다면 알려 주세요.

3. ACL(URL)

   • ACL은 개발 배포와 라이브 배포에 같이 적용되나요?
   • 같이 적용된다면, 운영 빌드에서도 개발·검수 서버 주소가 허용 목록에 남게 됩니다. 환경별로 ACL을 나눌 수 있을까요?
   • 나눌 수 없다면 라이브 배포 전에 개발용 주소를 빼야 하는지 궁금합니다.

4. 실행 중 환경 구분

   • 플러그인이 실행 중에 지금 개발 배포로 깔렸는지 라이브 배포로 깔렸는지 알 수 있는 값을 SDK가 주나요?
   • 그런 값이 있으면 빌드 하나로 서버 주소를 고를 수 있어서, 환경별로 빌드를 나누지 않아도 될 것 같습니다.

5. 라이브 배포

   • 라이브 배포에 검수 절차는 보통 얼마나 걸리나요?
   • 라이브 배포 뒤에 문제가 생기면 이전 버전으로 되돌릴 수 있나요?

비슷하게 여러 환경을 운영하는 연동사에서 주로 쓰는 방식이 있다면 함께 알려 주시면 감사하겠습니다.

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

문의 주신 환경별 배포와 ACL 설정, 이전 버전 복귀 방법을 안내 드립니다.

1. 개발·스테이징·운영 구성
앱은 추가 등록할 수 있으며, 앱마다 개발·라이브 배포를 구분합니다. 세 환경의 빌드와 ACL을 독립적으로 운영하시려면 환경별로 앱을 분리하는 구성을 제안 드립니다.
운영용 앱은 개발 배포가 아닌 검수 후 라이브 배포로 운영해 주세요.

2. 테스트 단말기별 버전
같은 앱의 개발 배포는 등록된 테스트 단말기에 공통으로 적용됩니다. 단말기마다 서로 다른 개발 버전을 지정하는 기능은 제공하지 않습니다.
dev와 stg 빌드를 동시에 유지하려면 앱을 분리하고 각각 테스트 단말기를 등록해 주세요. 앱별 테스트 단말기 등록은 기존 답변도 참고해 주세요.

3. ACL 설정
ACL은 여러 URL을 줄바꿈으로 등록할 수 있습니다. 다만 같은 앱의 개발·라이브 배포에 공통 적용됩니다.
개발용 URL을 삭제하면 해당 앱의 개발 배포에서도 접근할 수 없으므로, 환경별 허용 목록까지 분리하려면 앱을 나눠 주세요. ACL 설정 가이드

4. 실행 환경 구분
공개 SDK는 개발·라이브 구분값을 제공하지 않으며, getPluginInfo에서는 이름과 버전을 조회할 수 있습니다.
서버 주소와 Sentry 설정은 현재처럼 환경별 빌드 설정으로 구분해 주세요. Plugin API

5. 라이브 검수 및 이전 버전 복귀
검수는 매주 월·목요일, 근무일 기준으로 진행되며, 검수 승인 후 라이브 배포할 수 있습니다.
이전 버전으로 되돌리는 롤백 기능은 제공하지 않습니다. 이전 코드로 복귀가 필요하면 정상 동작하던 코드를 신규 버전으로 업로드한 뒤, 검수·배포하는 방식을 권장합니다.
배포 후 POS를 새로고침하거나 재시작하여 변경 사항을 반영해 주세요. 검수·배포 가이드