Astro 사이트를 Seenode에 배포

Seenode는 데이터베이스, 내장된 관찰 기능, 자동 확장이 포함된 웹 애플리케이션을 빌드하고 배포하기 위한 배포 플랫폼입니다. Astro 사이트는 서버 측 렌더링(SSR)을 사용하여 Seenode에 배포할 수 있습니다.

이 가이드에는 웹 인터페이스를 통해 Seenode에 배포하는 방법에 대한 지침이 포함되어 있습니다.

프로젝트 구성

SSR용 어댑터

Astro 프로젝트에서 요청 시 렌더링을 활성화하고 Seenode에 배포하려면 다음 astro add 명령을 사용하여 Node.js 어댑터를 추가하세요. 이렇게 하면 어댑터가 설치되고 astro.config.mjs 파일에 필요한 변경 사항이 한번에 적용됩니다.

npx astro add node

pnpm astro add node

yarn astro add node

어댑터를 설치한 후 Seenode의 요구 사항에 맞게 서버를 구성하도록 astro.config.mjs를 업데이트하세요.

import { defineConfig } from 'astro/config';
import node from '@astrojs/node';

export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'standalone'
  }),
  server: {
    port: process.env.NODE_ENV === 'production' ? (Number(process.env.PORT) || 80) : 4321,
    host: true
  }
});

빌드된 서버를 실행하는 시작 스크립트를 포함하도록 package.json을 업데이트하세요.

{
  "scripts": {
    "dev": "astro dev",
    "build": "astro build",
    "preview": "astro preview",
    "start": "NODE_ENV=production node ./dist/server/entry.mjs"
  }
}

자세한 구성 옵션 및 문제 해결은 Seenode의 Astro 배포 가이드를 참조하세요.

배포 방법

Git 리포지토리를 연결하여 웹 인터페이스를 통해 Seenode에 배포할 수 있습니다.

웹 인터페이스 배포

Seenode 계정을 생성하고 로그인합니다.
코드를 Git 리포지토리(GitHub 또는 GitLab)에 푸시합니다.
Seenode 대시보드에서 새 Web Service를 생성하고 리포지토리를 연결합니다.
Seenode는 자동으로 Astro 프로젝트를 감지합니다. 배포 설정을 구성하세요.
- Build Command: npm ci && npm run build (또는 pnpm / yarn 등을 사용합니다.)
- Start Command: npm start
- Port: 80 (웹 서비스에서 필수)
선호하는 인스턴스 크기를 선택하고 Create Web Service를 클릭합니다.
애플리케이션이 빌드 및 배포됩니다. 작업이 완료되면 실시간 Astro 사이트에 액세스할 수 있는 URL을 받게 되며, 이후 도메인을 연결할 수 있습니다.