View a markdown version of this page

Trabalhando com modernização contínua - AWS Transformação
Gerenciamento de fontesDescoberta e gerenciamento de repositóriosAnálise em execuçãoGerenciar descobertasCriação de remediaçõesAWS Transformar aplicativo web (opcional)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com modernização contínua

Gerenciamento de fontes

Use atx ct source comandos para conectar repositórios. Provedores compatíveis: GitHub, GitLab, Bitbucket, local.

GitHub organizações

Token: token de acesso pessoal (clássico) com repo escopo. Read-only para análise, repositório completo para remediação.

atx ct source add --name name --provider github --org org --token pat

GitLab grupos e usuários

Token: token de acesso pessoal com api escopo.

atx ct source add --name name --provider gitlab --org group-or-user --token pat
# Self-hosted:
atx ct source add --name name --provider gitlab --org group-or-user --token pat --url https://gitlab.example.com

Espaços de trabalho e projetos do Bitbucket

Bitbucket Cloud — escopos:read:repository:bitbucket,,write:repository:bitbucket,read:pullrequest:bitbucket. write:pullrequest:bitbucket Também precisa --email --username e.

atx ct source add --name name --provider bitbucket --org workspace --token api-token --email email --username username

Centro de dados Bitbucket:

atx ct source add --name name --provider bitbucket --org project-key --token http-access-token --url https://bitbucket.example.com

Repositórios locais

atx ct source add --name name --provider local --path parent-directory
Importante

--pathdeve apontar para um diretório pai contendo repositórios git como subdiretórios, não para um único repositório.

Gerenciando fontes

atx ct source list
atx ct source remove --name name

Descoberta e gerenciamento de repositórios

atx ct discovery scan --source name
atx ct discovery status --source name
atx ct discovery scan --source name --path new-directory

Após a descoberta:

atx ct repository list
atx ct repository list --source name
atx ct repository list --labels "team:frontend,priority:high"
atx ct repository update --source name --repo "source::slug" --labels "team:frontend,priority:high"
atx ct repository update --source name --labels "migration:wave-1"

Análise em execução

O --type sinalizador especifica o tipo de análise a ser executada:

  • rapid-techdebt-analysis— Dependências desatualizadas e vitórias fáceis.

  • tech-debt-comprehensive— AI-powered Análise mais profunda abrangendo descobertas sobre dependência, segurança, padrões, desempenho, capacidade de manutenção, arquitetura, qualidade de código e infraestrutura.

  • security— Vulnerabilidades e exposições de segurança.

  • agentic-readiness— Preparação de seus repositórios para agentes de IA (estruturas, APIs, documentação).

  • modernization-readiness— oportunidades de modernização em suas dimensões de infraestrutura, aplicativos, dados, segurança e operações.

atx ct analysis run --type type --source name [--repo source::slug] [--wait]
atx ct analysis get --id id --json
atx ct analysis list --json
atx ct analysis list --status pending|running|complete|cancelled|failed --json
atx ct analysis list --type type --json
atx ct analysis cancel --id id
atx ct analysis delete --id id [--cascade-findings]

Análise personalizada

atx ct analysis run --type custom --transformation-name name --source source --repo source::slug --wait

Configuração com -g sinalizador: valor-chave, JSON ou caminho do arquivo.

Listar TDs: atx custom def list

Gerenciar descobertas

atx ct findings list --json
atx ct findings list --repo source::slug --source name --severity high|medium|low --type analysis-type --status open|dismissed|obsolete --analysis-id id --fix-transform transform-name --json

Encontrando status

  • open— Ativo

  • dismissed— Dispensado manualmente (requer motivo)

  • obsolete— System-set quando a reanálise não produz mais a descoberta

atx ct findings update --id id --status dismissed --reason "reason"
atx ct findings update --id id --status open
atx ct findings batch-update --ids id1,id2 --status dismissed --reason "reason"
atx ct findings get --id id
atx ct findings delete --id id

Encontrando a obsolescência

Re-analysis marca as descobertas resolvidas como obsoletas. Não pode ser reaberto. Retido para auditoria.

Criação de remediações

Três modos: baseado em descobertas, substituição de TD, TD direto.

atx ct remediation create --ids id1,id2 --name "name"
atx ct remediation create --ids id1,id2 --transformation-name TD
atx ct remediation create --transformation-name TD --repo source::slug

Saída por provedor: GitHub PR, GitLab MR, Bitbucket PR, filial local.

nota

O token deve ter acesso de gravação para PR/MR criação.

Execução local com --local bandeira.

atx ct remediation create --transformation-name TD --repo source::slug -g "additionalPlanContext=Upgrade to Node.js 22"
atx ct remediation list
atx ct remediation status --id id
atx ct remediation retry --id id
atx ct remediation delete --id id

AWS Transformar aplicativo web (opcional)

O aplicativo web AWS Transform é uma interface opcional para monitorar análises, descobertas e correções de modernização contínua em todo o seu portfólio de fontes de código.

Antes de usar o aplicativo web AWS Transform, você precisa ter uma identidade de usuário habilitada para acessar o AWS Transform em sua organização. Para obter informações sobre como ativar o AWS Transform, consulte Configurando o AWS Transform.

Para usar o aplicativo web AWS Transform:

  1. Visite https://aws.amazon.com/transform/ e faça login usando as credenciais AWS do IAM Identity Center.

  2. Se a modernização contínua não aparecer após o login, faça login com as credenciais do IAM. Para ativar o login com as credenciais do IAM:

    1. No AWS Management Console, abra AWS Transformar e escolha Configurações.

    2. Na seção AWS Transformação de acesso com credenciais do IAM, ative o acesso às credenciais do IAM.

    3. Na mesma página de configurações, copie o link de login mostrado em URL do aplicativo Web (com IAM).

    4. Cole o URL de login na mesma janela do navegador em que o AWS Management Console está aberto. Isso garante que o aplicativo web use as AWS credenciais dessa conta.

  3. Abra o menu de navegação à esquerda e escolha a modernização contínua. O painel exibe estatísticas resumidas, incluindo fontes, repositórios, resultados totais por gravidade e tipos de análise.

  4. Use as guias Análises, Descobertas e Remediações para visualizar resultados detalhados.

  5. AWS Converse com o Transform diretamente do aplicativo web para fazer perguntas sobre suas análises, descobertas ou correções.

O aplicativo web foi projetado para operações em escala empresarial em que você precisa de visibilidade centralizada das análises e correções contínuas de modernização em várias bases de código.