Hızlı Başlangıç: Node.js konsol uygulamasına özellik bayrakları ekleme

Bu hızlı başlangıçta, özellik yönetiminin uçtan uca uygulamasını oluşturmak için Azure Uygulaması Yapılandırmasını bir Node.js konsol uygulamasına dahil edersiniz. tüm özellik bayraklarınızı merkezi olarak depolamak ve durumlarını denetlemek için Uygulama Yapılandırması kullanabilirsiniz.

JavaScript Özellik Yönetimi kitaplıkları, çerçeveyi özellik bayrağı desteğiyle genişletir. JavaScript yapılandırma sağlayıcısı aracılığıyla Uygulama Yapılandırması ile sorunsuz bir şekilde tümleşir. Örnek olarak, bu öğreticide javascript özellik yönetiminin bir Node.js uygulamasında nasıl kullanılacağı gösterilmektedir.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir tane oluşturun.
Mağaza oluşturma öğreticisinde gösterildiği gibi bir Uygulama Yapılandırma deposu.
Node.jsLTS sürümleri . Node.js doğrudan Windows'a yükleme veya Linux için Windows Alt Sistemi'ni (WSL) kullanma hakkında bilgi için bkz. Node.jskullanmaya başlama

Özellik bayrağı ekleme

Uygulama Yapılandırma deposuna Beta adlı bir özellik bayrağı ekleyin ve Etiket ve Açıklama değerlerini varsayılan değerleriyle bırakın. Azure portalını veya CLI'yı kullanarak bir depoya özellik bayrakları ekleme hakkında daha fazla bilgi için Özellik bayrağı oluşturma bölümüne gidin.

Özellik bayrağını kullanma

komutunu kullanarak Özellik Yönetimi'ni npm install yükleyin.
```
npm install @microsoft/feature-management
```

app.js adlı bir dosya oluşturun ve aşağıdaki kodu ekleyin.

Microsoft Entra Id (önerilen)
Bağlantı dizesi

Uygulama Yapılandırması deponuzda kimlik doğrulaması yapmak için öğesini kullanırsınızDefaultAzureCredential. Kimlik bilgilerinizi Uygulama Yapılandırması Veri Okuyucusu rolüne atamak için yönergeleri izleyin. Uygulamanızı çalıştırmadan önce iznin yayılması için yeterli süreye izin verdiğinden emin olun.

const sleepInMs = require("util").promisify(setTimeout);
const { load } = require("@azure/app-configuration-provider");
const { DefaultAzureCredential } = require("@azure/identity");
const { FeatureManager, ConfigurationMapFeatureFlagProvider} = require("@microsoft/feature-management");
const endpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
const credential = new DefaultAzureCredential(); // For more information, see https://learn.microsoft.com/azure/developer/javascript/sdk/credential-chains#use-defaultazurecredential-for-flexibility

async function run() {
    // Connect to Azure App Configuration using endpoint and token credential
    const appConfig = await load(endpoint, credential, {
        featureFlagOptions: {
            enabled: true,
            // Note: selectors must be explicitly provided for feature flags.
            selectors: [{
                keyFilter: "*"
            }],
            refresh: {
                enabled: true,
                refreshIntervalInMs: 10_000
            }
        }
    });

    // Create feature manager with feature flag provider that accesses feature flags from App Configuration
    const fm = new FeatureManager(
        new ConfigurationMapFeatureFlagProvider(appConfig));

    while (true) {
        await appConfig.refresh(); // Refresh to get the latest feature flag settings
        const isEnabled = await fm.isEnabled("Beta"); // Evaluate the feature flag
        console.log(`Beta is enabled: ${isEnabled}`);
        await sleepInMs(5000);
    }
}

run().catch(console.error);

const sleepInMs = require("util").promisify(setTimeout);
const { load } = require("@azure/app-configuration-provider");
const { FeatureManager, ConfigurationMapFeatureFlagProvider} = require("@microsoft/feature-management");
const connectionString = process.env.AZURE_APPCONFIG_CONNECTION_STRING;

async function run() {
    // Connect to Azure App Configuration using connection string
    const appConfig = await load(connectionString, {
        featureFlagOptions: {
            enabled: true,
            // Note: selectors must be explicitly provided for feature flags.
            selectors: [{
                keyFilter: "*"
            }],
            refresh: {
                enabled: true,
                refreshIntervalInMs: 10_000
            }
        }
    });

    // Create feature manager with feature flag provider that accesses feature flags from App Configuration
    const fm = new FeatureManager(
        new ConfigurationMapFeatureFlagProvider(appConfig));

    while (true) {
        await appConfig.refresh(); // Refresh to get the latest feature flag settings
        const isEnabled = await fm.isEnabled("Beta"); // Evaluate the feature flag
        console.log(`Beta is enabled: ${isEnabled}`);
        await sleepInMs(5000);
    }
}

run().catch(console.error);

Uygulamayı çalıştırma

ortam değişkenini ayarlayın.
- Microsoft Entra Id (önerilen)
- Bağlantı dizesi
AZURE_APPCONFIG_ENDPOINT adlı ortam değişkenini Azure portalındaki mağazanıza genel bakış bölümünde bulunan Uygulama Yapılandırma deponuzun uç noktasına ayarlayın.

Windows komut istemini kullanıyorsanız, aşağıdaki komutu çalıştırın ve değişikliğin etkili olması için komut istemini yeniden başlatın:
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
AZURE_APPCONFIG_CONNECTION_STRING adlı ortam değişkenini, Azure portalındaki mağazanızın Erişim anahtarları altında bulunan Uygulama Yapılandırma deponuzun salt okunur bağlantı dizesine ayarlayın.

Windows komut istemini kullanıyorsanız, aşağıdaki komutu çalıştırın ve değişikliğin etkili olması için komut istemini yeniden başlatın:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<connection-string-of-your-app-configuration-store>"
```
macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
Uygulamayı yerel olarak çalıştırmak için aşağıdaki komutu çalıştırın:
```
node app.js
```
Beta özellik bayrağı devre dışı bırakıldığından aşağıdaki konsol çıkışlarını görürsünüz.
```
Beta is enabled: false
```
Azure portalında oturum açın. Tüm kaynaklar'ı seçin ve daha önce oluşturduğunuz Uygulama Yapılandırma deposu'na tıklayın.
Özellik yöneticisi'ni seçin ve Beta özellik bayrağını bulun. Etkin altındaki onay kutusunu seçerek bayrağı etkinleştirin.
Birkaç saniye bekleyin; konsol çıkışlarının değiştiğini göreceksiniz.
```
Beta is enabled: true
```

Sonraki adımlar

JavaScript özellik yönetimi kitaplığının tam özellik çalıştırması için aşağıdaki belgeye geçin.

JavaScript Özellik Yönetimi

Özellik bayrağı, uygulamanızdaki işlevselliği etkinleştirmenize veya devre dışı bırakmanıza olanak tanırken, uygulamanızın mantığına göre bir özellik bayrağını özelleştirmek isteyebilirsiniz. Özellik filtreleri, bir özellik bayrağını koşullu olarak etkinleştirmenizi sağlar. Daha fazla bilgi için aşağıdaki öğreticiye geçin.

Özellik filtreleri ile koşullu özellikleri etkinleştirme

Azure Uygulaması Yapılandırması, özellik bayrağını yalnızca belirli bir dönemde veya uygulamanızın belirli bir hedef kitlesine etkinleştirmenizi sağlayan yerleşik özellik filtreleri sunar. Daha fazla bilgi için aşağıdaki öğreticiye geçin.

Zamanlamaya göre özellikleri etkinleştirme

Özellikleri hedeflenen hedef kitlelere sunma

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-09-30