Azure Static Web Apps CLI 구성

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

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

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

• 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-cli.config.json 파일의 유효성을 검사할 수 있습니다. https://aka.ms/azure/static-web-apps-cli/schema