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 a modernização contínua

Gerenciamento de fontes

Use atx ct source comandos para conectar repositórios. Provedores suportados: 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

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::repo" --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:

atx ct analysis run --type type --source name [--repo source::repo] [--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::repo --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::repo --source name --severity high|medium|low --type analysis-type --status open|dismissed|obsolete --analysis-id id --fix-transform transform-name --json

Localizando status

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. Reservado 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::repo

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

Execução local com --local bandeira.

atx ct remediation create --transformation-name TD --repo source::repo -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 cancel --id id
atx ct remediation delete --id id

Execução remota

Por padrão, as análises e correções são executadas em sua máquina local. Para portfólios maiores, você pode transferir o trabalho para a infraestrutura remota. Você pode executar em uma AWS Transform-managed infraestrutura sem nada para provisionar (somente análises) ou na infraestrutura que você provisiona e gerencia em suas tarefas Conta da AWS— uma instância persistente do Amazon EC2 ou AWS Batch (Fargate). Os atx ct remote comandos provisionam, executam, monitoram e destroem a infraestrutura gerenciada pelo cliente. Independentemente de onde a execução acontece, você cria todos os recursos Conta da AWS e seu código-fonte permanece sob seu controle.

Executando em AWS Transform-managed infraestrutura (sem provisionamento)

Para executar uma análise remotamente sem provisionar nada, use. --mode aws-managed O envio vai para a AWS Transform, que executa a análise da AWS Transform-managed infraestrutura. Não há pilha para provisionar, rede para configurar e credenciais para armazenar no AWS Secrets Manager. A submissão é a corrida. Escolha a AWS região com a qual a carga de trabalho é executada--region.

# Run an analysis on AWS Transform-managed infrastructure
atx ct remote analysis --type type --mode aws-managed --sources name [--repos repo1,repo2] [--region region]

# Poll the submission (there is no remote status command in this mode)
atx ct analysis get --id id --json

Esse modo executa somente análises. Ele não oferece suporte à remediação, ao tipo de custom análise ou às fontes locais. Como não há pilha, as --batch-name opções --stack-name--tags,--existing-instance, e não se aplicam. Uma única submissão abrange até 100 repositórios. Para cobrir escopos maiores, divida-os em vários envios com. --repos Ao contrário das execuções do Amazon EC2 e do Batch, você monitora o progresso com, atx ct analysis get em vez deatx ct remote status.

Redes

A computação remota deve ser executada em sub-redes privadas. Descubra a rede existente ou crie uma nova VPC antes de provisionar:

# List VPCs, private subnets, and security groups in the current account and Region
atx ct remote network discover
atx ct remote network discover --vpc vpc-id --json

# Create a new VPC with private subnets, a NAT gateway, and a security group
atx ct remote network create --cidr 10.1.0.0/16 --ack

Provisionar infraestrutura

Implante a pilha Amazon EC2 ou Batch. Omita --execute para visualizar o modelo ou conjunto de alterações; adicione --execute para aplicar.

O provisionamento cria a pilha de computação para o modo que você escolher, além de uma pilha de agendador:

# Preview, then deploy an EC2 stack
atx ct remote provision --mode ec2 --vpc vpc-id --subnets subnet-a,subnet-b
atx ct remote provision --mode ec2 --vpc vpc-id --subnets subnet-a,subnet-b --execute --ack

# Deploy a Batch stack
atx ct remote provision --mode batch --vpc vpc-id --subnets subnet-a,subnet-b --securityGroup sg-id --execute --ack

# Update an existing stack to the latest template, or tear it down
atx ct remote update --mode ec2|batch --execute --ack
atx ct remote teardown --mode ec2|batch --execute --ack

Imagem do contêiner

Quando você executa análises e correções remotas, elas são executadas dentro de uma imagem de contêiner. Por padrão, quando você provisiona um ambiente remoto, ele usa a imagem pública AWS Transform,public.ecr.aws/d9h8z6l7/aws-transform:latest. O lote a define como a imagem de definição do trabalho. O Amazon EC2 a usa como imagem do executor.

Para executar uma imagem diferente, por exemplo, uma imagem privada do Amazon ECR que agrupa linguagens ou ferramentas adicionais, passe ao provisionar: --image-uri

# Batch: provision with a custom image
atx ct remote provision --mode batch --vpc vpc-id --subnets subnet-a,subnet-b --securityGroup sg-id --image-uri account-id.dkr.ecr.region.amazonaws.com/repo:tag --execute --ack

# EC2: provision with a custom image
atx ct remote provision --mode ec2 --vpc vpc-id --subnets subnet-a,subnet-b --image-uri account-id.dkr.ecr.region.amazonaws.com/repo:tag --execute --ack

Armazenamento de credenciais de origem

Os contêineres remotos clonam seus repositórios usando tokens armazenados no AWS Secrets Manager. Registre um token para cada fonte de SCM antes de executar uma análise ou correção remota:

atx ct remote credentials --source name --token token
atx ct remote credentials --source name --remove

Executando remotamente

A análise remota executa um contêiner para cada repositório; a remediação remota executa um contêiner para cada descoberta. Use--sources,--repos, e --labels para controlar a distribuição --stack-name e/ou --tags para selecionar qual pilha provisionada usar.

# Run analysis across a source on Batch
atx ct remote analysis --type type --mode batch --sources name [--repos repo1,repo2] [--labels "team:frontend"]

# Run remediation for specific findings on EC2
atx ct remote remediation --mode ec2 --ids id1,id2
atx ct remote remediation --mode ec2 --sources name --min-severity high

Monitoramento e gerenciamento de execuções

# Check whether infrastructure is deployed
atx ct remote detect --mode ec2|batch

# Track a submission (Batch by batch ID, EC2 by group ID)
atx ct remote status --batch batch-id --stack-name name
atx ct remote status --group ec2-group-id --wait

# Resume a partially-failed Batch run (re-submits only incomplete repos).
# On resume, --batch-name takes the existing batch ID reported by "remote status --batch".
atx ct remote analysis --type type --mode batch --sources name --resume-incomplete --batch-name batch-id

# Cancel a running submission
atx ct remote cancel --mode batch --batch batch-id --stack-name name
atx ct remote cancel --mode ec2 --group ec2-group-id

Agendamento de análises recorrentes

Use atx ct schedule para executar análises automaticamente em uma cadência recorrente. Você pode programar análises, mas não remediações. Espelho de opções de trabalhoatx ct remote analysis. Os agendamentos são executados remotamente, de duas maneiras:

O --recurrence valor aceitadaily, weekly:DAY (por exemplo,weekly:MONDAY), ou monthly:N onde N é um dia de 1 a 28. Os cronogramas de AWS Transform-managed infraestrutura são executados em UTC.

# AWS Transform-managed schedule (no infrastructure; requires an execution role)
atx ct schedule create --name name --mode aws-managed --execution-role role-arn --recurrence daily --type type --sources name [--repos repo1,repo2]

# Customer-managed schedule (EventBridge Scheduler dispatching to your EC2 or Batch stack)
atx ct schedule create --name name --mode ec2|batch --recurrence weekly:MONDAY --type type --sources name [--repos repo1,repo2]

# Manage schedules of either type by their schedule ID (from schedule list)
atx ct schedule list
atx ct schedule get schedule-id
atx ct schedule disable schedule-id
atx ct schedule enable schedule-id
atx ct schedule delete schedule-id

Para visualizar as análises executadas por um cronograma, useatx ct analysis list --schedule-id schedule-id, que retorna as execuções acionadas do cronograma, primeiro as mais recentes.

Para remover a função de agendador e o grupo de agendamentos usados pelas agendas gerenciadas pelo cliente, execute. atx ct schedule teardown --execute

Função de execução para AWS Transform-managed horários

Uma programação criada com --mode aws-managed exige um --execution-role ARN que o AWS Transform assume toda vez que a programação é executada. Configure a função da seguinte forma:

A política embutida a seguir concede ao AWS Secrets Manager o acesso que as execuções agendadas precisam para recuperar as credenciais do clone de origem. Anexe-o à função de execução junto com a política AWSTransformCustomFullAccess gerenciada, substituindo region e account-id com a AWS região e a conta em que o cronograma é executado.

{
  "Version": "2012-10-17", 
  "Statement": [
    {
      "Sid": "AtxSourceCredentials",
      "Effect": "Allow",
      "Action": [
        "secretsmanager:GetSecretValue",
        "secretsmanager:DescribeSecret"
      ],
      "Resource": "arn:aws:secretsmanager:region:account-id:secret:atx/*"
    }
  ]
}

Marcação e controle de acesso

Você pode aplicar tags (key=valuepares separados por vírgula) a fontes, análises e remediações com a opção. --tags As tags também são suportadas em infraestrutura remota, credenciais armazenadas e recursos de rede. Com as tags, você pode organizar os recursos. Combinadas com as condições de tag do IAM, as tags implementam o controle de acesso baseado em atributos (ABAC) para que as equipes acessem somente os recursos que carregam suas tags.

atx ct source add --name name --provider github --org org --token pat --tags team=platform,env=prod
atx ct analysis run --type type --source name --tags team=platform
atx ct remediation create --ids id1,id2 --tags team=platform

Por padrão, os recursos são marcados com as tags que você define~/.aws/atx/settings.json. Adicione as tags que você deseja aplicar a cada recurso e applyTags elas se tornarão suas tags padrão.

{
  "applyTags": [
    { "team": "alpha" }
  ]
}

AWS Transforme o aplicativo web

Use o aplicativo web AWS Transform para criar e executar análises, revisar descobertas, criar correções e rastrear solicitações pull geradas em suas fontes de código.

Antes de usar o aplicativo web, sua organização deve habilitar sua identidade de usuário para acessar o AWS Transform. Para obter mais informações sobre como configurar o AWS Transform, consulte Configurando o AWS Transform.

Faça login

Para acessar o aplicativo web AWS Transform, conclua as etapas a seguir.

Modos de infraestrutura

Ao criar uma análise, escolha um dos seguintes modos de infraestrutura:

Para usar a infraestrutura de propriedade do cliente, abra a guia Configurações. Use os links de AWS CloudFormation criação rápida para implantar as seguintes pilhas em ordem:

Para configuração de CLI-based provisionamento e rede, consulte. Execução remota

Fluxo de trabalho de introdução

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