Una base de datos sin respaldos es una apuesta. En este artículo cuento cómo mi compañero Kevin Hinojosa y yo diseñamos y automatizamos la estrategia de respaldo de TacnaGo, nuestra guía de lugares turísticos de Tacna que guarda sus datos en Azure Cosmos DB for NoSQL. Yo me encargué de la parte de infraestructura y automatización: dónde se guardan los respaldos, cuánto tiempo se conservan y cómo se ejecutan solos con GitHub Actions.
👉 App publicada: https://app-tacnago-geraldzvallos.azurewebsites.net
👉 Repositorio: https://github.com/Geraldzvallos/tacnago-cosmosdb
El punto de partida
TacnaGo es una API en .NET 9 con una página web, desplegada en Azure App Service. Cada lugar es un documento JSON en el contenedor Lugares de Cosmos DB, con la categoría como clave de partición. Toda la infraestructura se crea con Terraform y se despliega con GitHub Actions.
Cosmos DB ya trae un respaldo automático, pero no basta por sí solo:
- El respaldo periódico nativo guarda una copia cada 4 horas y conserva solo las 2 últimas (8 horas de retención). Si alguien borra datos un viernes y nadie se da cuenta hasta el lunes, ya no hay copia.
- Para restaurarlo hay que abrir un ticket de soporte con Azure, y se restaura toda la cuenta en una cuenta nueva.
- El respaldo continuo (restauración a un punto en el tiempo) es mejor, pero cambiar a ese modo no tiene vuelta atrás y nuestra cuenta de Cosmos DB la compartimos con otro proyecto.
Por eso agregamos un respaldo lógico propio, que controlamos nosotros.
La estrategia en capas
| Capa | Qué hace | Dónde | Retención |
|---|---|---|---|
| 1. Respaldo nativo | Copia automática de la cuenta cada 4 horas | Azure (geo-redundante) | 8 horas |
| 2. Respaldo lógico diario | Exporta el contenedor a JSON comprimido con SHA-256 | Azure Blob Storage | 37 días |
| 3. Copia fuera de Azure | El mismo archivo como artefacto de GitHub Actions | GitHub | 30 días |
| 4. Prueba de restauración | Restaura cada semana el último respaldo y lo verifica | Contenedor Lugares-restore | — |
Con esto el RPO (cuántos datos podemos perder como máximo) es de 24 horas con el respaldo lógico, y el RTO (cuánto tardamos en recuperarnos) es de unos minutos: lo que demora ejecutar un workflow.
La infraestructura de respaldos con Terraform
Los respaldos viven en una cuenta de almacenamiento separada de la base de datos. Así, un problema en la base no se lleva también las copias. La cuenta tiene versionado y borrado temporal, de modo que un respaldo sobrescrito o borrado por error se puede recuperar:
resource "azurerm_storage_account" "backups" { name = "sttacnagobkgerald" account_tier = "Standard" account_replication_type = "LRS" min_tls_version = "TLS1_2" allow_nested_items_to_be_public = false blob_properties { versioning_enabled = true delete_retention_policy { days = 7 } } } La retención la aplica Azure solo, con una política de ciclo de vida: los respaldos pasan al nivel Cool (más barato) a los 7 días y se borran a los 37.
actions { base_blob { tier_to_cool_after_days_since_modification_greater_than = 7 delete_after_days_since_modification_greater_than = 37 } } Terraform también crea el contenedor de prueba Lugares-restore, con la misma clave de partición, dentro de la misma base. Comparte los RU/s de la base, así que no cuesta nada extra.
El respaldo diario: backup.yml
Se ejecuta todos los días a las 00:00 (hora de Perú) con un schedule, y también se puede lanzar a mano:
on: schedule: - cron: '0 5 * * *' # 05:00 UTC = 00:00 en Perú workflow_dispatch: Los pasos son:
- Inicia sesión en Azure con un service principal guardado en los secrets del repositorio.
- Obtiene la clave de Cosmos DB con
az cosmosdb keys listy la enmascara en el log (::add-mask::). - Ejecuta
backup/backup.py, que lee todos los documentos, quita las propiedades del sistema (_rid,_etag,_ts) y guarda un.json.gzcon la cantidad de documentos y un hash SHA-256. - Sube el archivo a Blob Storage con la cantidad y el hash como metadatos.
- Guarda una segunda copia como artefacto de GitHub Actions.
- name: Subir el respaldo a Azure Blob Storage run: | az storage blob upload --container-name "$BLOB_CONTAINER" \ --name "tacnago/${{ steps.respaldo.outputs.nombre }}" \ --file "${{ steps.respaldo.outputs.archivo }}" \ --metadata documentos=${{ steps.respaldo.outputs.documentos }} La prueba de restauración: restore.yml
Un respaldo que nunca se probó no es un respaldo. Por eso restore.yml corre cada domingo y:
- Descarga el último respaldo de Blob Storage.
- Verifica el SHA-256 (si el archivo está dañado, falla).
- Vacía el contenedor de prueba
Lugares-restorey restaura ahí todos los documentos. - Comprueba que la cantidad coincida y lee cada documento por su id y su clave de partición.
En una emergencia real, el mismo workflow se ejecuta a mano eligiendo el destino Lugares. Restaura con upsert, así que se puede repetir sin duplicar datos.
Los respaldos en la app
La app tiene una sección "Respaldos de la base de datos" y un endpoint GET /api/respaldos que lista los respaldos guardados en Blob Storage, con su fecha, cantidad de documentos, tamaño y nivel de acceso. La cadena de conexión de la cuenta de respaldos la pasa Terraform a la configuración del App Service, así que no aparece en el código.
Problemas que encontré
- La cuenta de Cosmos DB es compartida. Usamos la cuenta gratuita de la suscripción, que también usa otro proyecto, así que no cambié su política de respaldo nativa (pasar a respaldo continuo no tiene vuelta atrás). El respaldo lógico funciona a nivel de nuestro contenedor sin tocar la cuenta.
- Los permisos del service principal. El rol Contributor no puede leer blobs con Azure AD (
--auth-mode login), así que el workflow obtiene la clave de la cuenta conaz storage account keys listy la enmascara en el log. - El nivel Cool tiene un tiempo mínimo de 30 días. Si un blob se borra antes, Azure cobra la diferencia. Por eso los respaldos se borran a los 37 días (7 en Hot + 30 en Cool) y no a los 30.
Conclusiones
- El respaldo nativo de Cosmos DB es un buen piso, pero un respaldo lógico propio da más retención, independencia y control.
- Guardar las copias en otra cuenta y en otro proveedor (GitHub) sigue la idea de la regla 3-2-1.
- La prueba de restauración automática es lo que da confianza: cada semana sabemos que el último respaldo sirve.
Enlaces
- Repositorio: https://github.com/Geraldzvallos/tacnago-cosmosdb
- Workflows de respaldo y restauración: https://github.com/Geraldzvallos/tacnago-cosmosdb/actions
- App publicada: https://app-tacnago-geraldzvallos.azurewebsites.net
- Video (grabado con Kevin): https://youtu.be/z_5a_3TTS8E
