> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ale.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Vanilla app

> Node.js 애플리케이션 배포 가이드입니다.

***

## 준비 및 확인사항

<AccordionGroup>
  <Accordion title="지원 Node.js 버전" defaultOpen={true}>
    * **8, 10, 12, 14, 16, 18, 20**
  </Accordion>
</AccordionGroup>

<Warning>
  프로젝트 설정 파일(package.json, .nvmrc 등)에 명시된 Node.js 버전과 배포 설정 시 선택한 버전이 일치하지 않으면 빌드 및 런타임 오류가 발생할 수 있습니다.
</Warning>

## 템플릿과 저장소 선택

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/node_02.png" />
</Frame>

> 대시보드의 <Icon icon="circle-plus" iconType="solid" size={15} color="2396F1" /> 또는 `⌘ + K` 로 생성되는 배포창에서 **Node.js** 템플릿을 선택하고, 이어지는 드롭다운 메뉴에서 연동된 GitHub 계정의 저장소를 선택하거나 [Git URL 탭에서 Git 저장소 URL을 입력하세요.](/developers/private-repo)

## 배포 설정값 입력

> 다음의 각 항목에 서비스를 배포하기 위한 설정값을 입력하세요.

<AccordionGroup>
  <Accordion title="기본 항목">
    * **버전**
    * [환경 변수](/developers/env)
    * **포트번호**: `3000`(기본값)
    * **Install Command**: npm/yarn 패키지 설치 명령어
    * **Build Command**: npm/yarn 빌드 명령어
    * **Start Command**: node 실행 명령어
    * [Health Check](/developers/zero-downtime-deployment): 컨테이너 상태 검증 엔드포인트
  </Accordion>

  <Accordion title="더 많은 옵션">
    * **Build Variables**: 컨테이너 이미지 빌드 시 포함되어야 하는 변수
    * **Update strategy**
      * **Rolling Update**: 새로운 버전의 서비스 배포 시점에 기존 파드 종료, 노드 가용자원 확보 필요
      * **Recreate**: 모든 서비스 종료후 새로운 버전의 서비스를 생성 및 구동하여 다운타임 발생
    * **.npmrc**: npm 패키지 레지스트리 경로, 프록시 등 설정
  </Accordion>
</AccordionGroup>

## 성능(리소스) 설정 및 배포

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/08_04.png" />
</Frame>

* **리소스 유형** : [온디맨드 리소스와 스팟 리소스](/ko/developers/resource#on-demand-spot) 중 선택

* **CPU** : 서비스가 사용할 수 있는 vCPU 리소스의 최대값으로, '최소' 선택 시 0.1 vCPU로 설정됩니다.

* **메모리** : 서비스가 사용할 수 있는 메모리 리소스의 최대값

* [동시실행(레플리카)](/ko/developers/replica) : 설정한 수만큼 서비스가 수평확장되어 부하 분산 및 안정성 확보

* **배포** : `배포하기` 클릭

<Info>
  배포가 완료되면 프리뷰 도메인을 통해 브라우저로 웹 페이지를 조회하거나 API 툴을 사용해 요청을 보낼 수 있습니다.
</Info>

<Tip>
  리소스 제한으로 배포할 수 없는 경우 [스페이스 및 리소스 관리 페이지](/ko/operations/spaces#%EB%A6%AC%EC%86%8C%EC%8A%A4-%EB%B6%80%EC%97%AC%ED%95%98%EA%B8%B0)를 참고해 스페이스에 리소스를 추가하세요.
</Tip>

***

[Node.js Docs](https://nodejs.org/en/docs)