Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-10-04

Entornos (dev/test/prod) y promoción versionada

Cómo separar desarrollo, prueba y producción en workspaces hermanos y promover un dashboard entre ellos con diff, aprobación de otra persona, aplicación idempotente y rollback.

En esta página (6)

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.

EntornoEtiquetaPara qué
devDesarrolloconstruir y romper a voluntad
testPruebavalidar con quienes lo van a usar, antes de exponerlo
prodProducciónlo 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 → test y test → prod son las transiciones normales.
  • dev → prod solo 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. 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, inalterado o conflito.

  2. 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. 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. 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.

Enlaces relacionados