App 릴리스하기
App 하나의 불변 버전을 심사에 제출하고 게시·설치·업데이트 결과를 확인합니다.
App 릴리스하기
샌드박스에서 확인한 앱을 GitHub 버전 태그로 심사에 제출합니다. 제출은 앱 하나의 버전 하나를 대상으로 하며, 승인·게시·설치는 별도 단계입니다.
자동 검사와 관리자 승인
소스·빌드·계약·마이그레이션 검사가 완료되면 AI가 실행 코드를 나누어 권한, 테넌트 격리, 조회·저장, 데이터 보존, 외부 통신과 SDK 사용을 검토합니다. 문서·의존성 잠금 데이터·JSON 번역 사전은 별도 범위로 기록하며 AI가 실행 코드처럼 반복 검사하지 않습니다.
Console에서 AI 검사 진행 상황을 확인할 수 있습니다. 완료된 분할 결과를 저장하고 다음 검사를 이어서 처리합니다. 검사 누락, 오류 또는 해결되지 않은 위험은 통과가 아닙니다. 필수 검사를 통과하거나 아래의 수락 가능한 계약 변경을 검토한 뒤 관리자가 검토 의견을 남기고 직접 승인해야 합니다. AI가 앱을 자동 승인하거나 게시하지 않습니다. 승인 후 게시와 런타임 배포·테넌트 설치는 각각 별도 단계입니다.
마이그레이션 호환성 검사가 실패하면 Console에서 확인 가능한 테이블, 컬럼과 사유를 표시합니다. 결과를 확인해 앱 마이그레이션을 수정한 뒤 새 버전을 제출하세요. 행의 데이터 값은 표시하지 않습니다. Core 심사 구현
공개 계약이 바뀌면 관리자가 이전 릴리스와의 전체 비교 결과를 검토하고 영향을 명시적으로 수락할 수 있습니다. 기존 계약 검사 실패 결과는 그대로 표시됩니다. 비교 결과가 불완전하거나 마이그레이션·별도 보안·프로토콜 검사가 실패한 경우에는 승인이 계속 차단됩니다. 수락한 변경은 제출한 App의 심사 상태에서 확인할 수 있습니다.
제출 순서
Core 리소스 테이블의 표시 변경만으로 앱을 다시 빌드하거나 변경 없는 마이그레이션·계약 검사를 반복할 필요는 없습니다. 비교 대상 게시 버전이나 호스트 API·DB 경계가 바뀌면 관련 검사는 계속 무효화됩니다. 실제 수행된 AI 분석은 참고한 호스트 문맥이 바뀌면 다시 분석해야 하며, 관리자가 비활성화한 AI 검사는 생략 상태를 유지합니다. Console에 유효하지 않은 검사 결과가 표시되면 새 버전을 제출하기 전에 관리자에게 해당 증거의 확인을 요청하세요. Core 심사 구현
- 앱 폴더에서
nexia check와composer test를 실행하고 샌드박스에서 저장·새로고침·권한 거부를 확인합니다. 변경별 기준은 App 테스트하기를 참고하세요. - Console의 프로젝트 앱 → 내 앱 → 버전 제출에서 GitHub 저장소를 연결합니다. 첫 연결 절차는 아래에 있습니다.
- 검증한 소스와 의존성 lock 파일을 커밋·push합니다. 앱 폴더에서 실제 버전으로 바꿔 실행하세요.
git tag v1.0.0
git push origin v1.0.0
nexia submit --tag v1.0.0자동 제출이 켜져 있으면 태그 push 후 Console에서 접수 여부를 먼저 확인하세요.
앱 개발자의 담당 범위
앱 개발자는 소스 개발·검증, 버전 태그 push, 심사 제출과 결과 확인·수정 대응까지 진행합니다. Nexia 관리자는 승인·게시를, 운영자는 운영 배포를 담당합니다. 개발자가 운영 서버에 직접 배포하지 않습니다. 고객 설치는 별도이며, 제출 접수나 게시 상태만으로 배포·설치 완료를 판단하지 않습니다.
검증한 릴리스 커밋에 태그를 만들기 전에 저장소의 병합 규칙을 따르세요. 공식 워크스페이스에서는 작업 PR을 develop에 병합한 뒤, develop에서 main으로 릴리스 PR을 병합합니다. Nexia는 원격 태그의 커밋을 제출받으며, 로컬 미커밋 변경이나 현재 샌드박스 소스를 제출하지 않습니다.
제출할 앱 선택
앱 폴더나 그 하위 폴더에서는 다음과 같이 실행합니다.
nexia submit --tag v1.0.0연결된 프로젝트 루트에서 같은 명령을 실행하면 앱이 여러 개일 때 선택 목록이 나옵니다. 앱이 하나면 자동 선택하고, 없으면 오류를 표시합니다. 앱이 여러 개인 비대화형 실행에서는 --app이 필요합니다. 폴더명이나 앱 키로 직접 지정할 수도 있습니다.
nexia submit --app people --tag v1.0.0
nexia submit --app people --tag v1.0.0 --no-interactive --yes --json자동화 전에 저장소 연결을 완료해야 합니다. --yes는 확인에 동의하는 옵션이며 접근 권한 검사를 우회하지 않습니다. Git 태그 명령은 프로젝트 루트가 아니라 해당 앱의 Git 저장소에서 실행하세요.
제출 상세 화면에서 실패한 빌드와 검사의 보존된 출력을 확인할 수 있습니다. 제출 프로젝트의 개발 권한이 필요합니다. 출력이 길면 일부가 생략되며, 이전에 보존되지 않은 출력은 복구할 수 없습니다.
접수와 결과 확인
UUID를 복사할 필요 없이 목록에서 앱·태그·상태·제출 날짜를 보고 선택할 수 있습니다.
nexia submit list
nexia submit status
nexia submit list --page 2앱 폴더에서는 해당 앱, 프로젝트 루트에서는 프로젝트 전체 제출을 표시합니다. 일반 터미널에서는 ↑/↓와 Enter로 선택합니다. 비대화형 실행에서 ID 없는 status는 목록을 반환합니다. 자동화에서는 nexia submit status <submission-id> --json을 사용할 수 있습니다.
대응하는 CLI는 검사별 상태, 제공되는 경우 분석 진행률, 검토 의견과 다음 행동을 표시합니다. 상세 피드백은 Developers의 버전 제출에서 확인하세요.
빌드가 끝나면 CLI 0.2.0-alpha.53 이상에서 제출된 카탈로그와 아티팩트의 근거가 일치하는 경우 대시보드 경로 목록 경고를 볼 수 있습니다. 표시된 소스 또는 선택 엔터티 위젯 경로를 앱의 GET 경로와 비교하세요. 이 경고는 참고용입니다. 목록에 없다는 사실만으로 경로 오류가 확정되지 않으며, 일치해도 경로 순서·바인딩·권한 검증을 뜻하지 않습니다. 근거가 없거나 오래된 경우에도 통과로 판단하지 않습니다.
| 결과 | 다음 행동 |
|---|---|
| 이미 제출됨 | 기존 제출 상태를 확인합니다. 자동 제출이 먼저 접수한 경우에도 새 제출은 생성하지 않습니다. |
| 대기·빌드 대기·실행 중 | 나중에 상태를 확인합니다. 앞선 심사 때문에 처리가 대기할 수 있으며 중복 제출하지 않습니다. |
| 검사 미완료 | Developers에서 실패·차단·유효하지 않은 검사 결과를 확인합니다. 증거 누락은 통과가 아닙니다. |
| 관리자 심사 준비 완료·승인됨 | 각각 관리자 심사 또는 게시를 기다립니다. |
| 게시됨 | nexia status와 운영자 확인으로 배포 가능 여부를 확인합니다. 게시만으로 배포·설치가 완료되지는 않습니다. |
| 재시도 가능한 소스 수집 실패 | nexia submit retry에서 기존 제출을 선택합니다. 자동화에는 제출 ID와 확인이 필요합니다. |
| 빌드 검토 필요·결과 불확실 | 요청 또는 제출 ID와 함께 개발자 지원에 문의합니다. 데이터 초기화나 중복 제출로 우회하지 않습니다. |
| 반려·취소·코드 수정 | 검토 의견을 반영하고 새 버전 태그로 제출합니다. |
| 기존 버전이 다른 코드를 가리킴 | 제출이 거절됩니다. 기존 태그를 옮기지 말고 새 버전 태그를 사용합니다. |
| 응답 유실 | 원래 태그와 출력된 --request-id로 다시 요청합니다. 원격 태그가 이동했어도 원래 제출을 반환합니다. |
중복 제출은 기존 접수 결과를 반환합니다. 상태를 확인한 뒤 재시도와 새 버전 제출 중 필요한 조치를 선택하세요.
접수 완료는 게시 완료가 아닙니다. 취소·반려된 버전도 다른 코드로 재사용할 수 없습니다. 게시되어도 현재 샌드박스 소스가 자동 교체되지는 않습니다.
제출 단위와 버전
한 번의 제출은 App 하나의 특정 버전 하나를 대상으로 합니다. 프로젝트에서 여러 앱을 함께 개발하더라도 각 앱을 따로 제출합니다. 같은 앱에 진행 중인 심사는 하나이며 제출한 버전의 파일을 덮어쓰지 않습니다. 수정이 필요하면 새 버전을 준비합니다. 프로젝트·디렉터리 이름을 바꿔 기존 App 식별자나 버전 제한을 우회하지 않습니다.
서로 다른 앱의 제출은 동시에 처리될 수 있으며, 처리 용량과 기존 작업에 따라 심사 시작 시점이 달라질 수 있습니다. 같은 앱에 진행 중인 심사는 여전히 하나입니다. Manager 변경
| 대상 | 선언과 의미 |
|---|---|
| App 버전 | 제출된 불변 산출물을 식별합니다. Git tag만 생성한다고 게시되지는 않습니다. |
| PHP SDK | composer.json의 require에 사용하는 공개 SDK 호환 범위를 선언합니다. |
| React SDK | package.json의 peerDependencies에 프런트엔드 SDK 호환 범위를 선언합니다. PHP SDK와 독립 버전입니다. |
| 플랫폼 계약 | nexia.json → platform은 런타임 계약과 필수 기능을 선언합니다. 기존 선택 필드인 core_version은 허용하지만 Core 호환성 검사에 사용하지 않습니다. |
| 초기화 버전 | VersionedTenantAppSeederContribution::versions()은 기본 데이터 적용 버전입니다. App 버전만 올려도 완료한 시더가 다시 실행되는 것은 아닙니다. |
| Resource 계약 | ResourceDescriptor::version은 다른 앱이 사용하는 리소스 계약 버전입니다. |
| Event schema | Event와 구독이 선언하는 payload 버전이며 App 릴리스 버전과 다릅니다. |
생성된 의존성 선언을 기준으로 실제 테스트한 범위만 지원한다고 명시합니다. 새 SDK 기능에 새 Host 구현이 필요하면 두 최소 버전을 함께 올립니다. Composer version을 임의로 추가하거나 배포용 설정에 로컬 SDK path·link: 의존성을 남기지 않습니다.
게시만으로 모든 고객에게 새 버전이 활성화되지는 않습니다. 신규 설치와 기존 데이터에서의 업그레이드, 이전에 비활성화한 설치를 함께 확인하세요. 필수 기본 데이터는 반복 실행해도 사용자 변경을 보존해야 하며, 내용이 바뀌면 초기화 버전도 갱신합니다.
제출 전 확인
샌드박스에서 확인한 결과와 다음 변경 영향을 정리하세요.
- 신규 설치와 기존 데이터가 있는 업그레이드를 모두 확인합니다.
- 이미 적용한 migration 파일은 유지하고 새 migration으로 변경합니다. 앱 제거·비활성화·업데이트 실패 때문에 기존 migration과 데이터를 자동 삭제하지 않습니다.
- 필수 초기화는 설치 과정에서 자동 실행되며 반복해도 사용자 수정값과 기존 데이터를 보존해야 합니다. 데모 fixture는 명시적으로 선택한 개발 작업입니다.
- 공개 필드·필터·이벤트·권한·명령의 변경을 검토합니다. 버전 숫자를 올린 것만으로 기존 소비자와 호환되지 않는 변경이 허용되지는 않습니다.
- 필수 의존 앱의 존재와 사용 가능한 버전을 확인합니다. 비밀값·고객 데이터·Core 코드·타사 앱 소스를 제출본에 포함하지 않습니다.
App revision, 의존성 lock, 실제 검사 결과와 변경 영향을 제출 설명에 남깁니다. 아직 실행하지 않은 검사를 성공으로 적지 않습니다.
GitHub 저장소 연결
정식 제출에는 제출할 저장소에 Nexia GitHub App을 설치하고 접근을 허용하는 과정이 필수입니다. GitHub 로그인용 OAuth App과는 별개입니다. 이미 해당 저장소에 설치되어 있으면 다시 설치하지 않아도 됩니다.
- Console의 앱에서 버전 제출 → 저장소 연결·변경을 선택하고 GitHub 인증을 진행합니다. CLI에서는
nexia submit로 같은 화면을 엽니다. - GitHub에서 Nexia App 설치·접근 설정을 누르고 본인 계정 또는 저장소가 속한 조직을 선택합니다.
- 제출할 저장소를 선택해 설치하거나 기존 설치에 저장소 접근을 추가합니다. 조직 정책상 설치 승인이 필요하면 조직 관리자에게 승인을 요청합니다.
- Console로 돌아와 저장소 새로고침 → 이 저장소 연결을 선택합니다. 연결하려는 저장소의 관리 권한이 필요합니다.
연결이 없거나 접근이 철회된 상태에서 nexia submit을 실행하면 설치·접근 확인과 nexia submit 실행을 안내합니다. 개발자가 GitHub App을 새로 만들거나 웹훅 주소를 등록할 필요는 없습니다.
앱 하나에 저장소 하나를 연결합니다. 루트에 현행 표준 PHP/React 앱과 nexia.json이 있어야 합니다. 모노레포, 하위 경로, submodule, Git LFS는 지원하지 않습니다. 앱 등록·샌드박스 개발에는 연결이 필요 없지만 정식 제출에는 필수입니다.
자동 제출 켜기 이후 새 v + SemVer 태그를 push하면 심사에 접수됩니다. 기존 태그는 Console에서 직접 선택하거나 CLI로 제출하세요. GitHub Release는 필요하지 않으며 일반·주석 태그 모두 사용할 수 있습니다. 브랜치는 선택하지 않습니다.
취소·실패 복구
nexia submit cancel <submission-id>로 취소 가능한 제출을 취소합니다. 태그 삭제는 제출 취소가 아닙니다.
일시적인 소스 수집 장애는 nexia submit retry <submission-id>로 재시도할 수 있습니다. 빌드가 실패하면 표시된 원인을 확인하고 수정한 뒤 새 버전 태그를 제출하세요. 최초 제출 응답만 유실됐다면 출력된 동일 --request-id로 복구합니다. 이전 제출 중 결과 확인이 필요한 건은 개발자 지원에 문의하세요.
제출은 GitHub에 이미 올라간 태그를 사용합니다. 로컬 미커밋·미푸시 파일은 포함하지 않으며 개인 샌드박스가 꺼져 있어도 제출할 수 있습니다. 다음 버전은 진행 중인 심사를 덮어쓰지 않고 대기합니다.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.
자동 검사를 통과하면 상태가 succeeded로 표시됩니다. 관리자 승인과 게시는 별도 단계입니다. 새 상태를 확인하려면 CLI 0.2.0-alpha.48 이상으로 업데이트하세요.
검사 환경 업데이트 대기와 재검증
Core 0.8.169는 검사 도구 업데이트 중에도 제출과 고정된 커밋을 보관합니다. 태그를 바꾸거나 새 요청을 반복하지 말고 제출 상태의 대기 이유를 확인하세요. 호환 검사 도구가 준비되면 보관한 제출을 이어서 처리할 수 있습니다. 접수는 심사 통과를 뜻하지 않습니다.
Core 0.8.172부터 서버가 일시적인 플랫폼 검사 오류를 재시도 가능 상태로 표시할 수 있습니다. 상태를 확인한 뒤 기존 제출 ID로 실행하세요.
Core 0.8.185는 완료된 호환성 검사 실패도 기록하여 제출이 결과 반영을 기다리며 멈추지 않도록 합니다. 실패한 검사는 계속 심사와 게시를 차단합니다. 서버가 준비된 상태로 표시할 때만 재시도할 수 있으며 원래 실패 증거는 보존합니다.
nexia submit status <submission-id> --json
nexia submit retry <submission-id>현재 상태와 권한에 따라 재시도가 허용됩니다. 제출 소스와 원래 검사 기록을 유지하고 필수 검사를 모두 통과해야 합니다. 소스 수정에는 새 태그가 필요하며 앱 오류·관리자 승인·배포·설치를 재검증으로 건너뛸 수 없습니다. GitHub 제출 복구 안내와 Nexia CLI를 참고하세요.