컨텐츠로 건너뛰기

Astro 사이트를 Zerops에 배포

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

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

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

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

Zerops의 Astro Static 사이트

섹션 제목: Zerops의 Astro Static 사이트

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라는 프로젝트가 생성됩니다.

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

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

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

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

섹션 제목: 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라는 프로젝트가 생성됩니다.

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

zerops.yml
# 전체 참조를 확인하기 위해 https://docs.zerops.io/references/zeropsyml 를 방문하세요.
- 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)를 사용하는 파이프라인 트리거

섹션 제목: Zerops CLI (zcli)를 사용하는 파이프라인 트리거
  1. Zerops CLI를 설치합니다.

    Terminal window
    # zcli 바이너리를 직접 다운로드하려면,
    # https://github.com/zeropsio/zcli/releases 를 방문하세요.
    npm i -g @zerops/zcli
  2. Zerops 앱에서 Settings > Access Token Management를 열고 새 액세스 토큰을 생성합니다.

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

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

    Terminal window
    zcli push

더 많은 배포 안내서