Instantáneas

Una instantánea es un subconjunto inmutable y con nombre de los valores clave de un almacén de App Configuration. Los valores clave que componen una instantánea se eligen durante el tiempo de creación mediante el uso de filtros de clave y etiqueta. Una vez creada una instantánea, se garantiza que los valores clave que contenga permanezcan inalterados.

Hay una breve introducción disponible en este vídeo, donde se resaltan tres razones por las que las instantáneas podrían resultarle útiles.

Implementación segura con instantáneas

Las instantáneas están diseñadas para implementar de forma segura los cambios de configuración. La implementación de cambios de configuración defectuosos en un entorno en ejecución podría provocar problemas, como la interrupción del servicio y la pérdida de datos. Para evitar estos problemas, resulta importante examinar los cambios de configuración antes de que pasen a entornos de producción. Si se produjese este problema, es importante poder revertir los cambios de configuración defectuosos para restaurar el servicio. Las instantáneas se crean para administrar estos escenarios.

Los cambios de configuración deben implementarse de forma controlada y coherente. Los desarrolladores pueden usar instantáneas para realizar lanzamientos controlados. El único cambio necesario en una aplicación para iniciar un lanzamiento controlado consiste en actualizar el nombre de la instantánea a la que haga referencia la aplicación. A medida que la aplicación pase a producción, hay una garantía de que la configuración de la instantánea a la que se haga referencia permanezca sin cambios. Esta garantía frente a cualquier cambio en una instantánea protege frente a configuraciones inesperadas que pudieran llegar a producción. La inmutabilidad y la facilidad de referencia de las instantáneas hacen que sea sencillo garantizar que el conjunto correcto de cambios en la configuración se implemente de forma segura.

Escenarios de uso de instantáneas

• Lanzamiento controlado: las instantáneas son adecuadas para llevar a cabo lanzamientos controlados debido a su naturaleza inmutable. Cuando los desarrolladores usen instantáneas para la configuración, podrán estar seguros de que la configuración permanecerá sin cambios a medida que avance la versión a través de distintas fases del lanzamiento.

• Última configuración válida conocida (LKG): las instantáneas pueden usarse como soporte de procedimientos seguros de implementación de la configuración. Con las instantáneas, los desarrolladores se asegurarán de que se disponga de una última configuración válida conocida (LKG) para revertirla si se produjera algún problema durante la implementación.

• Control de versiones de configuración: las instantáneas se pueden usar para crear un historial de versiones de las opciones de configuración para su sincronización con las versiones de lanzamiento. La configuración capturada en cada instantánea se puede comparar para identificar los cambios entre versiones.

• Auditoría: las instantáneas se pueden usar con fines de auditoría y cumplimiento. Los desarrolladores pueden mantener un registro de los cambios de configuración entre versiones mediante las instantáneas de las versiones.

• Entornos de pruebas y ensayo: las instantáneas se pueden usar para crear entornos de ensayo y pruebas coherentes. Los desarrolladores se asegurarán de que se use la misma configuración en distintos entornos con el uso de la misma instantánea, lo que ayudará con la depuración y las pruebas.

• Composición simplificada de la configuración de cliente: normalmente, los clientes de App Configuration necesitan un subconjunto de pares clave-valor de la instancia de App Configuration. Para obtener el conjunto de pares clave-valor necesarios, deben tener la lógica de consulta escrita en el código. Como las instantáneas admiten la provisión de filtros durante el tiempo de creación, esto ayuda a simplificar la composición del cliente, ya que los clientes ya pueden hacer referencia al conjunto de valores clave que requieran por nombre.

Operaciones de instantáneas

Como las instantáneas son entidades inmutables, solo se pueden crear y archivar. No se pueden eliminar, purgar ni editar.

• Crear instantáneas: las instantáneas se pueden crear definiendo los filtros de clave y etiqueta para capturar los valores de clave necesarios de la instancia de App Configuration. Los pares clave-valor filtrados se almacenan como instantánea con el nombre proporcionado durante la creación.

• Archivas instantáneas: el archivado de una instantánea la coloca en estado archivado. Aunque una instantánea esté archivada, sigue siendo totalmente funcional. Cuando se archive la instantánea, se establecerá una hora de expiración en función del período de retención configurado durante la creación de la instantánea. Si la instantánea permanece en estado archivado hasta la hora de expiración, desaparecerá automáticamente del sistema cuando transcurra el tiempo de expiración. El archivado se usa para eliminar las instantáneas que ya no estén en uso.

• Recuperar instantáneas: la recuperación de una instantánea vuelve a ponerla en estado activo. En este momento, la instantánea ya no estará sujeta a expiración en función de su período de retención configurado. La recuperación solo es posible en el período de retención después del archivado.

Nota

El período de retención solo se puede establecer durante la creación de una instantánea. El valor predeterminado para el período de retención es de 30 días para los almacenes de nivel Estándar y Premium, y de 7 días para los almacenes de nivel Gratis y Desarrollador.

Requisitos para las operaciones de instantáneas

En las secciones siguientes se detallan los permisos necesarios para realizar operaciones relacionadas con instantáneas con la autenticación de Microsoft Entra ID y HMAC.

Crear una instantánea

Para crear una instantánea en almacenes mediante la autenticación de Microsoft Entra, se requieren los permisos siguientes. El rol Propietario de datos de App Configuration ya tiene estos permisos.

• Microsoft.AppConfiguration/configurationStores/keyvalues/read
• Microsoft.AppConfiguration/configurationStores/snapshots/write

Para crear una instantánea mediante la autenticación HMAC, se debe usar una clave de acceso de lectura y escritura.

Archivar y recuperar instantáneas

Para archivar o recuperar instantáneas mediante la autenticación de Microsoft Entra, se necesita el siguiente permiso. El rol Propietario de datos de App Configuration ya tiene este permiso.

• Microsoft.AppConfiguration/configurationStores/snapshots/archive/action

Para archivar o recuperar instantáneas mediante la autenticación HMAC, se debe usar una clave de acceso de lectura y escritura.

Leer y enumerar instantáneas

Para enumerar todas las instantáneas u obtener todos los pares clave-valor en una instantánea individual por su nombre, se necesita el siguiente permiso para los almacenes que usen la autenticación de Microsoft Entra. Los roles integrados Propietario de datos y Lector de datos ya tienen este permiso.

• Microsoft.AppConfiguration/configurationStores/snapshots/read

En el caso de los almacenes que usen la autenticación HMAC, se pueden realizar las operaciones "leer instantánea" (para leer los pares clave-valor de una instantánea) y "enumerar instantáneas" mediante las claves de acceso de lectura y escritura o las claves de acceso de solo lectura.

Consideraciones y límites de facturación

App Configuration tiene cuatro niveles: Gratis, Desarrollador, Estándar y Premium. En la tabla siguiente se resumen las cuotas de almacenamiento de instantáneas para cada nivel:

Nivel	Cuota de almacenamiento de instantáneas
Gratuito	10 MB
Desarrollador	500 MB
Estándar	1 GB
De primera calidad	4 GB

Puede crear tantas instantáneas como sea necesario, siempre y cuando el tamaño total de almacenamiento de todas las instantáneas activas y archivadas no supere la cuota del nivel. El tamaño máximo de una instantánea individual es de 1 MB.

Pasos siguientes

Creación de instantáneas