Criar uma sinalização de recurso

Para criar uma sinalização de recurso, conclua estas etapas:

1. No console do App Configuration, clique em Sinalizações de recurso.

2. Selecione o Ambiente Atual para exibir a lista de sinalizadores de recursos nesse ambiente.

3. Clique em Criar. O painel lateral se abre, exibindo campos para a criação de um novo feature flag.

   

4. Forneça os detalhes da sinalização de recurso:

   • Nome - o nome da sinalização de recurso.
   • ID da sinalização de recurso - o valor do ID da sinalização de recurso é sugerido automaticamente com base no nome do recurso inserido. É possível modificar o mesmo, se necessário. Use o valor do ID da sinalização de recurso como o identificador em seu SDK ou código de API.
   • Tipo de sinalização - especifique o tipo da sinalização do recurso. O tipo suportado inclui: booleano, sequência e numérico. Para obter mais informações sobre o tipo de sinalização e valores padrão, consulte Tipo de sinalizador de recurso de seleção.
   • Valor padrão - especifique o valor padrão para o tipo de sinalização de recurso selecionado. Para obter mais informações sobre o tipo de sinalização e valores padrão, consulte Tipo de sinalizador de recurso de seleção.
   • Opcionalmente, selecione uma coleção para aplicação de uma bandeira de recurso agora. Caso contrário, você precisa adicionar uma coleção antes de alternar uma bandeira de recurso. Você pode adicionar o sinalizador de recurso a uma ou mais coleções selecionando-o na lista “Disponibilidade do sinalizador entre coleções ”.
   • rollout do recurso-especifique o Rollout percentage usando o slider. Para obter mais informações sobre a distribuição manual, consulte Configurar a porcentagem de distribuição de recursos.
   • Descrição - inclua uma descrição da sinalização de recurso, que é opcional.
   • Opcionalmente, defina tags que ajudem a identificar o feature flag.

5. Clique em Criar.

Por padrão, ao criar um novo sinalizador de recurso, o botão de alternância “Ativado” fica definido como “ OFF ”.

Selecionando um tipo de sinalização de recurso

É possível ter um dos tipos de sinalização a seguir que está associado a uma sinalização de recurso:

• Booleano
• Sequência
• Numéricos

Cada um dos tipos de sinalização tem um valor padrão.

• Ao colocar o botão seletor na posição ON, é necessário definir o valor para “Ativado”, que pode ser substituído ao selecionar um segmento como alvo.
• Quando você coloca o botão seletor na posição OFF, é necessário definir o valor para “Desativado”, que pode ser substituído ao selecionar um segmento como alvo.

Booleano

Ao selecionar o Tipo de sinalização como Booleano, os detalhes do Valor padrão são exibidos:

1. Selecione o Valor ativado na lista. Esse valor é retornado por padrão quando o botão de alternância está na posição ON para o sinalizador de recurso. Esse valor pode ser substituído ao direcionar a um segmento.

2. Selecione o Valor desativado na lista. Este valor é retornado por padrão quando o interruptor de duas posições é configurado como OFF para o sinalizador de recurso.

Sequência

Quando você seleciona o Tipo de sinalização como Sequência, os detalhes do Valor padrão são exibidos:

1. Selecione o Formato do tipo de sinalização string da lista. O formato suportado é Texto, JSON e YAML. Quando o formato JSON ou YAML é selecionado, forneça o Valor Habilitado e Valor Desativado no formato selecionado.

2. Especifique o Valor ativado. Esse valor é retornado por padrão quando o botão de alternância está na posição ON para o indicador de recurso. Esse valor pode ser substituído ao direcionar a um segmento.

3. Especifique o Valor desativado. Este valor é retornado por padrão quando o interruptor de duas posições é configurado como OFF para o sinalizador de recurso.

Numéricos

Ao selecionar o Tipo de sinalização como Numérico, os detalhes do Valor padrão são exibidos:

1. Selecione o Valor ativado na lista. Somente valores de número inteiro são suportados. Esse valor é retornado por padrão quando o botão de alternância está na posição ON para o indicador de recurso. Esse valor pode ser substituído ao direcionar a um segmento.

2. Selecione o Valor desativado na lista. Somente valores de número inteiro são suportados. Este valor é retornado por padrão quando o interruptor de duas posições é configurado como OFF para o sinalizador de recurso.

Apontar coleções como destino das sinalizações de recursos

Opcionalmente, selecione uma coleção para aplicação de uma bandeira de recurso agora. Caso contrário, você precisa adicionar uma coleção antes de alternar uma bandeira de recurso. É possível incluir sinalizações de recurso em uma ou mais coleções durante a criação da sinalização de recurso ou durante a edição dos detalhes da sinalização de recurso.

Para incluir coleções na sinalização de recurso, para o campo Disponibilidade da sinalização nas coleções, selecione a coleção na lista.

Se você tentar selecionar um sinalizador de recurso que não esteja vinculado a uma coleção, será exibida uma janela para adicionar esse sinalizador a uma coleção.

Configurar a porcentagem de lançamento de recurso

É possível configurar o sinalizador de recurso com uma porcentagem de lançamento no intervalo de 0 a 100, denotando a aplicabilidade do recurso a um conjunto parcial de usuários ou dispositivos.

A implementação manual permite disponibilizar um recurso para uma pequena porcentagem de usuários aleatórios ou para um subconjunto de entidades, proporcionando maior controle sobre o ciclo de lançamento e possibilitando uma entrega progressiva. Quando você estiver confiante no recurso que deseja rolar está funcionando como pretendido, aumente o percentual ao longo do tempo.

A distribuição manual usa um algoritmo de hashing que gera um hash com base no conjunto de regras. Esse hash é usado pelo SDK para gerar um valor percentual para esse usuário. O valor percentual gerado para esse usuário é comparado com o valor definido para o valor de implementação manual e determina se o usuário está qualificado para receber esse recurso ou não.

Por exemplo, o hash tem partições de 1 100.000. Ao atribuir um sinalizador de recurso, o hash atribui valores de 1 100.000 aos usuários em cada partição. Por exemplo, ao atribuir 25% a um flag de recurso, App Configuration SDK entrega esse recurso para hash partições de 1 25.000. Se você alterar a porcentagem de usuários que recebem esse recurso de 25% para 50%, as partições de 25.001 a 50.000 seriam adicionadas ao conjunto de partições já recebendo esse recurso.

A funcionalidade de implantação manual está disponível nos planos Lite e Enterprise.

Veja a seguir alguns dos cenários de implementação manual:

• Se o sinalizador do recurso estiver desativado, então SDK retorna o Valor Desativado padrão.
• Se o sinalizador de recurso estiver ativado sem nenhuma regra de segmento e nenhuma distribuição manual estiver definida, o SDK retornará o padrão Valor habilitado.
• Se o sinalizador de recurso estiver ativado sem nenhuma regra de segmento e a distribuição manual estiver definida como 0%, o SDK retornará o valor Disabled (Desativado ) para todos os usuários.
• Se o sinalizador de recurso estiver ativado sem nenhuma regra de segmento e a distribuição manual estiver definida como uma porcentagem, por exemplo, 50%, o SDK verificará se o usuário pertence ao tamanho da distribuição manual configurada; se o usuário pertencer aos critérios de distribuição, o SDK retornará o valor Ativado. Se o usuário não pertencer aos critérios de rollout, então o SDK retorna o Valor Desativado.
• Se o sinalizador de recurso estiver ativado com regras do segmento, então SDK primeiro avalia o usuário contra as regras configuradas. Se o usuário fizer parte da regra configurada, o SDK avaliará se o usuário está qualificado para a distribuição manual.
  • Se várias regras forem configuradas e o usuário for marcado para correspondência de regras até a primeira partida. Se nenhuma correspondência encontrada, então o SDK se avalia contra o rollout padrão.
  • Se o usuário for avaliado como parte do segmento e a distribuição manual do segmento for 0%, mesmo que o usuário faça parte do segmento, ele não receberá o valor do segmento. O SDK retorna o padrão Desativado valor.
  • Se o usuário for avaliado como parte do segmento e a distribuição manual do segmento for definida como uma porcentagem, por exemplo, 50%, o SDK verificará se o usuário pertence ao tamanho de distribuição configurado; se o usuário pertencer aos critérios de distribuição, o SDK retornará o valor de substituição do segmento. Se o usuário não pertencer aos critérios de rollout, então o SDK retorna Valor Desativado.

Apontando um segmento como destino com uma sinalização de recurso

É possível apresentar sinalizações de recurso para um ou mais segmentos de destino. Será possível configurar valores de sinalização diferentes para segmentos diferentes, se necessário.

1. No console do App Configuration, acesse Sinalizações de recurso. Este painel exibe a lista de sinalizadores de recurso disponíveis no ambiente atual da instância do serviço “ App Configuration ”.

2. Clique em Add targeting (Adicionar direcionamento ) na linha do sinalizador do recurso necessário para exibir o painel lateral Add targeting configurations (Adicionar configurações de direcionamento ).

3. A seção Rollout de recurso (Padrão) exibe o controle deslizante de porcentagem de rollout padrão definido ao criar o sinalizador de recurso. Você pode ajustar o valor da porcentagem de distribuição movendo o controle deslizante. As alterações são salvas automaticamente à medida que você ajusta o controle deslizante.

4. Na seção Rules (Regras ), você pode definir regras que controlam quem vê seu recurso e gerenciar várias regras com facilidade. A visualização inicial mostra o botão Criar regra e um campo de pesquisa para filtrar as regras existentes.

   

   Ao criar a regra, especifique o seguinte:

   • Nome da regra- Digite um nome descritivo para a regra (máximo de 100 caracteres).

   • ID da regra- Digite um identificador exclusivo para a regra. Deve conter apenas letras, números, pontos (.), hífens (-) e sublinhados (_). Máximo de 100 caracteres.

   • Na porcentagem de Rollout, você pode definir o valor como Override (Substituir ) ou Inherit (Herdar) do padrão. Se a opção Override estiver selecionada, ajuste o valor da porcentagem de Rollout usando o controle deslizante. A porcentagem é salva automaticamente à medida que você ajusta o controle deslizante.

   • Selecionar segmentos- Escolha um ou mais segmentos da lista. Os segmentos selecionados são exibidos com um indicador de contagem (por exemplo, "1 × segment is selected"). Se nenhum segmento estiver disponível para o destino, clique em Criar segmento. Para obter mais informações sobre a criação de um segmento, consulte Criar um segmento.

   • Para o Valor habilitado, você pode selecionar Override e modificar o valor ou selecionar Herdar a partir de flag.

   • Prioridade- Defina a prioridade da regra para determinar a ordem em que as regras são avaliadas. Você pode definir a prioridade para uma das seguintes opções:

     • Definir como inferior - Define a prioridade da regra como a última. Esse é a opção padrão.
     • Set to Top - Define a prioridade como a mais alta das regras (ou seja, 1).
     • Specific Position (Posição específica)- Define a prioridade para uma posição específica definida pelo usuário. (O número de prioridade pode ser de 1 a número de regras).

   A regra é criada e salva quando você clica em Save Rule (Salvar regra ). Não há um botão separado para Criar ou Cancelar- basta fechar o painel quando você terminar de configurar a regra.

5. Depois de criar uma regra, ela aparecerá na tabela de regras, mostrando as informações de Prioridade, Nome da regra, Segmentos e Distribuição. Você pode executar as seguintes ações para cada regra usando o menu de estouro:

   • Copy (Copiar )- Cria uma nova regra duplicando uma regra existente.

   

   

   • Editar regra- Modifica uma configuração de regra existente.

   

   

   • Editar prioridade- Altera a ordem de avaliação da regra. A prioridade determina a ordem em que as regras são avaliadas. As regras com um número de prioridade mais baixo são avaliadas primeiro. Você pode definir a prioridade como uma das opções mencionadas anteriormente.

   

   

   • Excluir- Remove a regra. Quando você seleciona excluir, uma caixa de diálogo de confirmação é exibida para evitar a exclusão acidental.

   

   

Se você tentar selecionar um sinalizador de recurso que não esteja vinculado a uma coleção, será exibida uma janela para adicionar esse sinalizador a uma coleção.

Como as regras de direcionamento são avaliadas

Quando você configurar o direcionamento, tenha em mente o seguinte comportamento de avaliação:

• Em um segmento, diferentes atributos são avaliados com AND.
• Em um único atributo de segmento, vários valores são avaliados com OR.
• Em uma regra de direcionamento, vários segmentos selecionados são avaliados com OR.
• Entre as regras de direcionamento, as regras são avaliadas por prioridade, e a primeira regra correspondente é aplicada.

Por exemplo, se uma regra contiver os segmentos Production - US-East e Production - Eu-De, a regra corresponderá quando um dos segmentos corresponder. Se você quiser distribuir para esses públicos separadamente, crie regras separadas ou defina cada segmento com todos os atributos necessários e ordene as regras por prioridade.

Se quiser habilitar um recurso primeiro para os usuários de produção em eu-de e, depois, para os usuários de produção em us-east, defina cada segmento com todos os atributos necessários, como, por exemplo

• Segmento 1: environment is production e region is eu-de
• Segmento 2: environment is production e region is us-east

Em seguida, direcione esses segmentos em regras separadas e ordene as regras por prioridade na visualização Editar direcionamento. Essa abordagem ajuda a garantir que cada regra corresponda apenas ao público-alvo pretendido.

Ativando uma sinalização de recurso

Depois de atribuir um feature flag a um segmento, clique no botão de ativação/desativação (ON/OFF) para ativar ou desativar o feature flag.

Sinalizações de recurso - menu overflow

O menu overflow para cada uma das sinalizações de recurso (três pontos verticais) consiste em operações Editar, Copiar e Excluir e Remover destino para aquelas sinalizações de recurso que já foram destinadas.

• Quando a opção “Editar” estiver selecionada, você poderá alterar o Nome e a Descrição, adicionar ou excluir Tags, alterar o tipo de Sinalizador e o valor Padrão, além de adicionar ou remover coleções nas informações do campo “Disponibilidade do Sinalizador entre coleções ”.
• Quando a opção “Copiar” é selecionada, as informações do sinalizador de recurso são copiadas, e você precisa alterar o nome do sinalizador de recurso. Opcionalmente, modifique os outros detalhes com base em sua necessidade.
• Quando a opção Excluir é selecionada, uma janela de confirmação é exibida para buscar a confirmação para excluir a sinalização de recurso selecionada. A opção “Excluir” exclui definitivamente o indicador de recurso, e a ação não pode ser desfeita.
• Na lista de sinalizações de recursos, em um sinalização de recurso, quando o ícone Copiar para a área de transferência é clicado, o valor do ID de sinalização de recurso da sinalização de recurso é copiado para a área de transferência.
• A remoção da segmentação elimina a atribuição de feature flags a um segmento.