Static Web Apps CLI 에뮬레이터 시작

Important

Static Web Apps CLI에서 배포 보안을 강화하기 위해 2025년 1월 15일까지 Static Web Apps CLI의 최신 버전(2.0.2)으로 업그레이드해야 하는 호환성이 손상되는 변경이 도입되었습니다.

Static Web Apps는 웹앱을 호스트하고 실행하는 클라우드 기반 플랫폼입니다. 앱을 로컬로 실행하는 경우 앱이 클라우드에서 실행되는 방식을 대략적으로 파악하는 데 도움이 되는 특별한 도구가 필요합니다.

SWA CLI(Static Web Apps CLI)에는 앱이 Azure에서 실행되는 방식을 모방하는 에뮬레이터가 포함되어 있지만 대신 컴퓨터에서만 실행됩니다.

swa start 명령은 기본 설정으로 에뮬레이터를 시작합니다. 기본적으로 에뮬레이터는 포트 4280을 사용합니다.

개별 명령에 대한 자세한 내용은 CLI 참조를 참조하세요.

파일 시스템의 정적 파일 제공

SWA CLI를 사용하면 다른 필수 도구 없이 파일 시스템의 정적 콘텐츠를 직접 제공할 수 있습니다. 현재 디렉터리 또는 특정 폴더에서 정적 콘텐츠를 제공할 수 있습니다.

제공처...	명령	주의
현재 폴더	`swa start`	기본적으로 CLI는 현재 작업 디렉터리에서 정적 콘텐츠(HTML, 이미지, 스크립트 및 CSS 파일)를 시작하고 제공합니다.
특정 폴더	`swa start ./my-dist`	동작을 재정의하여 다른 정적 자산 폴더로 에뮬레이터를 시작할 수 있습니다.

앱의 프런트 엔드를 개발할 때 프레임워크의 기본 개발 서버를 사용해야 할 수 있습니다. 프레임워크의 서버를 사용하면 라이브 다시 로드 및 HMR(핫 모듈 교체)와 같은 이점을 활용할 수 있습니다.

예를 들어 Angular 개발자는 종종 ng serve 또는 npm start를 사용하여 개발 서버를 실행합니다.

SWA(Static Web Apps) CLI를 개발 서버에 대한 프록시 요청으로 설정할 수 있습니다. 그러면 Static Web Apps CLI와 동시에 작업하면서 프레임워크 CLI의 이점을 모두 얻을 수 있습니다.

SWA CLI와 함께 프레임워크의 개발 서버를 사용하는 두 가지 단계가 있습니다.

참고 항목

<DEV_SERVER_URL> 자리 표시자를 사용자의 값으로 바꿔야 합니다.

SWA CLI에서 개발 서버를 시작하게 하여 워크플로를 더욱 간소화할 수 있습니다.

사용자 지정 명령을 swa start 명령의 --run 매개 변수로 전달할 수 있습니다.

swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>

다음은 몇 가지 다른 프레임워크를 사용하여 에뮬레이터를 시작하는 몇 가지 예입니다.

프레임워크	명령
React	`swa start http://localhost:3000 --run "npm start"`
Blazor	`swa start http://localhost:5000 --run "dotnet watch run"`
Jekyll	`swa start http://localhost:4000 --run "jekyll serve"`

개발 서버를 시작할 때 사용자 지정 스크립트를 실행하려는 경우에도 --run 매개 변수를 사용할 수 있습니다.

swa start http://localhost:4200 --run "./startup.sh"

위의 명령을 사용하여 http://localhost:4280에서 에뮬레이트된 서비스를 통해 애플리케이션에 액세스합니다.