Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lavorare con una modernizzazione continua

Gestione delle fonti

Usa atx ct source i comandi per connettere i repository. Provider supportati: GitHub, GitLab, Bitbucket, local.

GitHub organizzazioni

Token: token di accesso personale (classico) con repo ambito. Read-only per l'analisi, repository completo per la correzione.

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

GitLab gruppi e utenti

Token: token di accesso personale con api ambito.

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

Spazi di lavoro e progetti Bitbucket

Bitbucket Cloud: ambiti:,,,. read:repository:bitbucket write:repository:bitbucket read:pullrequest:bitbucket write:pullrequest:bitbucket Inoltre ha bisogno di e. --email --username

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

Centro dati Bitbucket:

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

Repository locali

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

Gestione delle fonti

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

Individuazione e gestione dei repository

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

Dopo la scoperta:

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"

Analisi in corso

Il --type flag specifica il tipo di analisi da eseguire:

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]

Analisi personalizzata

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

Configurazione con -g flag: chiave-valore, JSON o percorso del file.

Elenca i TD: atx custom def list

Gestione degli esiti

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

Ricerca degli stati

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

Scoprire l'obsolescenza

Re-analysis contrassegna i risultati risolti come obsoleti. Non può essere riaperto. Conservato per l'audit.

Creazione di correzioni

Tre modalità: basata sui risultati, TD override, TD diretto.

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

Produzione per fornitore: GitHub PR, GitLab MR, Bitbucket PR, filiale locale.

Esecuzione locale con --local flag.

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

Esecuzione remota

Per impostazione predefinita, le analisi e le correzioni vengono eseguite sul computer locale. Per portafogli più grandi, puoi scaricare il lavoro sull'infrastruttura remota. Puoi eseguire l'esecuzione su AWS Transform-managed un'infrastruttura che non richiede il provisioning (solo analisi) o su un'infrastruttura di cui esegui il provisioning e gestisci all'interno della tua azienda Account AWS: un'istanza persistente di Amazon EC2 o AWS processi Batch (Fargate). I atx ct remote comandi forniscono, eseguono, monitorano e distruggono l'infrastruttura gestita dal cliente. Indipendentemente dal luogo in cui avviene l'esecuzione, crei tutte le risorse Account AWS e il codice sorgente rimane sotto il tuo controllo.

In esecuzione su AWS Transform-managed infrastruttura (nessun provisioning)

Per eseguire un'analisi in remoto senza effettuare alcun provisioning, usa. --mode aws-managed L'invio va a AWS Transform, che esegue l'analisi sull'infrastruttura. AWS Transform-managed Non ci sono stack da fornire, nessuna rete da configurare e nessuna credenziale da archiviare in AWS Secrets Manager. L'invio è la corsa. Scegli la AWS regione in cui viene eseguito il carico di lavoro. --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

Questa modalità esegue solo analisi. Non supporta la correzione, il tipo di custom analisi o le fonti locali. Poiché non esiste uno stack, le --batch-name opzioni --stack-name--tags,--existing-instance, e non sono applicabili. Un singolo invio copre fino a 100 repository. Per coprire ambiti più ampi, suddividili su più invii con. --repos A differenza di Amazon EC2 e Batch Runs, i progressi vengono monitorati con anziché conatx ct analysis get. atx ct remote status

Rete

L'elaborazione remota deve essere eseguita in sottoreti private. Scopri le reti esistenti o crea un nuovo VPC prima di effettuare il provisioning:

# 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

Provisioning dell'infrastruttura

Implementa lo stack Amazon EC2 o Batch. Ometti --execute di visualizzare in anteprima il modello o il changeset; aggiungi per applicare. --execute

Il provisioning crea lo stack di calcolo per la modalità scelta, più uno stack di scheduler:

# 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

Immagine del contenitore

Quando esegui analisi e correzioni in remoto, queste vengono eseguite all'interno di un'immagine del contenitore. Per impostazione predefinita, quando si esegue il provisioning di un ambiente remoto, viene utilizzata l'immagine pubblica AWS Transform,. public.ecr.aws/d9h8z6l7/aws-transform:latest Batch la imposta come immagine di definizione del lavoro. Amazon EC2 la utilizza come immagine del runner.

Per eseguire un'immagine diversa, ad esempio un'immagine privata Amazon ECR che raggruppa linguaggi o strumenti aggiuntivi, è necessario eseguire il provisioning di: --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

Memorizzazione delle credenziali di origine

I contenitori remoti clonano i tuoi repository utilizzando i token archiviati in Secrets Manager. AWS Registra un token per ogni fonte SCM prima di eseguire l'analisi o la correzione remota:

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

Esecuzione in remoto

L'analisi remota esegue un contenitore per ogni repository; la riparazione remota esegue un contenitore per ogni risultato. Usa --sources--repos, e --labels per controllare il fan-out --stack-name e/o per selezionare lo stack di cui è stato eseguito --tags il provisioning da utilizzare.

# 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

Monitoraggio e gestione delle esecuzioni

# 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

Pianificazione di analisi ricorrenti

atx ct scheduleDa utilizzare per eseguire analisi automaticamente su una cadenza ricorrente. È possibile pianificare le analisi ma non le correzioni. Le opzioni di lavoro si specchiano. atx ct remote analysis Le pianificazioni vengono eseguite in remoto, in due modi:

Il --recurrence valore accettadaily, weekly:DAY (ad esempio,weekly:MONDAY), o monthly:N dove N è un giorno compreso tra 1 e 28. Gli orari sull' AWS Transform-managed infrastruttura vengono eseguiti in 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

Per visualizzare le analisi eseguite da una pianificazione, usaatx ct analysis list --schedule-id schedule-id, che restituisce le esecuzioni attivate della pianificazione, le più recenti per prime.

Per rimuovere il ruolo dello scheduler e il gruppo di pianificazione utilizzati dalle pianificazioni gestite dal cliente, esegui. atx ct schedule teardown --execute

Ruolo di esecuzione per AWS Transform-managed orari

Una pianificazione creata con --mode aws-managed richiede un --execution-role ARN che AWS Transform assume ogni volta che viene eseguita la pianificazione. Configura il ruolo come segue:

La seguente policy in linea garantisce al AWS Secrets Manager l'accesso necessario alle esecuzioni pianificate per recuperare le credenziali del clone di origine. Associala al ruolo di esecuzione insieme alla policy AWSTransformCustomFullAccess gestita, sostituendola account-id con la AWS Regione region e l'account in cui viene eseguita la pianificazione.

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

Etichettatura e controllo degli accessi

Puoi applicare tag (key=valuecoppie separate da virgole) a fonti, analisi e correzioni con questa opzione. --tags I tag sono supportati anche sull'infrastruttura remota, sulle credenziali archiviate e sulle risorse di rete. Con i tag, puoi organizzare le risorse. In combinazione con le condizioni dei tag IAM, i tag implementano il controllo degli accessi basato sugli attributi (ABAC) in modo che i team accedano solo alle risorse che contengono i loro tag.

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

Per impostazione predefinita, le risorse sono contrassegnate con i tag definiti dall'utente. ~/.aws/atx/settings.json Aggiungete i tag da applicare a tutte le risorse in applyTags essa contenuti e diventeranno i tag predefiniti.

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

AWS Trasforma l'applicazione web

Usa l'applicazione web AWS Transform per creare ed eseguire analisi, esaminare i risultati, creare correzioni e tenere traccia delle pull request generate tra le tue fonti di codice.

Prima di utilizzare l'applicazione web, l'organizzazione deve abilitare la tua identità utente per accedere AWS a Transform. Per ulteriori informazioni sulla configurazione di AWS Transform, vedere Configurazione di AWS Transform.

Accesso

Per accedere all'applicazione web AWS Transform, completare i passaggi seguenti.

Modalità di infrastruttura

Quando crei un'analisi, scegli una delle seguenti modalità di infrastruttura:

Per utilizzare l'infrastruttura di proprietà del cliente, apri la scheda Impostazioni. Usa i link di AWS CloudFormation creazione rapida per distribuire i seguenti stack nell'ordine:

Per il CLI-based provisioning e la configurazione di rete, vedereEsecuzione remota.

Flusso di lavoro introduttivo

Chatta con AWS Transform direttamente dall'applicazione web per porre domande sulle tue analisi, scoperte o correzioni.