콘텐츠로 이동

Astro 사이트를 Zerops에 배포

Zerops는 Static 및 SSR Astro 사이트를 배포하는 데 사용할 수 있는 개발 우선 클라우드 플랫폼입니다.

이 가이드는 Zerops에서 Static 및 SSR Astro 사이트를 설정하고 배포하는 과정을 안내합니다.

:::tip[Astro x Zerops 빠르게 시작하기]

아무것도 설치하거나 설정하지 않고 Zerops에서 Astro 실행을 테스트하고 싶나요? Zerops x Astro - Static 또는 Zerops x Astro - Node.js SSR 저장소를 사용하면 예시 Astro 사이트를 클릭 한 번으로 배포할 수 있습니다.

:::

Zerops에서 앱을 실행하려면 다음 두 단계가 필요합니다.

  1. 프로젝트 생성
  2. 빌드 및 배포 파이프라인 트리거

:::note하나의 Zerops 프로젝트에는 여러 Astro 사이트가 포함될 수 있습니다.:::

Zerops의 Astro Static 사이트

Astro Static용 프로젝트 및 서비스 만들기

프로젝트와 서비스는 Project add 마법사를 통해 추가하거나 다음 yaml 구조를 사용하여 가져올 수 있습니다.

# 전체 참조를 확인하기 위해 https://docs.zerops.io/references/import 를 방문하세요.
project:
  name: recipe-astro
services:
  - hostname: app
    type: static

그러면 app이라는 Zerops Static 서비스를 사용하여 recipe-astro라는 프로젝트가 생성됩니다.

Astro Static 사이트 배포

Zerops에게 사이트 빌드 및 실행 방법을 알려주려면 'zerops.yml'을 저장소에 추가하세요.

 # 전체 참조를 확인하기 위해 https://docs.zerops.io/zerops-yml/specification 를 방문하세요.
 zerops:
   - setup: app
     build:
       base: nodejs@20
       buildCommands:
         - npm i
         - npm build
       deployFiles:
         - dist/~
     run:
       base: static

이제 Zerops CLI를 사용하거나 서비스 세부 세부 사항에서 GitHub / GitLab 저장소와 app 서비스를 연결하여 빌드 및 배포 파이프라인을 트리거할 수 있습니다.

Zerops의 Astro SSR 사이트

스크립트 업데이트

Node 어댑터에서 서버 출력을 실행하도록 start 스크립트를 업데이트하세요.

"scripts": {
  "start": "node ./dist/server/entry.mjs",
}

Astro SSR (Node.js)용 프로젝트 및 서비스 만들기

프로젝트와 서비스는 Project add 마법사를 통해 추가하거나 다음 yaml 구조를 사용하여 가져올 수 있습니다.

# 전체 참조를 확인하기 위해 https://docs.zerops.io/references/import 를 방문하세요.
project:
  name: recipe-astro
services:
  - hostname: app
    type: nodejs@20

그러면 app이라는 Zerops Node.js 서비스를 사용하여 recipe-astro라는 프로젝트가 생성됩니다.

Astro SSR 사이트 배포

standalone 모드에서 공식 Astro Node.js 어댑터를 사용하여 사이트를 빌드하고 실행하는 방법을 Zerops에게 알리려면 저장소에 zerops.yml 파일을 추가하세요.

 # 전체 참조를 확인하기 위해 https://docs.zerops.io/zerops-yml/specification 를 방문하세요.
   - setup: app
     build:
       base: nodejs@20
       buildCommands:
         - npm i
         - npm run build
       deployFiles:
         - dist
         - package.json
         - node_modules
     run:
       base: nodejs@20
       ports:
         - port: 3000
           httpSupport: true
       envVariables:
         PORT: 3000
         HOST: 0.0.0.0
       start: npm start

이제 Zerops CLI를 사용하거나 서비스 세부 세부 사항에서 GitHub / GitLab 저장소와 app 서비스를 연결하여 빌드 및 배포 파이프라인을 트리거할 수 있습니다.

Zerops CLI (zcli)를 사용하는 파이프라인 트리거

  1. Zerops CLI를 설치합니다.

    # zcli 바이너리를 직접 다운로드하려면,
# https://github.com/zeropsio/zcli/releases 를 방문하세요.
npm i -g @zerops/zcli

  2. Zerops 앱에서 Settings > Access Token Management를 열고 새 액세스 토큰을 생성합니다.

  3. 다음 명령으로 액세스 토큰을 사용하여 로그인합니다.

    zcli login <token>

  4. 앱의 루트 (zerops.yml이 있는 위치)로 이동하고 다음 명령을 실행하여 배포를 트리거합니다.

    zcli push

리소스

공식

커뮤니티

더 많은 배포 가이드

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