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

Questa sezione descrive come configurare AWS Transform personalizzato ed eseguire la prima trasformazione.

Prerequisiti

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.