Documentación

Exportar e importar configuraciones

Mueva la configuración de la organización entre espacios de trabajo como un paquete portátil, sin transferir secretos.

La configuración de la organización se puede exportar como un paquete portátil y aplicar a otra organización. Encuéntrelo en Configuración → Datos → Exportar configuraciones.

Esto resulta útil en tres situaciones: crear una segunda organización que deba coincidir con una ya existente, promover una configuración desde un espacio de trabajo de prueba a uno real, y mantener un registro revisable de cómo está configurado un espacio de trabajo.

Qué se incluye

El paquete abarca la configuración a nivel de organización:

ÁreaIncluido
Políticas y calidadPolítica de la organización, políticas de calidad, controles de proyecto, políticas de ciclo de vida y reglas de revisión.
Agentes y modelosPerfiles de AI, claves de proveedor referencias
AutomatizaciónHooks, programaciones
ConexionesIntegraciones de Control de código fuente, puentes de canal y servidores MCP.
AccesoConfiguración de Identidad empresarial y cuentas de servicio.
DatosConfiguraciones de Retención de datos, configuración de almacenamiento y destinos de auditoría.

Qué no se incluye

Los secretos nunca se transfieren. Las claves de proveedor, tokens y credenciales se exportan como marcadores de posición. El paquete registra que existe una clave y qué la utiliza, pero nunca su valor; deberá reintroducir los secretos después de importarlos.

También se excluyen elementos que corresponden a la identidad del espacio de trabajo en lugar de a la configuración: el nombre de la organización, sus miembros, su relación de facturación, y el historial operativo como tareas, ejecuciones y eventos de auditoría.

La regla es que un paquete describe cómo está un espacio de trabajo configurado, no lo que ha ocurrido en él.

Vista previa antes de aplicar

Al aplicar un paquete, primero se genera una vista previa que muestra lo que haría cada sección:

EstadoSignificado
appliedEl ajuste se creará o actualizará.
unchangedYa coincide; no hay nada que hacer.
needsRebindDepende de algo que deba reorientarse localmente.
failedNo se puede aplicar; se indica el motivo.

Lea bien la vista previa. needsRebind es el más importante: señala los ajustes que hacen referencia a algo que no existe de forma idéntica en el destino, generalmente una conexión de repositorio o un secreto. Estos requieren atención antes de que la configuración sea realmente equivalente.

Mantener los paquetes en el control de versiones

Un paquete exportado es un archivo, por lo que puede almacenarse en un repositorio, compararse y revisarse. Para los equipos que tratan la configuración como código, ese es el valor: un cambio en la política de la organización se convierte en una diferencia revisable en lugar de en un clic realizado por alguien.

Dado que los secretos son marcadores de posición, un paquete es seguro para confirmar; pero verifique si contiene algo identificable en su propia configuración antes de hacerlo público.