Quien construye un panel quiere probar antes de mostrarlo. El producto separa eso en
tres ambientes — dev, test y prod — y ofrece un flujo de promoción
que lleva la definición de un dashboard de un ambiente al siguiente sin copiar
datos, sin copiar credenciales y sin edición manual en el destino.
Qué es un ambiente aquí#
No existe un registro separado de "ambiente". El ambiente es una convención sobre el
workspace: una etiqueta [dev], [test] o [prod] en el nombre del workspace (o
el nombre completo siendo dev/test/prod). Los workspaces hermanos pertenecen a la misma
organización — es ella la que indica qué dev/test/prod
forman un conjunto.
| Entorno | Etiqueta | Para qué |
|---|---|---|
dev | Desarrollo | construir y romper a voluntad |
test | Prueba | validar con quienes lo van a usar, antes de exponerlo |
prod | Producción | lo que la empresa consume y comparte |
Sin etiqueta, el workspace se trata como sin ambiente declarado y no entra en el flujo de promoción.
La regla de orden#
La promoción es siempre hacia adelante y nunca salta etapas sin registro:
dev → testytest → prodson las transiciones normales.dev → prodsolo con forzar explícito, y eso queda en la auditoría.- Retroceder (
prod → test) o promover al mismo ambiente no está permitido — para revertir existe el rollback (más abajo).
El flujo: diff → aprobar → aplicar → rollback#
La promoción se construye sobre el BI-as-code: el diff es el mismo dry-run del import; aplicar es el mismo merge aditivo.
1. Generar el plan (diff)
En el panel de origen, abra Promoção y elija el workspace de destino. El producto exporta la definición, elimina cualquier referencia local del ambiente de origen (como el vínculo con el modelo semántico de ese workspace) y calcula, entidad por entidad, qué es
novo,inalteradooconflito.2. Aprobar (otra persona)
Quien aprueba no puede ser quien promueve — segregación de funciones. Los conflictos exigen estrategia explícita (
manter_meu/usar_deles); sin elección, la promoción no aplica nada.3. Aplicar
El merge es aditivo e idempotente: aplicar la misma promoción dos veces no cambia nada en la segunda (todo pasa a ser
inalterado). El estado del destino antes de aplicar queda guardado en el plan.4. Rollback
Volver es reescribir el snapshot capturado en el paso 3. También queda en la auditoría.
Regla de oro: la credencial nunca viaja#
La exportación ya nace sin secreto (lee solo la definición del panel). Aun así, antes de aplicar, el producto recorre el contenido y elimina cualquier clave sensible (contraseña, token, clave de API, credencial de cuenta de servicio…) que haya sido inyectada en alguna configuración. Conexiones, chaves y datos no migra(n); en el destino usas las conexiones del propio destino y ejecutas el refresh.
Qué queda registrado#
Cada promoción genera eventos en la auditoría: quién pidió, quién aprobó, origen, destino, si fue forzada, resumen del plan aplicado y, si lo hubo, el rollback.
Límites actuales#
- La promoción cubre dashboards e modelo (la definición). Pipelines tienen su propio versionamiento (publicar e versionar) y no son promovidos por este flujo.
- Los tres ambientes son workspaces separados: cada uno tiene su propio datalake, sus propias conexiones y sus propios créditos.
Relacionado: BI-as-code · Organización y workspaces · Roles (RBAC) · Auditoría.