Guía de instalación para Jetbrains Qodana Ultimate

1) Crear un proyecto en Qodana Cloud

1. Acceda a Qodana Cloud (plataforma de JetBrains).
2. Crear:
   • Organización
   • Equipo
   • Proyecto
3. Copia el token del proyecto (QODANA_TOKEN) → necesario para la autenticación y la licencia.

2) Elige el método de instalación

Opción A: Instalar mediante CLI (recomendado)

1. Instala Docker o Podman (requerido).
2. Instala la CLI de Qodana:

   brew install jetbrains/utils/qodana   # macOS
   

   O descarga la CLI desde el GitHub de JetBrains.

3. Ejecuta el análisis:

   qodana scan \
     -e QODANA_TOKEN="<tu-token>" \
     --linter qodana-<lenguaje>
   

Opción B: Ejecutar a través de Docker (directo)

docker run \
  -v <ruta-del-proyecto>/:/data/project/ \
  -e QODANA_TOKEN="<tu-token>" \
  jetbrains/qodana-<linter>:2025.3

Opción C: Usar en el IDE de JetBrains (la más sencilla)

Los IDE compatibles incluyen:

• IntelliJ IDEA
• PyCharm
• PhpStorm
• WebStorm
• GoLand
• Rider

Pasos:

1. Abre tu proyecto en el IDE
2. Ve a Problemas → pestaña Qodana
3. Haz clic en «Probar localmente»
4. Consulta los resultados dentro del IDE o del navegador

Opción D: Integración CI/CD (GitHub, GitLab, Jenkins)

• Añade QODANA_TOKEN como secreto/variable
• Utiliza la acción oficial de Qodana en GitHub o la configuración de pipeline

3) Proceso de activación (licencia Qodana Ultimate)

1. Compra o activa la licencia Qodana Ultimate (vinculada a la cuenta de JetBrains)
2. Completa la configuración del proyecto en Qodana Cloud
3. Genera QODANA_TOKEN desde Qodana Cloud
4. Utilice QODANA_TOKEN en CLI, Docker o CI/CD
5. Qodana verifica automáticamente la licencia a través de Qodana Cloud durante la ejecución
6. (Opcional)
   • Abrir IDE
   • Ir a Ayuda → Registrar → Activar nueva licencia
   • Seleccionar Cuenta de JetBrains
   • Iniciar sesión y activar