GravitonArquitetura
Nível de dificuldade: Especialista (5 de 5)
Como validar se seu Java roda no Graviton antes de migrar com AWS Transform
Em números
- 7 findings na análise de prontidão do repositório usado neste tutorial: 3 de severidade alta, 3 média e 1 baixa
- 245.000 linhas de código Java no projeto de exemplo, o toolkit de genética TASSEL
- 867 linhas adicionadas pela remediação, das quais só duas arquivos de código de fato mudam (o resto é relatório de análise e validação)
- 5x mais throughput na operação de matriz depois de recompilar a biblioteca nativa BLAS para Arm64 (12,47 ms contra 60,36 ms no caminho puro Java)
Desde 29 de outubro de 2026, o AWS Transform continuous modernization tem duas skills específicas para Graviton: uma avalia prontidão para Arm64 em código Java, outra remedia o que encontrar. Se você já cogitou mover uma aplicação Java para instância Graviton e parou na dúvida sobre dependências nativas, é esse o problema que essas skills resolvem.
O que você vai construir
Você vai rodar uma análise de prontidão Arm64 contra um repositório Java real, deixar a skill de remediação corrigir o que for encontrado, validar o build resultante numa instância Graviton de verdade e, por fim, escalar a mesma análise para um portfólio inteiro com agendamento recorrente. No fim, você sabe exatamente o que falha, por quê, e tem o código já corrigido num branch para revisar.
O exemplo usado é o TASSEL, um toolkit de genética open source, Gradle, Java 21, cerca de 245 mil linhas. Ele é útil justamente porque a dependência em x86 é típica, não exótica: uma ponte JNI para BLAS nativo e bibliotecas que embarcam binários compilados por arquitetura dentro do próprio JAR.
Pré-requisitos
- Uma conta AWS com o AWS Transform habilitado para sua identidade de usuário
- Uma AWS Region onde o AWS Transform está disponível (confira a lista de regiões suportadas na documentação)
- Credenciais AWS com permissão para usar o AWS Transform
- A CLI do AWS Transform, instalada pelo script de setup, e Node.js 20 ou mais recente (instale direto do site do Node.js; alguns gerenciadores de pacote distribuem versão mais antiga)
- Git para controle de versão durante a transformação
- Uma conexão de fonte: um personal access token do GitHub, GitLab ou Bitbucket com escopo de repositório, ou uma pasta local com checkouts que você já tem. A análise de prontidão é somente leitura, então não precisa de acesso de escrita; a remediação só precisa se você quiser que ela abra o pull request
- Para a remediação, um host Arm64, como uma instância EC2 baseada em Graviton. Rodando localmente em Arm64, a remediação compila a mudança na própria máquina; em x86, ela produz o código mas não consegue compilar nem testar em Arm64
- Java 8 ou mais recente (essas skills não trocam a versão do Java; se precisar de upgrade de versão, rode antes a transformação
AWS/java-version-upgrade)
Este tutorial usa Amazon Corretto 21, Gradle 8.13 e uma instância c7g.2xlarge rodando Amazon Linux 2023. Se você não tem uma aplicação própria para testar, clone o exemplo:
git clone https://github.com/btmonier/tassel-renovate.gitPasso a passo
1. Conecte sua fonte e descubra os repositórios
- Abra um terminal e defina a região da sessão:
export AWS_REGION=us-east-1 - Confirme que a CLI alcança o serviço:
atx ct status(ele imprime um resumo de fontes, repositórios, análises e findings na sua conta) - Registre uma fonte hospedada com
atx ct source add --name graviton-demo --provider github --org my-org --token "$PAT", ou uma pasta local comatx ct source add --name graviton-demo --provider local --path ~/code - Descubra os repositórios:
atx ct discovery scan --source graviton-demo - Confirme o que foi encontrado:
atx ct repository list --source graviton-demo --language java
2. Rode a análise de prontidão para Graviton
- Dispare a análise:
atx ct analysis run --type graviton-readiness --source graviton-demo --repo tassel-renovate - Acompanhe o progresso:
atx ct analysis get --id <analysis-id> - Veja a distribuição por severidade:
atx ct findings count --by severity --repo graviton-demo::tassel-renovate
No TASSEL, esse comando retornou 7 findings: 3 altos, 3 médios, 1 baixo. Dá para rodar o mesmo fluxo pelo console, na aba Analyses, escolhendo Graviton readiness como tipo, selecionando a fonte conectada e os repositórios, e optando por agendamento recorrente em vez de execução única.
3. Entenda o que foi encontrado
A análise separa dois tipos de problema, e a diferença entre eles é o motivo de valer a pena rodá-la. O primeiro é código seu: o TASSEL carrega uma ponte BLAS nativa com System.loadLibrary("TasselBlas") e declara seis métodos nativos; o código-fonte C da ponte JNI está no repositório, mas sem binário compilado para Arm64.
O segundo tipo é invisível no seu código e nas suas declarações de dependência: binários embutidos dentro de arquivos JAR de terceiros. A análise resolve a árvore de dependências e inspeciona os binários dentro de cada pacote:
$ unzip -l cisd-jhdf5-19.04.1.jar | grep native
native/jhdf5/amd64-Linux/libjhdf5.so
native/jhdf5/arm-Linux/libjhdf5.so
$ file native/jhdf5/*/libjhdf5.so
amd64-Linux: ELF 64-bit LSB shared object, x86-64
arm-Linux: ELF 32-bit LSB shared object, ARM, EABI5Repare no segundo diretório: é ARM de 32 bits, não aarch64. Numa listagem rápida parece suporte a ARM, mas no Graviton o carregador que busca por nome de arquitetura não encontra correspondência, e nenhuma versão publicada traz um diretório aarch64-Linux. Duas outras dependências chegaram pelo mesmo caminho: cisd:base:18.09.0 via jhdf5, e gov.nih.nlm.ncbi:ngs-java:2.9.0 via com.github.samtools:htsjdk:2.24.1, cujo carregador só publica linux-x86_64.
4. Remedie os achados
- Colete os IDs dos findings no formato que
--idsespera:
atx ct findings list --repo graviton-demo::tassel-renovate --json \
| jq -r '[.[].id] | join(",")'- Passe a lista para a remediação:
atx ct remediation create --ids <finding-ids> --local - Acompanhe:
atx ct remediation status --id <remediation-id> - Revise o branch gerado com
git logegit diff --stat
Repare no que você não passa: nem a transformação, nem o repositório. Cada finding já registra a transformação que o resolve, então a remediação lê isso dos findings e deriva os repositórios-alvo sozinha; --transformation-name só serve para fixar ou sobrescrever essa escolha.
No TASSEL, a execução produziu três commits atômicos (relatórios de análise, a mudança em si, depois relatórios de validação), tocando 15 arquivos, 867 linhas adicionadas e 3 removidas. Só duas são arquivos de código de verdade: build.gradle.kts (53 linhas) e DoubleMatrixFactory.java (7 linhas). O resto documenta o que foi encontrado e o que foi feito.
As mudanças de código fazem três coisas. Primeiro, removem do classpath resolvido a dependência exclusivamente x86 (ngs-java baixa binários linux-x86_64 em tempo de execução e não tem caminho de busca para aarch64; como não existe versão 2.x com suporte a aarch64, a remediação excluiu o caminho não usado e registrou o porquê em comentário).
Segundo, adicionam um diretório de busca para binários aarch64 construídos externamente, à frente dos payloads x86 embutidos nos JARs, já que jhdf5 e cisd:base não têm build para Arm64 publicado nem código C no repositório para recompilar ali. Terceiro, aplicam as flags de JVM recomendadas para Graviton no bloco test (-XX:ReservedCodeCacheSize=64M e -XX:InitialCodeCacheSize=64M, válidas em x86-64 também) e tornam visível, no log, o estado das bibliotecas nativas no momento da carga.
5. Escale para o portfólio
- Analise todos os repositórios de uma fonte de uma vez:
atx ct remote analysis --type graviton-readiness --mode aws-managed --sources graviton-demo - Crie um agendamento recorrente:
atx ct schedule create --name graviton-weekly --mode aws-managed --execution-role <role-arn> --recurrence weekly:MONDAY --type graviton-readiness --sources graviton-demo
Um único envio aceita até 5.000 repositórios. Agendamentos em infraestrutura gerenciada pelo AWS Transform precisam de uma role de execução que o serviço assume a cada rodada.
Aqui entra o primeiro trade-off de Well-Architected explícito: rodar em modo gerenciado pela AWS custa zero provisionamento seu, mas a infraestrutura remota atualmente roda em x86, então uma remediação remota produz o código Arm64 sem poder compilar ou testar nessa arquitetura. Isso é eficiência operacional contra confiabilidade da validação: você ganha escala e perde a garantia de que compilou no alvo, e precisa fechar esse ciclo no seu próprio pipeline Arm64 antes do merge.
| Modo | Análise | Remediação |
|---|---|---|
| Gerenciado pelo AWS Transform | Suportado, nada para provisionar | Não suportado |
| Gerenciado por você (EC2 ou AWS Batch) | Suportado | Suportado (somente x86) |
| Local | Suportado | Suportado, compila no alvo |
Testando
Com a remediação rodando localmente num host Arm64, a mudança já fica no disco, compilada contra a arquitetura alvo, o que resolve o trade-off acima na ponta: menos escala automática, mais confiabilidade por validação imediata.
- Faça checkout do branch gerado pela remediação
- Rode
./gradlew clean build -x test --no-daemon - Confirme a saída:
BUILD SUCCESSFUL in 14s
5 actionable tasks: 5 executed
$ ls -la build/libs/sTASSEL.jar
-rw-r--r-- 3681163 build/libs/sTASSEL.jar
$ ls build/libs/lib/*.jar | wc -l
61O build do TASSEL resolveu 61 JARs de dependência e gerou o artefato. Isso valida a árvore de dependências em Arm64, mas não valida a biblioteca nativa BLAS, que precisa ser compilada no host final.
- Suba uma instância
c7g.2xlargecom Amazon Linux 2023 - Instale Amazon Corretto 21, OpenBLAS e LAPACK como pacotes aarch64
- Copie o repositório remediado para a instância e rode
./gradlew classes copyDependencies - Compile a ponte JNI para aarch64. O código C original inclui um header exclusivo de macOS; troque
#include <vecLib/cblas.h>por#include <cblas.h>e compile:
gcc -O3 -shared -fPIC -I"$JAVA_HOME/include" -I"$JAVA_HOME/include/linux" \
-I/usr/include/openblas -o libTasselBlas.so <jni-source>.c \
-lopenblas -llapack -lm- Rode a aplicação e confirme que a biblioteca nativa carrega
Na instância, o build resolve 62 JARs (um a mais que localmente, pelas dependências de ambiente), e o file confirma a arquitetura do binário recém-compilado:
libTasselBlas.so: ELF 64-bit LSB shared object, ARM aarch64A saída da aplicação em execução:
os.arch : aarch64
java.vendor : Amazon.com Inc. (Corretto 21)
libTasselBlas : LOADED
DoubleMatrix backend: blas
fast path active : YES (native BLAS/LAPACK)
matmul 512x512 best 12.47 ms | 21.53 GFLOP/sA biblioteca nativa carrega, o backend BLAS é selecionado e a álgebra matricial roda. Essa comparação, 12,47 ms com biblioteca nativa contra 60,36 ms no caminho puro Java, é entre dois caminhos na mesma instância Graviton, não entre Graviton e x86. É o argumento para recompilar a biblioteca nativa em vez de simplesmente contornar o problema com uma implementação Java pura, que também funcionaria, só que cinco vezes mais devagar.
Limpando os recursos
A instância Graviton gera cobrança enquanto estiver no ar, e um agendamento recorrente gera cobrança a cada execução (os valores exatos dependem do seu plano no AWS Transform; consulte a página de pricing do serviço). Para não deixar nada cobrando:
- Termine a instância:
aws ec2 terminate-instances --instance-ids <instance-id> - Apague o agendamento, se criou um:
atx ct schedule delete - Remova o restante, que não gera custo contínuo mas vale limpar:
atx ct remediation delete,atx ct analysis deleteeatx ct source remove
Próximos passos
Se sua aplicação Java depende de alguma lib nativa ou de dados empacotados por arquitetura, essa análise de prontidão é leitura, não gera risco algum: aponte para o seu portfólio inteiro antes de prometer qualquer prazo de migração para Graviton. A documentação completa de comandos está em Working with continuous modernization no AWS Transform User Guide, e os detalhes de cobrança de análise e remediação estão na página de pricing do AWS Transform.
O caso do TASSEL deixa um ponto em aberto que vale levar para o seu próprio estado: nem toda dependência tem build Arm64 publicado. Quando não tem, a remediação exclui o caminho morto ou abre espaço para você trazer um binário externo, mas não inventa um aarch64 que não existe. Isso é trade-off de otimização de custos contra esforço operacional: migrar para Graviton pode custar menos em instância e mais em manutenção de binários nativos que antes eram problema de outra pessoa.
Serviços neste textoGraviton
Leve para a sua IA
Decida com o seu assistente, com o contexto deste texto já montado.
1. O que você quer saber
Ver o prompt
Li no AWS Hub: "Como validar se seu Java roda no Graviton antes de migrar com AWS Transform" (https://awshub.com.br/arquitetura/como-validar-se-seu-java-roda-no-graviton-antes-de-migrar-com-aws-transform). Resumo: O AWS Transform ganhou, desde 29 de outubro de 2026, duas skills que escaneiam um repositório Java em busca de dependências incompatíveis com Arm64 e corrigem o código antes de você trocar de instância. Fonte oficial: https://aws.amazon.com/blogs/devops/aws-graviton-support-for-java-in-aws-transform-continuous-modernization/ Serviços: Graviton Minha stack: [descreva em uma linha: serviços, linguagem, volume, região] Isso muda alguma coisa na minha arquitetura? O que eu faria diferente a partir de amanhã?