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 al AWS Transforma de forma personalizada
En esta sección se describe cómo elegir una interfaz, configurar AWS Transform custom y ejecutar la primera transformación.
Elige dónde quieres ejecutar AWS Transforma de forma personalizada
Ejecute AWS Transform custom desde la línea de comandos, Kiro Power, un complemento de agente o un complemento IDE. Cada opción proporciona acceso a las mismas definiciones de transformación AWS gestionadas y personalizadas.
importante
Para la configuración guiada, se recomienda utilizar Kiro Power o el complemento AWS Transform agent. Durante la configuración, el agente comprueba los requisitos previos e instala o actualiza la AWS CLI de Transform cuando es necesario. A continuación, lo guía a través de su primera transformación. Aún necesita AWS los permisos y el acceso adecuados al repositorio que desea transformar.
Si eligió la CLI de AWS transformación, continúe con los requisitos previos de CLI que se indican a continuación. Si eligió otra opción, siga las instrucciones de configuración de la pestaña seleccionada.
Para obtener información sobre la supervisión centralizada de las campañas de transformación en varios repositorios, consulteAWS Transformar la aplicación web (opcional).
AWS Requisitos previos de Transform CLI
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: soporte completo para Windows nativo mediante Windows Terminal y PowerShell (los
atx ctcomandos 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.comtransform-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
Ejecute el script de instalación:
Verificar la instalación:
atx --versionEl 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.
También puede especificar un perfil mediante la variable de AWS_PROFILE entorno.
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, 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. 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:
AWSTransformCustomExecuteTransformations— Proporciona acceso para ejecutar transformaciones.
AWSTransformCustomManageTransformations— Proporciona acceso para crear, actualizar, leer y eliminar recursos de transformación, así como para ejecutar transformaciones.
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:
AWS_REGIONvariable de entorno (máxima prioridad)AWS_DEFAULT_REGIONvariable de entornoPerfil seleccionado en el archivo de AWS configuración (mediante variable de
AWS_PROFILEentorno)Perfil predeterminado en el archivo de AWS configuración
Recurso predeterminado a
us-east-1si 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 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):
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:
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 regional
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:
Vea la resolución detallada de la región en los registros de depuración:
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
Entender 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 que se adapten a sus requisitos específicos.
Para crear una transformación personalizada
Inicie la CLI de AWS transformación en modo interactivo:
atxDígale al agente que desea crear una nueva transformación y describa sus requisitos.
Proporcione materiales de referencia, como documentación y ejemplos de códigos, para mejorar la calidad.
Pruebe y perfeccione la transformación de forma iterativa.
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:
Visite https://aws.amazon.com/transform/ e inicie sesión con las credenciales AWS del IAM Identity Center.
Seleccione el tipo de trabajo «Personalizado/código» en la aplicación web AWS Transform.
Indique al agente el nombre de la definición de transformación que desea utilizar.
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.
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.
