Panduan ini menjelaskan cara mengonfigurasi dan menjalankan peluncuran fitur bertahap menggunakan tombol fitur App Lifecycle Manager. Anda akan mempelajari cara menentukan atribut penargetan, mengonfigurasi alokasi berbasis persentase, dan menjalankan peluncuran progresif dengan aman.
Kita akan menggunakan skenario saat Anda ingin mengaktifkan algoritma enhanced-search hanya untuk 1% traffic, yang diacak berdasarkan atribut userID, sementara 99% sisanya terus menggunakan penelusuran standar.
Prasyarat
Sebelum memulai, pastikan Anda telah menyelesaikan salah satu panduan memulai standar untuk menyediakan infrastruktur dasar pengukuran atau resource tombol fitur mandiri:
- Panduan memulai: Men-deploy flag fitur dengan App Lifecycle Manager
- Panduan memulai: Menggunakan tombol fitur Mandiri
Mengintegrasikan flag di aplikasi Anda
Untuk mendukung alokasi berbasis persentase yang didorong oleh data pengguna, aplikasi Anda harus melampirkan nilai atribut (misalnya, userID) ke OpenFeature Evaluation Context saat runtime sebelum memanggil metode evaluasi.
Contoh berikut menunjukkan cara mengambil klien yang diinisialisasi dan mengevaluasi flag dengan konteks penargetan yang disertakan.
Go
import ( "context" "fmt" "log" "github.com/open-feature/go-sdk/openfeature" ) // Example userID - in a real application, this would come from the request context. var userID = "example-user-123" // 1. Get client client := openfeature.NewClient("simple-api") // 2. Create Evaluation Context with user data evalCtx := openfeature.NewEvaluationContext( userID, map[string]interface{}{ "userID": userID, // Ensure userID is passed dynamically }, ) // 3. Evaluate flag (defaults to false if unreachable) isEnhanced, err := client.BooleanValue(context.Background(), "enhanced-search", false, evalCtx) if err != nil { log.Printf("Flag evaluation failed: %v", err) } // 4. Execute business logic if isEnhanced { log.Printf("Enhanced search algorithm for user %s", userID) } else { log.Printf("Standard search algorithm for user %s", userID) }
Java
// 1. Get client var client = OpenFeatureAPI.getInstance().getClient("simple-api"); // 2. Create Evaluation Context with user data var context = new dev.openfeature.sdk.MutableContext(); context.add("userID", userID); // 3. Evaluate flag boolean isEnhanced = client.getBooleanValue("enhanced-search", false, context); // 4. Execute business logic if (isEnhanced) { System.out.println("Executing enhanced search algorithm..."); } else { System.out.println("Executing standard search algorithm..."); }
Python
import openfeature from openfeature.evaluation_context import EvaluationContext # 1. Get client client = openfeature.api.get_client() # 2. Create Evaluation Context with user data eval_ctx = EvaluationContext( targeting_key=str(user_id), attributes={ "userID": user_id, } ) # 3. Evaluate flag is_enhanced = client.get_boolean_value( "enhanced-search", False, eval_ctx ) # 4. Execute business logic if is_enhanced: print(f"Executing enhanced search for user {user_id}") else: print(f"Executing standard search for user {user_id}")
Mengonfigurasi perilaku flag
Tentukan parameter atribut acak dan kaitkan dengan aturan alokasi berbasis persentase pada resource tombol fitur.
Buat atribut penargetan: Tentukan resource atribut
userIDsecara global untuk mendaftarkannya ke evaluasi penargetan.gcloud beta app-lifecycle-manager flags attributes create "user-id-attr" \ --key="userID" \ --attribute-value-type="STRING" \ --location="global"Tentukan aturan alokasi flag: Buat resource tombol fitur untuk menetapkan bobot 1% ke varian
enabledyang diacak padauserID.gcloud beta app-lifecycle-manager flags create "enhanced-search" \ --key="enhanced-search" \ --flag-value-type=bool \ --location="global" \ --unit-kind="demo-test-unitkind" \ --variants='[ { "id": "disabled", "booleanValue": false }, { "id": "enabled", "booleanValue": true } ]' \ --evaluation-spec='{ "allocations": [{ "id": "percentage-rollout", "randomizedOn": "userID", "slots": [ {"variant": "disabled", "weight": 99}, {"variant": "enabled", "weight": 1} ] }], "defaultAllocation": "percentage-rollout", "attributes": ["projects/PROJECT_ID/locations/global/flagAttributes/user-id-attr"] }'
Membuat peluncuran konfigurasi tanda
Untuk mendistribusikan aturan alokasi bertahap yang baru dibuat dengan aman, lanjutkan melalui fase peluncuran standar yang tidak dapat diubah.
Buat revisi: Ambil snapshot konfigurasi alokasi 1%.
gcloud beta app-lifecycle-manager flags revisions create "enhanced-search-rev-1" \ --location="global" \ --flag="enhanced-search"Membuat rilis: Buat paket revisi untuk deployment terhadap jenis unit Anda.
gcloud beta app-lifecycle-manager flags releases create "release-of-enhanced-search" \ --location="global" \ --unit-kind="demo-test-unitkind" \ --revisions="enhanced-search-rev-1"Memulai peluncuran: Tentukan strategi orkestrasi Anda dan deploy konfigurasi.
gcloud beta app-lifecycle-manager rollout-kinds create "rollout-kind-of-enhanced-search" \ --unit-kind="demo-test-unitkind" \ --rollout-orchestration-strategy="Google.Cloud.Simple.AllAtOnce" \ --location="global" gcloud beta app-lifecycle-manager rollouts create "rollout-of-enhanced-search" \ --flag-release="release-of-enhanced-search" \ --rollout-kind="rollout-kind-of-enhanced-search" \ --location="global"Pantau peluncuran: Pastikan deployment mencapai status
SUCCEEDED.gcloud beta app-lifecycle-manager rollouts describe "rollout-of-enhanced-search" \ --location="global"
Memperbarui penargetan tanda
Setelah peluncuran 1% dianggap berhasil dan stabil, perluas persentase audiens peluncuran dengan memperbarui bobot alokasi internal flag (misalnya, menjadi 50%).
Perbarui spesifikasi flag: Ubah slot alokasi menjadi 50% diaktifkan dan 50% dinonaktifkan.
gcloud beta app-lifecycle-manager flags update "enhanced-search" \ --location="global" \ --evaluation-spec='{ "allocations": [{ "id": "percentage-rollout", "randomizedOn": "userID", "slots": [ {"variant": "disabled", "weight": 50}, {"variant": "enabled", "weight": 50} ] }], "defaultAllocation": "percentage-rollout", "attributes": ["projects/PROJECT_ID/locations/global/flagAttributes/user-id-attr"] }'Men-deploy perluasan: Ikuti siklus proses untuk mendistribusikan bobot yang diperbarui ke klien yang terhubung.
gcloud beta app-lifecycle-manager flags revisions create "enhanced-search-rev-2" \ --location="global" \ --flag="enhanced-search" gcloud beta app-lifecycle-manager flags releases create "enhanced-search-50pct" \ --location="global" \ --unit-kind="demo-test-unitkind" \ --revisions="enhanced-search-rev-2" gcloud beta app-lifecycle-manager rollouts create "rollout-of-enhanced-search-50pct" \ --flag-release="enhanced-search-50pct" \ --rollout-kind="rollout-kind-of-enhanced-search" \ --location="global"Operasi ini dapat diulang terus-menerus hingga fitur mencapai deployment 100%.
Menonaktifkan flag
Setelah tombol fitur menyelesaikan peluncurannya dan berfungsi sebagai perilaku operasional standar, tombol fitur harus dinonaktifkan dengan aman.
- Hapus dari aplikasi: Hapus semua logika bersyarat evaluasi flag dari codebase aplikasi Anda dan deploy payload yang diperbarui ke produksi.
Tandai untuk pembersihan: Tetapkan status flag ke
CLEANUPuntuk menandakan niat untuk mencabut aksesnya:gcloud beta app-lifecycle-manager flags update "enhanced-search" \ --location="global" \ --state=cleanupMen-deploy peluncuran akhir: Buat rilis flag yang merujuk ke flag dan luncurkan untuk melepaskan flag dari unit Anda:
gcloud beta app-lifecycle-manager flags releases create "cleanup-enhanced-search" \ --location="global" \ --unit-kind="demo-test-unitkind" \ --flags="enhanced-search" gcloud beta app-lifecycle-manager rollouts create "rollout-of-cleanup-enhanced-search" \ --flag-release="cleanup-enhanced-search" \ --rollout-kind="rollout-kind-of-enhanced-search" \ --location="global"Setelah peluncuran selesai, hapus rilis flag, revisi flag, dan flag dari bidang pengelolaan.