View a markdown version of this page

Introducción - AWS Transformar
Requisitos previosInstalación de la   AWS Transforme la CLIConfiguración de la autenticaciónConfiguración AWS RegionEjecutando su primera transformaciónComprender los resultados de la transformaciónCrear una transformación personalizadaAWS Transformar la aplicación web (opcional)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción

En esta sección se describe cómo configurar AWS Transform Custom y ejecutar la primera transformación.

Requisitos previos

Antes de instalar AWS Transform custom, asegúrese de disponer de lo siguiente:

Plataformas admitidas

AWS Transform custom es compatible con los siguientes sistemas operativos:

  • Linux: soporte completo para todas las distribuciones de Linux

  • macOS: soporte completo para sistemas macOS

  • Windows: compatibilidad total con Windows nativo mediante Windows Terminal y PowerShell (los atx ct comandos aún no son compatibles con Windows)

  • Subsistema de Windows para Linux (WSL): se admite cuando se ejecuta en WSL

Software requerido

  • Node.js 22 o posterior: descárguelo desde https://nodejs.org/en/download

  • Git: debe estar instalado y el directorio de trabajo debe ser un repositorio de Git válido para ejecutar una transformación. Ejecuta git init; git add .; git commit -m "Initial commit" para inicializar un repositorio de Git en tu directorio de trabajo.

Requisitos de red

Se requiere una conexión a Internet con acceso a los siguientes puntos finales:

  • transform-cli.awsstatic.com

  • transform-custom.<region>.api.aws

  • *.s3.amazonaws.com

Si trabaja en un entorno con acceso restringido a Internet, actualice las reglas del firewall para incluir estas URL en la lista de permitidos.

Instalación de la   AWS Transforme la CLI

El método de instalación recomendado es utilizar el script de instalación. Seleccione la pestaña correspondiente a su sistema operativo.

Para instalar la CLI de AWS Transform

  1. Ejecute el script de instalación:

    Linux and macOS
    curl -fsSL https://transform-cli.awsstatic.com/install.sh | bash
    Windows (PowerShell)

    En Windows nativo, ejecute el script de instalación desde la Terminal de Windows mediante PowerShell.

    irm https://transform-cli.awsstatic.com/install.ps1 | iex

  2. Verificar la instalación:

    atx --version

    El comando debe mostrar la versión instalada de la CLI de AWS Transform.

Configuración de la autenticación

AWS Transform custom requiere AWS credenciales para autenticarse en el servicio. Configure la autenticación mediante uno de los siguientes métodos.

Variables de entorno

Configure las siguientes variables de entorno.

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"

También puede especificar un perfil mediante la variable de AWS_PROFILE entorno.

Linux and macOS
export AWS_PROFILE=your_profile_name
Windows (PowerShell)
$env:AWS_PROFILE="your_profile_name"
nota

Las variables de entorno configuradas con $env: in PowerShell se aplican únicamente a la sesión actual. Para conservarlas en todas las sesiones, configúralas en Propiedades del sistema > Variables de entorno o utilízalas[System.Environment]::SetEnvironmentVariable().

AWS Archivo de credenciales

Configure las credenciales en el archivo de AWS credenciales, que se encuentra ~/.aws/credentials en Linux y macOS, o %USERPROFILE%\.aws\credentials en Windows:

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Permisos de IAM

Sus AWS credenciales deben tener permisos para llamar al servicio personalizado AWS Transform. Le recomendamos que adjunte la política AWSTransformCustomFullAccess AWS gestionada a su usuario o rol de IAM. Esta política proporciona acceso total a AWS Transform Custom, incluido el permiso para crear el rol vinculado al servicio necesario para la emisión de CloudWatch métricas a tu cuenta.

Para un control más detallado, AWS Transform custom también proporciona las siguientes políticas AWS administradas:

Para obtener más información sobre estas políticas, consulte las políticas AWS administradas para AWS Transform. Para ver las políticas de IAM personalizadas con permisos a nivel de recursos, consulte la guía de referencia de autorización del servicio de IAM personalizado de AWS Transform.

nota

  • Las definiciones de transformación son AWS recursos con ARN (nombres de recursos de Amazon). Puede usar las políticas de IAM para controlar el acceso a transformaciones o grupos de transformaciones específicos especificando el ARN de la transformación en sus declaraciones de recursos de políticas de IAM. Las etiquetas se pueden usar para el control de acceso agrupado.

  • AWS El IAM Identity Center es necesario para acceder a la AWS transformación, pero no es necesario utilizar la CLI.

Configuración AWS Region

AWS La transformación personalizada está disponible en AWS regiones específicas y detecta automáticamente la configuración de su región mediante la prioridad estándar de la AWS CLI.

Regiones admitidas

AWS La transformación personalizada está disponible en las siguientes AWS regiones:

  • us-east-1(Este de EE. UU. - Virginia del Norte)

  • eu-central-1(Europa - Fráncfort)

  • eu-west-2(Europa - Londres)

  • ca-central-1(Canadá - Centro)

  • ap-northeast-1(Asia Pacífico - Tokio)

  • ap-northeast-2(Asia Pacífico - Seúl)

  • ap-southeast-2(Asia Pacífico - Sídney)

  • ap-south-1(Asia Pacífico - Bombay)

¿Cómo se determina la región

La CLI comprueba estas fuentes en orden de prioridad para determinar qué región usar:

  1. AWS_REGIONvariable de entorno (máxima prioridad)

  2. AWS_DEFAULT_REGION variable de entorno

  3. Perfil seleccionado en el archivo de AWS configuración (mediante la variable de AWS_PROFILE entorno)

  4. Perfil predeterminado en el archivo de AWS configuración

  5. Recurso predeterminado a us-east-1 si no se encuentra ninguna configuración

nota

El archivo de AWS configuración se encuentra ~/.aws/config en Linux y macOS, o %USERPROFILE%\.aws\config en Windows.

nota

Si ATX_CUSTOM_ENDPOINT está configurada, la región se extrae de la URL del punto final y anula todas las demás configuraciones.

Configuración de su región

Elige uno de estos métodos para configurar tu región:

Opción 1: variable de entorno (recomendada para uso temporal):

Linux and macOS
export AWS_REGION=<your-region>
Windows (PowerShell)
$env:AWS_REGION="<your-region>"

Opción 2: configuración de la AWS CLI (recomendada para una configuración permanente): 

aws configure set region <your-region>

Opción 3: Profile-specific configuración:

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"

Opción 4: Edición directa de archivos:

Edite el archivo de AWS configuración directamente (~/.aws/configen Linux y macOS, o %USERPROFILE%\.aws\config en Windows):

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Verificación de la configuración de su región

Para comprobar qué región utilizará AWS Transform Custom:

Comprueba la configuración regional actual: 

aws configure get region

Compruebe las variables de entorno:

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"

Vea la resolución regional detallada en los registros de depuración:

Linux and macOS
tail -f ~/.aws/atx/logs/debug.log
Windows (PowerShell)
Get-Content "$env:USERPROFILE\.aws\atx\logs\debug.log" -Wait -Tail 10

Ejemplo de salida de registro que muestra el origen de la región:

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

El regionSource campo muestra de dónde se derivó la región (por ejemplo, «aws-config (profile: default)», «AWS_REGION», «default»).

importante

Si la configuración de su región apunta a una región no compatible, la CLI mostrará un mensaje de error claro con instrucciones para actualizar la configuración a una región compatible.

Ejecutando su primera transformación

La forma más rápida de empezar es utilizar una transformación AWS gestionada. AWS Las transformaciones administradas son transformaciones prediseñadas y AWS revisadas que están listas para usarse sin necesidad de ninguna configuración.

Para ejecutar una transformación gestionada de forma interactiva AWS: 

atx

A continuación, pida al agente que ejecute una transformación:

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

Para ejecutar una transformación de forma no interactiva: 

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

Para obtener información detallada sobre los modos de ejecución, las opciones de configuración y los indicadores de comando, consulte. Referencia de comandos

Comprender los resultados de la transformación

Cuando se completa una transformación, AWS Transform custom proporciona un informe en el que se describen los resultados. Si la transformación no se validó (por ejemplo, si se compiló correctamente para una aplicación Java), el informe proporciona recomendaciones para acciones futuras.

La mayoría de las transformaciones se realizan en varios pasos y se utiliza Git para confirmar los pasos intermedios. Puedes revisar los cambios realizados por la transformación mediante los comandos estándar de Git:

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

Crear una transformación personalizada

Cuando las transformaciones AWS administradas no satisfacen sus necesidades, puede crear transformaciones personalizadas que se adapten a sus requisitos específicos.

Para crear una transformación personalizada

  1. Inicie la CLI de AWS Transform en modo interactivo:

    atx

  2. Dígale al agente que desea crear una nueva transformación y describa sus requisitos.

  3. Proporcione materiales de referencia, como documentación y ejemplos de código, para mejorar la calidad.

  4. Pruebe y perfeccione la transformación de forma iterativa.

  5. Publíquela en el registro de transformaciones de su organización.

Para obtener instrucciones detalladas sobre la creación de transformaciones personalizadas, consulteFlujos de trabajo.

AWS Transformar la aplicación web (opcional)

La aplicación web AWS Transform es una interfaz opcional para monitorear campañas de transformación a gran escala en varios repositorios. Antes de usar la aplicación web AWS Transform, debe tener una identidad de usuario habilitada para acceder a AWS Transform en su organización. Para obtener información sobre cómo habilitar AWS Transform, consulte Configurar AWS Transform.

Para usar la aplicación web AWS Transform:

  1. Visite https://aws.amazon.com/transform/ e inicie sesión con las credenciales AWS del IAM Identity Center.

  2. Seleccione el tipo de trabajo «código/personalizado» en la aplicación web AWS Transform.

  3. Dígale al agente el nombre de la definición de transformación que desea usar.

  4. La aplicación web proporciona un comando de AWS transformación de la CLI que se puede compartir con su equipo. Este comando invoca la definición de transformación y registra los resultados de la ejecución en la aplicación web.

  5. Una vez capturados los resultados de la transformación, consulte las estadísticas, las mediciones del ahorro de tiempo y formule preguntas sobre el progreso de su trabajo en el panel de control.

La aplicación web está diseñada para operaciones a escala empresarial en las que se necesita una supervisión centralizada de las transformaciones en varias bases de código.

nota

AWS Se requiere el IAM Identity Center para acceder a la aplicación web Transform. AWS La CLI no requiere el IAM Identity Center; solo se necesitan AWS credenciales estándar.