Guia de instalação para Jetbrains Qodana Ultimate

1) Criar um projeto no Qodana Cloud

1. Aceda ao Qodana Cloud (plataforma JetBrains).
2. Criar:
   • Organização
   • Equipa
   • Projeto
3. Copie o Token do Projeto (QODANA_TOKEN) → necessário para autenticação e licenciamento.

2) Escolha o Método de Instalação

Opção A: Instalar via CLI (Recomendado)

1. Instale o Docker ou o Podman (obrigatório).
2. Instale a CLI do Qodana:

   brew install jetbrains/utils/qodana   # macOS
   

   OU descarregue a CLI do GitHub da JetBrains.

3. Execute a análise:

   qodana scan \
     -e QODANA_TOKEN="<seu-token>" \
     --linter qodana-<linguagem>
   

Opção B: Executar via Docker (Direto)

docker run \
  -v <project-path>/:/data/project/ \
  -e QODANA_TOKEN="<your-token>" \
  jetbrains/qodana-<linter>:2025.3

Opção C: Utilizar no IDE da JetBrains (Mais fácil)

Os IDEs suportados incluem:

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

Passos:

1. Abra o seu projeto no IDE
2. Vá para Problemas → separador Qodana
3. Clique em “Experimentar localmente”
4. Veja os resultados no IDE ou no navegador

Opção D: Integração CI/CD (GitHub, GitLab, Jenkins)

• Adicione QODANA_TOKEN como segredo/variável
• Utilize a ação oficial do Qodana no GitHub ou a configuração do pipeline

3) Processo de ativação (licença Qodana Ultimate)

1. Adquira ou ative a licença Qodana Ultimate (vinculada à conta JetBrains)
2. Conclua a configuração do projeto Qodana Cloud
3. Gere QODANA_TOKEN a partir do Qodana Cloud
4. Utilize QODANA_TOKEN na CLI, no Docker ou no CI/CD
5. O Qodana verifica automaticamente a licença através do Qodana Cloud durante a execução
6. (Opcional)
   • Abrir IDE
   • Ir para Ajuda → Registar → Ativar nova licença
   • Escolher Conta JetBrains
   • Iniciar sessão e ativar