Direcionamento de propriedades para segmentos

É possível criar e gerenciar propriedades, incluí-las em coleções e usá-las em seu app usando SDKs. É possível usá-los em sua infraestrutura usando plug-in do terraform ou CLI. Usando propriedades, é possível gerenciar as propriedades de configuração de sua infraestrutura ou aplicativos centralmente usando App Configuration.

Por padrão, a janela de propriedades lista todas as propriedades em um ambiente na instância atual do serviço App Configuration. São exibidos os atributos de cada propriedade, como Nome, Última atualização, Última avaliação, Segmentos visados e Tipo.

Tipos de propriedade:

  • Um tipo Booleano tem dois valores e é possível configurar o valor padrão como 'true' ou 'false'.

  • Uma propriedade do tipo Sequência suporta dados em forma de texto e arquivos JSON ou YAML.

  • Uma propriedade Numérica suporta valores de número inteiro.

  • Uma propriedade Referência secreta suporta a integração Secrets Manager.

    Para selecionar a propriedade Referência de segredo, é necessário ter uma instância Secrets Manager com acesso de Visualizador para o grupo de recursos no qual a instância do Secret Manager é criada ou existe. Além disso, é necessário ter acesso de Leitor à instância Secrets Manager.

Um caso de uso de exemplo de propriedades pode ser decidir o número de instâncias de seu aplicativo em uma região específica. Crie uma propriedade em App Configuration, com o tipo numérico, e atribua segmentos com base no valor da região.

Lista de
de propriedades*Lista de

Criar uma propriedade

Para criar uma propriedade, conclua estas etapas:

  1. No console do App Configuration, clique em Propriedades.

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

  3. Clique em Criar. O painel lateral é aberto com campos para a criação de uma nova propriedade.

    Criar
    uma nova

  4. Forneça os detalhes da propriedade:

    • Nome - nome da propriedade.
    • ID da propriedade - o valor do ID da propriedade é sugerido automaticamente com base no nome da propriedade inserida. É possível modificar o mesmo, se necessário. Use o valor de ID da propriedade como o identificador em seu código de SDK ou de API.
    • Tipo de propriedade - especifique o tipo da propriedade. O tipo suportado inclui referência Boolean, String, Numeric e Secret. Para obter mais informações sobre o tipo de propriedade e valores padrão, consulte Tipo de propriedade de seleção.
    • Valor padrão - especifique o valor padrão para o tipo de propriedade selecionado. Para obter mais informações, consulte Selecionando o tipo de propriedade.
    • Opcionalmente, é possível incluir a propriedade em uma ou mais coleções, selecionando na lista Incluir na coleção.
    • Descrição - inclua uma descrição da propriedade, que é opcional.
    • Opcionalmente, defina Tags que podem ajudá-lo a identificar a propriedade.
  5. Clique em Criar.

Selecionando o tipo de propriedade

É possível ter um dos tipos de propriedade a seguir que estão associados a uma propriedade:

  • Booleano
  • Sequência
  • Numéricos
  • Referência secreta

Cada um dos Tipos de propriedade tem um valor padrão.

  • O valor para o Valor da propriedade é necessário, o qual pode ser substituído durante o direcionamento para um segmento.

Booleano

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

Tipo de propriedade - Boolean*Seleção
-

  1. Selecione o Valor da propriedade a partir da lista (True ou False). Esse valor é retornado por padrão e pode ser substituído quando direcionamento para um segmento.

Sequência

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

Tipo de propriedade -
de propriedade -

  1. Especifique o Valor Padrão. Esse valor é retornado por padrão e ser substituído enquanto direcionamento para um segmento.

    • Formato: selecione o formato do tipo string a partir da lista. As opções são: Texto, JSON e YAML.
    • Valor da propriedade: especificar o valor da propriedade com base no formato selecionado.

Numéricos

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

Tipo de propriedade -
de propriedade -

  1. Especifique o Valor da propriedade. Esse valor é retornado por padrão e pode ser substituído enquanto direcionamento para um segmento.

Referência secreta

Ao selecionar os Tipo de propriedade como Referência secreta, os detalhes Secrets Manager instância e Valor padrão são exibidos:

Tipo de propriedade - referência
secreta*Tipo de propriedade - referência

  1. Especifique a instância Secrets Manager informações de onde os valores precisam ser puxados.

    • Grupo de recursos: selecione o grupo de recursos de onde a instância Secrets Manager a ser usada.
    • Secrets Manager instância: selecione a instância Secrets Manager para ser usada para a propriedade especificada.
  2. Especifique o Valor Padrão. Esse valor é retornado por padrão e pode ser substituído enquanto direcionamento para um segmento.

    • Tipo secreto: selecione o tipo secreto a partir da lista. Para obter mais informações sobre tipos secretos, consulte Trabalhando com segredos de diferentes tipos.
    • Nome secreto: selecione o nome secreto a partir do dropdown.

Coleções de destino para propriedades

É possível incluir propriedades em uma ou mais coleções durante a criação da propriedade ou durante a edição de detalhes de uma propriedade.

Para incluir coleções nas propriedades, para o campo Disponibilidade entre coleções, selecione a coleção na lista.

Se você tentar direcionar uma propriedade que não esteja vinculada a uma coleção, será exibida uma janela para adicionar uma propriedade a uma coleção.

Destinando um segmento com propriedades

É possível apresentar a propriedade para um ou mais segmentos de destino. É possível configurar valores de propriedade diferentes para diferentes segmentos, se necessário.

  1. A partir do console App Configuration, vá em Propriedades para exibir a lista de propriedades disponíveis no ambiente atual da instância de serviço App Configuration.

  2. Clique em Adicionar destinação na linha de propriedade necessária para exibir o painel lateral Propriedade de destino a segmentos.

    Propriedade alvo para
    alvo para segmentos*Propriedade alvo para

  3. Selecione Segmentos na lista. 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.

  4. Selecione o valor da propriedade (Inherited from property ou Override).

  5. Clique em Salvar regra para salvar as mudanças nas regras.

  6. Clique em Incluir destino.

Se você tentar direcionar uma propriedade que não esteja vinculada a uma coleção, será exibida uma janela para adicionar uma propriedade a uma coleção.

Propriedades - menu overflow

O menu overflow para cada uma das propriedades (três pontos verticais) consiste em operações Editar, Copiar e Excluir e Remover destino para a propriedade já destinada.

Menu de estouro para uma
de estouro para uma

  • Quando Editar é selecionado, você pode alterar o Nome e a Descrição, adicionar ou excluir Tags, alterar o Tipo de propriedade e o Valor padrão e adicionar ou remover coleções para as informações do campo Disponibilidade entre coleções.
  • Quando Copiar é selecionado, as informações da propriedade são copiadas e você precisa modificar o Nome da propriedade. Opcionalmente, modifique os outros detalhes com base em sua necessidade.
  • Quando a opção Excluir é selecionada, uma janela de confirmação é exibida para solicitar a confirmação da exclusão da propriedade selecionada. A opção de exclusão exclui permanentemente a propriedade e a ação não pode ser desfeita.
  • Na lista de propriedades, em uma propriedade, quando o ícone Copiar para a área de transferência é clicado, o valor de ID da propriedade da propriedade é copiado para a área de transferência.
  • Remover direcionamento remove o direcionamento de propriedades para um segmento.