콘텐츠로 이동

Sevalla에 Astro 사이트 배포하기

Sevalla는 정적 사이트, 애플리케이션 및 데이터베이스를 위한 올인원 호스팅 및 관리 플랫폼입니다.

이 가이드는 Astro 프로젝트를 Sevalla에 배포하는 방법을 자세히 설명합니다.

Sevalla의 정적 사이트 호스팅은 사이트를 글로벌 엣지 네트워크에 직접 배포합니다.

  1. Sevalla 대시보드에서 새 정적 사이트를 생성합니다.

  2. Git 리포지토리(GitHub, GitLab 또는 Bitbucket)를 연결합니다.

  3. 리포지토리 및 브랜치(예: main)를 선택합니다.

  4. 빌드 설정을 구성합니다:

    • Build command: npm run build
    • Publish directory: dist
  5. Create Static Site을 클릭하여 배포합니다.

Sevalla의 애플리케이션 호스팅은 풀스택 애플리케이션을 지원합니다. Node.js 어댑터를 통해 주문형 렌더링(서버 측 렌더링)을 사용하여 Astro 프로젝트를 배포할 수 있습니다.

  1. Astro 프로젝트에 @astrojs/node 어댑터를 추가합니다.

    터미널 창
    npx astro add node
  2. astro.config.mjs에서 어댑터를 구성합니다. mode: 'standalone'으로 설정하고, 서버가 모든 주소에서 수신하도록 host: true가 설정되어 있는지 확인합니다(컨테이너화된 환경에 필요).

    astro.config.mjs
    import { defineConfig } from 'astro/config';
    import node from '@astrojs/node';
    export default defineConfig({
    output: 'server',
    adapter: node({
    mode: 'standalone'
    }),
    server: {
    host: true
    }
    });
  3. package.json에 빌드된 서버를 실행하는 start 스크립트가 있는지 확인합니다:

    package.json
    "scripts": {
    "start": "node ./dist/server/entry.mjs"
    }
  4. Sevalla 대시보드에서 새 애플리케이션을 생성합니다.

  5. Git 리포지토리를 연결합니다.

  6. 빌드 설정을 구성합니다:

    • Build Method: Sevalla는 Node.js 프로젝트를 자동으로 감지합니다(Nixpacks를 통해).
    • Build command: npm run build
    • Start command: npm run start
  7. Create Application을 클릭하여 배포합니다.

Sevalla 대시보드의 빌드 로그에서 오류 메시지를 확인하세요. 모든 종속성이 dependencies에 있는지 확인하세요(런타임에 필요한 경우 devDependencies에 있지 않아야 함).

Sevalla에서 선택한 Node.js 버전이 로컬 개발 버전과 일치하는지 확인하세요(node -v로 확인).

더 많은 배포 가이드

기여하기 커뮤니티 후원하기