Azure Static Web Apps CLI 개요
Important
Static Web Apps CLI에서 배포 보안을 강화하기 위해 2025년 1월 15일까지 Static Web Apps CLI의 최신 버전(2.0.2)으로 업그레이드해야 하는 호환성이 손상되는 변경이 도입되었습니다.
Azure Static Web Apps 웹 사이트는 클라우드에서 호스트되며 종종 클라우드 서비스 컬렉션을 함께 연결합니다. 개발 중에 로컬로 앱을 실행해야 할 때마다 클라우드에서 앱이 실행되는 방식을 모방하는 도구가 필요합니다.
SWA CLI(Static Web Apps CLI)에는 Azure에서 앱이 실행되는 방식을 대략적으로 설명하는 일련의 로컬 서비스가 포함되어 있지만, 대신 컴퓨터에서만 실행됩니다.
Azure Static Web Apps CLI는 다음 서비스를 제공합니다.
- 로컬 정적 사이트 서버
- 프런트 엔드 프레임워크 개발 서버에 대한 프록시
- API 엔드포인트에 대한 프록시 - Azure Functions Core Tools를 통해 사용 가능
- 모의 인증 및 권한 부여 서비스
- 로컬 경로 및 구성 설정 적용
작동 방식
다음 차트에서는 요청을 로컬로 처리하는 방법을 보여 줍니다.
Important
http://localhost:4280으로 이동하여 CLI에서 제공하는 애플리케이션에 액세스합니다.
포트
4280으로 전송되는 요청은 요청 형식에 따라 적합한 서버로 전달됩니다.HTML 또는 CSS와 같은 정적 콘텐츠 요청은 내부 CLI 정적 콘텐츠 서버에서 처리되거나 디버깅을 위해 프런트 엔드 프레임워크 서버에서 처리됩니다.
인증 및 권한 부여 요청은 애플리케이션에 가짜 ID 프로필을 제공하는 에뮬레이터에서 처리됩니다.
Functions Core Tools 런타임1은 사이트의 API에 대한 요청을 처리합니다.
모든 서비스의 응답은 모두 단일 애플리케이션처럼 브라우저에 반환됩니다.
UI와 Azure Functions API 앱을 독립적으로 시작하면 Static Web Apps CLI를 시작하고 다음 명령을 사용하여 실행 중인 앱을 가리킵니다.
swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071
필요에 따라 swa init 명령을 사용하는 경우 Static Web Apps CLI는 애플리케이션 코드를 살펴보고 CLI에 대한 swa-cli.config.json 구성 파일을 빌드합니다. swa-cli.config.json 파일을 사용하는 경우 swa start를 실행하여 애플리케이션을 로컬로 시작할 수 있습니다.
1 Azure Functions Core Tools는 시스템에 아직 설치되지 않은 경우 CLI에 의해 자동으로 설치됩니다.
시작하기
다음 리소스를 사용하여 Static Web Apps CLI 작업을 시작합니다.
| 리소스 | 설명 |
|---|---|
| SWA CLI(Static Web Apps CLI) 설치 | 컴퓨터에 Azure Static Web Apps CLI를 설치합니다. |
| 환경 구성 | 애플리케이션이 구성 정보를 읽는 방법을 설정합니다. |
| 웹 사이트 에뮬레이터 시작 | 웹사이트를 로컬로 제공하려면 서비스를 시작합니다. |
| 로컬 API 서버 시작 | API 엔드포인트를 로컬로 제공하려면 서비스를 시작합니다. |
| Azure에 배포 | Azure의 프로덕션 환경에 애플리케이션을 배포합니다. |
참고 항목
일반적으로 프런트 엔드 프레임워크를 사용하여 빌드된 사이트에서는 api 경로에서 요청을 올바르게 처리하려면 프록시 구성 설정이 필요합니다. Azure Static Web Apps CLI를 사용하는 경우 프록시 위치 값은 /api이고 CLI를 사용하지 않는 경우 값은 http://localhost:7071/api입니다.