Preguntas y respuestas

Esta página responde a las preguntas que los clientes suelen plantear antes de usar ajat en un flujo real de gobierno o exportación de Jira Automation.

¿Para qué está diseñado ajat?

ajat es la Atlassian Jira Automation Tool de Climakers. Exporta, audita, compara, restaura y opera de forma segura las reglas de Jira Cloud Automation desde archivos controlados por el cliente.

Se usa cuando necesitas un registro duradero y sin conexión de tu patrimonio de automatización — para continuidad, migración, auditorías, respuesta a incidentes, revisiones de gobierno o alimentar la estructura de reglas a flujos internos de búsqueda e IA.

¿ajat es compatible con Jira Server o Data Center?

No. ajat v1 es compatible solo con Atlassian Jira Cloud Automation.

Jira Server y Jira Data Center no son compatibles. Los sitios que no son Cloud se detectan por la ausencia del endpoint /_edge/tenant_info y se rechazan con un error Jira site is not Atlassian Cloud. No hay solución alternativa en v1.

¿Qué sistemas operativos son compatibles?

ajat publica binarios para macOS y Linux (Linux en amd64 y arm64).

• macOS: un instalador .pkg universal firmado y notarizado.
• Linux: un .zip por arquitectura con .sha256 y un bundle Sigstore/Cosign .sigstore.json para verificación keyless.

Cada paquete incluye un checksum .sha256 correspondiente. Descarga los paquetes actuales y sus checksums desde los enlaces de tu correo de pedido de Climakers — enviado tras adquirir un plan o iniciar una prueba gratuita en store.climakers.com/ajat.

¿ajat modifica Jira?

La mayor parte de lo que haces es de solo lectura, y todo lo que puede cambiar Jira es plan-first y está protegido.

• 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 — pueden cambiar el estado del tenant o ejecutar una regla manual. Cada uno imprime un plan primero y requiere confirmación salvo que se pase --yes.

¿Cómo previsualizo una mutación antes de ejecutarla?

Cada comando de mutación imprime un plan primero y admite --dry-run y --yes:

• Ejecuta con --dry-run para ver exactamente qué cambiaría sin tocar Jira.
• Ejecuta sin flag para revisar el plan y confirmar de forma interactiva.
• Ejecuta con --yes para omitir la confirmación en automatización controlada.

Esto permite que el mismo comando funcione de forma interactiva y en un pipeline sin cambiar el modelo de seguridad. Consulta las páginas de Operaciones sobre reglas e Importación para más detalles.

¿Cómo está protegida la eliminación de reglas?

La eliminación de reglas solo se permite para reglas deshabilitadas, siguiendo el comportamiento de la API de Automation. Deshabilita una regla antes de poder eliminarla.

En las importaciones, --prune elimina solo las reglas deshabilitadas del destino que estén ausentes en la exportación de origen. Las reglas huérfanas habilitadas siempre se conservan y deben tratarse explícitamente.

¿Dónde se almacenan la configuración y la licencia?

Ambas viven en el directorio estándar de configuración de usuario de la plataforma:

Ese directorio contiene config.yaml y el archivo license.bin, vinculado a la máquina y cifrado con AES-256-GCM. Las ejecuciones de exportación también mantienen un archivo de estado incremental, .ajat_state.json, dentro del directorio de salida. Muestra las rutas exactas con ajat config where y ajat license where.

¿Cómo muevo una licencia a una máquina nueva?

Como license.bin se cifra con una clave derivada de tu ID de hardware, copiarlo a otra máquina no funciona. Para mover una licencia:

1. Ejecuta ajat license deactivate en la máquina antigua para liberar la licencia.
2. Ejecuta ajat license activate --license-key <tu-clave> en la máquina nueva.

Las copias de seguridad hechas con ajat license export solo pueden importarse de nuevo en la misma máquina que las exportó. Consulta la página de Licencia para el flujo completo.

¿Puedo ejecutar ajat en CI/CD?

Sí, con la edición CI/CD Automation. Es obligatoria para uso en pipelines y rechaza el uso fuera de un entorno de CI reconocido (detectado mediante las variables de entorno CI / GITHUB_ACTIONS / GITLAB_CI / … y un stdin no interactivo). Valida de forma stateless en una programación semanal basada en hash, por lo que no llama a la API de licencias en cada ejecución del pipeline.

Para automatización controlada, combínala con --yes en los comandos de mutación y --log-file ./ajat.log --log-format json para una traza de auditoría estructurada. Compra la edición en store.climakers.com/ajat.

¿Cuáles son los errores más comunes y cómo se resuelven?

• license required — ejecuta ajat license list; si no se encuentra licencia, activa una. Si existe una licencia pero está expired o disabled, activa directamente una clave renovada — no necesitas desactivar primero.
• authentication failed (HTTP 401/403) — el token API es inválido o ha caducado. Genera uno nuevo en id.atlassian.com, configúralo con ajat config set jira.api_token <nuevo-token> y confirma que jira.username es tu email de Atlassian, no un nombre para mostrar.
• rate limited by api.atlassian.com — ajat respeta Retry-After en cada 429 y aparca todo el pool de workers a la vez. Si persiste, reduce --workers (predeterminado 4, mínimo 1) o --page-size. La exportación es totalmente reanudable, así que vuelve a lanzar con el mismo --output-dir y las reglas ya descargadas se omiten.
• Jira site is not Atlassian Cloud — el destino es Server o Data Center, que v1 no soporta.

La página de Soporte tiene el flujo de escalado completo.

¿Son sensibles los datos exportados?

Sí. Las exportaciones y los informes pueden contener contenido sensible de automatización — URLs de webhook, destinatarios de correo, smart values, cuerpos de mensajes y configuración de integraciones. Guárdalos con los mismos controles que usas para otros registros operativos confidenciales. Usa ajat export --redact-sensitive-fields cuando necesites una exportación de menor sensibilidad, y comparte paquetes de soporte en lugar de la config bruta, ya que los paquetes anonimizan los secretos automáticamente.

¿Qué debo hacer antes de mi primera ejecución real?

Sigue este orden:

1. Instala el binario firmado para tu plataforma.
2. Crea el archivo de configuración con ajat config create.
3. Configura las credenciales de Jira Cloud (jira.domain, jira.username, jira.api_token).
4. Activa la licencia con ajat license activate.
5. Ejecuta ajat doctor para una comprobación de entorno en verde.
6. Ejecuta una primera ajat export --output-dir ./jira-automations-backup sobre un tenant conocido.
7. Renderiza un informe de inventario para confirmar el catálogo.

Para el recorrido detallado, consulta la página de Primeros pasos.

¿Cómo obtengo ayuda si algo falla?

Empieza por las comprobaciones integradas y escala en orden:

1. Ejecuta ajat doctor para validar la configuración, la conectividad y el estado de la licencia.
2. Reproduce con ajat --debug --log-file ./ajat.log <command> para capturar logs.
3. Genera un paquete diagnóstico anonimizado con ajat support --log-file ./ajat.log --output support-bundle.txt.
4. Contacta con Climakers en support@climakers.com.

El flujo completo de soporte está documentado en la página de Soporte.

¿Dónde debo continuar?

• Usa Primeros pasos para el camino desde no tener binario hasta la primera exportación.
• Usa Configuración para la estructura del archivo de configuración y las credenciales.
• Usa Exportación cuando estés listo para construir un catálogo local.
• Usa Informes para los informes de inventario, colisión, consistencia, riesgo y workflow.
• Usa Licencia para activación, validación y archivos de licencia vinculados a la máquina.