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
<a name="ct-working-with"></a>

## Gerenciamento de fontes
<a name="ct-source-management"></a>

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

### GitHub organizações
<a name="ct-source-github"></a>

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
<a name="ct-source-gitlab"></a>

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
<a name="ct-source-bitbucket"></a>

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
<a name="ct-source-local"></a>

```
atx ct source add --name {{name}} --provider local --path {{parent-directory}}
```

**Importante**  
`--path`deve apontar para um diretório pai contendo repositórios git como subdiretórios, não para um único repositório.

### Gerenciando fontes
<a name="ct-managing-sources"></a>

```
atx ct source list
atx ct source remove --name {{name}}
```

## Descoberta e gerenciamento de repositórios
<a name="ct-repository-discovery"></a>

```
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
<a name="ct-running-analysis"></a>

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
<a name="ct-custom-analysis"></a>

```
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
<a name="ct-managing-findings"></a>

```
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
<a name="ct-finding-statuses"></a>
+ `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
<a name="ct-finding-obsolescence"></a>

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

## Criação de remediações
<a name="ct-creating-remediations"></a>

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)
<a name="ct-web-application"></a>

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](https://docs.aws.amazon.com/transform/latest/userguide/transform-setup.html).

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.

1. 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**.

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

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

   1. 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.

1. 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.

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

1.  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.