애플리케이션 설정에는 데이터베이스 연결 문자열과 같이 변경될 수 있는 구성 값이 포함됩니다. 애플리케이션 설정을 추가하면 애플리케이션 코드를 변경하지 않고도 앱에 대한 구성 입력을 수정할 수 있습니다.
애플리케이션 설정:
., _만 포함 가능이 문서에서 설명하는 애플리케이션 설정은 Azure Static Web App의 백 엔드 API에만 적용됩니다.
프런트 엔드 웹 애플리케이션을 빌드하는 데 필요한 환경 변수를 구성하려면 빌드 구성을 참조하세요.
Azure Static Web Apps의 API는 Azure Functions로 제공되며, 이를 통해 애플리케이션을 로컬로 실행할 때 local.settings.json 파일에서 애플리케이션 설정을 정의할 수 있습니다. 이 파일은 구성의 Values 속성에서 애플리케이션 설정을 정의합니다.
참고 항목
local.settings.json 파일은 로컬 개발에만 사용됩니다. Azure Portal을 사용하여 프로덕션에 대한 애플리케이션 설정을 구성합니다.
다음 샘플 local.settings.json에서는 DATABASE_CONNECTION_STRING에 대한 값을 추가하는 방법을 보여 줍니다.
{
"IsEncrypted": false,
"Values": {
"AzureWebJobsStorage": "",
"FUNCTIONS_WORKER_RUNTIME": "node",
"DATABASE_CONNECTION_STRING": "<YOUR_DATABASE_CONNECTION_STRING>"
}
}
Settings defined in the Values property can be referenced from code as environment variables. In Node.js functions, for example, they're available in the process.env object.
const connectionString = process.env.DATABASE_CONNECTION_STRING;
The local.settings.json file isn't tracked by the GitHub repository because sensitive information, like database connection strings, are often included in the file. Since the local settings remain on your machine, you need to manually configure your settings in Azure.
Generally, configuring your settings is done infrequently, and isn't required with every build.
Azure Portal 또는 Azure CLI를 통해 애플리케이션 설정을 구성할 수 있습니다.
Important
이 문서에서 설명하는 애플리케이션 설정은 Azure Static Web App의 백 엔드 API에만 적용됩니다.
프런트 엔드 웹 애플리케이션을 빌드하는 데 필요한 환경 변수를 구성하려면 빌드 구성을 참조하세요.
Azure Portal은 애플리케이션 설정을 만들고 업데이트하고 삭제하기 위한 인터페이스를 제공합니다.
Azure Portal로 이동합니다.
정적 웹앱을 엽니다.
설정 섹션에서 환경 변수를 선택합니다.
환경 변수를 만들 환경을 선택합니다. 환경별로 변수를 만들 수 있습니다. 끌어오기 요청을 만들면 스테이징 환경이 자동으로 만들어지고 끌어오기 요청을 병합할 때 프로덕션으로 승격됩니다.
새 환경 변수를 추가하려면 + 추가를 선택합니다.
이름 및 값 상자에 값을 입력합니다.
적용을 선택합니다.
다시 적용을 선택하여 변경 내용을 저장합니다.
az staticwebapp appsettings 명령을 사용하여 Azure에서 설정을 업데이트합니다.
터미널 또는 명령줄에서 다음 명령을 실행하여 message라는 설정을 Hello world 값으로 추가하거나 업데이트합니다. 자리 표시자 <YOUR_APP_ID>를 사용자의 값으로 바꿔야 합니다.
az staticwebapp appsettings set --name <YOUR_APP_ID> --setting-names "message=Hello world"
Tip
You can add or update multiple settings by passing multiple name-value pairs to --setting-names.
In a terminal or command line, execute the following command. Make sure to replace the placeholder <YOUR_APP_ID> with your value.
az staticwebapp appsettings list --name <YOUR_APP_ID>
In a terminal or command line, execute the following command to delete a setting named message. Make sure to replace the placeholder <YOUR_APP_ID> with your value.
az staticwebapp appsettings delete --name <YOUR_APP_ID> --setting-names "message"
Tip
Delete multiple settings by passing multiple setting names to --setting-names.