ajat

ajat significa “Atlassian Jira Automation Tool”.

Es la herramienta de gobernanza y portabilidad de la automatización de Jira dentro del portafolio de Climakers. Se utiliza cuando la automatización ha crecido más allá de una sola pantalla de proyecto hasta convertirse en una malla a escala de organización: reglas globales, reglas de proyecto, reglas multiproyecto, reglas manuales, etiquetas, actores, webhooks y disparadores programados que resultan difíciles de revisar solo desde Jira. ajat convierte esa malla en archivos controlados por el cliente, informes autocontenidos y operaciones repetibles.

Qué hace

• Exporta todas las reglas de Jira Automation de un tenant a un árbol de archivos JSON organizado por scope con un solo comando.
• Genera cinco informes HTML autocontenidos — inventory, collision, consistency, risk y workflow — que leen la exportación localmente sin llamar a Jira.
• Compara dos snapshots de exportación para detectar drift, altas, bajas y reglas modificadas, sin credenciales de Jira ni acceso a red.
• Restaura o promociona reglas mediante una importación explícita, con plan previo, que muestra recuentos de creación, actualización, omisión, poda y error antes de cualquier escritura en la API.
• Opera reglas en masa — desactivar, activar, eliminar o recambiar el scope de reglas seleccionadas — usando un vocabulario de selectores compartido sobre el catálogo local.
• Descubre e invoca reglas manuales desde scripts o CI/CD con resultados por objetivo, vistas previas dry-run y confirmación explícita.

Por qué los clientes lo usan

Los clientes suelen adoptar ajat cuando el problema no es una sola regla, sino todo un patrimonio de automatización. La necesidad de negocio suele ser gobernanza, continuidad, copia de seguridad, migración, evidencia de cumplimiento o habilitación de IA, más que una conveniencia puntual.

• Mantener una copia de seguridad de todas las reglas de Automation, controlada por el cliente y fuera de Jira.
• Construir un archivo de recuperación ante desastres y un camino seguro de vuelta cuando se editan, desactivan o eliminan reglas.
• Auditar dónde envía datos la automatización fuera de Jira — los webhooks, espacios de chat, destinatarios de correo y servicios cloud que alcanza.
• Encontrar reglas que fallan en silencio, sin propietario, obsoletas pero activas o de alta frecuencia antes de que provoquen incidentes.
• Promocionar reglas de sandbox a producción con nuevos UUIDs y scopes de proyecto reescritos.
• Convertir la estructura de la automatización en un corpus para búsqueda interna, analítica y RAG.

Instalación y configuración inicial

Si es la primera vez que usas el producto, empieza por la configuración inicial antes de elegir un comando.

La secuencia de onboarding recomendada es:

1. instalar el binario publicado para la plataforma objetivo
2. confirmar la instalación y la superficie de comandos disponible
3. revisar y activar la licencia comercial o local
4. crear el archivo de configuración
5. generar un token API de Jira y configurar las credenciales
6. ejecutar ajat doctor
7. lanzar la primera exportación y el informe de inventario

Usa Instalación y configuración inicial como guía principal para nuevos usuarios. Esa página está escrita para clientes que necesitan pasar de la compra y la instalación a una primera exportación de Automation correcta y bien delimitada.

Cómo usar esta documentación

Lee primero esta vista general cuando necesites decidir si el requisito es una exportación completa, un informe de gobernanza, una comparación de drift, una restauración o una operación masiva segura.

Después entra en la guía operativa que corresponda al trabajo:

• Instalación y configuración inicial para la primera exportación correcta
• Configuración para conexión, credenciales, prioridad y ajustes de proxy
• Exportar el patrimonio para la exportación JSON por scope, los archivos de estado y el refresco incremental
• Informes HTML para los cinco informes autocontenidos y su compartición segura
• Comparar snapshots para la revisión local de drift y los gates de drift en CI
• Buscar en el tenant para consultas de reglas en vivo a nivel de resumen
• Operaciones masivas de reglas para desactivar, activar, eliminar, recambiar scope y descubrir reglas manuales
• Importar y restaurar para recuperación en el mismo tenant y promoción entre tenants
• Invocar reglas manuales para resolución de objetivos, entradas tipadas y resultados por objetivo
• Comandos de configuración para config create, get, list, set, validate y where
• Flujos y recetas para escenarios repetibles de gobernanza, continuidad y migración
• Licencias para activación, variantes, respaldo y la edición CI/CD Automation
• Utilidades para doctor, tree, support y completion

Esa separación mantiene esta página centrada en el modelo operativo y la toma de decisiones, no en duplicar cada flag.

Los cinco informes

Cada informe lee el árbol de exportación local y produce un único archivo HTML autocontenido. Ninguno llama a Jira, por lo que son seguros para ejecutar en un puesto de revisión, adjuntar a un ticket o guardar como evidencia.

• Inventory — el catálogo completo por scope, con diagramas de flujo por regla, propietarios, etiquetas, analítica del patrimonio y la huella de integración: cada servicio externo que alcanza la automatización. Responde la pregunta de egreso de datos y dependencia de proveedores que Jira no puede.
• Collision — reglas solapadas o duplicadas en comportamiento, agrupadas por similitud entre scopes para exponer la proliferación por copia y los candidatos a consolidación.
• Consistency — higiene de etiquetas y nombres, propiedad y postura de gobernanza general.
• Risk — un panel de riesgo de gobernanza y operativo con puntuación A–F que expone fallos silenciosos, propiedad huérfana, reglas obsoletas pero activas, programaciones de alta frecuencia, complejidad y egreso de datos externo, con atribución por proyecto.
• Workflow — cada regla representada como un runbook de diagrama de flujo apto para impresión, con una lectura paso a paso de lo que hace.

Usa Informes HTML para el contenido de los informes, la navegación, el theming y las pautas de compartición segura.

Resultados de negocio

Copia de seguridad y retención a largo plazo

El árbol JSON exportado lo controla el cliente y se devuelve en la forma estándar de la API de Automation, no en un formato de base de datos propietario. Guárdalo en Git, almacenamiento de objetos, archivos cifrados, bóvedas de respaldo, almacenamiento regional o paquetes de evidencia offline. Eso hace que las definiciones de reglas sean más fáciles de retener, comparar, clasificar, aprobar y recuperar que una vista solo desde Jira.

Continuidad de negocio y recuperación ante desastres

Cuando una regla se edita, desactiva o elimina por accidente, los equipos necesitan una copia reciente y un camino seguro de vuelta. ajat import lee el árbol de exportación, calcula un plan y aplica creaciones o actualizaciones solo tras la confirmación. La estrategia de UUID por defecto preserva la identidad para la recuperación en el mismo tenant.

Cumplimiento y gobernanza

Las exportaciones JSON en texto plano con una organización previsible por scope son útiles para la recogida de evidencias, la gestión documental, los controles internos y el soporte de auditoría. Los equipos pueden aplicar etiquetas de retención, control de versiones, revisión de accesos y políticas de respaldo inmutable con las herramientas que ya conocen, y los informes de risk e integración aportan artefactos de gobernanza listos para revisión.

Habilitación para RAG y LLM

El árbol de exportación y los informes ponen la estructura de la automatización de Jira a disposición de la búsqueda, la analítica y los flujos de IA internos. Los equipos pueden indexar nombres de reglas, etiquetas, condiciones, acciones, descripciones, scopes e historial de cambios sin raspar pantallas de Jira.

Propiedad de los datos y seguridad del tenant

ajat está diseñado en torno a artefactos controlados por el cliente.

• Las exportaciones de reglas se escriben en archivos JSON locales bajo un árbol de directorios determinista y organizado por scope.
• Los informes HTML son archivos autocontenidos que pueden abrirse offline, adjuntarse a tickets, guardarse como evidencia o compartirse por canales aprobados.
• Las comparaciones de snapshots se ejecutan localmente y no requieren credenciales de Jira.
• Los archivos de licencia se cifran localmente y quedan vinculados a la máquina.
• Los paquetes de soporte enmascaran los valores sensibles de configuración antes de compartirse.

Solo lectura y plan primero por diseño: ajat separa los comandos que solo observan de los que pueden cambiar el estado del tenant.

• Comandos de solo lectura — export, report, diff, search, doctor, config, license list, license validate, support, tree y version — nunca modifican las reglas de Jira Automation.
• Comandos de mutación — import, rule enable, rule disable, rule delete, rule scope set e invoke — imprimen primero un plan y admiten --dry-run y --yes, de modo que el mismo flujo funciona de forma interactiva y en automatización controlada.
• Guardia de borrado: la eliminación de reglas solo se permite para reglas desactivadas, igual que la API de Automation. import --prune elimina solo reglas huérfanas desactivadas; las huérfanas activas se conservan y deben tratarse explícitamente.

Las exportaciones y los informes pueden contener contenido de automatización sensible — URLs de webhook, destinatarios de correo, smart values, cuerpos de mensaje y configuración de integraciones. Guárdalos con los mismos controles que usas para otros registros operativos confidenciales.

Elegir el comando adecuado

Escenarios típicos de cliente

Herramientas complementarias

ajat gobierna Jira Cloud Automation. Para la parte de Confluence de la suite Atlassian de Climakers, consulta las herramientas de Confluence: acp2md para exportar páginas individuales y acs2md para exportar espacios completos.