구성 데이터 가져오기 또는 내보내기

Azure App Configuration은 데이터 가져오기 및 내보내기 작업을 지원합니다. 해당 작업을 사용하여 구성 데이터를 대량으로 작업하고 App Configuration 저장소와 코드 프로젝트 간에 데이터를 교환할 수 있습니다. 예를 들어 테스트용으로 App Configuration 저장소 1개를 설정하고 프로덕션에 다른 App Configuration 저장소를 1개 설정할 수 있습니다. 데이터를 두 번 입력하지 않아도 되도록 두 저장소 간의 애플리케이션 설정을 복사할 수 있습니다.

이 문서에서는 App Configuration을 사용하여 데이터를 가져오고 내보내는 방법에 대한 지침을 제공합니다. GitHub 리포지토리와의 지속적인 동기화를 설정하려는 경우 GitHub 작업 및 Azure Pipeline 작업을 살펴보세요.

Azure Portal 또는 Azure CLI를 사용하여 데이터를 가져오거나 내보낼 수 있습니다.

데이터 가져오기

가져오기는 기존 소스의 App Configuration 저장소로 구성 데이터를 가져옵니다. 가져오기 함수를 사용하여 데이터를 App Configuration 저장소로 마이그레이션하거나 여러 소스에서 데이터를 집계합니다.

이 가이드에서는 App Configuration 데이터를 가져오는 방법을 보여 줍니다.

• Json, Yaml 또는 Properties의 구성 파일에서
• App Configuration 저장소에서
• Azure App Service에서

구성 파일에서 데이터 가져오기

파일에서 키-값을 가져오려면 아래 단계를 따릅니다.

참고 항목

파일에서 기능 플래그를 가져오는 것은 지원되지 않습니다. 구성 파일에 기능 플래그가 포함되어 있으면 자동으로 일반 키-값으로 가져옵니다.

포털

Azure Portal에서 다음 단계를 따릅니다.

1. App Configuration 저장소로 이동하고 작업 메뉴에서 가져오기/내보내기를 선택합니다.

   

2. 가져오기 탭에서 원본 서비스 아래의 구성 파일을 선택합니다.

3. 다음 매개 변수로 양식을 작성합니다.

   매개 변수	설명	예시
   언어	.NET, Java(Spring) 및 기타 간에 가져오는 파일의 언어를 선택합니다.	.NET
   파일 형식	Yaml, Properties 및 Json 중에서 가져올 파일 형식을 선택합니다.	Json

4. 폴더 아이콘을 선택하고 가져올 파일을 찾습니다.

   참고 항목

   파일을 성공적으로 가져왔다는 메시지가 화면에 표시됩니다.

5. 양식의 다음 부분을 작성합니다.

   매개 변수	설명	예시
   구분 기호	구분 기호는 가져온 구성 파일에서 구문 분석된 문자로, 구성 저장소에 추가될 키-값을 구분합니다. 다음 옵션 중 하나를 선택합니다. ., ,, :, ;, /, -, _, —	;
   접두사	선택 사항. 키 접두사는 키-값 “key” 속성의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다. 입력한 접두사는 이 파일에서 가져오는 모든 키-값의 “key” 속성 앞에 추가됩니다.	TestApp:
   Label	선택 사항. 기존 레이블을 선택하거나 가져온 키-값에 할당할 새 레이블을 입력합니다.	prod
   내용 유형	선택 사항. JSON 파일 또는 Key Vault 참조를 가져오는지 여부를 나타냅니다. Key Vault 참조에 대한 자세한 내용은 ASP.NET Core 앱에서 Key Vault 참조 사용으로 이동하세요.	JSON’(애플리케이션/json)’

6. 적용을 선택하여 가져오기를 진행합니다.

JSON 파일에서 키-값을 가져오고 "prod" 레이블과 "TestApp" 접두사를 할당했습니다. 구분 기호 “:”이 사용되며 가져온 모든 키-값의 콘텐츠 형식이 “JSON”으로 설정되었습니다.

Azure CLI

Azure CLI에서 아래 단계를 따릅니다. Azure CLI를 로컬로 설치하지 않은 경우 필요에 따라 Azure Cloud Shell을 사용할 수 있습니다.

1. 가져오기 명령 az appconfig kv import를 입력하고 다음 매개변수를 추가합니다.

   매개 변수	설명	예시
   --name	데이터를 가져올 App Configuration 저장소의 이름을 입력합니다.	my-app-config-store
   --source	파일에서 앱 구성 데이터를 가져오고 있음을 나타내려면 file을 입력합니다.	file
   --path	가져올 데이터가 포함된 파일의 로컬 경로를 입력합니다.	C:/Users/john/Downloads/data.json
   --format	가져올 파일의 형식을 나타내기 위해 yaml, properties 또는 json을 입력합니다.	json

2. 선택적으로 다음 매개 변수도 추가합니다.

   매개 변수	설명	예시
   --separator	선택 사항. 구분 기호는 키-값을 Json/Yaml로 병합하기 위한 구분 기호입니다. 계층 구조를 내보내는 데 필요하며 속성 파일 및 기능 플래그에 대해서는 무시됩니다. 다음 옵션 중 하나를 선택합니다. ., ,, :, ;, /, -, _, —.	;
   --prefix	선택 사항. 키 접두사는 키의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다. 이 접두사는 가져온 각 키-값의 “key” 속성 앞에 추가됩니다.	TestApp:
   --label	선택 사항. 가져온 키-값에 할당할 레이블을 입력합니다.	prod
   --content-type	선택 사항. 가져온 콘텐츠가 Key Vault 참조 또는 JSON 파일로 구성되어 있음을 나타내려면 appconfig/kvset 또는 application/json을 입력합니다.	application/json

   예: JSON 파일에서 모든 키-값과 기능 플래그를 가져오고, “prod” 레이블을 적용하고, “TestApp” 접두사를 추가합니다. "application/json" 콘텐츠 형식을 추가합니다.

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. 명령줄에 향후 변경 내용 목록이 표시됩니다. y를 선택하여 가져오기를 확인합니다.

   

JSON 파일에서 키-값을 가져오고 "prod" 레이블과 "TestApp:" 접두사를 할당했습니다. 구분 기호 “;”이 사용되며 가져온 모든 키-값의 콘텐츠 형식이 “JSON”으로 설정되었습니다.

더 많은 선택적 매개 변수와 예를 보려면 az appconfig kv import로 이동합니다.

App Configuration 저장소에서 데이터 가져오기

한 App Configuration 저장소에서 다른 App Configuration 저장소로 값을 가져오거나 한 App Configuration 저장소에서 동일한 App Configuration 저장소로 값을 가져와 값을 복제하고 새 레이블 또는 콘텐츠 형식과 같은 다른 매개 변수를 적용할 수 있습니다.

Azure App Configuration 저장소에서 키-값 및 기능 플래그를 가져오려면 아래 단계를 따릅니다.

포털

Azure Portal에서 다음 단계를 따릅니다.

1. App Configuration 저장소로 이동하고 작업 메뉴에서 가져오기/내보내기를 선택합니다.

   

2. 가져오기 탭의 원본 서비스에서 App Configuration을 선택합니다.

3. 리소스 선택을 선택하고 다음 매개 변수로 양식을 작성한 후 적용을 선택합니다.

   매개 변수	설명	예시
   구독	현재 구독이 기본적으로 선택되어 있습니다.	my-subscription
   Resource group	가져올 구성이 있는 App Configuration 저장소가 포함된 리소스 그룹을 선택합니다. 현재 리소스 그룹이 기본적으로 선택됩니다.	my-resource-group
   리소스	가져올 구성이 포함된 App Configuration 저장소를 선택합니다.	my-other-app-config-store

   참고 항목

   "액세스 키를 성공적으로 가져왔습니다"라는 메시지는 App Configuration 저장소와의 연결이 성공했음을 나타냅니다.

4. 양식의 다음 부분을 작성합니다.

   매개 변수	설명	예시
   원본 레이블	해당 레이블이 있는 값을 가져오려면 하나 이상의 레이블을 선택합니다. 모두 선택은 레이블이 있는 키-값을 가져오고 (레이블 없음)은 레이블이 없는 키-값으로 가져오기를 제한합니다.	prod
   특정 시간에	선택 사항. 특정 시점에서 키-값을 가져오려면 작성합니다. 이것은 선택한 구성 저장소에서 키-값의 특정 시점입니다. 형식: "YYYY-MM-DDThh:mm:ssZ". 이 필드는 기본적으로 비워 두면 키-값의 현재 시점으로 설정됩니다.	2022/07/28 오전 12:00:00
   기본 키-값 레이블 재정의	선택 사항. 기본적으로 가져온 항목은 현재 레이블을 사용합니다. 상자를 선택하고 레이블을 입력하여 이러한 기본값을 사용자 지정 레이블로 재정의합니다.	신규
   기본 키-값 콘텐츠 형식 재정의	선택 사항. 기본적으로 가져온 항목은 현재 콘텐츠 형식을 사용합니다. 확인란을 선택하고 콘텐츠 형식에서 Key Vault 참조 또는 JSON(application/json)을 선택하여 가져온 콘텐츠가 Key Vault 참조 또는 JSON 파일로 구성되어 있음을 나타냅니다. 콘텐츠 형식은 가져온 키-값에 대해서만 재정의할 수 있습니다. 기능 플래그의 기본 콘텐츠 형식은 "application/vnd.microsoft.appconfig.ff+json;charset=utf-8"이며 이 매개 변수에 의해 업데이트되지 않습니다.	JSON’(애플리케이션/json)’

5. 적용을 선택하여 가져오기를 진행합니다.

2021년 1월 28일 오전 12시에 App Configuration 저장소에서 “prod” 레이블이 있는 키-값 및 기능 플래그를 가져오고 “new” 레이블을 할당했습니다. 가져온 모든 키-값의 콘텐츠 형식이 “JSON”으로 설정되었습니다.

Azure CLI

Azure CLI에서 아래 단계를 따릅니다. Azure CLI를 로컬로 설치하지 않은 경우 필요에 따라 Azure Cloud Shell을 사용할 수 있습니다.

1. 가져오기 명령 az appconfig kv import를 입력하고 다음 매개 변수를 입력합니다.

   매개 변수	설명	예시
   --name	데이터를 가져올 App Configuration 저장소의 이름을 입력합니다.	my-app-config-store
   --source	App Configuration 저장소에서 데이터를 가져오고 있음을 나타내려면 appconfig를 입력합니다.	appconfig
   --src-name	데이터를 가져올 App Configuration 저장소의 이름을 입력합니다.	my-source-app-config
   --src-label	특정 레이블이 있는 키-값으로 가져오기를 제한합니다. 이 매개 변수를 사용하지 않으면 null 레이블이 있는 키-값만 가져옵니다. 필터로 별표를 지원합니다. 모든 레이블의 경우 *, 접두사가 abc인 모든 레이블의 경우 abc*를 입력합니다.	prod

2. 선택적으로 다음 매개 변수를 추가합니다.

   매개 변수	설명	예시
   --label	선택 사항. 가져온 키-값에 할당할 레이블을 입력합니다.	new
   --content-type	선택 사항. 가져온 콘텐츠가 Key Vault 참조 또는 JSON 파일로 구성되어 있음을 나타내려면 appconfig/kvset 또는 application/json을 입력합니다. 콘텐츠 형식은 가져온 키-값에 대해서만 재정의할 수 있습니다. 기능 플래그의 기본 콘텐츠 형식은 기본적으로 "application/vnd.microsoft.appconfig.ff+json;charset=utf-8"이며 이 매개 변수에 의해 업데이트되지 않습니다.	application/json

   예: 다른 App Configuration에서 “prod” 레이블이 있는 키-값 및 기능 플래그를 가져오고 “new” 레이블을 할당합니다. "application/json" 콘텐츠 형식을 추가합니다.

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. 명령줄에 향후 변경 내용 목록이 표시됩니다. y를 선택하여 가져오기를 확인합니다.

   

App Configuration 저장소에서 “prod” 레이블이 있는 키-값을 가져오고 “new” 레이블을 할당했습니다. 가져온 모든 키-값의 콘텐츠 형식이 “JSON”으로 설정되었습니다.

더 많은 선택적 매개 변수와 예를 보려면 az appconfig kv import로 이동합니다.

Azure App Service에서 데이터 가져오기

Azure App Service에서 키-값을 가져오려면 아래 단계를 따릅니다.

참고 항목

App Service는 현재 기능 플래그를 지원하지 않습니다. App Service로 가져온 모든 기능 플래그는 자동으로 키-값으로 변환됩니다. App Service 리소스에는 키-값만 포함될 수 있습니다.

포털

Azure 포털에서 다음을 수행합니다.

1. App Configuration 저장소로 이동하고 작업 메뉴에서 가져오기/내보내기를 선택합니다.

   

2. 가져오기 탭의 원본 서비스에서 App Services를 선택합니다.

3. 리소스 선택을 선택하고 다음 매개 변수로 양식을 작성한 후 적용을 선택합니다.

   매개 변수	설명	예시
   구독	현재 구독이 기본적으로 선택되어 있습니다.	my-subscription
   Resource group	가져올 구성이 있는 App Service가 포함된 리소스 그룹을 선택합니다.	my-resource-group
   리소스	가져올 구성이 포함된 App Service를 선택합니다.	my-app-service

   참고 항목

   원본 App Service 리소스에서 성공적으로 페치된 키-값 수를 나타내는 메시지가 표시됩니다.

4. 양식의 다음 부분을 작성합니다.

   매개 변수	설명	예시
   접두사	선택 사항. 키 접두사는 키-값 “key” 속성의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다. 이 접두사는 가져온 각 키-값의 “key” 속성 앞에 추가됩니다.	TestApp:
   Label	선택 사항. 기존 레이블을 선택하거나 가져온 키-값에 할당할 새 레이블을 입력합니다.	prod
   내용 유형	선택 사항. 가져오는 파일이 Key Vault 참조 또는 JSON 파일인지를 나타냅니다. Key Vault 참조에 대한 자세한 내용은 ASP.NET Core 앱에서 Key Vault 참조 사용으로 이동하세요.	JSON’(애플리케이션/json)’

5. 적용을 선택하여 가져오기를 진행합니다.

App Service에서 모든 애플리케이션 설정을 키-값으로 가져오고 레이블 "prod"와 접두사 "TestApp"을 할당했습니다. 가져온 모든 키-값의 콘텐츠 형식이 “JSON”으로 설정되었습니다.

Azure CLI

Azure CLI에서 아래 단계를 따릅니다. Azure CLI를 로컬로 설치하지 않은 경우 필요에 따라 Azure Cloud Shell을 사용할 수 있습니다.

1. 가져오기 명령 az appconfig kv import를 입력하고 다음 매개변수를 추가합니다.

   매개 변수	설명	예시
   --name	데이터를 가져올 App Configuration 저장소의 이름을 입력합니다.	my-app-config-store
   --source	Azure App Service에서 앱 구성 데이터를 가져오고 있음을 나타내려면 appservice를 입력합니다.	appservice
   --appservice-account	App Service의 ARM ID를 입력하거나 App Configuration과 동일한 구독 및 리소스 그룹에 있는 경우 App Service의 이름을 사용합니다.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service 또는 my-app-service

2. 선택적으로 다음 매개 변수도 추가합니다.

   매개 변수	설명	예시
   --prefix	선택 사항. 키 접두사는 키-값 “key” 속성의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다. 이 접두사는 가져온 각 키-값의 “key” 속성 앞에 추가됩니다.	TestApp:
   --label	선택 사항. 가져온 키-값에 할당할 레이블을 입력합니다. 레이블을 할당하지 않으면 null 레이블이 키-값에 할당됩니다.	prod
   --content-type	선택 사항. 가져온 콘텐츠가 Key Vault 참조 또는 JSON 파일로 구성되어 있음을 나타내려면 appconfig/kvset 또는 application/json을 입력합니다.	application/json

   --appservice-account의 값을 가져오려면 az webapp show --resource-group <resource-group> --name <resource-name> 명령을 사용합니다.

   예: App Service의 모든 애플리케이션 설정을 레이블이 "prod"인 키-값으로 App Configuration 저장소로 가져오고 "TestApp:" 접두사를 추가합니다.

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. 명령줄에 향후 변경 내용 목록이 표시됩니다. y를 선택하여 가져오기를 확인합니다.

   

App Service에서 모든 애플리케이션 설정을 키-값으로 가져오고 "prod" 레이블을 할당하고 "TestApp:" 접두사를 추가했습니다. 가져온 모든 키-값의 콘텐츠 형식이 “JSON”으로 설정되었습니다.

더 많은 선택적 매개 변수와 예를 보려면 az appconfig kv import로 이동합니다.

데이터 내보내기

내보내기는 App Configuration에 저장된 구성 데이터를 다른 대상에 기록합니다. 예를 들어 내보내기 함수를 사용하면 App Configuration 저장소의 데이터를 배포 중에 애플리케이션 코드에 포함될 수 있는 파일에 저장할 수 있습니다.

이 가이드에서는 App Configuration 데이터를 내보내는 방법을 보여 줍니다.

• Json, Yaml 또는 Properties의 구성 파일로
• App Configuration 저장소로
• Azure App Service 리소스로

구성 파일로 데이터 내보내기

앱 구성 저장소에서 Json, Yaml 또는 Properties 파일로 구성 데이터를 내보내려면 아래 단계를 따릅니다.

참고 항목

App Configuration 저장소에서 구성 파일로 기능 플래그 내보내기는 현재 CLI에서만 지원됩니다.

포털

Azure Portal에서 다음 단계를 따릅니다.

1. App Configuration 저장소로 이동한 후 가져오기/내보내기를 선택합니다.

   

2. 내보내기 탭의 대상 서비스에서 구성 파일을 선택합니다.

3. 다음 매개 변수로 양식을 작성합니다.

   매개 변수	설명	예시
   접두사	선택 사항. 이 접두사는 각 키-값의 “key” 속성에서 잘립니다. 키 접두사는 키의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다.	TestApp:
   원본 레이블	기존 레이블을 선택하여 내보내기를 특정 레이블이 있는 키-값으로 제한합니다. 레이블을 선택하지 않으면 기본적으로 "레이블 없음" 레이블이 있는 키-값만 내보내집니다. 다음 참고를 참조하세요.	prod
   특정 시간에	선택 사항. 특정 시점에서 키-값을 가져오려면 작성합니다. 이것은 선택한 구성 저장소에서 키-값의 특정 시점입니다. 형식: "YYYY-MM-DDThh:mm:ssZ". 이 필드는 기본적으로 비워 두면 키-값의 현재 시점으로 설정됩니다.	2022/07/28 오전 12:00:00
   파일 형식	Yaml, Properties 또는 Json 중에서 내보낼 파일 형식을 선택합니다.	JSON
   구분 기호	구분 기호는 키-값을 Json/Yaml로 병합하기 위한 구분 기호입니다. 구성의 계층 구조를 지원하며 속성 파일 및 기능 플래그에는 적용되지 않습니다. 다음 옵션 중 하나를 선택합니다. ., ,, :, ;, /, -, _, — 또는 (구분자 없음).	;

   Important

   레이블에서를 선택하지 않으면 레이블이 없는 키-값만 내보냅니다. 레이블을 사용하여 키-값을 내보내려면 해당 레이블을 선택해야 합니다. 포털에서 내보내기당 하나의 레이블만 선택할 수 있습니다. 모든 레이블이 지정된 키-값을 내보내려면 CLI를 사용합니다.

4. 내보내기를 선택하여 내보내기를 완료합니다.

구성 파일에서 "prod" 레이블이 있는 키-값을 2021년 7월 28일 오전 12:00:00부터 해당 상태로 내보내고 접두사 "TestApp"을 잘라냈습니다. 파일에서 값은 ";"으로 구분됩니다.

Azure CLI

Azure CLI에서 아래 단계를 따릅니다. Azure CLI를 로컬로 설치하지 않은 경우 필요에 따라 Azure Cloud Shell을 사용할 수 있습니다.

1. 내보내기 명령 az appconfig kv export를 입력하고 다음 매개 변수를 추가합니다.

   매개 변수	설명	예시
   --name	내보낼 키-값이 포함된 App Configuration 저장소의 이름을 입력합니다.	my-app-config-store
   --destination	데이터를 파일로 내보내고 있음을 나타내려면 file을 입력합니다.	file
   --path	파일을 저장할 경로를 입력합니다.	C:/Users/john/Downloads/data.json
   --format	내보낼 파일의 형식을 나타내려면 yaml, properties 또는 json을 입력합니다.	json
   --label	레이블을 입력하여 이 레이블이 있는 키-값 및 기능 플래그를 내보냅니다. 레이블을 지정하지 않으면 기본적으로 레이블이 없는 키-값과 기능 플래그만 내보냅니다. 하나의 레이블을 입력하거나 ,로 구분하여 여러 레이블을 입력하거나 *를 사용하여 모든 레이블을 고려할 수 있습니다.	prod

   Important

   레이블을 선택하지 않으면 레이블이 없는 키-값만 내보냅니다. 레이블을 사용하여 키-값을 내보내려면 해당 레이블을 선택해야 합니다.

2. 선택적으로 다음 매개 변수도 추가합니다.

   매개 변수	설명	예시
   --separator	선택 사항. 구분 기호는 키-값을 Json/Yaml로 병합하기 위한 구분 기호입니다. 계층 구조를 내보내는 데 필요하며 속성 파일 및 기능 플래그에 대해서는 무시됩니다. 다음 옵션 중 하나를 선택합니다. ., ,, :, ;, /, -, _, —.	;
   --prefix	선택 사항. 각 키-값의 “key” 속성에서 잘릴 접두사입니다. 키 접두사는 키의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다. 기능 플래그의 경우 접두사는 무시됩니다.	TestApp:

   예: “prod” 레이블이 있는 모든 키-값 및 기능 플래그를 JSON 파일에 내보냅니다.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. 명령줄은 파일로 내보내는 키-값 목록을 표시합니다. y를 선택하여 내보내기를 확인합니다.

   

"prod" 레이블이 있는 키-값 및 기능 플래그를 구성 파일로 내보내고 "TestApp" 접두사를 잘라냈습니다. 파일에서 값은 ";"으로 구분됩니다.

더 많은 선택적 매개 변수 및 예를 보려면 az appconfig kv export로 이동합니다.

App Configuration 저장소로 데이터 내보내기

키-값 및 기능 플래그를 Azure App Configuration 저장소로 내보내려면 아래 단계를 따릅니다.

한 App Configuration 저장소에서 다른 App Configuration 저장소로 값을 내보내거나 한 App Configuration 저장소에서 동일한 App Configuration 저장소로 값을 내보내 해당 값을 복제하고 새 레이블 또는 콘텐츠 형식과 같은 다른 매개 변수를 적용할 수 있습니다.

포털

Azure Portal에서 다음 단계를 따릅니다.

1. 내보낼 데이터가 포함된 App Configuration 저장소로 이동하고 작업 메뉴에서 가져오기/내보내기를 선택합니다.

   

2. 내보내기 탭의 대상 서비스에서 App Configuration을 선택합니다.

3. 리소스 선택을 선택하고 다음 매개 변수로 양식을 작성한 후 적용을 선택합니다.

   매개 변수	설명	예시
   구독	현재 구독이 기본적으로 선택되어 있습니다.	my-subscription
   Resource group	가져올 구성이 있는 App Configuration 저장소가 포함된 리소스 그룹을 선택합니다.	my-resource-group
   리소스	가져올 구성이 포함된 App Configuration 저장소를 선택합니다.	my-app-config-store

4. 이제 페이지에 선택한 대상 서비스 및 리소스 ID가 표시됩니다. 리소스 선택 작업을 통해 다른 원본 App Configuration 저장소로 전환할 수 있습니다.

   참고 항목

   키-값이 성공적으로 페치되었음을 나타내는 메시지가 화면에 표시됩니다.

5. 양식의 다음 부분을 작성합니다.

   매개 변수	설명	예시
   원본 레이블	해당 레이블과 함께 값을 내보내려면 하나 이상의 레이블을 선택합니다. 모두 선택은 레이블이 있는 키-값을 내보내고 (레이블 없음)은 레이블이 없는 키-값으로 내보내기를 제한합니다.	prod
   특정 시간에	선택 사항. 특정 시점에서 키-값을 가져오려면 작성합니다. 이것은 선택한 구성 저장소에서 키-값의 특정 시점입니다. 형식: "YYYY-MM-DDThh:mm:ssZ". 이 필드는 기본적으로 비워 두면 키-값의 현재 시점으로 설정됩니다.	2022/07/28 오전 12:00:00
   기본 키-값 레이블 재정의	선택 사항. 기본적으로 가져온 항목은 현재 레이블을 사용합니다. 상자를 선택하고 레이블을 입력하여 이러한 기본값을 사용자 지정 레이블로 재정의합니다.	신규

6. 내보내기를 계속하려면 적용을 선택합니다.

2022년 7월 28일 오전 12:00:00부터 App Configuration 저장소에서 "prod" 레이블이 있는 키-값 및 기능 플래그를 내보내고 레이블 "new"를 할당했습니다.

Azure CLI

Azure CLI에서 아래 단계를 따릅니다. Azure CLI를 로컬로 설치하지 않은 경우 필요에 따라 Azure Cloud Shell을 사용할 수 있습니다.

1. 내보내기 명령 az appconfig kv export를 입력하고 다음 매개 변수를 입력합니다.

   매개 변수	설명	예시
   --name	내보낼 키-값이 포함된 App Configuration 저장소의 이름을 입력합니다.	my-app-config-store
   --destination	appconfig를 입력하여 데이터를 App Configuration 저장소로 내보내고 있음을 나타냅니다.	appconfig
   --dest-name	데이터를 내보내려는 App Configuration 저장소의 이름을 입력합니다.	my-other-app-config-store
   --label	레이블을 입력하여 이 레이블이 있는 키-값 및 기능 플래그를 내보냅니다. 레이블을 지정하지 않으면 기본적으로 레이블이 없는 키-값과 기능 플래그만 내보냅니다. 하나의 레이블을 입력하거나 ,로 구분하여 여러 레이블을 입력하거나 *를 사용하여 모든 레이블을 고려할 수 있습니다.	prod

   Important

   내보내려는 키-값에 레이블이 있는 경우 --label 명령을 사용하고 해당 레이블을 입력해야 합니다. 레이블을 선택하지 않으면 레이블이 없는 키-값만 내보냅니다. 쉼표 기호(,)를 사용하여 여러 레이블을 선택하거나 *를 사용하여 null 레이블(레이블 없음)을 포함한 모든 레이블을 포함합니다.

2. 선택적으로 다음 매개 변수도 추가합니다.

   매개 변수	설명	예시
   --dest-label	선택 사항. 내보낸 키-값에 이 레이블을 할당하려면 대상 레이블을 입력합니다.	new

   예: “prod” 레이블이 있는 키-값 및 기능 플래그를 다른 App Configuration 저장소로 내보내고 대상 레이블 “new”를 추가합니다.

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. 명령줄은 파일로 내보내는 키-값 목록을 표시합니다. y를 선택하여 내보내기를 확인합니다.

   

App Configuration 저장소에서 레이블이 "prod"인 키-값 및 기능 플래그를 내보냈고 "new" 레이블을 할당했습니다.

더 많은 선택적 매개 변수와 예를 보려면 az appconfig kv import로 이동합니다.

Azure App Service로 데이터 내보내기

키-값을 Azure App Service로 내보내려면 아래 단계를 따릅니다.

참고 항목

App Service로 기능 플래그 내보내기는 현재 지원되지 않습니다.

포털

Azure Portal에서 다음 단계를 따릅니다.

1. App Configuration 저장소로 이동하고 작업 메뉴에서 가져오기/내보내기를 선택합니다.

   

2. 내보내기 탭의 대상 서비스에서 App Services를 선택합니다.

3. 리소스 선택을 선택하고 다음 매개 변수로 양식을 작성한 후 적용을 선택합니다.

   매개 변수	설명	예시
   구독	현재 구독이 기본적으로 선택되어 있습니다.	my-subscription
   Resource group	내보낼 구성이 있는 App Service가 포함된 리소스 그룹을 선택합니다.	my-resource-group
   리소스	내보낼 구성이 포함된 App Service를 선택합니다.	my-app-service

4. 이제 페이지에 선택한 대상 서비스 및 리소스 ID가 표시됩니다. 리소스 선택 작업을 통해 다른 대상 App Service 리소스로 전환할 수 있습니다.

5. 선택적으로 양식의 다음 부분을 작성합니다.

   매개 변수	설명	예시
   접두사	선택 사항. 이 접두사는 내보낸 각 키-값의 “key” 속성에서 잘립니다. 키 접두사는 키의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다. 기능 플래그의 경우 접두사는 무시됩니다.	TestApp:
   참조로 내보내기	선택 사항. 키-값을 App Configuration 참조로 App Service에 내보내야 합니다. 자세한 정보
   특정 시간에	선택 사항. 특정 시점의 키-값을 내보내려면 입력합니다. 이것은 선택한 구성 저장소에서 키-값의 특정 시점입니다. 형식: "YYYY-MM-DDThh:mm:ssZ". 이 필드는 기본적으로 비워 두면 키-값의 현재 시점으로 설정됩니다.	2022/07/28 오전 12:00:00
   원본 레이블	선택 사항. 기존 레이블을 선택하여 내보내기를 특정 레이블이 있는 키-값으로 제한합니다. 레이블을 선택하지 않으면 "레이블 없음" 레이블이 있는 키-값만 내보내집니다.	prod

6. 내보내기를 계속하려면 적용을 선택합니다.

App Service 리소스에서 "prod" 레이블이 있는 키-값을 2021년 7월 28일 오전 12:00:00부터 해당 상태로 내보내고 접두사 "TestApp"을 잘라냈습니다. 키-값은 JSON 형식의 콘텐츠 형식으로 내보냈습니다.

키-값을 참조로 내보내는 확인란을 선택한 경우 내보낸 키-값은 App Service 리소스 구성 설정의 “원본” 열에 App Configuration 참조로 표시됩니다.

Azure CLI

Azure CLI에서 아래 단계를 따릅니다. Azure CLI를 로컬로 설치하지 않은 경우 필요에 따라 Azure Cloud Shell을 사용할 수 있습니다.

1. 내보내기 명령 az appconfig kv export를 입력하고 다음 매개 변수를 입력합니다.

   매개 변수	설명	예시
   --name	내보낼 키-값이 포함된 App Configuration 저장소의 이름을 입력합니다.	my-app-config-store
   --destination	데이터를 App Service로 내보내고 있음을 나타내려면 appservice를 입력합니다.	appservice
   --appservice-account	App Service의 ARM ID를 입력하거나 App Configuration과 동일한 구독 및 리소스 그룹에 있는 경우 App Service의 이름을 사용합니다.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service 또는 my-app-service
   --label	선택 사항. 레이블을 입력하여 이 레이블이 있는 키-값 및 기능 플래그를 내보냅니다. 레이블을 지정하지 않으면 기본적으로 레이블이 없는 키-값과 기능 플래그만 내보냅니다.	prod

   --appservice-account의 값을 가져오려면 az webapp show --resource-group <resource-group> --name <resource-name> 명령을 사용합니다.

2. 선택적으로 접두사도 추가합니다.

   매개 변수	설명	예시
   --prefix	선택 사항. 내보낸 키-값의 “key” 속성에서 잘릴 접두사입니다. 키 접두사는 키의 시작 부분입니다. 접두사는 구성 저장소에서 키-값 그룹을 관리하는 데 사용할 수 있습니다.	TestApp:

   예: 레이블이 "prod"인 모든 키-값을 App Service 애플리케이션으로 내보내고 "TestApp" 접두사를 자릅니다.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   명령줄은 App Service 리소스에 내보내는 키-값 목록을 표시합니다. y를 선택하여 내보내기를 확인합니다.

   

   “prod” 레이블이 있는 모든 키-값을 Azure App Service 리소스에 내보내고 “TestApp:” 접두사를 잘랐습니다.

3. 필요에 따라 App Configuration 참조로 내보낼 플래그를 지정합니다.

   매개 변수	설명
   --export-as-reference -r	선택 사항입니다. 키-값을 App Configuration 참조로 App Service에 내보낼지 여부를 지정합니다. 자세히 알아보기.

   예: “prod” 레이블이 있는 모든 키-값을 App Configuration 참조로 App Service 애플리케이션에 내보냅니다.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   명령줄은 App Service 리소스에 App Configuration 참조로 내보내는 키-값 목록을 표시합니다. y를 선택하여 내보내기를 확인합니다.

   

   “prod” 레이블이 있는 모든 키-값을 App Configuration 참조로 Azure App Service 리소스에 내보냈습니다. App Service 리소스에서 가져온 키-값은 “원본” 열에서 App Configuration 참조로 표시됩니다.

   

더 많은 선택적 매개 변수 및 예를 보려면 az appconfig kv export로 이동합니다.

오류 메시지

App Configuration 키-값을 가져오거나 내보낼 때 다음 오류 메시지가 나타날 수 있습니다.

• 선택한 파일은 1~2097152바이트여야 합니다. 파일이 너무 큽니다. 더 작은 파일을 선택합니다.
• 저장소에 대한 공용 액세스가 사용하지 않도록 설정되었거나 저장소의 프라이빗 엔드포인트 구성에 없는 프라이빗 엔드포인트에서 액세스하고 있습니다. App Configuration 저장소에서 키-값을 가져오려면 해당 저장소에 대한 액세스 권한이 있어야 합니다. 필요한 경우 원본 저장소에 대한 공용 액세스를 사용하도록 설정하거나 승인된 프라이빗 엔드포인트에서 액세스합니다. 공용 액세스를 사용하도록 설정한 경우 캐시가 새로 고쳐질 때까지 최대 5분을 기다립니다.

다음 단계

CI/CD 파이프라인과 통합