querypie · jk-kim0 · Aug 19, 2026
diff --git a/aws/marketplace/FIELD-CATALOG.md b/aws/marketplace/FIELD-CATALOG.md
@@ -36,7 +36,7 @@ AWS의 메타데이터 작성 지침에 따라 제목과 제출 원문에는 ASC
 |------|-----------|
 | Version information | Version title, release notes |
 | AMI | AMI ID, IAM access role ARN, OS, OS version, OS user name, scanning port |
-| Delivery option | AMI standalone, recommended instance type, usage instructions |
+| Delivery option | AMI standalone, recommended instance type, usage instructions; Community 초안은 `products/community/12-usage-instructions.md` |
 | Endpoint | Protocol, relative URL, port |
 | Security group | Protocol, port 범위, 권장 IPv4 CIDR |
 | Availability | 배포 가능 AWS 리전, 향후 리전 자동 포함 여부, 허용 인스턴스 타입 |

diff --git a/aws/marketplace/LICENSE-FULFILLMENT.md b/aws/marketplace/LICENSE-FULFILLMENT.md
@@ -7,7 +7,7 @@
 
 | 제품 | AWS 가격 모델 | `.crt` 발급 기준 | 출시 정책 |
 |------|---------------|------------------|-----------|
-| QueryPie ACP Community Edition | BYOL | 공개 HTTPS BYOL URL에서 무료 자동 발급 | 먼저 Public 등록 |
+| QueryPie ACP Community Edition | BYOL | 공개 HTTPS BYOL URL에서 무료 자동 발급 | Limited 검증 후 Public 등록 |
 | QueryPie ACP Standard Edition | AMI with contract pricing | AWS Contract 권리를 확인해 자동 발급하는 방식 확정 필요 | 자료와 AMI 준비만 수행 |
 | QueryPie ACP Enterprise Edition | AMI with contract pricing | 구매자가 수락한 Private Offer 조건 | Private Offer only |
 
@@ -63,18 +63,18 @@ Enterprise 발급 절차는 다음을 보장해야 합니다.
 - Private Offer가 없거나 만료·취소되었거나 구매자 정보가 일치하지 않으면 발급하지 않습니다.
 - 발급 후 런타임 검증은 컨테이너 내부에서 오프라인으로 수행합니다.
 
-## 구매자 문서 요구 사항
+## Community 구매자 문서 경계
 
-Marketplace 전용 사용 지침에는 다음 내용을 명시합니다.
+Community의 Marketplace 필수 사용 절차는 AMI 실행부터 `https://<instance-address>:8443/` 접속 확인까지 설명합니다.
+선택적 진단 절차는 `ec2-user` SSH 접속과 컨테이너 상태 확인 방법을 추가로 설명합니다.
+Marketplace 사용 지침에는 라이선스 발급 또는 `.crt` 설치 절차를 포함하지 않습니다.
+접속 이후의 자세한 설정과 사용 방법은 [QueryPie ACP Community Edition 설치 및 사용 가이드](https://docs.querypie.com/installation/querypie-acp-community-edition)로 안내합니다.
 
-- AMI에 QueryPie ACP와 필요한 컨테이너 이미지가 사전 설치되어 있음
-- 구매자가 외부 설치 스크립트를 실행하지 않음
-- 해당 에디션의 라이선스 발급 조건과 `.crt` 등록 절차
-- 컨테이너 내부의 로컬 PKI 검증
-- 실행 중 외부 라이선스 서버 연결이 없음
-- 라이선스 파일의 저장, 교체, 갱신, 백업과 복구 절차
-- 라이선스 검증용 공개 키의 교체 정책
-- 라이선스 서명 private key가 구매자 환경에 제공되지 않음
+Marketplace AMI에는 QueryPie ACP와 필요한 컨테이너 이미지가 사전 설치되어 있습니다.
+구매자는 연결된 가이드의 일반 Linux 설치 스크립트를 다시 실행하지 않습니다.
+
+라이선스 발급과 PKI 검증 구조는 Marketplace 사용 지침과 분리해 이 문서에서 관리합니다.
+판매자 내부 검증에서는 `.crt` 등록, 최대 5 active users 권리, 외부 라이선스 서버 없이 실행되는 동작을 계속 확인합니다.
 
 ## 공식 근거
 

diff --git a/aws/marketplace/README.md b/aws/marketplace/README.md
@@ -42,6 +42,7 @@ products/<edition>/
 └── 11-support-information.md
 ```
 
+QueryPie ACP Community Edition의 AMI 실행 지침은 `products/community/12-usage-instructions.md`에서 관리합니다.
 QueryPie ACP Standard Edition의 유료 계약 초안은 `products/standard/12-contract-pricing.md`에서 별도로 관리합니다.
 
 영어 섹션은 실제 Marketplace 제출 원문입니다.

diff --git a/aws/marketplace/REGISTRATION-PLAN.md b/aws/marketplace/REGISTRATION-PLAN.md
@@ -58,20 +58,25 @@ Version title은 에디션이나 라이선스 권리를 구분하는 용도로
 2. 판매자 계정 `us-east-1`에 검증할 Community AMI를 준비합니다.
 3. 첫 버전과 AMI standalone deployment를 입력해 Limited 상품을 생성합니다.
 4. 내부 구매 계정을 allowlist에 추가하고 `Test Add Version`과 보안 스캔을 완료합니다.
-5. Marketplace 전용 사용 지침으로 EC2 실행, 최초 관리자 설정과 무료 `.crt` 발급·등록을 검증합니다.
-6. 라이선스 등록 이후 외부 라이선스 서버 연결 없이 최대 5 active users 권리가 적용되는지 확인합니다.
-7. 영어 원문과 AWS 자동 번역을 검수합니다.
-8. Community만 Public 전환을 요청합니다.
+5. Marketplace 사용 지침으로 EC2 인스턴스가 `Running` 상태가 된 시점부터 일반적으로 3분 이내에 `https://<instance-address>:8443/` 웹 콘솔에 접속되는지 검증합니다.
+6. 판매자 내부 검증에서는 별도로 라이선스 등록 이후 외부 라이선스 서버 연결 없이 최대 5 active users 권리가 적용되는지 확인합니다.
+7. `ec2-user`로 SSH 접속한 뒤 `/usr/local/bin/setup.v2.sh --verify-installation`이 성공하는지 확인합니다.
+8. 영어 원문과 AWS 자동 번역을 검수합니다.
+9. Community만 Public 전환을 요청합니다.
 
 ### Community Public 제출 게이트
 
 - 평가판이 아니라 지속 사용 가능한 정식 Community 제품으로 설명됩니다.
 - 유일한 에디션 용량 제한이 최대 5 active users로 명시됩니다.
 - 무료 `.crt` 발급이 자동화되고 별도의 판매자 승인을 기다리지 않습니다.
 - 공통 초기 관리자 비밀번호를 사용하지 않습니다.
-- Marketplace 전용 사용 지침이 실행, 라이선스 등록, 상태 확인, 백업, 복구와 업그레이드를 설명합니다.
-- BYOL 제품에 필요한 동등한 AWS Marketplace paid option과 적용 시점을 Seller Operations와 확인했습니다.
-- 실제 AMI 소유권, 이름, Description과 스캔 결과를 확인했습니다.
+- Marketplace 사용 지침이 EC2 실행 후 일반적으로 3분 이내에 `https://<instance-address>:8443/` 접속을 확인하는 방법을 설명합니다.
+- 선택적 SSH 지침이 `ec2-user` 접속과 `/usr/local/bin/setup.v2.sh --verify-installation` 실행 방법을 설명합니다.
+- 접속 이후의 자세한 설정과 사용 방법을 QueryPie ACP Community Edition 공개 문서로 안내합니다.
+- AWS가 요구하는 민감 정보, 암호화, 백업, 복구, 할당량, 비용과 업그레이드 정보가 Marketplace 지침 또는 연결된 공개 문서에서 제공됩니다.
+- BYOL 제품에 필요한 동등한 AWS Marketplace paid option과 적용 시점을 Seller Operations와 확인해야 합니다.
+- 실제 AMI 소유권, 이름, Description과 스캔 결과를 확인해야 합니다.
+- 지원할 인스턴스 타입과 초기 출시 리전에서 `Running` 상태 이후 통상적인 3분 이내 접속 시간을 반복 검증해야 합니다.
 
 위 항목이 해결되기 전에는 Community Public 전환 요청을 제출하지 않습니다.
 

diff --git a/aws/marketplace/RELEASE-READINESS.md b/aws/marketplace/RELEASE-READINESS.md
@@ -65,10 +65,23 @@ Enterprise 상품을 Public으로 전환하거나 Public Offer를 제공하지
 ### Marketplace 전용 사용 지침
 
 AWS는 민감 정보 위치, 암호화 구성, 키 교체, 내부 저장소의 백업과 복구, 상태 점검, 할당량과 추가 비용을 포함한 상세 사용 지침을 요구합니다.
-현재 공개 QueryPie ACP Community Edition 가이드는 일반 Linux 서버에 새로 설치하는 절차를 설명하므로 사전 설치된 Marketplace AMI의 구매자 지침으로 사용할 수 없습니다.
+Marketplace 입력 필드에는 EC2 인스턴스가 `Running` 상태가 된 시점부터 일반적으로 3분 이내에 `https://<instance-address>:8443/` 접속을 확인하는 절차를 직접 입력합니다.
+선택적 진단 절차로 `ec2-user` SSH 접속과 `/usr/local/bin/setup.v2.sh --verify-installation` 실행 방법을 안내합니다.
+라이선스 설치 과정은 Marketplace 사용 지침에서 생략하고, 접속 이후의 자세한 설정과 사용 방법은 [QueryPie ACP Community Edition 설치 및 사용 가이드](https://docs.querypie.com/installation/querypie-acp-community-edition)로 안내합니다.
 
-Marketplace 전용 영어 사용 지침을 작성하고 실제 Limited 구매 흐름으로 검증해야 합니다.
-Marketplace 입력 필드에는 핵심 실행 절차를 직접 적고 상세 운영 문서로 연결합니다.
+현재 연결 문서는 일반 Linux 설치 명령, 라이선스 등록, 고정 초기 관리자 비밀번호와 평가판처럼 읽힐 수 있는 일부 표현을 함께 포함합니다.
+Marketplace AMI 구매자가 설치 명령을 다시 실행하지 않도록 지침에 명시해야 합니다.
+Public 제출 전에는 연결 문서의 제품명을 `QueryPie ACP Community Edition`으로 통일하고, 지속 사용 가능한 제품이며 유일한 에디션 제한이 최대 5 active users라는 설명과 충돌하는 표현을 수정해야 합니다.
+
+연결 문서만으로 AWS가 요구하는 민감 정보, 암호화, 키 교체, 백업, 복구, 상태 점검, 할당량, 추가 비용과 업그레이드 정보가 모두 제공되는지도 확인해야 합니다.
+부족한 항목은 Marketplace 사용 지침 또는 별도의 공개 운영 문서로 보완하고 실제 Limited 구매 흐름으로 검증합니다.
+
+### 일반적인 3분 이내 접속 기준
+
+`Running` 상태 이후 3분은 일반적인 환경에서 애플리케이션이 접근 가능한 상태가 되는 통상 시간입니다.
+현재 최초 부팅 서비스의 600초 제한은 실패 방지를 위한 최대 실행 한도이며 일반적인 준비 시간을 의미하지 않습니다.
+Marketplace 문구는 3분을 보장된 제한 시간이나 SLA로 표현하지 않고 `typically`를 사용합니다.
+지원할 인스턴스 타입과 초기 출시 리전에서 반복 측정해 통상적인 3분 설명을 뒷받침해야 합니다.
 
 ### 제품명과 AMI 설명의 정합성
 
@@ -115,7 +128,8 @@ Marketplace 소스 스냅샷의 비암호화 요구와 구매자 런타임 EBS
 - Standard Contract 또는 Enterprise Private Offer 권리를 확인한 뒤 수행하는 `.crt` 발급 절차
 - 컨테이너 내부의 로컬 PKI 라이선스 검증
 
-Community의 라이선스 발급 URL은 구매자에게 필요한 일회성 BYOL fulfillment 경로이므로 BYOL URL과 사용 지침에 표시합니다.
+Community의 라이선스 발급 URL은 구매자에게 필요한 일회성 BYOL fulfillment 경로이므로 Marketplace의 BYOL URL 필드에 표시합니다.
+라이선스 발급 또는 설치 단계는 Community Marketplace 사용 지침에 반복해서 작성하지 않습니다.
 Standard와 Enterprise의 발급 절차는 각각 수락된 Contract 또는 Private Offer 권리를 확인해야 합니다.
 
 ## 현재 구현에서 이미 반영된 항목

diff --git a/aws/marketplace/SUBMISSION-FIELDS.md b/aws/marketplace/SUBMISSION-FIELDS.md
@@ -88,26 +88,31 @@ MySQL `3306`, Redis `6379`, tools `8050`은 외부 인바운드 규칙에 포함
 사용하지 않는 QueryPie ACP 프록시 포트도 열지 않습니다.
 AWS Marketplace 스캔에 필요한 최신 내부 CIDR은 제출 시 AWS 포털 안내와 대조합니다.
 
-## Usage instructions에 포함할 내용
-
-Marketplace 입력 필드에는 구매자가 제품을 시작할 수 있는 핵심 절차를 직접 입력합니다.
-상세 운영 내용은 Marketplace 전용 공개 문서로 연결합니다.
-일반 Linux 설치용 `setup.v2.sh` 가이드를 Marketplace 구매자 지침으로 사용하지 않습니다.
-
-- QueryPie ACP가 AMI에 사전 설치되어 있다는 설명
-- 최초 부팅 완료와 애플리케이션 상태 점검 절차
-- 웹 콘솔에 접속하고 최초 관리자를 안전하게 생성하는 절차
-- 에디션별 구매 권리를 확인하는 라이선스 발급 절차와 `.crt` 등록 방법
-- `.crt`가 컨테이너 내부에서 로컬 PKI 방식으로 검증되고 지속적인 외부 연결이 없다는 설명
-- 민감 정보와 라이선스 파일의 저장 위치
-- 암호화 구성과 키 교체 요구 사항
-- 내부 데이터 저장소의 구성, 백업, 복구 절차
-- 업그레이드 시 데이터와 설정 보존 절차
-- AWS 서비스 할당량 관리와 추가 AWS 인프라 비용
-- 지원 연락처와 장애 진단 자료 수집 방법
-
-AWS는 Usage instructions 필드에 지침 또는 상세 문서 링크를 허용합니다.
-링크를 사용하는 경우에도 연결된 문서는 위 내용을 모두 포함하고 Marketplace AMI의 실제 실행 흐름과 일치해야 합니다.
+## Community Usage instructions
+
+Marketplace 입력 필드에는 Community AMI 실행 후 일반적으로 3분 이내에 웹 콘솔 접속을 확인하는 핵심 절차를 직접 입력합니다.
+제출 원문은 [Community Usage instructions](products/community/12-usage-instructions.md)에서 관리합니다.
+
+지침의 범위는 다음과 같습니다.
+
+- QueryPie ACP Community Edition AMI를 EC2 인스턴스로 실행
+- 신뢰된 접근 네트워크에서 TCP `8443` 인바운드 허용
+- EC2 인스턴스가 `Running` 상태가 된 시점부터 일반적으로 3분 이내에 `https://<instance-address>:8443/` 접속
+- QueryPie ACP 초기 화면 표시 확인
+- 필요한 경우 신뢰된 관리자 네트워크에만 TCP `22`를 허용하고 `ec2-user`로 SSH 접속
+- `/usr/local/bin/setup.v2.sh --verify-installation`으로 최초 부팅 서비스, 컨테이너와 애플리케이션 준비 상태 확인
+
+Marketplace 지침에는 라이선스 발급 또는 설치 과정을 포함하지 않습니다.
+접속 확인 이후의 자세한 설정과 사용 방법은 [QueryPie ACP Community Edition 설치 및 사용 가이드](https://docs.querypie.com/installation/querypie-acp-community-edition)를 참조하도록 안내합니다.
+Marketplace AMI는 사전 설치된 제품이므로 구매자가 연결된 가이드의 일반 Linux 설치 명령을 다시 실행하지 않도록 명시합니다.
+
+AWS는 별도로 민감 정보 위치, 암호화 구성, 암호화 자료 교체, 내부 데이터 저장소의 백업과 복구, 상태 점검, 서비스 할당량, 추가 비용과 업그레이드 지침을 요구합니다.
+위 운영 정보는 Marketplace 지침 또는 연결된 공개 문서에서 구매자가 확인할 수 있어야 합니다.
+현재 QueryPie ACP Community Edition 설치 문서만으로 이 AWS 전용 운영 정보가 모두 충족되는지는 Public 제출 전에 보완하고 검증해야 합니다.
+
+`Running` 상태 이후 일반적으로 3분 이내 접속 가능하다는 문구는 구매자에게 통상적인 부팅 시간 기대치를 제시합니다.
+이 시간은 보장된 제한 시간이나 SLA가 아닙니다.
+Public 제출 전에는 지원할 인스턴스 타입과 초기 출시 리전에서 반복 측정해 이 설명을 뒷받침해야 합니다.
 
 ## 리전과 국가
 

diff --git a/aws/marketplace/products/community/10-additional-resources.md b/aws/marketplace/products/community/10-additional-resources.md
@@ -4,7 +4,7 @@
 
 | Resource name | URL |
 |---------------|-----|
-| QueryPie ACP AWS Marketplace Usage Guide | [AWS_MARKETPLACE_USAGE_GUIDE_URL] |
+| QueryPie ACP Community Edition Installation and Usage Guide | https://docs.querypie.com/installation/querypie-acp-community-edition |
 | QueryPie ACP Administrator Manual | https://docs.querypie.com/en/administrator-manual |
 | QueryPie ACP User Manual | https://docs.querypie.com/en/user-manual |
 | QueryPie ACP Support | https://docs.querypie.com/support |
@@ -13,7 +13,7 @@
 
 | 자료명 | URL |
 |--------|-----|
-| QueryPie ACP AWS Marketplace 사용 가이드 | [AWS_MARKETPLACE_USAGE_GUIDE_URL_KO] |
+| QueryPie ACP Community Edition 설치 및 사용 가이드 | https://docs.querypie.com/installation/querypie-acp-community-edition |
 | QueryPie ACP 관리자 매뉴얼 | https://docs.querypie.com/ko/administrator-manual |
 | QueryPie ACP 사용자 매뉴얼 | https://docs.querypie.com/ko/user-manual |
 | QueryPie ACP 기술지원 | https://docs.querypie.com/support |
@@ -22,4 +22,6 @@
 
 AWS에는 영어 자료명과 영어 URL을 제출합니다.
 자동 번역이 URL까지 언어별로 바꾸지는 않으므로 현지화된 URL은 Limited 상태에서 AWS와 조정할 참고값입니다.
-일반 Linux 설치용 QueryPie ACP Community Edition 가이드는 외부 설치 스크립트를 안내하므로 사전 설치된 Marketplace AMI의 구매자 지침으로 사용하지 않습니다.
+Marketplace 필수 사용 절차는 AMI 실행과 웹 콘솔 접속 확인까지 직접 안내하며, 선택적 SSH 진단 절차를 함께 제공합니다.
+연결된 문서는 접속 확인 이후의 상세 설정과 사용 방법을 확인하는 참고 자료로 안내합니다.
+Marketplace AMI에는 QueryPie ACP가 사전 설치되어 있으므로 연결된 문서의 일반 Linux 설치 명령을 다시 실행하지 않습니다.