로컬·Docker 개발
로컬과 앱 개발 컨테이너에서 같은 공개 CLI 흐름을 사용합니다.
로컬·Docker 개발
빠른 시작과 CLI 문서를 따르세요. 앱은 연결된 프로젝트 바로 아래에 있습니다. dev는 프로젝트 루트나 앱 내부에서 실행해도 전체 프로젝트를 감시합니다. 특정 앱만 실행하려면 --app을 사용합니다.
앱 데이터를 Nexia 제공 DB 대신 개발자 PC의 PostgreSQL에 두려면 첫 실행 전에 개발 앱에 로컬 PostgreSQL 사용하기를 따르세요. 기존 로컬 서버와 DBeaver 사용, 선택적 Docker 서버, 터널 및 마이그레이션 순서를 구분합니다.
기존 프로젝트에 참여하기
Console에서 초대를 수락하고 개발 환경의 프로젝트 연결 명령을 복사하세요. 앱들을 보관할 폴더에서 실행합니다.
mkdir my-project
cd my-project
nexia connect <project-id><project-id>는 Console의 값으로 바꿉니다. 브라우저에서 승인한 뒤 필요한 앱 저장소를 이 폴더 바로 아래에 clone하세요. 예를 들어 my-project/my-app/nexia.json이 있어야 합니다. 이미 연결된 폴더가 있으면 새로 만들지 말고 nexia status로 대상을 확인합니다.
각 앱 폴더에서 아래 의존성 설치를 마치고 프로젝트 폴더에서 nexia dev를 한 번 실행하세요. 팀원들은 같은 소스를 개발해도 각자의 샌드박스와 테스트 권한을 사용합니다.
dev는 켜 두세요. 새 앱은 두 번째 터미널의 같은 앱 폴더에서 nexia db migrate를 실행하고 완료된 뒤 엽니다. 이후 파일 저장만으로 migration을 적용하지 않으며, 준비되면 같은 명령을 다시 실행합니다.
로컬 개발
각 앱에서 composer install --no-scripts, npm install로 의존성을 설치한 뒤 nexia dev를 실행합니다. 생성된 Vite 감시기가 프런트를 빌드하고 PHP 소스는 승인된 샌드박스로 동기화합니다. 로컬 미리보기는 원격 권한을 부여하지 않습니다. 소스·의존성 오류를 수정하고 재시작하세요. 감시 중 연결 파일이나 인증을 변경하지 않습니다.
Docker
앱 생성기의 Dockerfile·compose.yaml은 유지합니다. 이미지를 빌드하고 서비스 셸에 들어갑니다.
docker compose build dev
docker compose run --rm --service-ports --entrypoint sh dev컨테이너에서 앱 의존성을 설치하고 nexia login <project-id>를 실행한 뒤 출력된 승인 URL을 브라우저로 엽니다. 이미 등록된 독립 앱 연결은 nexia dev --container로 개발할 수 있습니다. 새 앱은 프로젝트의 dev로 먼저 등록하거나, 프로젝트 전체와 앱들을 컨테이너에 마운트한 뒤 프로젝트 루트에서 연결해야 합니다. 미등록 앱 하나만 마운트한 폴더는 프로젝트 워크스페이스가 아닙니다.
인증은 해당 실행 환경에 속합니다. 인증 파일을 다른 환경으로 복사하지 마세요. 생성된 compose는 전용 CLI 볼륨과 호스트 loopback 포트를 유지합니다. 마운트를 바꾸기 전에 구성을 확인하세요.
중단과 복구
Ctrl+C는 로컬 감시를 종료하고 소스·데이터를 유지합니다. 원격 런타임, 샌드박스 만료, 준비 실패는 Developers에서 관리합니다. 진행 중 작업이나 활성 쓰기 임대가 새 실행을 막을 수 있습니다. 데이터를 초기화하지 말고 기존 결과를 확인하세요. 원인을 해결한 뒤 nexia dev로 재개합니다.
플랫폼 관리자가 제공한 대체 서버를 사용할 때만 해당 환경에서 로그인·연결 전에 NEXIA_ENDPOINT를 지정합니다. 이미 연결된 프로젝트는 저장된 서버를 유지합니다. 브라우저 승인 대상 프로젝트를 확인하세요.
개발 세션 확인
nexia dev가 출력한 워크스페이스 URL을 여세요. 대상 프로젝트와 앱을 확인한 뒤 레코드를 생성하고 다시 엽니다. 권한이 부족하면 워크스페이스 설정의 역할·접근에서 부여하세요. 로컬 감시 프로세스를 재시작해도 저장된 기록이 유지되는지 확인하세요. 로컬 소스 검사만으로 원격 런타임의 실행 가능 여부가 검증되지는 않습니다.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.