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.
Criar uma propriedade
Para criar uma propriedade, conclua estas etapas:
-
No console do App Configuration, clique em Propriedades.
-
Selecione o Ambiente Atual para exibir a lista de propriedades nesse ambiente.
-
Clique em Criar. O painel lateral é aberto com campos para a criação de uma nova propriedade.
uma nova -
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.
-
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:
- 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:
-
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:
- 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:
-
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.
-
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.
-
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.
-
Clique em Adicionar destinação na linha de propriedade necessária para exibir o painel lateral Propriedade de destino a segmentos.
alvo para segmentos*Propriedade alvo para -
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.
-
Selecione o valor da propriedade (Inherited from property ou Override).
-
Clique em Salvar regra para salvar as mudanças nas regras.
-
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.