Inicio rápido: administración de las marcas de características en Azure App Configuration
Azure App Configuration incluye marcas de características, que se pueden usar para habilitar o deshabilitar funcionalidades y marcas de características variantes (versión preliminar), que permiten distintas variaciones de marcas de características.
El Administrador de características de Azure Portal proporciona una interfaz de usuario para crear y administrar las marcas de características y las marcas de características variantes que se usan en las aplicaciones.
Requisitos previos
- Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.
- Un almacén de App Configuration. Crear un almacén.
Creación de una marca de características
Agregue una nueva marca de características siguiendo los pasos que se indican a continuación.
Abra el almacén de Azure App Configuration en Azure Portal y, en el menú Operaciones, seleccione Administrador de características>Crear. A continuación, seleccione Marca de características.
En Crear, seleccione o escriba la siguiente información:
Configuración Valor de ejemplo Descripción Habilitar marca de características La casilla está activada Esta opción habilita la marca de características tras la creación. Si se deja esta casilla desactivada, se guardará la configuración de la nueva marca de características, pero la nueva marca de características permanecerá deshabilitada. Nombre de la marca de características Beta El nombre de la marca de características es lo que se usa para hacer referencia a la marca en el código. Debe ser único dentro de una aplicación. Clave Beta Use la clave para filtrar las marcas de características que se cargarán en la aplicación. La clave se genera a partir del nombre de la marca de características de forma predeterminada, pero también es posible agregar un prefijo o un espacio de nombres para agrupar las marcas de características. Por ejemplo: .appconfig.featureflag/myapp/Beta. Label Dejar en blanco Use etiquetas para crear diferentes marcas de características para la misma clave y filtras marcas cargadas en la aplicación en función de la etiqueta. De forma predeterminada, una marca de características no tiene etiqueta. Descripción Dejar en blanco Déjela vacía o escriba una descripción para la marca de características. Usar un filtro de características La casilla está desactivada Deje desactivada la casilla de filtro de características. Para más información sobre los filtros de características, consulte Uso de filtros de características para habilitar las marcas de características condicionales y Habilitar el lanzamiento preconfigurado de características para audiencias de destino. Seleccione Aplicar para crear la marca de características.
Creación de una marca de características variante (versión preliminar)
Agregue una nueva marca de características variante (versión preliminar) abriendo el almacén de Azure App Configuration en Azure Portal y, en el menú Operaciones, seleccione Administrador de características>Crear. A continuación, seleccione marca de características variante (versión preliminar).
Configurar conceptos básicos
En las pestañas de Detalles, seleccione o escriba la siguiente información:
| Configuración | Valor de ejemplo | Descripción |
|---|---|---|
| Habilitar marca de características | La casilla está activada | Esta opción habilita la marca de características tras la creación. Si se deja esta casilla desactivada, se guardará la configuración de la nueva marca de características, pero la nueva marca de características permanecerá deshabilitada. |
| Nombre | Saludo | El nombre de la marca de características es lo que se usa para hacer referencia a la marca en el código. Debe ser único dentro de una aplicación. |
| Clave | Saludo | Use la clave para filtrar las marcas de características que se cargarán en la aplicación. La clave se genera a partir del nombre de la marca de características de forma predeterminada, pero también es posible agregar un prefijo o un espacio de nombres para agrupar las marcas de características. Por ejemplo: .appconfig.featureflag/myapp/Greeting. |
| Label | Dejar en blanco | Use etiquetas para crear diferentes marcas de características para la misma clave y filtras marcas cargadas en la aplicación en función de la etiqueta. De forma predeterminada, una marca de características no tiene etiqueta. |
| Descripción | Dejar en blanco | Déjela vacía o escriba una descripción para la marca de características. |
Seleccione Siguiente > para agregar Variantes.
Agregar variantes
En la pestaña Variantes, seleccione o escriba la siguiente información.
| Configuración | Valor de ejemplo | Descripción |
|---|---|---|
| Nombre de la variante | Desactivado y activado | De forma predeterminada, se agregan dos variantes. Actualícelas o escriba un nombre para una nueva variante. Los nombres de las variantes deben ser únicos dentro de una marca de características. |
| Valor | false y true | Proporcione un valor para cada variante. El valor puede ser una cadena, un número, un valor booleano o un objeto de configuración. Para editar el valor en un editor JSON, seleccione Editar valor en varias líneas. |
| Variante predeterminada | Desactivado | Elija la variante predeterminada de la lista desplegable. La marca de características devuelve la variante predeterminada cuando no se asigna ninguna variante a una audiencia o la marca de características está deshabilitada. Junto a la variante predeterminada designada, se muestra la palabra Valor predeterminado. |
Seleccione Siguiente > para acceder a la configuración de Asignación.
Asignación de tráfico
En la pestaña Asignación, seleccione o escriba la siguiente información:
Distribuir el tráfico entre cada variante, sumando exactamente el 100 %.
Opcionalmente, seleccione las opciones Invalidar por grupos e Invalidar por usuarios para asignar variantes para grupos o usuarios seleccionados. Estas opciones están deshabilitadas de forma predeterminada.
En Distribución, seleccione opcionalmente Usar inicialización personalizada y proporcione una cadena no vacía como un nuevo valor de inicialización. El uso de la inicialización común en varias marcas de características permite asignar el mismo usuario al mismo percentil. Resulta útil al implementar varias marcas de características al mismo tiempo y si se quiere garantizar una experiencia coherente para cada segmento de la audiencia. Si no se especifica ninguna inicialización personalizada, se usará una inicialización predeterminada en función del nombre de la característica.
Seleccione Revisar y crear para ver un resumen de la nueva marca de características variante y, a continuación, seleccione Crear para finalizar la operación. Una notificación indicará que la nueva marca de característica se creó correctamente.
Editar marcas de características
Para actualizar una marca de características o una marca de características variante:
En el menú Operaciones, seleccione Administrador de características.
Vaya al extremo derecho de la marca de características o marca de características variante que quiera modificar y seleccione el botón de puntos suspensivos Más acciones (...). En este menú, es posible editar la marca, bloquearla o desbloquearla, crear una etiqueta, actualizar etiquetas, revisar el historial o eliminar la marca.
Seleccione Editar y actualice la marca.
Opcionalmente, es posible cambiar el estado de una marca de características activando o desactivando el botón de alternancia Habilitado.
Administrar vistas
El menú Administrador de características muestra las marcas de características y las marcas de características variantes almacenadas en Azure App Configuration. Cambie la presentación del Administrador de características en Azure Portal seleccionando Administrar vista.
Configuración permite elegir cuántas marcas de características se cargarán por cada acción Cargar más. Cargar más solo estará visible si hay más de 200 marcas de características.
Editar columnas permite agregar o quitar columnas y cambiar el orden de las mismas.
Las marcas de características creadas con el Administrador de características se almacenan como pares clave-valor normales. Se guardan con el prefijo especial .appconfig.featureflag/ y el tipo de contenido application/vnd.microsoft.appconfig.ff+json;charset=utf-8. Para ver los pares clave-valor subyacentes de las marcas de características en el Explorador de configuración, siga estos pasos.
En el menú Operaciones, abra el Explorador de configuración y, a continuación, seleccione Administrar vista>Configuración.
Seleccione Include feature flags in the configuration explorer y Apply.
Pasos siguientes
Para empezar a usar marcas de características con Azure App Configuration, continúe con los siguientes inicios rápidos específicos del lenguaje o la plataforma de su aplicación.