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, configurare AWS Transform custom ed eseguire la prima trasformazione.

Scegli dove correre AWS Trasforma personalizzata

Esegui AWS Transform custom dalla riga di comando, da Kiro Power, da un plugin agente o da un plug-in IDE. Ogni opzione fornisce l'accesso alle stesse definizioni AWS di trasformazione gestite e personalizzate.

AWS Transform CLI

Utilizza la CLI AWS Transform per flussi di lavoro, script e automazione dei terminali. Con questa opzione, puoi completare la configurazione manualmente. RivediAWS Prerequisiti della CLI Transform, quindiInstallazione di AWS Trasforma CLI.

Kiro Power

Usa AWS Transform Kiro Power per un flusso di lavoro conversazionale guidato in Kiro IDE.

1. Apri Kiro IDE e vai al pannello Powers.

2. Trova AWS Transform e installalo.

3. Apri Kiro Chat, scegli Power, quindi scegli Try power.

Dopo l'installazione, chiedi a Kiro di configurare AWS Transform personalizzato e di mostrarti le trasformazioni disponibili per il tuo repository.

Per l'opzione di GitHub importazione e le informazioni di autenticazione, vedi. Kiro Power

Agent plugin

Utilizzate il plug-in AWS Transform agent con Claude Code, Codex o Cursor nel repository che desiderate trasformare.

Da installare in Claude Code

Aggiungi il marketplace del plug-in AWS agent e installa il plug-in AWS Transform:

/plugin marketplace add awslabs/agent-plugins
/plugin install aws-transform@agent-plugins-for-aws

Per installarlo in Codex o Cursor

Segui le istruzioni di installazione nel repository agent-plugins README sul sito web. GitHub Per ulteriori informazioni, consulta Plugin Agent.

Dopo l'installazione, chiedi al tuo agente di codifica di configurare AWS Transform personalizzato e di mostrarti le trasformazioni disponibili per il tuo repository.

IDE plugin

Usa il plug-in AWS Transform IDE per creare ed eseguire definizioni di trasformazione da VS Code o da un editor compatibile con Open VSX.

• VS Code: installa il plugin dal VS Code Marketplace.

• Apri VSX: installa il plugin dal registro Open VSX.

Per ulteriori informazioni, consulta Plugin IDE.

Se hai scelto AWS Transform 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 Transform Web Application (opzionale)

AWS Prerequisiti della CLI Transform

Prima di installare AWS Transform custom, assicurati di disporre di quanto segue:

Piattaforme supportate

AWS Transform custom supporta i seguenti sistemi operativi:

Software richiesto

Requisiti di rete

È necessaria una connessione Internet con accesso ai seguenti endpoint:

Se lavori in un ambiente con restrizioni Internet, aggiorna le regole del firewall per inserire questi URL nella lista consentita.

Installazione di AWS Trasforma CLI

Il metodo di installazione consigliato è l'utilizzo dello script di installazione. Scegli la scheda relativa al tuo sistema operativo.

Per installare la CLI AWS Transform

Configurazione dell'autenticazione

AWS Transform custom richiede AWS credenziali per l'autenticazione con il servizio. Configura l'autenticazione utilizzando uno dei seguenti metodi.

Variabili di ambiente

Imposta le seguenti variabili di ambiente.

Linux and macOS

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_SESSION_TOKEN=your_session_token

Windows (PowerShell)

$env:AWS_ACCESS_KEY_ID="your_access_key"
$env:AWS_SECRET_ACCESS_KEY="your_secret_key"
$env:AWS_SESSION_TOKEN="your_session_token"

È inoltre possibile specificare un profilo utilizzando la variabile di AWS_PROFILE ambiente.

Linux and macOS

export AWS_PROFILE=your_profile_name

Windows (PowerShell)

$env:AWS_PROFILE="your_profile_name"

AWS File di credenziali

Configura le AWS credenziali nel file delle credenziali, disponibile ~/.aws/credentials su Linux e macOS o su Windows: %USERPROFILE%\.aws\credentials

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Autorizzazioni IAM

AWS Le tue credenziali devono disporre delle autorizzazioni per chiamare il servizio personalizzato Transform. AWS Ti consigliamo di allegare la policy AWSTransformCustomFullAccess AWS gestita al tuo utente o ruolo IAM. Questa policy fornisce l'accesso completo a AWS Transform custom, inclusa l'autorizzazione a creare il ruolo collegato al servizio necessario per l'emissione delle CloudWatch metriche sul tuo account.

Per un controllo più granulare, AWS Transform custom fornisce anche le seguenti politiche gestite: AWS

Per ulteriori informazioni su queste politiche, consulta le politiche AWS gestite per AWS Transform. Per le policy IAM personalizzate con autorizzazioni a livello di risorsa, consulta la AWS Transform Custom IAM Service Authorization Reference Guide.

Configurazione AWS Region

AWS Transform custom è disponibile in AWS aree specifiche e rileva automaticamente la configurazione della regione utilizzando la precedenza AWS CLI standard.

Regioni supportate

AWS Transform custom è disponibile nelle seguenti regioni: AWS

Come viene determinata la regione

La CLI controlla queste fonti in modo prioritario per determinare quale regione utilizzare:

Impostazione della regione

Scegli uno di questi metodi per configurare la tua regione:

Opzione 1: variabile di ambiente (consigliata per l'uso temporaneo):

Linux and macOS

export AWS_REGION=<your-region>

Windows (PowerShell)

$env:AWS_REGION="<your-region>"

Opzione 2: configurazione AWS CLI (consigliata per la configurazione permanente):

aws configure set region <your-region>

Opzione 3: Profile-specific configurazione:

Linux and macOS

aws configure set region <your-region> --profile your_profile_name
export AWS_PROFILE=your_profile_name

Windows (PowerShell)

aws configure set region <your-region> --profile your_profile_name
$env:AWS_PROFILE="your_profile_name"

Opzione 4: modifica diretta dei file:

Modifica direttamente il file di AWS configurazione (~/.aws/configsu Linux e macOS %USERPROFILE%\.aws\config o su Windows):

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Verifica della configurazione della regione

Per verificare quale regione verrà utilizzata da AWS Transform custom:

Controlla l'impostazione attuale della regione:

aws configure get region

Controlla le variabili di ambiente:

Linux and macOS

echo "AWS_REGION: $AWS_REGION"
echo "AWS_DEFAULT_REGION: $AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $AWS_PROFILE"

Windows (PowerShell)

echo "AWS_REGION: $env:AWS_REGION"
echo "AWS_DEFAULT_REGION: $env:AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $env:AWS_PROFILE"

Visualizza la risoluzione dettagliata della regione nei log di debug:

Linux and macOS

tail -f ~/.aws/atx/logs/debug.log

Windows (PowerShell)

Get-Content "$env:USERPROFILE\.aws\atx\logs\debug.log" -Wait -Tail 10

Esempio di output di 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 campo mostra da dove è stata derivata la regione (ad esempio, «aws-config (profile: default)», «AWS_REGION», «default»).

Esecuzione della prima trasformazione

Il modo più veloce per iniziare è utilizzare una trasformazione AWS gestita. AWS-le trasformazioni gestite sono trasformazioni predefinite e AWS controllate, pronte all'uso senza alcuna configurazione.

Per eseguire una trasformazione gestita in modo interattivo: AWS

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, le opzioni di configurazione e i flag di comando, vedere. Riferimento ai comandi

Comprensione dei risultati della trasformazione

Al termine di una trasformazione, AWS Transform custom fornisce un rapporto che descrive i risultati. Se la trasformazione non è stata convalidata (ad esempio, creazione riuscita 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 quelle intermedie. 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 le trasformazioni AWS gestite non soddisfano le tue esigenze, puoi creare trasformazioni personalizzate su misura per i tuoi requisiti specifici.

Per creare una trasformazione personalizzata

Per istruzioni dettagliate sulla creazione di trasformazioni personalizzate, consultaFlussi di lavoro.

AWS Transform Web Application (opzionale)

L'applicazione web AWS Transform è un'interfaccia opzionale per il monitoraggio di campagne di trasformazione su larga scala su più repository. Prima di utilizzare l'applicazione web AWS Transform, devi avere un'identità utente abilitata per accedere a AWS Transform nella tua organizzazione. Per informazioni sull'attivazione di AWS Transform, consulta Configurazione di AWS Transform.

Per utilizzare l'applicazione web AWS Transform:

L'applicazione Web è progettata per operazioni su scala aziendale in cui è necessario il monitoraggio centralizzato delle trasformazioni su più basi di codice.