컨텐츠로 건너뛰기

Astro 사이트를 Clever Cloud에 배포하기

Clever Cloud는 자동화되고 확장 가능한 서비스를 제공하는 유럽의 클라우드 플랫폼입니다.

완전히 정적인 프로젝트 및 주문형으로 렌더링된 Astro 프로젝트를 모두 Clever Cloud에 배포할 수 있습니다. output 모드 (사전 렌더링 또는 주문형)에 관계없이 포스트 빌드 훅을 사용하여 실행되는 정적 애플리케이션으로 배포하거나 package.json과 함께 즉시 작동하는 Node.js 애플리케이션으로 배포할 수 있습니다.

Clever Cloud의 애플리케이션은 8080 포트에서 수신을 대기합니다. 프로젝트에 이 구성이 필요한 경우, 다음 두 위치 중 하나에서 Astro의 포트와 호스트를 설정하세요:

  1. package.json 스크립트에서:

    package.json
    "scripts": {
    "dev": "astro dev",
    "start": "astro dev",
    "build": "astro check && astro build",
    "preview": "astro preview --host 0.0.0.0 --port 8080",
    "astro": "astro"
    }
  2. astro.config.mjs에서:

    astro.config.mjs
    import { defineConfig } from 'astro/config';
    export default defineConfig({
    server: {
    port: 8080,
    host: true
    }
    });

Astro 프로젝트를 Clever Cloud에 배포하려면 새 애플리케이션을 생성해야 합니다. 애플리케이션 마법사가 필요한 구성 단계를 안내합니다.

  1. 측면 메뉴 표시줄에서 Create > An application을 클릭합니다.

  2. 배포 방법을 선택합니다:

    • Create a brand new app: Git을 사용하여 로컬 저장소로 배포하기 위해

    또는

    • Select a GitHub repository: GitHub로 배포하기 위해
  3. Node.js 애플리케이션 또는 static 애플리케이션을 선택합니다.

  4. 인스턴스 및 확장성 옵션의 최소 크기를 설정합니다. Astro 사이트는 일반적으로 Nano 인스턴스를 사용하여 배포할 수 있습니다. 프로젝트의 사양과 종속성에 따라 Overview 페이지에서 메트릭을 보면서 적절히 조정해야 할 수도 있습니다.

  5. 인스턴스를 배포할 region을 선택합니다.

  6. 데이터베이스나 Keycloak를 사용하지 않는 한 Clever 애플리케이션에 Add-ons 연결하기를 건너뛰세요.

  7. environment variables를 삽입합니다:

    • Node.js의 경우, npm을 사용한다면 Astro를 배포하는 데 특정 환경 변수가 필요하지 않습니다. yarn 또는 pnpm을 사용하는 경우, 다음 환경 변수를 설정하세요:
    터미널 창
    CC_NODE_BUILD_TOOL="custom"
    CC_PRE_BUILD_HOOK="npm install -g pnpm && pnpm install"
    CC_CUSTOM_BUILD_TOOL="pnpm run astro telemetry disable && pnpm build"
    CC_RUN_COMMAND="pnpm run preview"
    • static 애플리케이션의 경우, 다음 변수를 추가합니다:
    터미널 창
    CC_POST_BUILD_HOOK="npm run build"
    CC_PRE_BUILD_HOOK="npm install && npm run astro telemetry disable"
    CC_WEBROOT="/dist"
  8. 배포! GitHub에서 배포하는 경우 배포가 자동으로 시작됩니다. Git을 사용하는 경우, 원격 저장소를 복사하여 master 브랜치에 푸시하세요.

더 많은 배포 안내서

기여하기

여러분의 생각을 들려주세요!

GitHub Issue 생성

우리에게 가장 빨리 문제를 알려줄 수 있어요.

커뮤니티