Menggunakan manifes flag fitur

Panduan ini menunjukkan cara membuat atau mengekspor tanda dari manifes tanda fitur App Lifecycle Manager.

Dengan fitur flag App Lifecycle Manager, Anda dapat mengontrol ketersediaan dan perilaku fitur dalam aplikasi tanpa memerlukan deployment kode baru atau perubahan infrastruktur. Manifes tombol fitur memungkinkan Anda membuat tombol dalam grup, sehingga Anda tidak perlu membuat dan menyinkronkan tombol di seluruh bidang pengelolaan dan lingkungan pengembangan lokal secara manual. Manifes menyediakan utilitas pengelolaan massal yang memungkinkan Anda mengelola flag menggunakan file JSON yang sesuai dengan skema manifes flag OpenFeature open source.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

  1. Lingkungan gcloud yang dikonfigurasi untuk mengelola resource App Lifecycle Manager.
  2. Selesaikan Panduan memulai tombol fitur deployment.

Membuat tanda dari manifes

Perintah push memungkinkan Anda membuat beberapa tanda sekaligus dengan menyediakan file manifes JSON lokal.

  1. Buat file bernama my_flags.json dengan definisi flag Anda. File ini berfungsi sebagai sumber tepercaya lokal untuk manifes Anda.

    Contoh my_flags.json:

    {
      "flags": {
        "my-flag": {
          "defaultValue": "foo-bar",
          "description": "A description of the flag.",
          "flagType": "string"
        }
      }
    }
    
    1. Jalankan perintah push yang menentukan file manifes dan UnitKind yang ditargetkan.
    gcloud beta app-lifecycle-manager flags push \
        --file="my_flags.json" \
        --unit-kind="UNIT_KIND_NAME"
    

Membuat manifes dari konfigurasi flag yang ada

Perintah pull mengambil konfigurasi flag yang ada dari App Lifecycle Manager API dan menghasilkan file manifes JSON lokal. Hal ini memungkinkan Anda menyimpan catatan lokal tentang tanda atau menyiapkan tanda untuk digunakan dengan alat codegen OpenFeature.

  1. Jalankan perintah pull dengan menentukan jalur output yang Anda pilih.

     gcloud beta app-lifecycle-manager flags pull \
         --output-file="manifest.json" \
         --unit-kind="UNIT_KIND_NAME" \
         --overwrite-output-file
    
  2. Jika Anda menggunakan pengakses flag yang aman untuk jenis, jalankan utilitas codegen OpenFeature CLI terhadap manifest.json baru untuk memperbarui pengakses flag yang aman untuk jenis aplikasi Anda. Hal ini memastikan manifes cocok dengan kunci dan jenis di bidang pengelolaan.

Langkah berikutnya