Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Démarrage

Cette section décrit comment configurer AWS Transform custom et exécuter votre première transformation.

Conditions préalables

Avant d'installer AWS Transform custom, assurez-vous de disposer des éléments suivants :

Plateformes prises en charge

AWS Transform Custom prend en charge les systèmes d'exploitation suivants :

Logiciel requis

Exigences réseau

Une connexion Internet permettant d'accéder aux points de terminaison suivants est requise :

Si vous travaillez dans un environnement où Internet est restreint, mettez à jour les règles de pare-feu pour autoriser la mise en liste de ces URL.

Installation de la   AWS Transformer la CLI

La méthode d'installation recommandée consiste à utiliser le script d'installation. Choisissez l'onglet correspondant à votre système d'exploitation.

Pour installer la CLI AWS Transform

Configuration de l'authentification

AWS Transform Custom nécessite AWS des informations d'identification pour s'authentifier auprès du service. Configurez l'authentification à l'aide de l'une des méthodes suivantes.

Variables d’environnement

Définissez les variables d'environnement suivantes.

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"

Vous pouvez également spécifier un profil à l'aide de la variable d'AWS_PROFILEenvironnement.

Linux and macOS

export AWS_PROFILE=your_profile_name

Windows (PowerShell)

$env:AWS_PROFILE="your_profile_name"

AWS Fichier d'informations d'identification

Configurez les informations AWS d'identification dans le fichier d'informations d'~/.aws/credentialsidentification, situé sous Linux et macOS, ou %USERPROFILE%\.aws\credentials sous Windows :

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Autorisations IAM

Vos AWS informations d'identification doivent être autorisées à appeler le service personnalisé AWS Transform. Nous vous recommandons d'associer la politique AWSTransformCustomFullAccess AWS gérée à votre utilisateur ou à votre rôle IAM. Cette politique fournit un accès complet à AWS Transform custom, y compris l'autorisation de créer le rôle lié au service requis pour l'émission de CloudWatch métriques sur votre compte.

Pour un contrôle plus précis, AWS Transform custom fournit également les politiques AWS gérées suivantes :

Pour plus d'informations sur ces politiques, consultez la section Politiques AWS gérées pour AWS Transform. Pour les politiques IAM personnalisées avec des autorisations au niveau des ressources, reportez-vous au guide de référence d'autorisation du service AWS Transform Custom IAM.

Configuration AWS Région

AWS Transform custom est disponible dans des AWS régions spécifiques et détecte automatiquement la configuration de votre région à l'aide de la priorité de la AWS CLI standard.

Régions prises en charge

AWS Transform custom est disponible dans les AWS régions suivantes :

Comment est déterminée la région

La CLI vérifie ces sources par ordre de priorité afin de déterminer la région à utiliser :

Configuration de votre région

Choisissez l'une des méthodes suivantes pour configurer votre région :

Option 1 : variable d'environnement (recommandée pour une utilisation temporaire) :

Linux and macOS

export AWS_REGION=<your-region>

Windows (PowerShell)

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

Option 2 : configuration de la AWS CLI (recommandée pour une installation permanente) :

aws configure set region <your-region>

Option 3 : Profile-specific configuration :

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"

Option 4 : édition directe des fichiers :

Modifiez directement le fichier de AWS configuration (~/.aws/configsous Linux et macOS, ou %USERPROFILE%\.aws\config sous Windows) :

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Vérification de la configuration de votre région

Pour vérifier la région que AWS Transform custom utilisera :

Vérifiez le paramètre régional actuel :

aws configure get region

Vérifiez les variables d'environnement :

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"

Afficher la résolution détaillée de la région dans les journaux de débogage :

Linux and macOS

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

Windows (PowerShell)

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

Exemple de sortie de journal indiquant la source de la région :

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"
}

Le regionSource champ indique d'où provient la région (par exemple, « aws-config (profile : default) », « AWS_REGION », « default »).

Exécution de votre première transformation

Le moyen le plus rapide de démarrer est d'utiliser une transformation AWS gérée. AWS Les transformations -gérées sont des transformations prédéfinies et AWS validées qui sont prêtes à être utilisées sans aucune configuration.

Pour exécuter une transformation AWS gérée de manière interactive, procédez comme suit :

atx

Demandez ensuite à l'agent d'exécuter une transformation :

Execute the AWS/java-aws-sdk-v1-to-v2 transformation on the codebase at ./my-java-project

Pour exécuter une transformation de manière non interactive, procédez comme suit :

atx custom def exec -n AWS/java-aws-sdk-v1-to-v2 -p ./my-java-project -c "mvn clean install" -x -t

Pour des informations détaillées sur les modes d'exécution, les options de configuration et les indicateurs de commande, consultezRéférence de commande.

Comprendre les résultats de la transformation

Lorsqu'une transformation est terminée, AWS Transform custom fournit un rapport décrivant les résultats. Si la transformation n'a pas été validée (par exemple, compilation réussie pour une application Java), le rapport fournit des recommandations pour d'autres actions.

La plupart des transformations sont effectuées en plusieurs étapes, en utilisant Git pour valider les transformations intermédiaires. Vous pouvez consulter les modifications apportées par la transformation à l'aide des commandes Git standard :

git status
git log
git diff <original commit-id> 

Création d'une transformation personnalisée

Lorsque les transformations AWS gérées ne répondent pas à vos besoins, vous pouvez créer des transformations personnalisées adaptées à vos besoins spécifiques.

Pour créer une transformation personnalisée

Pour obtenir des instructions détaillées sur la création de transformations personnalisées, consultezFlux de travail.

AWS Transformer une application Web (facultatif)

L'application Web AWS Transform est une interface optionnelle permettant de surveiller les campagnes de transformation à grande échelle sur plusieurs référentiels. Avant d'utiliser l'application Web AWS Transform, vous devez avoir activé une identité d'utilisateur pour accéder à AWS Transform dans votre organisation. Pour plus d'informations sur l'activation de AWS Transform, voir Configuration de AWS Transform.

Pour utiliser l'application Web AWS Transform :

L'application Web est conçue pour les opérations à l'échelle de l'entreprise où vous avez besoin d'une surveillance centralisée des transformations sur plusieurs bases de code.