기능 플래그 매니페스트 사용

이 가이드에서는 App Lifecycle Manager 기능 플래그 매니페스트에서 플래그를 만들거나 내보내는 방법을 보여줍니다.

App Lifecycle Manager 기능 플래그를 사용하면 새로운 코드 배포 또는 인프라 변경 없이 애플리케이션 내에서 기능의 가용성과 동작을 제어할 수 있습니다. 기능 플래그 매니페스트를 사용하면 플래그를 그룹으로 만들 수 있으므로 관리 영역과 로컬 개발 환경에서 플래그를 수동으로 만들고 동기화할 필요가 없습니다. 매니페스트는 오픈소스 OpenFeature 플래그 매니페스트 스키마를 준수하는 JSON 파일을 사용하여 플래그를 관리할 수 있는 일괄 관리 유틸리티를 제공합니다.

기본 요건

시작하기 전에 다음 사항을 확인하세요.

  1. App Lifecycle Manager 리소스를 관리하도록 구성된 gcloud 환경
  2. 기능 플래그 배포 빠른 시작을 완료했습니다.

매니페스트에서 플래그 만들기

push 명령어를 사용하면 로컬 JSON 매니페스트 파일을 제공하여 한 번에 여러 플래그를 만들 수 있습니다.

  1. 플래그 정의가 포함된 my_flags.json 파일을 만듭니다. 이 파일은 매니페스트의 로컬 정보 소스 역할을 합니다.

    my_flags.json 예시:

    {
  "flags": {
    "my-flag": {
      "defaultValue": "foo-bar",
      "description": "A description of the flag.",
      "flagType": "string"
    }
  }
}
    1. 매니페스트 파일과 타겟팅된 UnitKind를 지정하여 push 명령어를 실행합니다.
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

기존 플래그 구성에서 매니페스트 만들기

pull 명령어는 App Lifecycle Manager API에서 기존 플래그 구성을 가져오고 로컬 JSON 매니페스트 파일을 생성합니다. 이를 통해 플래그의 로컬 레코드를 유지하거나 OpenFeature codegen 도구와 함께 사용할 수 있도록 준비할 수 있습니다.

  1. 선택한 출력 경로를 지정하여 pull 명령어를 실행합니다.

     gcloud beta app-lifecycle-manager flags pull \
     --output-file="manifest.json" \
     --unit-kind="UNIT_KIND_NAME" \
     --overwrite-output-file

  2. 유형 안전 플래그 접근자를 사용하는 경우 새 manifest.json에 대해 OpenFeature CLI codegen 유틸리티를 실행하여 애플리케이션의 유형 안전 플래그 접근자를 업데이트합니다. 이렇게 하면 매니페스트가 관리 영역의 키 및 유형과 일치합니다.

다음 단계