컨텐츠로 건너뛰기
This is an unmaintained snapshot of the Astro v4 docs. View the latest docs.

Astro 사이트 배포

Astro 사이트를 구축하고 배포할 준비가 되셨나요? 다양한 배포 서비스에 대한 안내서 중 하나를 따르거나 아래로 스크롤하여 Astro 사이트 배포에 대한 일반적인 지침을 확인하세요.

웹 사이트의 대시보드 UI 또는 CLI를 사용하여 Astro 사이트를 여러 호스트에 신속하게 빌드하고 배포할 수 있습니다.

웹 사이트를 배포하는 빠른 방법은 Astro 프로젝트의 온라인 Git 저장소(예: GitHub, GitLab, Bitbucket)를 호스트 공급자에 연결하고 Git을 사용하여 지속적인 배포를 활용하는 것입니다.

이러한 호스트 플랫폼은 Astro 프로젝트의 소스 저장소에 대한 푸시를 자동으로 감지하고 사이트를 빌드한 후 이를 사용자 정의 URL 또는 개인 도메인의 웹에 배포합니다. 이러한 플랫폼에서 배포를 설정하는 경우 다음과 같은 단계를 따르는 경우가 많습니다.

  1. 온라인 Git 제공업체(예: GitHub, GitLab, Bitbucket)에 저장소를 추가하세요.

  2. 지속적 배포(예: Netlify 또는 Vercel)을 지원하는 호스트를 선택하고 Git 저장소를 새로운 사이트/프로젝트로 가져옵니다.

    많은 일반 호스트는 여러분의 프로젝트를 Astro 사이트로 인식하고 아래와 같이 사이트를 빌드하고 배포하기 위한 적절한 구성 설정을 선택해야 합니다. (그렇지 않은 경우 이 설정을 변경할 수 있습니다.)

  3. “Deploy”를 클릭하면 해당 호스트의 고유 URL(예: new-astro-site.netlify.app)에 새 웹사이트가 생성됩니다.

호스트는 Git 공급자의 기본 브랜치에서 변경 사항을 감시하고 새로운 커밋이 있을 때마다 사이트를 다시 빌드하고 다시 게시하도록 자동으로 구성됩니다. 이러한 설정은 일반적으로 호스트 공급자의 대시보드 UI에서 구성할 수 있습니다.

일부 호스트에는 npm을 사용하여 컴퓨터에 전체적으로 설치할 수 있는 자체 명령줄 인터페이스(CLI)가 있습니다. CLI를 사용하여 배포하는 경우는 다음과 같은 경우가 많습니다.

  1. 호스트의 CLI를 전역적으로 설치합니다. 예:

    터미널 창
    npm install --global netlify-cli
  2. CLI를 실행하고 인증, 설정 등에 대한 지침을 따릅니다.

  3. 사이트를 빌드하고 호스트에 배포합니다.

    많은 일반 호스트가 여러분을 위해 사이트를 빌드하고 배포합니다. 그들은 일반적으로 여러분의 프로젝트를 Astro 사이트로 인식하고 아래와 같이 빌드 및 배포에 적합한 구성 설정을 선택해야 합니다. (그렇지 않은 경우 이 설정을 변경할 수 있습니다.)

    다른 호스트에서는 사이트를 로컬로 빌드하고 명령줄을 사용하여 배포해야 합니다.

Netlify 및 Vercel과 같은 많은 호스트는 여러분을 위해 사이트를 빌드한 다음 해당 빌드 결과물을 웹에 게시합니다. 그러나 일부 사이트에서는 로컬로 빌드한 다음 배포 명령을 실행하거나 빌드 결과물을 업로드해야 합니다.

사이트를 미리 보거나 사용자 환경에서 잠재적인 오류 및 경고를 포착하기 위해 로컬로 빌드할 수도 있습니다.

Astro 사이트를 빌드하려면 npm run build 명령을 실행하세요.

터미널 창
npm run build

기본적으로 빌드 결과물은 dist/ 디렉터리에 배치됩니다. 이 위치는 outDir 구성 옵션을 사용하여 변경할 수 있습니다.

기여하기

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

GitHub Issue 생성

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

커뮤니티