Instalación y configuración inicial

Esta es la página recomendada para nuevos clientes. Lleva un puesto desde “nada instalado” hasta “primera exportación de Automation e informe de inventario completados correctamente” siguiendo el orden adecuado. Cada paso valida el anterior antes de que el siguiente toque una superficie mayor.

ajat es compatible solo con Atlassian Jira Cloud Automation. No es compatible con Jira Server ni con Jira Data Center.

Al final de esta página tendrás un binario ajat firmado en el PATH, una licencia activada, credenciales de Jira Cloud configuradas por archivo o variables de entorno, un resultado verde de ajat doctor, un árbol de exportación local de archivos JSON de Automation y un informe de inventario autocontenido.

Antes de empezar

un sitio de Jira Cloud como acme.atlassian.net — Jira Server y Jira Data Center no son compatibles
una cuenta de Jira con permiso para leer reglas de Automation en el alcance que vas a exportar (y, para flujos de mutación, los permisos de gestión de Automation correspondientes)
un token API de Jira creado para esa cuenta de Atlassian
conectividad de red desde el puesto o el runner de CI hacia el sitio de Jira Cloud y api.atlassian.com — los proxies corporativos se configuran con http.client.proxy o AJAT_HTTP_CLIENT_PROXY
una licencia válida de ajat obtenida en store.climakers.com/ajat, o un archivo de licencia offline vinculado a máquina emitido por el soporte de Climakers
espacio suficiente en disco para el árbol de exportación y los informes
permisos de administrador solo para el paso de instalación, si la plataforma lo necesita

Paso 1: Descargar e instalar el paquete publicado

Hay versiones publicadas para macOS y Linux: Linux tanto en amd64 como en arm64. No hay compilación para Windows.

ajat se distribuye a través de la tienda de Climakers. Adquiere un plan o inicia una prueba gratuita en store.climakers.com/ajat. Tras la compra, la página de tu pedido y el correo de confirmación incluyen un enlace de descarga para cada paquete publicado y su archivo de checksum .sha256 correspondiente:

ajat-<version>-darwin-universal.pkg — instalador de macOS (Apple Silicon e Intel)
ajat-<version>-linux-amd64.zip — Linux x86-64
ajat-<version>-linux-arm64.zip — Linux ARM64
un archivo de checksum .sha256 correspondiente para cada paquete

Descarga el paquete de tu plataforma junto con su archivo .sha256 en la misma carpeta y luego sigue la sección que corresponda a tu puesto.

Los enlaces de descarga de tu pedido están vinculados a tu compra. Mantenlos privados y no los compartas fuera de tu organización.

Instalar en macOS

ajat para macOS es un instalador universal .pkg firmado y notarizado para sistemas Apple Silicon e Intel. Descarga ajat-<version>-darwin-universal.pkg y su .sha256 desde tu pedido, luego valida e instala (define VERSION con la versión que aparece en tu pedido):


VERSION=v1.0.0   # use la versión que aparece en tu pedido de Climakers
shasum -a 256 -c "ajat-${VERSION}-darwin-universal.sha256"
sudo installer -pkg "ajat-${VERSION}-darwin-universal.pkg" -target /

También puedes abrir el .pkg con doble clic en Finder y seguir el asistente de instalación.

Instalar en Linux

ajat para Linux se distribuye como un archivo .zip por arquitectura con un archivo de checksum .sha256 correspondiente. Descarga el archivo de la arquitectura de tu CPU (amd64 o arm64) y su .sha256 desde tu pedido, luego valida y coloca el binario en PATH:


VERSION=v1.0.0   # use la versión que aparece en tu pedido de Climakers
ARCH=amd64       # o arm64
sha256sum -c "ajat-${VERSION}-linux-${ARCH}.sha256"
unzip -q -o "ajat-${VERSION}-linux-${ARCH}.zip"
chmod +x ajat
sudo mv ajat /usr/local/bin/ajat

Paso 2: Confirmar la instalación

Verifica el binario e inspecciona la superficie de comandos antes de seguir:


ajat version
ajat --help
ajat tree --short

ajat tree --short es la forma más rápida de confirmar que toda la superficie de comandos está disponible sin leer la referencia. También puedes imprimir en cualquier momento las rutas resueltas de configuración y licencia:


ajat config where
ajat license where

Paso 3: Revisar y activar la licencia

ajat es software comercial. Los comandos de configuración y diagnóstico (config, doctor, license, support, tree, version, la ayuda y completion) funcionan sin licencia, pero los comandos operativos como export, report, diff, search, import, rule e invoke requieren una válida.

El acuerdo de licencia va embebido en el binario y puede revisarse offline:


ajat license terms

Activa una clave de licencia adquirida:


ajat license activate --license-key YOUR_LICENSE_KEY
ajat license list

Para un entorno aislado o restringido, activa en su lugar el archivo de licencia vinculado a máquina emitido por el soporte de Climakers:


ajat license activate --license-file ./ajat-license.bin
ajat license list

Comprueba la activación:


ajat license validate

La edición gratuita Trial habilita todas las funciones durante una evaluación de 14 días. Tras obtenerla en la tienda de Climakers, se activa con el mismo flujo license activate --license-key que una edición de pago.

Los archivos de licencia se cifran con AES-256-GCM y quedan vinculados a la máquina, por lo que un license.bin copiado de otro equipo no se descifrará. Cambiar de máquina implica desactivar la anterior y volver a activar con --license-key. Consulta Licencias para variantes, respaldo y la edición CI/CD Automation.

Paso 4: Crear el archivo de configuración

Crea el archivo de configuración por defecto e imprime su ruta resuelta:


ajat config create
ajat config where

Ubicaciones por defecto:

Plataforma	Ruta
Linux	`~/.config/ajat/config.yaml` o `$XDG_CONFIG_HOME/ajat/config.yaml`
macOS	`~/Library/Application Support/ajat/config.yaml`

La prioridad de configuración es: flags de línea de comandos, luego variables de entorno AJAT_, luego el archivo de configuración y luego los valores por defecto.

Paso 5: Generar un token API de Jira

Genera un token en id.atlassian.com/manage-profile/security/api-tokens para la cuenta de Atlassian que operará ajat.

Necesitas:

el dominio de Jira Cloud, por ejemplo acme.atlassian.net
el correo de la cuenta de Atlassian — la autenticación de la API de Jira Cloud usa el correo, no un nombre visible
el token API generado

Paso 6: Configurar las credenciales de Jira

El dominio es el nombre de host desnudo. No incluyas https://, una barra final ni un sufijo /wiki.

Usar el archivo de configuración


jira:
  domain: acme.atlassian.net
  username: you@acme.com
  api_token: YOUR_API_TOKEN

Usar comandos CLI


ajat config set jira.domain acme.atlassian.net
ajat config set jira.username you@acme.com
ajat config set jira.api_token YOUR_API_TOKEN

Usar variables de entorno

Para CI/CD, prefiere variables de entorno y guarda el token como secreto.

bash / zsh


export AJAT_JIRA_DOMAIN=acme.atlassian.net
export AJAT_JIRA_USERNAME=you@acme.com
export AJAT_JIRA_API_TOKEN=YOUR_API_TOKEN

Inspecciona la configuración efectiva de forma segura en cualquier momento — jira.api_token se enmascara en la salida:


ajat config list
ajat config get jira.domain
ajat config validate --require-credentials

Paso 7: Ejecutar doctor

Ejecuta la comprobación de estado antes de tocar una exportación real:


ajat doctor

Doctor valida en un solo paso la configuración, la legibilidad de la licencia y sus metadatos locales, la resolución del tenant, las credenciales de Jira, el acceso a la API de reglas manuales de Automation y la escritura en el directorio de salida.

Salida de ejemplo de una sesión real, con datos del tenant y de la máquina anonimizados:


🩺 Running diagnostics for ajat v1.0.0...

  ✅  Configuration file           /Users/<user>/Library/Application Support/ajat/config.yaml
  ✅  Jira credentials             <tenant>.atlassian.net (user: <redacted>)
  ✅  Jira Cloud API               connected (287ms)
  ✅  Automation API               manual-rule access confirmed
  ✅  License file                 loaded (<redacted>)
  ✅  License validation           active (<redacted>)
  ✅  Output directory             writable
  ✅  Version                      ajat v1.0.0 (darwin/arm64, built 2026-03-29T08:23:49Z)

📊 Result: all 8 checks passed

🎉 ajat is ready to use!

Para validar un destino de exportación concreto antes de la primera ejecución:


ajat doctor --output-dir ./jira-automations-backup

Paso 8: Ejecutar la primera exportación e informe de inventario

Exporta el patrimonio de automatización a un árbol JSON organizado por scope y luego construye un informe de inventario autocontenido a partir de él. Los informes leen el árbol local y no llaman a Jira.


ajat export --output-dir ./jira-automations-backup
 
ajat report inventory \
  --input-dir ./jira-automations-backup \
  --output-file inventory.html

Abre el informe localmente:


open inventory.html        # macOS
xdg-open inventory.html    # Linux

Después de esta primera ejecución, conserva el mismo directorio de exportación para los refrescos incrementales. ajat usa .ajat_state.json para omitir las reglas sin cambios y reintentar las fallidas.

Si algo falla

Sigue este orden:

vuelve a ejecutar ajat doctor para confirmar el entorno
verifica el archivo de configuración activo con ajat config where y el estado de la licencia con ajat license validate
captura logs estructurados con ajat --debug --log-file ./ajat.log <command>
genera un paquete de diagnóstico enmascarado con ajat support --log-file ./ajat.log --output support-bundle.txt cuando contactes con el soporte de Climakers

Qué leer a continuación

Exportar el patrimonio para el manejo de estado, el refresco incremental, los límites de tasa y la disposición en disco
Informes HTML para los cinco informes y las pautas de compartición segura
Comparar snapshots para la revisión de drift y los gates de drift en CI
Operaciones masivas de reglas e Importar y restaurar para mutaciones seguras con plan previo
Configuración para la prioridad, las variables de entorno y los ajustes de proxy

Ejecuta ajat --help o ajat <command> --help en cualquier momento para ver la superficie completa de comandos publicada para esta versión.