Administrar y usar instantáneas

En este artículo, aprenderá a crear, usar y administrar instantáneas en Azure App Configuration. La instantánea es un conjunto de opciones de configuración de App Configuration almacenada en un estado inmutable.

Requisitos previos

• Un almacén de App Configuration. Crear un almacén.
• Rol de «Propietario de datos» al almacén de App Configuration. Detalles sobre el rol y los permisos necesarios para las instantáneas

Agregar los pares de clave-valor al almacén de App Configuration

En el almacén de App Configuration, vaya al Explorador de configuración>de operaciones y agregue los siguientes valores de clave. Mantenga el valor predeterminado deTipo de contenido. Para obtener más información sobre cómo agregar pares clave-valor a un almacén mediante Azure Portal o la CLI, vaya a Creación de un par clave-valor.

Clave	Value	Etiqueta
app2/bgcolor	Gris claro	label2
app1/color	Negro	Sin etiqueta
app1/color	Azul	label1
app1/color	Verde	label2
app1/color	Amarillo	label3
app1/message	Hello	label1
app1/message	¡Hola!	label2
app2/message	Buenos días	label1

Crear una instantánea

En Operaciones>Instantáneas, seleccione Crear una instantánea.

1. Escriba un nombre de instantánea y, opcionalmente, agregue etiquetas.

2. En Elegir el tipo de composición, mantenga el valor predeterminado Clave (valor predeterminado).

   • Con el tipo de composición Clave, si el almacén tiene claves idénticas con etiquetas diferentes, solo se incluye el valor de clave especificado en el último filtro aplicable en la instantánea. Los valores de clave idénticos a otras etiquetas se dejan fuera de la instantánea.
   • Con el tipo de composición Key-Label, si el almacén tiene claves idénticas con etiquetas diferentes, todos los valores de clave con claves idénticas pero etiquetas diferentes se incluyen en la instantánea en función de los filtros especificados.

3. Seleccione Agregar filtros para seleccionar los valores de clave de la instantánea. El filtrado se realiza seleccionando filtros: Iguales, Comienza con, Cualquiera de y Todos para las claves y para las etiquetas. Puede escribir entre uno y tres filtros.

   1. Agregue el primer filtro:
      • En Clave, seleccione Comienza con y escriba app1.
      • En Etiqueta, seleccione Iguales y seleccione label2 en el menú desplegable.
   2. Agregue el segundo filtro:
      • En Clave, seleccione Comienza con y escriba app1.
      • En Etiqueta, seleccione Iguales y seleccione label1 en el menú desplegable.

4. Si archiva una instantánea, de forma predeterminada, se conservará durante 30 días después del archivado. Opcionalmente, en Opciones de recuperación, reduzca el número de días de retención que la instantánea estará disponible después del archivado.

   Nota:

   La duración del período de retención no se puede actualizar una vez creada la instantánea.

5. Seleccione Crear para generar la instantánea. En este ejemplo, la instantánea creada tiene el tipo de composición Clave y los filtros siguientes:

   • Claves que comienzan con app1, con etiqueta label2
   • Claves que comienzan con app1, con etiqueta label1

   

6. Compruebe la tabla para comprender qué valores clave del almacén de configuración terminan en la instantánea en función de los parámetros proporcionados.

   Llave	Value	Etiqueta	Incluido en la instantánea
   app2/bgcolor	Gris claro	label2	No: no comienza con app1.
   app1/color	Negro	Sin etiqueta	No: no tiene la etiqueta label2 ni label1.
   app1/color	Azul	label1	Sí: tiene la etiqueta correcta label1 de los últimos filtros aplicables.
   app1/color	Verde	label2	No: la misma clave con etiqueta label1 seleccionada por el segundo filtro la invalida, aunque tiene la etiqueta seleccionada llamadalabel2.
   app1/color	Amarillo	label3	No: no tiene la etiqueta label2 ni label1.
   app1/message	Hello	label1	Sí: tiene la etiqueta correcta label1 de los últimos filtros aplicables.
   app1/message	¡Hola!	label2	No: la misma clave con etiqueta label1 seleccionada por el segundo filtro la invalida, aunque tiene la etiqueta seleccionada llamadalabel2.
   app2/message	Buenos días	label1	No: no comienza con app1.

Creación de instantáneas de ejemplo

Para crear instantáneas de ejemplo y comprobar cómo funciona la característica de instantáneas, use el espacio aislado de instantáneas. Este espacio aislado contiene datos de ejemplo con los que puede jugar para comprender mejor cómo funcionan el tipo de composición y los filtros de la instantánea.

1. En Operaciones>Instantáneas>Instantáneas activas, seleccione Probar en espacio aislado.
2. Revise los datos de ejemplo y practique la creación de instantáneas rellenando el formulario con un tipo de composición y uno o varios filtros.
3. Seleccione Crear para generar la instantánea de ejemplo.
4. Consulte el resultado de la instantánea generado en Instantánea de ejemplo generada. La instantánea de ejemplo muestra todas las claves que se incluyen en la instantánea de ejemplo, según la selección.

Uso de instantáneas

Puede seleccionar cualquier número de instantáneas para la configuración de la aplicación. Al seleccionar una instantánea, se agregan todos sus valores de clave. Una vez agregada a una configuración, los valores de clave de las instantáneas se tratan igual que cualquier otro valor de clave.

Si tiene una aplicación que utiliza Azure App Configuration, puede actualizarla con el siguiente código de ejemplo para usar instantáneas. Solo necesita proporcionar el nombre de la instantánea, que distingue entre mayúsculas y minúsculas.

.NET

Edite la llamada al método AddAzureAppConfiguration, que a menudo se encuentra en el archivo Program.cs de la aplicación. Si no tiene una aplicación, puede hacer referencia a cualquiera de las guías de inicio rápido de .NET, como la creación de una aplicación principal de ASP.NET con Azure App Configuration.

Adición de instantáneas a la configuración

configurationBuilder.AddAzureAppConfiguration(options =>
{
    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"));

    // Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
    options.SelectSnapshot("SnapshotName");
    
    // Other changes to options
});

Nota:

La compatibilidad con la instantánea está disponible si usa la versión 7.0.0 o posterior de cualquiera de los siguientes paquetes.

• Microsoft.Extensions.Configuration.AzureAppConfiguration
• Microsoft.Azure.AppConfiguration.AspNetCore
• Microsoft.Azure.AppConfiguration.Functions.Worker

Spring

Actualice el archivo bootstrap.yml de la aplicación con las siguientes configuraciones.

spring:
  cloud:
    azure:
      appconfiguration:
        stores:
         -
           endpoint: <your-endpoint>
           selects:
             -
              snapshot-name: <name-of-your-snapshot>
           trim-key-prefix: 
             - <prefix-to-trim>

Nota:

Cualquier prefijo, como /application/, el cual se recorta automáticamente al utilizar un filtro de claves deberá especificarse para las instantáneas o no se asignarán correctamente a las clases @ConfigurationProperties correctas. La compatibilidad con la instantánea está disponible si usa la versión 4.12.0-beta.1/5.6.0-beta.1 o posterior de cualquiera de los siguientes paquetes.

• spring-cloud-azure-appconfiguration-config
• spring-cloud-azure-appconfiguration-config-web
• spring-cloud-azure-starter-appconfiguration-config

Nota:

Solo se pueden cargar las instantáneas creadas con el tipo de composición Key mediante los ejemplos de código mostrados anteriormente.

Administración de instantáneas activas

La página en Operaciones>Instantáneas muestra dos pestañas: Instantáneas activas e Instantáneas archivadas. Seleccione Instantáneas activas para ver la lista de todas las instantáneas activas en un almacén de App Configuration.

Usar instantánea existente

En la pestaña Instantáneas activas, seleccione los puntos suspensivos ... a la derecha de una instantánea existente y seleccione Ver para ver una instantánea. Esta acción abre una página de detalles de instantánea que muestra la configuración de la instantánea y los valores de clave incluidos en la instantánea.

Archivar una instantánea

En la pestaña Instantáneas activas, seleccione los puntos suspensivos ... a la derecha de una instantánea existente y seleccione Ver para ver una instantánea. Para confirmar el archivo, seleccione Sí o cancele con No. Una vez archivada una instantánea, aparece una notificación para confirmar la operación y se actualiza la lista de instantáneas activas.

Administración de instantáneas archivadas

Vaya a Operaciones>Instantáneas>Instantáneas archivadas para ver la lista de todas las instantáneas archivadas en un almacén de App Configuration. Las instantáneas archivadas permanecen accesibles durante el período de retención que se seleccionó durante su creación.

Visualización de la instantánea archivada

La vista detallada de la instantánea también está disponible en el estado de archivo. En la pestaña Instantáneas archivadas, seleccione los puntos suspensivos ... a la derecha de una instantánea existente y seleccione Ver para ver una instantánea. Esta acción abre una página de detalles de instantánea que muestra la configuración de la instantánea y los valores de clave incluidos en la instantánea.

Recuperar una instantánea archivada

En la pestaña Instantáneas archivadas, seleccione los puntos suspensivos ... a la derecha de una instantánea archivada y seleccione Recuperar para recuperar una instantánea. Una vez recuperada una instantánea, aparece una notificación para confirmar la operación y se actualiza la lista de instantáneas archivadas.

Pasos siguientes

Instantáneas en Azure App Configuration