Boas práticas de manutenção e atualização

Objetivos

Nesta aula você vai:

• Atualizar JDK e ferramentas sem surpresas
• Usar Docker e CI para ambientes reproduzíveis
• Adotar hábitos de manutenção profissional

Atualizar o JDK

1. Leia release notes da nova versão LTS
2. Teste em branch — rode suite completa
3. Atualize CI antes ou junto do laptop
4. Mantenha versão anterior até migração confirmada (SDKMAN facilita)

Não atualize produção no dia do lançamento — aguarde patches .0.1 se possível.

Ambientes reproduzíveis

Docker

FROM eclipse-temurin:21-jdk
WORKDIR /app
COPY . .
RUN ./mvnw package -DskipTests

Todo desenvolvedor e o CI usam a mesma imagem base.

CI (GitHub Actions, GitLab CI)

- uses: actions/setup-java@v4
  with:
    distribution: temurin
    java-version: '21'

Versão explícita no pipeline — não "o que estiver na máquina".

Documentação

README do projeto deve listar:

• Java mínimo (ex.: 17+)
• Maven 3.9+ ou Gradle 8+
• Comandos para rodar localmente

Higiene de ambiente

• Remova JDKs órfãos que poluem PATH
• Não commite target/, build/, .idea/ indevidos
• Use .sdkmanrc ou .java-version quando o time padronizar
• Security patches: assine alertas da sua distribuição (Adoptium, etc.)

Política de equipe

• Uma versão LTS por projeto ativo
• Exceções legadas documentadas
• Onboarding: script ou doc "setup em 15 minutos"

Resumo

• Atualize JDK com testes e CI alinhados
• Docker + CI eliminam "funciona na minha máquina"
• Documente versões; remova instalações antigas do PATH