다음을 통해 공유

Azure Static Web Apps CLI 구성

Important

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

Azure SWA(Static Web Apps) CLI는 다음 두 가지 방법 중 하나로 정적 웹앱에 대한 구성 정보를 가져옵니다.

  • CLI 옵션(런타임에 전달됨)
  • swa-cli.config.json이라는 CLI 구성 파일

참고 항목

기본적으로 SWA CLI는 현재 디렉터리에서 swa-cli.config.json 이라는 구성 파일을 찾습니다.

구성 파일에는 각각 고유한 구성 이름으로 식별되는 여러 구성이 포함될 수 있습니다.

  • swa-cli.config.json 파일에 단일 구성만 있는 경우 swa start는 기본적으로 이를 사용합니다.

  • 구성 파일에서 옵션을 로드하면 명령줄 옵션이 무시됩니다.

구성 파일 예

다음 코드 조각은 구성 파일의 모양을 보여줍니다.

{
  "configurations": {
    "app": {
      "appDevserverUrl": "http://localhost:3000",
      "apiLocation": "api",
      "run": "npm run start",
      "swaConfigLocation": "./my-app-source"
    }
  }
}

이 예제와 같이 구성 섹션이 하나만 있는 경우 swa start 명령은 이러한 값을 자동으로 사용합니다.

구성 파일 초기화

swa init 명령을 사용하여 구성 파일을 초기화할 수 있습니다. 기존 프로젝트에 대해 명령을 실행하는 경우 swa init가 구성 설정을 추측하려고 시도합니다.

기본적으로 이 프로세스는 프로젝트의 현재 작업 디렉터리에 있는 swa-cli.config.json에서 이러한 설정을 만듭니다. 이 디렉토리는 프로젝트 구성 값을 검색할 때 swa에서 사용하는 기본 파일 이름 및 위치입니다.

swa --config <PATH>

파일에 명명된 구성이 하나만 포함된 경우 기본적으로 이 구성을 사용합니다. 여러 구성이 정의된 경우 원하는 구성 이름을 옵션으로 전달합니다.

swa --<CONFIG_NAME>

구성 파일 옵션을 사용하면 설정이 JSON 형식으로 저장됩니다. 만든 후에는 수동으로 파일을 편집하여 설정을 업데이트하거나 swa init를 사용하여 업데이트할 수 있습니다.

구성 보기

Static Webs CLI는 현재 구성을 검토할 수 있도록 --print-config 옵션을 제공합니다.

다음은 기본 설정을 사용하여 새 프로젝트에서 실행할 때 출력이 어떻게 표시되는지에 대한 예입니다.

swa --print-config

Options:
 - port: 4280
 - host: localhost
 - apiPort: 7071
 - appLocation: .
 - apiLocation: <undefined>
 - outputLocation: .
 - swaConfigLocation: <undefined>
 - ssl: false
 - sslCert: <undefined>
 - sslKey: <undefined>
 - appBuildCommand: <undefined>
 - apiBuildCommand: <undefined>
 - run: <undefined>
 - verbose: log
 - serverTimeout: 60
 - open: false
 - githubActionWorkflowLocation: <undefined>
 - env: preview
 - appName: <undefined>
 - dryRun: false
 - subscriptionId: <undefined>
 - resourceGroupName: <undefined>
 - tenantId: <undefined>
 - clientId: <undefined>
 - clientSecret: <undefined>
 - useKeychain: true
 - clearCredentials: false
 - config: swa-cli.config.json
 - printConfig: true

swa --print-config를 실행하면 현재 구성 기본값이 제공됩니다.

참고 항목

프로젝트가 아직 구성 파일을 정의하지 않은 경우 구성 파일을 만드는 데 도움이 되도록 swa init 워크플로를 자동으로 트리거합니다.

구성의 유효성 검사

다음 스키마에 대해 swa-cli.config.json 파일의 유효성을 검사할 수 있습니다. https://aka.ms/azure/static-web-apps-cli/schema

  • Last updated on