빠른 시작: Azure App Configuration에서 기능 플래그 관리

아티클
05/06/2024

Azure App Configuration에는 기능을 사용하거나 사용하지 않도록 설정하는 기능 플래그와 기능 플래그의 여러 변형을 허용하는 변형 기능 플래그(미리 보기)가 포함되어 있습니다.

Azure Portal의 기능 관리자는 애플리케이션에서 사용하는 기능 플래그와 변형 기능 플래그를 만들고 관리하기 위한 UI를 제공합니다.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정 만들기
App Configuration 저장소. 저장소를 만듭니다.

아래 단계에 따라 새 기능 플래그를 추가합니다.

Azure Portal에서 Azure App Configuration 저장소를 열고 작업 메뉴에서 기능 관리자>만들기를 선택합니다. 그런 다음 기능 플래그를 선택합니다.

만들기에서 다음 정보를 선택하거나 입력합니다.

설정	예제 값	설명
기능 플래그 사용	확인란이 선택됨	이 옵션은 만들 때 기능 플래그를 사용하도록 설정합니다. 이 상자를 선택하지 않은 상태로 두면 새 기능 플래그의 구성이 저장되지만 새 기능 플래그는 사용하지 않도록 설정된 상태로 유지됩니다.
기능 플래그 이름	베타	기능 플래그 이름은 코드에서 플래그를 참조하는 데 사용하는 이름입니다. 이는 애플리케이션 내에서 고유해야 합니다.
Key	베타	키를 사용하여 애플리케이션에 로드된 기능 플래그를 필터링할 수 있습니다. 키는 기본적으로 기능 플래그 이름에서 생성되지만 접두사 또는 네임스페이스를 추가하여 기능 플래그를 그룹화할 수도 있습니다(예: .appconfig.featureflag/myapp/Beta).
레이블	비워 둡니다.	레이블을 사용하여 동일한 키에 대해 서로 다른 기능 플래그를 만들고 레이블을 기반으로 애플리케이션에 로드된 플래그를 필터링할 수 있습니다. 기본적으로 기능 플래그에는 레이블이 없습니다.
설명	비워 둡니다.	비워두거나 기능 플래그에 대한 설명을 입력합니다.
기능 필터 사용	확인란이 선택 해제됨	기능 필터 상자를 선택하지 않은 상태로 둡니다. 기능 필터에 대해 자세히 알아보려면 기능 필터를 사용하여 조건부 기능 플래그를 사용 및 대상 그룹에 대한 기능의 단계적 롤아웃을 사용하도록 설정으로 이동합니다.

기능 플래그를 만들려면 적용을 선택합니다.

az appconfig feature set 명령을 사용하여 App Configuration 저장소에 기능 플래그를 추가합니다. 자리 표시자 <name>을 이름 또는 App Configuration 저장소로 바꿉니다.

az appconfig feature set --name <name> --feature Beta

변형 기능 플래그 만들기(미리 보기)

Azure Portal에서 Azure App Configuration 저장소를 열어 새로운 변형 기능 플래그(미리 보기)를 추가하고 작업 메뉴에서 기능 관리자>만들기를 선택합니다. 그런 다음 변형 기능 플래그(미리 보기)를 선택합니다.

기본 사항 구성

세부 정보 탭에서 다음 정보를 선택하거나 입력합니다.

설정	예제 값	설명
기능 플래그 사용	확인란이 선택됨	이 옵션은 만들 때 기능 플래그를 사용하도록 설정합니다. 이 상자를 선택하지 않은 상태로 두면 새 기능 플래그의 구성이 저장되지만 새 기능 플래그는 사용하지 않도록 설정된 상태로 유지됩니다.
이름	인사말	기능 플래그 이름은 코드에서 플래그를 참조하는 데 사용하는 이름입니다. 이는 애플리케이션 내에서 고유해야 합니다.
Key	인사말	키를 사용하여 애플리케이션에 로드된 기능 플래그를 필터링할 수 있습니다. 키는 기본적으로 기능 플래그 이름에서 생성되지만 접두사 또는 네임스페이스를 추가하여 기능 플래그를 그룹화할 수도 있습니다(예: .appconfig.featureflag/myapp/Greeting).
레이블	비워 둡니다.	레이블을 사용하여 동일한 키에 대해 서로 다른 기능 플래그를 만들고 레이블을 기반으로 애플리케이션에 로드된 플래그를 필터링할 수 있습니다. 기본적으로 기능 플래그에는 레이블이 없습니다.
설명	비워 둡니다.	비워두거나 기능 플래그에 대한 설명을 입력합니다.

다음 >을 선택하여 변형을 추가합니다.

변형 추가

변형 탭에서 다음 정보를 선택하거나 입력합니다.

설정	예제 값	설명
변형 이름	Off 및 On	기본적으로 두 가지 변형이 추가됩니다. 업데이트하거나 새 변형의 이름을 입력합니다. 변형 이름은 기능 플래그 내에서 고유해야 합니다.
값	false 및 true	각 변형에 대한 값을 제공합니다. 값은 문자열, 숫자, 부울 또는 구성 개체일 수 있습니다. JSON 편집기에서 값을 편집하려면 여러 줄로 값 편집을 선택하면 됩니다.
기본 변형	끄기	드롭다운 목록에서 기본 변형을 선택합니다. 대상 그룹에게 변형이 할당되지 않거나 기능 플래그가 사용하지 않도록 설정된 경우 기능 플래그는 기본 변형을 반환합니다. 지정된 기본 변형 옆에 기본값이라는 단어가 표시됩니다.

다음 >을 선택하여 할당 설정에 액세스합니다.

트래픽 할당

할당 탭에서 다음 정보를 선택하거나 입력합니다.

각 변형에 트래픽을 분산하여 정확히 100%까지 합산합니다.
선택적으로 그룹별 재정의 및 사용자별 재정의 옵션을 선택하여 특정 그룹 또는 사용자에 대한 변형을 할당합니다. 이러한 옵션은 기본적으로 사용하지 않도록 설정됩니다.
배포에서 선택적으로 사용자 지정 시드 사용을 선택하고 비어 있지 않은 문자열을 새 시드 값으로 제공합니다. 여러 기능 플래그에 걸쳐 공통 시드를 사용하면 동일한 사용자를 동일한 백분위수에 할당할 수 있습니다. 여러 기능 플래그를 동시에 롤아웃하고 각 대상 그룹 세그먼트에 대해 일관된 환경을 보장하려는 경우에 유용합니다. 사용자 지정 시드가 지정되지 않은 경우 기능 이름을 기반으로 기본 시드가 사용됩니다.
검토 + 만들기를 선택하여 새 변형 기능 플래그의 요약을 확인한 다음 만들기를 선택하여 작업을 마무리합니다. 알림은 새 기능 플래그가 성공적으로 만들어졌음을 나타냅니다.

편집 기능 플래그

기능 플래그 또는 변형 기능 플래그를 업데이트하려면:

작업 메뉴에서 기능 관리자를 선택합니다.
수정하려는 기능 플래그 또는 변형 기능 플래그의 오른쪽 끝으로 이동하고 추가 작업 줄임표(...)를 선택합니다. 이 메뉴에서 플래그를 편집하고, 플래그를 잠그거나 잠금 해제하고, 레이블을 만들고, 태그를 업데이트하고, 기록을 검토하거나 플래그를 삭제할 수 있습니다.
편집을 선택하고 플래그를 업데이트합니다.
선택적으로 사용 토글을 켜거나 꺼서 기능 플래그의 상태를 변경합니다.

보기 관리

기능 관리자 메뉴에는 Azure App Configuration에 저장된 기능 플래그와 변형 기능 플래그가 표시됩니다. 보기 관리를 선택하여 Azure Portal에서 기능 관리자 표시를 변경할 수 있습니다.

설정을 사용하면 더 보기 작업당 로드할 기능 플래그 수를 선택할 수 있습니다. 200개 이상의 기능 플래그가 있는 경우에만 추가 로드가 표시됩니다.
열 편집을 사용하면 열을 추가 또는 제거하고 열 순서를 변경할 수 있습니다.

기능 관리자에서 만든 기능 플래그가 일반 키 값으로 저장됩니다. 특수 접두사 .appconfig.featureflag/ 및 콘텐츠 형식 application/vnd.microsoft.appconfig.ff+json;charset=utf-8로 유지됩니다. 구성 탐색기에서 기능 플래그의 기본 키-값을 보려면 아래 단계를 따릅니다.

작업 메뉴에서 구성 탐색기를 연 다음 보기 관리>설정을 선택합니다.
구성 탐색기에 기능 플래그 포함 및 적용을 선택합니다.

다음 단계

대상 그룹에 대한 기능 단계적 롤아웃 사용

다음을 통해 공유