컨텐츠로 건너뛰기

Astro 사이트를 Microsoft Azure에 배포하세요

Azure는 Microsoft의 클라우드 플랫폼입니다. Microsoft Azure의 Static Web Apps 서비스를 사용하여 Astro 사이트를 배포할 수 있습니다.

이 안내서에서는 Visual Studio Code를 사용하여 GitHub에 저장된 Astro 사이트를 배포하는 과정을 안내합니다. 다른 설정에 대해서는 Azure Pipelines Task 사용에 대한 Microsoft 안내서를 참조하세요.

전제 조건

이 안내서를 따르려면 다음이 필요합니다.

Azure 계정 및 구독 키가 필요합니다. 여기에서 무료 Azure 계정을 생성할 수 있습니다.
GitHub에 푸시된 앱 코드가 필요합니다.
Visual Studio Code의 SWA 확장이 필요합니다.

배포 방법

VS Code에서 프로젝트를 엽니다.
Static Web Apps 확장을 열고 Azure에 로그인한 후 + 버튼을 클릭하여 새 Static Web App을 만듭니다. 사용할 구독 키를 지정하라는 메시지가 표시됩니다.
확장 프로그램에서 시작하는 마법사를 따라 앱 이름을 지정하고, 프레임워크 사전 설정을 선택하고, 앱 루트 (보통 /)와 빌드된 파일 위치 (/dist 사용)를 지정합니다. Astro는 Azure의 기본 제공 템플릿에 포함되어 있지 않으므로 custom을 선택해야 합니다. 마법사가 실행되고 저장소의 .github 폴더에 GitHub Action이 생성됩니다. (이 폴더가 아직 존재하지 않는 경우 자동으로 생성됩니다.)

GitHub Action이 앱을 배포합니다 (GitHub 저장소의 Actions 탭에서 진행 상황을 확인할 수 있습니다). 성공적으로 완료되면 Browse Website 버튼을 클릭하여 SWA Extension의 진행률 창에 표시된 주소에서 앱을 볼 수 있습니다 (GitHub Action이 실행된 후에 표시됨).

알려진 문제

생성된 GitHub action yaml은 노드 14를 사용한다고 가정합니다. 이는 Astro 빌드가 실패함을 의미합니다. 이 문제를 해결하려면 프로젝트 package.json 파일을 이 코드로 업데이트하세요.

  "engines": {
    "node": ">=18.0.0"
  },

공식 자료

Microsoft Azure Static Web Apps 문서

커뮤니티 자료

더 많은 배포 안내서