View a markdown version of this page

Introducción - AWS Transformar
Requisitos previosInstalación de la   AWS Transformar 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: compatibilidad total con los sistemas macOS

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

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

Software necesario

  • Node.js 22 o posterior: se puede descargar 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 una lista de direcciones URL permitidas.

Instalación de la   AWS Transformar 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 el sistema nativo de Windows, ejecute el script de instalación desde la Terminal de Windows utilizando 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úrelas en Propiedades del sistema > Variables de entorno o utilícelas[System.Environment]::SetEnvironmentVariable().

AWS Archivo de credenciales

Configure las credenciales en el archivo de AWS credenciales, ubicado ~/.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. Te recomendamos adjuntar la política AWSTransformCustomFullAccess AWS gestionada a tu usuario o rol de IAM. Esta política proporciona acceso completo 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 gestionadas:

Para obtener más información sobre estas políticas, consulte las políticas AWS gestionadas de AWS Transform. Para obtener información sobre las políticas de IAM personalizadas con permisos a nivel de recursos, consulte la Guía de referencia de autorización de servicios de IAM personalizados de AWS Transform.

nota

  • Las definiciones de transformación son AWS recursos con ARN (Amazon Resource Names). 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 utilizar para el control de acceso agrupado.

  • AWS Se requiere el IAM Identity Center para acceder a la AWS transformación, pero no es necesario para usar 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 la región mediante la prioridad AWS CLI estándar.

Regiones admitidas

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

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

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

  • eu-west-2(Europa - Londres)

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

  • 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 utilizar:

  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 una 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á establecida, la región se extrae de la URL del punto final y anula todos los demás ajustes.

Configuración de su región

Elija uno de estos métodos para configurar su 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 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:

Compruebe la configuración de región 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 detallada de la región 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 la fuente 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 el origen de 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 gestionadas son transformaciones prediseñadas y AWS examinadas que están listas para usarse sin necesidad de configuración alguna.

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 creó correctamente una aplicación Java), el informe proporciona recomendaciones para tomar medidas adicionales.

La mayoría de las transformaciones se realizan en varios pasos, utilizando Git para confirmar las intermedias. 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 gestionadas no satisfacen sus necesidades, puede crear transformaciones personalizadas adaptadas a sus requisitos específicos.

Para crear una transformación personalizada

  1. Inicie la CLI de AWS transformación 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ódigos, 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 cómo crear transformaciones personalizadas, consulteFlujos de trabajo.

AWS Transformar la aplicación web (opcional)

La aplicación web AWS Transform es una interfaz opcional para supervisar las campañas de transformación a gran escala en varios repositorios. Antes de usar la aplicación web AWS Transform, debe tener habilitada una identidad de usuario para acceder a AWS Transform en su organización. Para obtener información sobre cómo habilitar AWS Transform, consulte Configuración de 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 «Personalizado/código» en la aplicación web AWS Transform.

  3. Indique al agente el nombre de la definición de transformación que desea utilizar.

  4. La aplicación web proporciona un comando AWS Transform 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 medidas de 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 múltiples 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 Centro de identidad de IAM; solo se necesitan AWS credenciales estándar.