Analog
Analog의 Nitro SSR 출력 또는 미리 생성한 정적 사이트를 배포합니다.
나이트로쉽은 Analog의 Nitro 기반 Node 서버와 정적 출력을 지원합니다.
감지와 빌드 결과
- 감지 조건:
package.json의@analogjs/platform. 프로젝트의build스크립트를 둡니다. - 서버 빌드에는
BUILD_PRESET=node-server와NITRO_PRESET=node-server를 설정합니다. 자체 실행에 필요한 파일을 포함한dist/analog번들을node server/index.mjs로 실행하고,dist/analog/public은 CDN에 게시합니다. - 정적 빌드가
dist/analog/public을 만들고 서버 진입점은 만들지 않으면 이 폴더를 컴퓨트 없이 게시합니다. Analog의 정적 구성(static: true,ssr: false)도 여기에 해당합니다. - Analog의 출력 구조를 유지하세요. 커스텀 Nitro 엣지 대상이나 다른 구조는 직접 만든 Dockerfile이 필요합니다.
배포하기
CLI 설치
curl -fsSL https://nitroship.co/install.sh | bash
ntro login이미 설치했다면 다음 단계로 넘어가세요. 설치 옵션, PATH 설정 및 업데이트는 CLI 설치에서 확인하세요.
{
"build": {"framework": "analog"},
"compute": {"regions": ["kr-icn"]}
}build.framework를 적으면 자동 감지를 건너뛰고 이 프리셋을 씁니다. 루트에 Dockerfile이 있어도 마찬가지이고, build.dockerfile과는 함께 쓸 수 없습니다. 적지 않았을 때 어떤 순서로 감지하는지는 빌드 방식 선택에 정리해 두었습니다.
ntro apps create my-analog-app
ntro deploy . --prod의존성을 먼저 설치하면 ntro deploy . --prod --local로 내 컴퓨터에서 빌드할 수도 있습니다. 배포 후 CLI가 보여 준 주소에서 정적 파일과 서버 라우트를 열어 보세요.
알아둘 점
서버를 배포하려면 컴퓨트 리전을 정해야 합니다. 서버는 0.0.0.0:$PORT(기본 3000)에서 요청을 받아야 합니다. 클라이언트 자산은 CDN에서 내려가고, SSR과 API 요청은 Node 서버 하나가 모두 처리합니다. Next.js처럼 라우트마다 함수를 따로 나누지는 않습니다.
마이그레이션·큐 워커·스케줄러는 자동으로 실행하지 않습니다. 마이그레이션은 CI나 로컬에서 실행하고, 정기 작업은 예약 작업을 참고하세요. 업로드 파일은 S3 같은 오브젝트 스토리지에 저장하고, 비밀 값은 환경 변수로 설정하세요.
지원하는 어댑터나 출력 구조와 다른 구성이 필요하면 직접 만든 Dockerfile을 사용하세요. 이때 build.framework 설정을 빼고 Dockerfile에서 설치·빌드·실행을 정의합니다.