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 contiene permanecen inalterados.
Hay una breve introducción disponible en este vídeo, donde se resaltan tres razones por las que las instantáneas pueden 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 puede provocar problemas como la interrupción del servicio y la pérdida de datos. Para evitar estos problemas, es importante poder examinar los cambios de configuración antes de pasar a entornos de producción. Si se produce 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 un lanzamiento controlado. El único cambio necesario en una aplicación para iniciar un lanzamiento controlado es actualizar el nombre de la instantánea a la que hace referencia la aplicación. A medida que la aplicación pasa a producción, hay una garantía de que la configuración de la instantánea a la que se hace referencia permanece sin cambios. Esta garantía frente a cualquier cambio en una instantánea protege frente a configuraciones inesperadas que puedan 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 implementa de forma segura.
Escenarios para usar instantáneas
Lanzamiento controlado: las instantáneas son adecuadas para admitir el lanzamiento controlado debido a su naturaleza inmutable. Cuando los desarrolladores usan instantáneas para la configuración, pueden estar seguros de que la configuración permanece sin cambios a medida que avanza 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 pueden asegurarse de que se dispone 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 sincronizar 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 pueden asegurarse de que se usa la misma configuración en distintos entornos, mediante el uso de la misma instantánea, lo que puede 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 los valores de clave 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, ayuda a simplificar la composición del cliente, ya que los clientes ahora pueden hacer referencia al conjunto de valores clave que requieren por nombre.
Operaciones de instantáneas
A medida que las instantáneas son entidades inmutables, las instantáneas solo se pueden crear y archivar. No es posible eliminar, purgar ni editar.
Crear instantánea: 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 valores de clave filtrados se almacenan como una instantánea con el nombre proporcionado durante la creación.
Instantánea de archivo: el archivado de una instantánea lo coloca en un estado archivado. Aunque una instantánea esté archivada, sigue siendo totalmente funcional. Cuando se archiva la instantánea, se establece 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, desaparece automáticamente del sistema cuando transcurre el tiempo de expiración. El archivado se usa para eliminar las instantáneas que ya no están en uso.
Recuperar instantánea: la recuperación de una instantánea vuelve a ponerla en un estado activo. En este momento, la instantánea ya no está 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 periodo de retención es de 30 días para los almacenes Estándar y de 7 días para los almacenes Gratis.
Requisitos para las operaciones de instantánea
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/readMicrosoft.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 una instantánea
Para archivar o recuperar una instantánea mediante la autenticación de Microsoft Entra, se necesita el siguiente permiso. El rol propietario de datos App Configuration ya tiene este permiso.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Para archivar o recuperar una instantánea 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, o bien obtener todos los valores de clave en una instantánea individual por su nombre, se necesita el siguiente permiso para los almacenes que usan la autenticación de Microsoft Entra. Los roles integrado Propietario de datos y Lector de datos ya tienen este permiso.
Microsoft.AppConfiguration/configurationStores/snapshots/read
En el caso de los almacenes que usan la autenticación HMAC, se pueden realizar las operaciones de "instantánea de lectura" (para leer los valores de clave de una instantánea) y la operación de "instantáneas de lista" mediante las claves de acceso de lectura y escritura o las claves de acceso de solo lectura.
Consideraciones de facturación y límites
App Configuration tiene tres niveles, Gratis, Estándar y Premium. Consulte los detalles siguientes para ver las cuotas de instantáneas en cada nivel.
Nivel Gratis: este nivel tiene una cuota de almacenamiento de instantáneas de 10 MB. Se pueden crear tantas instantáneas como sea posible siempre que el tamaño total de almacenamiento de todas las instantáneas activas y archivadas sea inferior a 10 MB.
Nivel Estándar: este nivel tiene una cuota de almacenamiento de instantáneas de 1 GB. Se pueden crear tantas instantáneas como sea posible, siempre que el tamaño total de almacenamiento de todas las instantáneas activas y archivadas sea inferior a 1 GB.
Nivel Premium: este nivel tiene una cuota de almacenamiento de instantáneas de 4 GB. Uno puede crear tantas instantáneas como sea posible, siempre y cuando el tamaño total de almacenamiento de todas las instantáneas activas y archivadas sea inferior a 4 GB.
El tamaño máximo de una instantánea es de 1 MB.