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à.
Nozioni di base su AWS Trasforma personalizzata
Questa sezione descrive come scegliere un'interfaccia e configurarla AWS Trasforma in modo personalizzato ed esegui la tua prima trasformazione.
Scegli dove correre AWS Trasforma personalizzata
Esegui AWS Trasforma in modo personalizzato dalla riga di comando, da Kiro Power, da un plugin per agenti o da un plug-in IDE. Ogni opzione fornisce l'accesso alla stessa AWS-definizioni di trasformazione gestite e personalizzate.
Consigliato per la configurazione guidata: Usa Kiro Power o AWS Plugin Transform Agent. Durante la configurazione, l'agente verifica i prerequisiti e installa o aggiorna AWS Trasforma la CLI quando necessario. Quindi ti guida attraverso la tua prima trasformazione. Hai ancora bisogno di qualcosa di appropriato AWS autorizzazioni e accesso al repository che desideri trasformare.
Se hai scelto AWS Trasforma la CLI, continua con i prerequisiti CLI che seguono. Se hai scelto un'altra opzione, segui le istruzioni di configurazione nella scheda selezionata.
Per il monitoraggio centralizzato delle campagne di trasformazione su più repository, consulta AWS Trasforma l'applicazione Web (opzionale).
AWS Trasforma i prerequisiti della CLI
Prima dell'installazione AWS Trasforma in modo personalizzato, assicurati di avere quanto segue:
Piattaforme supportate
AWS Transform custom supporta i seguenti sistemi operativi:
Linux - Supporto completo per tutte le distribuzioni Linux
MacOS - Supporto completo per i sistemi macOS
finestre - Supporto completo per Windows nativo tramite Windows Terminal e PowerShell (Il
atx cti comandi non sono ancora supportati in Windows)Sottosistema Windows per Linux (WSL) - Supportato durante l'esecuzione in WSL
Software richiesto
Node.js 22 o successivo - Scarica da https://nodejs.org/en/download
Via - Deve essere installato e la directory di lavoro deve essere un repository Git valido per eseguire una trasformazione. - Esegui
git init; git add .; git commit -m "Initial commit"per inizializzare un repository Git nella tua directory di lavoro.
Requisiti di rete
È richiesta una connessione Internet con accesso ai seguenti endpoint:
transform-cli.awsstatic.com.rproxy.goskope.comtransform-custom.<region>.api.aws*.s3.amazonaws.com
Se lavori in un ambiente con restrizioni Internet, aggiorna le regole del firewall per inserire questi URL nella lista consentita.
Installazione di AWS Trasforma la CLI
Il metodo di installazione consigliato è l'utilizzo dello script di installazione. Scegli la scheda per il tuo sistema operativo.
Per installare AWS Trasforma la CLI
Esegui lo script di installazione:
Verifica l’installazione:
atx --versionIl comando dovrebbe visualizzare la versione installata di AWS Trasforma la CLI.
Configurazione dell'autenticazione
AWS La trasformazione personalizzata richiede AWS credenziali per l'autenticazione con il servizio. Configurare l'autenticazione utilizzando uno dei seguenti metodi.
Variabili di ambiente
Imposta le seguenti variabili di ambiente.
È inoltre possibile specificare un profilo utilizzando AWS_PROFILE variabile di ambiente.
Variabili di ambiente impostate con $env: nel PowerShell si applicano solo alla sessione corrente. Per mantenerli permanenti tra le sessioni, impostali Proprietà del sistema > Variabili di ambiente, o usa [System.Environment]::SetEnvironmentVariable().
AWS File delle credenziali
Configurare le credenziali nel AWS file delle credenziali, che si trova in ~/.aws/credentials su Linux e macOS, oppure %USERPROFILE%\.aws\credentials su Windows:
[default] aws_access_key_id = your_access_key aws_secret_access_key = your_secret_key
Autorizzazioni IAM
Il tuo AWS le credenziali devono disporre delle autorizzazioni per chiamare il AWS Trasforma il servizio personalizzato. Ti consigliamo di allegare il AWSTransformCustomFullAccess AWS policy gestita al tuo utente o ruolo IAM. Questa policy fornisce l'accesso completo a AWS Trasformazione personalizzata, inclusa l'autorizzazione a creare ruolo collegato al servizio richiesto per CloudWatch emissione delle metriche sul tuo account.
Per un controllo più granulare, AWS Transform custom fornisce anche quanto segue AWS politiche gestite:
AWSTransformCustomExecuteTransformations — Fornisce l'accesso per eseguire trasformazioni.
AWSTransformCustomManageTransformations — Fornisce l'accesso per creare, aggiornare, leggere ed eliminare risorse di trasformazione, nonché per eseguire trasformazioni.
Per ulteriori informazioni su queste politiche, vedere AWS politiche gestite per AWS Trasforma. Per politiche IAM personalizzate con autorizzazioni a livello di risorsa, fai riferimento a AWS Guida di riferimento all'autorizzazione del servizio IAM personalizzato di Transform.
Le definizioni di trasformazione sono AWS risorse con ARN (Amazon Resource Names). Puoi utilizzare le policy IAM per controllare l'accesso a trasformazioni o gruppi di trasformazioni specifici specificando l'ARN di trasformazione nelle dichiarazioni delle risorse delle tue policy IAM. I tag possono essere utilizzati per il controllo degli accessi raggruppati.
AWS IAM Identity Center è necessario per accedere a AWS Trasforma, ma non è necessario utilizzare la CLI.
Configurazione AWS Region
AWS Transform custom è disponibile in specifiche AWS regioni e rileva automaticamente la configurazione della regione utilizzando lo standard AWS precedenza CLI.
Regioni supportate
AWS Transform custom è disponibile nei seguenti AWS regioni:
us-east-1(Stati Uniti orientali - Virginia settentrionale)eu-central-1(Europa - Francoforte)eu-west-2(Europa - Londra)ca-central-1(Canada - Centrale)ap-northeast-1(Asia Pacifico - Tokyo)ap-northeast-2(Asia Pacifico - Seoul)ap-southeast-2(Asia Pacifico - Sydney)ap-south-1(Asia Pacifico - Mumbai)
Come viene determinata la regione
La CLI controlla queste fonti in ordine di priorità per determinare quale regione utilizzare:
AWS_REGIONvariabile di ambiente (massima priorità)Variabile di ambiente
AWS_DEFAULT_REGIONProfilo selezionato in AWS file di configurazione (tramite
AWS_PROFILEvariabile di ambiente)Profilo predefinito in AWS file di configurazione
Fallback predefinito su
us-east-1se non viene trovata alcuna configurazione
Il AWS il file di configurazione si trova in ~/.aws/config su Linux e macOS, oppure %USERPROFILE%\.aws\config su Windows.
Se ATX_CUSTOM_ENDPOINT è impostata, la regione viene estratta dall'URL dell'endpoint e sovrascrive tutte le altre impostazioni.
Impostazione della regione
Scegli uno dei seguenti metodi per configurare la tua regione:
Opzione 1: variabile d'ambiente (consigliata per un uso temporaneo):
Opzione 2: AWS Configurazione CLI (consigliata per l'installazione permanente):
aws configure set region <your-region>
Opzione 3: Profile-specific configurazione:
Opzione 4: modifica diretta dei file:
Modifica il AWS file di configurazione direttamente (~/.aws/config su Linux e macOS, oppure %USERPROFILE%\.aws\config su Windows):
[default] region = <your-region> [profile your_profile_name] region = <your-region>
Verifica della configurazione della regione
Per verificare in quale regione AWS Transform custom utilizzerà:
Controlla l'impostazione attuale della regione:
aws configure get region
Controlla le variabili di ambiente:
Visualizza la risoluzione dettagliata della regione nei log di debug:
Esempio di output del registro che mostra l'origine della regione:
2026-01-07 22:34:28 [DEBUG]: Initializing FrontendServiceClient with config: { "endpoint": "https://transform-custom.us-east-1.api.aws", "region": "us-east-1", "regionSource": "AWS_REGION" }
Il regionSource il campo mostra da dove è stata derivata la regione (ad esempio, «aws-config (profile: default)», «AWS_REGION», «default»).
Se la configurazione della tua regione punta a una regione non supportata, la CLI mostrerà un chiaro messaggio di errore con le istruzioni per aggiornare la configurazione in una regione supportata.
Esecuzione della prima trasformazione
Il modo più veloce per iniziare è utilizzare un AWS-trasformazione gestita. AWS-le trasformazioni gestite sono predefinite, AWS-trasformazioni controllate pronte all'uso senza alcuna configurazione.
Per eseguire un AWS-trasformazione gestita in modo interattivo:
atx
Quindi chiedi all'agente di eseguire una trasformazione:
Execute the AWS/java-aws-sdk-v1-to-v2 transformation on the codebase at ./my-java-project
Per eseguire una trasformazione in modo non interattivo:
atx custom def exec -n AWS/java-aws-sdk-v1-to-v2 -p ./my-java-project -c "mvn clean install" -x -t
Per informazioni dettagliate sulle modalità di esecuzione, sulle opzioni di configurazione e sui flag di comando, vedere Riferimento al comando.
Comprensione dei risultati della trasformazione
Quando una trasformazione viene completata, AWS Transform custom fornisce un rapporto che descrive i risultati. Se la trasformazione non è stata convalidata (ad esempio, una compilazione corretta per un'applicazione Java), il rapporto fornisce consigli per ulteriori azioni.
La maggior parte delle trasformazioni viene eseguita in più passaggi, utilizzando Git per eseguire il commit di quelli intermedi. Puoi rivedere le modifiche apportate dalla trasformazione usando i comandi Git standard:
git status git log git diff<original commit-id>
Creazione di una trasformazione personalizzata
Quando AWS-le trasformazioni gestite non soddisfano le tue esigenze, puoi creare trasformazioni personalizzate su misura per le tue esigenze specifiche.
Per creare una trasformazione personalizzata
Avvia il AWS Trasforma la CLI in modalità interattiva:
atxInforma l'agente che desideri creare una nuova trasformazione e descrivi i tuoi requisiti.
Fornisci materiali di riferimento come documentazione ed esempi di codice per migliorare la qualità.
Testa e perfeziona la trasformazione in modo iterativo.
Pubblicalo nel registro di trasformazione della tua organizzazione.
Per istruzioni dettagliate sulla creazione di trasformazioni personalizzate, consulta Flussi di lavoro.
AWS Trasforma l'applicazione Web (opzionale)
Il AWS L'applicazione web Transform è un'interfaccia opzionale per il monitoraggio di campagne di trasformazione su larga scala su più repository. Prima dell'uso AWS Trasforma l'applicazione web, devi avere un'identità utente abilitata per accedere AWS Trasforma la tua organizzazione. Per informazioni sull'abilitazione AWS Trasforma, vedi Configurazione AWS Trasforma.
Per usare AWS Trasforma l'applicazione web:
Visita https://aws.amazon.com/transform/ e accedi utilizzando AWS credenziali IAM Identity Center.
Seleziona il tipo di lavoro «Personalizzato/codice» nel campo AWS Trasforma l'applicazione web.
Indica all'agente il nome della definizione di trasformazione che desideri utilizzare.
L'applicazione web fornisce un AWS Trasforma il comando CLI che può essere condiviso con il tuo team. Questo comando richiama la definizione della trasformazione e registra i risultati dell'esecuzione nell'applicazione web.
Una volta acquisiti i risultati della trasformazione, visualizzate le statistiche, le misurazioni del risparmio di tempo e ponete domande sullo stato di avanzamento del vostro lavoro nella Dashboard.
L'applicazione web è progettata per operazioni su scala aziendale in cui è necessario il monitoraggio centralizzato delle trasformazioni su più basi di codice.
AWS IAM Identity Center è necessario per accedere a AWS Trasforma l'applicazione web. La CLI non richiede IAM Identity Center, ma solo standard AWS sono necessarie le credenziali.