Criar um aplicativo .js nó com o SDK do Azure para JavaScript

Este documento mostra exemplos de como usar o SDK do Azure para JavaScript para acessar valores-chave na Configuração do Aplicativo do Azure.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa - Crie uma gratuitamente
• Uma loja de configuração de aplicativos. Crie uma loja.
• Versões LTS do Node.js. Para obter informações sobre como instalar o Node.js diretamente no Windows ou usando o Subsistema Windows para Linux (WSL), consulte Introdução ao Node.js

Criar um valor-chave

Adicione o seguinte valor-chave à loja de Configuração de Aplicativos e deixe Rótulo e Tipo de Conteúdo com seus valores padrão. Para obter mais informações sobre como adicionar valores-chave a uma loja usando o portal do Azure ou a CLI, vá para Criar um valor-chave.

Configurando o aplicativo Node.js

1. Neste tutorial, você criará um novo diretório para o projeto chamado app-configuration-example.

   mkdir app-configuration-example
   

2. Alterne para o diretório app-configuration-example recém-criado.

   cd app-configuration-example
   

3. Instale a biblioteca de cliente de Configuração de Aplicativo do Azure usando o npm install comando.

   npm install @azure/app-configuration
   

4. Crie um novo arquivo chamado app-configuration-example.js no diretório app-configuration-example e adicione o seguinte código:

   const { AppConfigurationClient } = require("@azure/app-configuration");
   
   async function run() {
     console.log("Azure App Configuration - JavaScript example");
     // Example code goes here
   }
   
   run().catch(console.error);
   

Configurar a cadeia de conexão Configuração do Aplicativo

1. Defina uma variável de ambiente chamada AZURE_APPCONFIG_CONNECTION_STRING e defina-a como a cadeia de conexão da sua loja de configuração de aplicativos. Na linha de comando, execute o seguinte comando:

   • Prompt de comando do Windows
   • PowerShell
   • macOS
   • Linux

   Para executar o aplicativo localmente usando o prompt de comando do Windows, execute o seguinte comando e substitua <app-configuration-store-connection-string> pela cadeia de conexão do repositório de configuração do aplicativo:

   setx AZURE_APPCONFIG_CONNECTION_STRING "<app-configuration-store-connection-string>"
   

2. Imprima o valor da variável de ambiente para validar se ela está definida corretamente com o comando abaixo.

   • Prompt de comando do Windows
   • PowerShell
   • macOS
   • Linux

   Usando o prompt de comando do Windows, reinicie o prompt de comando para permitir que a alteração entre em vigor e execute o seguinte comando:

   echo %AZURE_APPCONFIG_CONNECTION_STRING%
   

Amostras de código

Os trechos de código de exemplo nesta seção mostram como executar operações comuns com a biblioteca de cliente de Configuração de Aplicativo para JavaScript. Adicione esses trechos de código ao corpo da run função no arquivo app-configuration-example.js criado anteriormente.

Saiba abaixo como:

• Conectar-se a uma loja de configuração de aplicativos
• Obter uma definição de configuração
• Adicionar uma definição de configuração
• Obter uma lista de definições de configuração
• Bloquear uma definição de configuração
• Desbloquear uma definição de configuração
• Atualizar uma definição de configuração
• Excluir uma definição de configuração

Conectar-se a uma loja de configuração de aplicativos

O trecho de código a seguir cria uma instância de AppConfigurationClient usando a cadeia de conexão armazenada em suas variáveis de ambiente.

const connection_string = process.env.AZURE_APPCONFIG_CONNECTION_STRING;
const client = new AppConfigurationClient(connection_string);

Obter uma definição de configuração

O trecho de código a seguir recupera uma definição de configuração por key nome.

    const retrievedConfigSetting = await client.getConfigurationSetting({
        key: "TestApp:Settings:Message"
    });
    console.log("\nRetrieved configuration setting:");
    console.log(`Key: ${retrievedConfigSetting.key}, Value: ${retrievedConfigSetting.value}`);

Adicionar uma definição de configuração

O trecho de código a seguir cria um ConfigurationSetting objeto com key e campos e value invoca o addConfigurationSetting método. Esse método lançará uma exceção se você tentar adicionar uma definição de configuração que já existe em sua loja. Se você quiser evitar essa exceção, o método setConfigurationSetting pode ser usado.

    const configSetting = {
        key:"TestApp:Settings:NewSetting",
        value:"New setting value"
    };
    const addedConfigSetting = await client.addConfigurationSetting(configSetting);
    console.log("\nAdded configuration setting:");
    console.log(`Key: ${addedConfigSetting.key}, Value: ${addedConfigSetting.value}`);

Obter uma lista de definições de configuração

O trecho de código a seguir recupera uma lista de definições de configuração. Os keyFilter argumentos e podem ser fornecidos para filtrar valores-chave com base em key e labelFilter label respectivamente. Para obter mais informações sobre filtragem, consulte como consultar definições de configuração.

    const filteredSettingsList = client.listConfigurationSettings({
        keyFilter: "TestApp*"
    });
    console.log("\nRetrieved list of configuration settings:");
    for await (const filteredSetting of filteredSettingsList) {
        console.log(`Key: ${filteredSetting.key}, Value: ${filteredSetting.value}`);
    }

Bloquear uma definição de configuração

O status de bloqueio de um valor-chave na Configuração do Aplicativo é indicado pelo readOnly atributo do ConfigurationSetting objeto. Se readOnly for true, a configuração está bloqueada. O setReadOnly método pode ser invocado com true como o segundo argumento para bloquear a definição de configuração.

    const lockedConfigSetting = await client.setReadOnly(addedConfigSetting, true /** readOnly */);
    console.log(`\nRead-only status for ${lockedConfigSetting.key}: ${lockedConfigSetting.isReadOnly}`);

Desbloquear uma definição de configuração

Se o readOnly atributo de a for false, a ConfigurationSetting configuração será desbloqueada. O setReadOnly método pode ser invocado com false como o segundo argumento para desbloquear a definição de configuração.

    const unlockedConfigSetting = await client.setReadOnly(lockedConfigSetting, false /** readOnly */);
    console.log(`\nRead-only status for ${unlockedConfigSetting.key}: ${unlockedConfigSetting.isReadOnly}`);

Atualizar uma definição de configuração

O setConfigurationSetting método pode ser usado para atualizar uma configuração existente ou criar uma nova configuração. O trecho de código a seguir altera o valor de uma definição de configuração existente.

    addedConfigSetting.value = "Value has been updated!";
    const updatedConfigSetting = await client.setConfigurationSetting(addedConfigSetting);
    console.log("\nUpdated configuration setting:");
    console.log(`Key: ${updatedConfigSetting.key}, Value: ${updatedConfigSetting.value}`);

Excluir uma definição de configuração

O trecho de código a seguir exclui uma definição de configuração por key nome.

    const deletedConfigSetting = await client.deleteConfigurationSetting({
        key: "TestApp:Settings:NewSetting"
    });
    console.log("\nDeleted configuration setting:");
    console.log(`Key: ${deletedConfigSetting.key}, Value: ${deletedConfigSetting.value}`);

Executar a aplicação

Neste exemplo, você criou um aplicativo Node.js que usa a biblioteca de cliente de Configuração de Aplicativo do Azure para recuperar uma definição de configuração criada por meio do portal do Azure, adicionar uma nova configuração, recuperar uma lista de configurações existentes, bloquear e desbloquear uma configuração, atualizar uma configuração e, finalmente, excluir uma configuração.

Neste ponto, seu arquivo app-configuration-example.js deve ter o seguinte código:

const { AppConfigurationClient } = require("@azure/app-configuration");

async function run() {
    console.log("Azure App Configuration - JavaScript example");

    const connection_string = process.env.AZURE_APPCONFIG_CONNECTION_STRING;
    const client = new AppConfigurationClient(connection_string);

    const retrievedConfigSetting = await client.getConfigurationSetting({
        key: "TestApp:Settings:Message"
    });
    console.log("\nRetrieved configuration setting:");
    console.log(`Key: ${retrievedConfigSetting.key}, Value: ${retrievedConfigSetting.value}`);

    const configSetting = {
        key: "TestApp:Settings:NewSetting",
        value: "New setting value"
    };
    const addedConfigSetting = await client.addConfigurationSetting(configSetting);
    console.log("Added configuration setting:");
    console.log(`Key: ${addedConfigSetting.key}, Value: ${addedConfigSetting.value}`);

    const filteredSettingsList = client.listConfigurationSettings({
        keyFilter: "TestApp*"
    });
    console.log("Retrieved list of configuration settings:");
    for await (const filteredSetting of filteredSettingsList) {
        console.log(`Key: ${filteredSetting.key}, Value: ${filteredSetting.value}`);
    }

    const lockedConfigSetting = await client.setReadOnly(addedConfigSetting, true /** readOnly */);
    console.log(`Read-only status for ${lockedConfigSetting.key}: ${lockedConfigSetting.isReadOnly}`);

    const unlockedConfigSetting = await client.setReadOnly(lockedConfigSetting, false /** readOnly */);
    console.log(`Read-only status for ${unlockedConfigSetting.key}: ${unlockedConfigSetting.isReadOnly}`);

    addedConfigSetting.value = "Value has been updated!";
    const updatedConfigSetting = await client.setConfigurationSetting(addedConfigSetting);
    console.log("Updated configuration setting:");
    console.log(`Key: ${updatedConfigSetting.key}, Value: ${updatedConfigSetting.value}`);

    const deletedConfigSetting = await client.deleteConfigurationSetting({
        key: "TestApp:Settings:NewSetting"
    });
    console.log("Deleted configuration setting:");
    console.log(`Key: ${deletedConfigSetting.key}, Value: ${deletedConfigSetting.value}`);
}

run().catch(console.error);

Na janela do console, navegue até o diretório que contém o arquivo app-configuration-example.js e execute o seguinte comando para executar o aplicativo:

node app.js

Deverá ver o seguinte resultado:

Azure App Configuration - JavaScript example

Retrieved configuration setting:
Key: TestApp:Settings:Message, Value: Data from Azure App Configuration

Added configuration setting:
Key: TestApp:Settings:NewSetting, Value: New setting value

Retrieved list of configuration settings:
Key: TestApp:Settings:Message, Value: Data from Azure App Configuration
Key: TestApp:Settings:NewSetting, Value: New setting value

Read-only status for TestApp:Settings:NewSetting: true

Read-only status for TestApp:Settings:NewSetting: false

Updated configuration setting:
Key: TestApp:Settings:NewSetting, Value: Value has been updated!

Deleted configuration setting:
Key: TestApp:Settings:NewSetting, Value: Value has been updated!

Clean up resources (Limpar recursos)

Se não quiser continuar a utilizar os recursos criados neste artigo, elimine o grupo de recursos que criou aqui para evitar cobranças.

1. Entre no portal do Azure e selecione Grupos de recursos.
2. Na caixa Filtrar por nome, introduza o nome do seu grupo de recursos.
3. Na lista de resultados, selecione o nome do grupo de recursos para ver uma visão geral.
4. Selecione Eliminar grupo de recursos.
5. É-lhe pedido que confirme a eliminação do grupo de recursos. Insira o nome do grupo de recursos a ser confirmado e selecione Excluir.

Após alguns momentos, o grupo de recursos e todos os seus recursos são excluídos.

Próximos passos

Este guia mostrou como usar o SDK do Azure para JavaScript para acessar valores de chave na Configuração do Aplicativo do Azure.

Para obter exemplos de código adicionais, visite:

Para saber como usar a Configuração de Aplicativo do Azure com aplicativos JavaScript, vá para: