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.
# Transformación de código en la línea de comandos con Amazon Q Developer
Puede transformar sus aplicaciones desde la línea de comandos con la herramienta de transformación de línea de comandos de Amazon Q Developer. Para transformar el código, debe proporcionar la ruta al código fuente y a los archivos de configuración necesarios y Amazon Q genera el nuevo código en una serie de pasos. A lo largo de la transformación, Amazon Q compila código en su entorno local para verificar los cambios. Para obtener más información, consulte [Compilación de código en el entorno local](#local-builds). Amazon Q crea una nueva ramificación en el repositorio donde confirma los cambios de código. Cuando se complete la transformación, puede combinar la ramificación con la ramificación original para incorporar los cambios en su código base.
Para empezar, instale la herramienta de línea de comandos y autentíquese y, a continuación, consulte los comandos para configurar e iniciar una transformación.
**Topics**
+ [Compilación de código en el entorno local](#local-builds)
+ [Comandos](#commands)
+ [Ejecución de una transformación en la línea de comandos con Amazon Q Developer](run-CLI-transformations.md)
+ [Solución de problemas de transformaciones en la línea de comandos](troubleshooting-CLI-transformations.md)
+ [Historial de versiones de la herramienta de transformación de línea de comandos de Amazon Q Developer](transform-CLI-versions.md)
## Compilación de código en el entorno local
Durante una transformación, Amazon Q realiza compilaciones de verificación en el entorno local. Amazon Q transforma el código en el servidor en varios pasos. Después de cada paso, Amazon Q envía el código al entorno local para compilar y probar los cambios que ha realizado. A continuación, el código se devuelve al servidor para continuar con la transformación.
La compilación en el entorno local ayuda a verificar el código transformado al permitir que Amazon Q ejecute pruebas que requieren acceso a recursos privados. Para minimizar los riesgos de seguridad asociados a la compilación de código generado por IA en el entorno local, Amazon Q revisa y actualiza el código que genera para abordar problemas de seguridad.
**nota**
Amazon Q realiza transformaciones en función de las solicitudes, las descripciones y el contenido del proyecto. Para mantener la seguridad, evite incluir artefactos externos no verificados en el repositorio del proyecto y valide siempre el código transformado para garantizar su funcionalidad y seguridad.
## Comandos
Para step-by-step obtener instrucciones sobre cómo ejecutar estos comandos, consulte[Ejecución de una transformación en la línea de comandos con Amazon Q Developer](run-CLI-transformations.md).
Para configurar una transformación y autenticarse en Amazon Q Developer Pro, ejecute:
```
qct configure
```
Para iniciar una transformación para una actualización de Java, ejecute el siguiente comando. Para**, puede escribir`JAVA_1.8`,`JAVA_8`, `JAVA_11``JAVA_17`, o`JAVA_21`. Para**, puede introducir una `JAVA_17` o`JAVA_21`. Los parámetros `--source_version` y `--target_version` son opcionales. El indicador `--trust` permite que se ejecute una transformación mientras se verifica el código para mantener la seguridad.
```
qct transform --source_folder
--source_version
--target_version
--trust
```
Para iniciar una transformación para una conversión de SQL, ejecute:
```
qct transform --source_folder
--sql_conversion_config_file
```
Para ver qué versión de la herramienta de línea de comandos para la transformación está utilizando, ejecute:
```
qct -v
```
Para obtener ayuda con las transformaciones, ejecute:
```
qct -h
```
Para ver el historial de sus trabajos de transformación, ejecute:
```
qct history
```
Para obtener más información sobre cómo ver y administrar el historial de trabajos de transformación, consulte [Visualización del historial de trabajos en la línea de comandos](transformation-job-history.md#cli-job-history).
# Ejecución de una transformación en la línea de comandos con Amazon Q Developer
Realice estos pasos para transformar el código en la línea de comandos con la herramienta de línea de comandos de Amazon Q Developer.
## Requisitos previos
Antes de iniciar una transformación en la línea de comandos, se deben cumplir los siguientes requisitos previos:
+ Si está actualizando su versión de código de Java, el proyecto cumple los [requisitos previos para actualizar las versiones de Java con Amazon Q](code-transformation.md#java-upgrade-prerequisites).
+ Si está convirtiendo SQL incrustado en una aplicación Java, la aplicación cumple los [requisitos previos para convertir SQL incrustado con Amazon Q](transform-sql.md#sql-transform-prereqs).
+ Tiene Python instalado en el entorno de línea de comandos. Así es como instalará la herramienta de línea de comandos. La versión de Phyton mínima compatible es 3.12.
+ Está ejecutando la transformación en macOS o Linux.
+ El tamaño de la aplicación es de 2 GB o menos.
+ Si tiene dependencias específicas que desea que Amazon Q actualice, ha configurado un [archivo de actualización de dependencias](#step-3-dependency-upgrade-file).
## Paso 1: elección del método de autenticación y añadido de permisos
Puede autenticar IAM Identity Center para ejecutar transformaciones en la línea de comandos. Asegúrese de disponer de los permisos necesarios.
**nota**
Las claves administradas por el cliente no son compatibles con las transformaciones realizadas en la línea de comandos.
### Inclusión de permisos
La identidad de IAM asociada a la suscripción de Amazon Q Developer que utilice para autenticarse debe contar con permisos para realizar transformaciones en la línea de comandos. Antes de continuar, asegúrese de que su identidad de IAM tiene los permisos definidos en [Permiso a los usuarios para ejecutar transformaciones en la línea de comandos](id-based-policy-examples-users.md#id-based-policy-examples-allow-cli-transformations).
### Autenticación con IAM Identity Center mediante una suscripción a Amazon Q Developer
Para autenticarse con IAM Identity Center, su administrador debe [suscribirlo a Amazon Q Developer Pro como usuario de personal](subscribe-users.md) y debe proporcionar la URL de inicio para autenticarse mediante la suscripción. Usted o su administrador pueden encontrar la URL de inicio en la consola de Amazon Q Developer. Para obtener más información, consulte [Búsqueda de la URL de inicio para el uso con Amazon Q Developer](manage-account-details.md).
Para añadir los permisos necesarios, consulte [Inclusión de permisos](#transform-CLI-add-permissions).
Se introduce la URL de inicio en [Paso 4: configuración y autenticación](#step-4-configure-auth).
## Paso 2: instalación de la herramienta
1. [Descargue la herramienta de línea de comandos de Amazon Q para realizar transformaciones](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.2.zip) y descomprímala.
Para descargar una versión anterior de la herramienta de línea de comandos, consulte [Historial de versiones](transform-CLI-versions.md).
1. Se recomienda configurar un entorno virtual en Python para instalar la herramienta. Para crear un entorno virtual, abra una ventana de terminal en el directorio donde desea instalar la herramienta y ejecute:
```
python -m venv qct-cli
```
1. Para activar el entorno virtual, ejecute:
```
source qct-cli/bin/activate
```
1. Para instalar la herramienta en la línea de comandos, ejecute el siguiente comando con la ruta en la que descomprimió la herramienta, según la arquitectura de su máquina:
------
#### [ Linux\$1aarch64 ]
```
pip install /Linux_aarch64/amzn_qct_cli-1.2.2-py3-none-any.whl
```
------
#### [ Linux\$1x86\$164 ]
```
pip install /Linux_x86_64/amzn_qct_cli-1.2.2-py3-none-any.whl
```
------
**nota**
Si está utilizando una versión anterior de la herramienta de línea de comandos para las transformaciones, reemplace `1.2.2` con la [versión](transform-CLI-versions.md) que descargó.
1. Para comprobar que la herramienta se ha instalado, ejecute:
```
which qct
```
## Paso 3: creación de un archivo de actualización de dependencias (opcional)
Puede proporcionar a Amazon Q un *archivo de actualización de dependencias*, un archivo YAML que enumera las dependencias del proyecto y qué versiones deben actualizarse durante una transformación. Al proporcionar un archivo de actualización de dependencias, puede especificar dependencias de terceros y propias que de otro modo puede que Amazon Q no sepa que hay que actualizar.
Las dependencias propias se refieren a las bibliotecas, complementos y marcos que mantiene la organización y que solo están disponibles localmente o en la red privada de la organización. Amazon Q puede acceder a sus dependencias propias cuando realiza compilaciones en el entorno local. Para obtener más información, consulte [Compilación de código en el entorno local](transform-CLI.md#local-builds). Las dependencias de terceros están disponibles públicamente o son dependencias de código abierto que no son exclusivas de la organización.
Puede especificar las dependencias propias que desee actualizar en un archivo YAML y Amazon Q las actualizará durante la actualización de JDK (por ejemplo, de Java 8 a 17). Puede iniciar una transformación independiente (de 17 a 17 o de 21 a 21) después de la actualización inicial de JDK para actualizar las dependencias de terceros.
Una vez que Amazon Q realice una actualización mínima de JDK, puede iniciar una transformación independiente para actualizar todas las dependencias de terceros. Como alternativa, puede especificar las dependencias de terceros y sus versiones en un archivo YAML para actualizar únicamente esas dependencias durante la transformación de la actualización de la biblioteca.
Amazon Q le pedirá que proporcione un archivo de actualización de dependencias durante la transformación. Si desea proporcionar uno, primero asegúrese de haber configurado el archivo correctamente. Los siguientes campos son obligatorios en el archivo YAML:
+ name: el nombre del archivo de actualización de dependencias.
+ description (opcional): descripción del archivo de actualización de dependencias y para qué transformación.
+ dependencyManagement: contiene la lista de dependencias y complementos que se van a actualizar.
+ dependencies: contiene el nombre y la versión de las bibliotecas que se van a actualizar.
+ plugins: contiene los nombres y las versiones de los complementos que se van a actualizar.
+ identifier: el nombre de la biblioteca, el complemento u otra dependencia.
+ targetVersion: la versión de la dependencia a la que se va a actualizar.
+ versionProperty (opcional): la versión de la dependencia que está definiendo, tal y como se establece con la etiqueta `properties` del archivo `pom.xml` de la aplicación.
+ originType: si la dependencia es propia o de un tercero, especificado por FIRST\$1PARTY o THIRD\$1PARTY.
A continuación se muestra un ejemplo de un archivo YAML de actualización de dependencias y la configuración necesaria para que Amazon Q lo analice:
```
name: dependency-upgrade
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
dependencyManagement:
dependencies:
- identifier: "com.example:library1"
targetVersion: "2.1.0"
versionProperty: "library1.version" # Optional
originType: "FIRST_PARTY"
- identifier: "com.example:library2"
targetVersion: "3.0.0"
originType: "THIRD_PARTY"
plugins:
- identifier: "com.example.plugin"
targetVersion: "1.2.0"
versionProperty: "plugin.version" # Optional
originType: "THIRD_PARTY"
```
## Paso 4: configuración y autenticación
Antes de comenzar una transformación, debe autenticarse en IAM Identity Center y proporcionar los detalles de configuración de la transformación.
1. Para iniciar el proceso de configuración de la transformación, ejecute el siguiente comando:
```
qct configure
```
1. Se le pedirá que introduzca una ruta de JDK para cada versión de Java compatible. Solo necesita especificar la ruta al JDK de la versión de origen de la aplicación Java, no de la versión de destino.
1. A continuación, para autenticarse en IAM Identity Center, se le pedirá que introduzca la URL de inicio del perfil de suscripción a Amazon Q Developer Pro.
Luego, ingrese el Región de AWS lugar al que se suscribió en el siguiente formato:`us-east-1`. Para obtener una lista de las regiones admitidas, consulte [Regiones compatibles](regions.md). Para obtener una lista de códigos de región, consulte [Puntos de conexión regionales](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) en la *Guía de Referencia general de AWS *.
1. Sus preferencias de configuración se guardan en un archivo configuration.ini.
## Paso 5: ejecución de una transformación
Elija el tipo de transformación que va a realizar para ver la configuración y los comandos necesarios.
**nota**
No apague ni cierre la máquina local durante la transformación del código, ya que la compilación del cliente requiere una conexión de red estable.
------
#### [ Java upgrade ]
**Modificación del plan de transformación**
Durante las actualizaciones de las versiones de Java, Amazon Q genera un plan de transformación que puede revisar antes de que comience la transformación. Tiene la opción de solicitar los siguientes cambios en el plan:
+ Qué bibliotecas actualiza Amazon Q, de la lista incluida en el plan
+ Ejemplos de peticiones:
+ Solo actualice , y
+ No actualice ni
+ La versión de destino a la que se va a actualizar una biblioteca
+ Ejemplos de peticiones:
+ Actualice a esta versión en su lugar
+ Qué pasos debe realizar Amazon Q
+ Ejemplos de peticiones:
+ Realice únicamente los pasos 1 a 7
+ No ejecute los pasos 5 a 9
+ Añada dependencias adicionales para actualizar (solo es una opción cuando se actualiza a una versión más reciente de JDK)
+ Ejemplos de peticiones:
+ Actualice también a
**Actualización de código Java**
1. Ejecute el siguiente comando para iniciar una transformación para una actualización de Java. Reemplace `` con la ruta a la carpeta con el código que está transformando y `` con `JAVA_17` o `JAVA_21`.
```
qct transform --source_folder
--target_version
```
Opciones de comandos adicionales:
+ Si está especificando las dependencias que desea actualizar, añada la opción `--dependency_upgrade_file` con la ruta al archivo de actualización de dependencias.
+ Si no desea revisar o actualizar el plan de transformación, añada el indicador `--no-interactive` a su comando. Amazon Q no le pedirá comentarios sobre el plan y no tendrá la oportunidad de solicitar cambios.
1. La versión de Maven se verifica antes de que comience la transformación. Si tiene al menos la versión mínima compatible, obtendrá el siguiente resultado:
```
Running command: mvn --version at: path/to/current/directory
Your Maven version is supported for transformations.
```
Si no tiene una versión compatible de Maven, debe actualizarla para continuar. Para obtener más información, consulte la [Requisitos previos](#CLI-transformation-prerequisites).
1. Si no ha añadido el indicador `--no-interactive`, Amazon Q le pedirá que dé su opinión sobre el plan de transformación. Puede explicar los cambios que desea realizar en inglés y Amazon Q actualizará el plan si puede admitir los cambios que solicite.
1. Amazon Q inicia la transformación. Generará actualizaciones de estado a lo largo de la transformación. Cuando finaliza, Amazon Q proporciona la ruta en la que se generan los resultados de la transformación, los registros y los archivos de configuración.
El código actualizado se confirmará para la nueva ramificación que ha creado Amazon Q. Amazon Q confirmará el código en una o varias confirmaciones, en función de la selección que haya realizado al ejecutar `qct configure`.
1. Si está ejecutando otra transformación después de actualizar su versión de Java, inicie la segunda transformación en la misma ramificación en la que confirmó los cambios de la primera transformación.
------
#### [ SQL conversion ]
Antes de empezar, asegúrese de haber leído [Conversión de SQL incrustado en aplicaciones Java con Amazon Q Developer](transform-sql.md) para entender los requisitos previos de este tipo de transformación para conocerlos.
1. Para convertir SQL incrustado, primero debe crear un archivo YAML que contenga la ruta al archivo de metadatos del esquema desde la [Conversión de esquema de AWS DMS](https://docs.aws.amazon.com/dms/latest/sbs/schema-conversion-oracle-postgresql.html).
El archivo debe tener el siguiente formato:
```
schema_conv_metadata_path:
```
1. Ejecute el siguiente comando para iniciar una transformación para una conversión de SQL. Reemplace `` con la ruta a la carpeta con el código que está transformando y `` con la ruta al archivo YAML que ha creado en el paso 1.
```
qct transform --source_folder
--sql_conversion_config_file
```
1. Si Amazon Q encuentra varios esquemas en el archivo de metadatos del esquema, detendrá la transformación y proporcionará una lista de los esquemas detectados. Elija el esquema que desea utilizar para la conversión de SQL y, a continuación, añada un campo nuevo `schema: ` al archivo YAML.
1. Amazon Q inicia la transformación. Generará actualizaciones de estado a lo largo de la transformación. Cuando finaliza, Amazon Q proporciona la ruta en la que se generan los resultados de la transformación, los registros y los archivos de configuración.
El código actualizado se confirmará para la nueva ramificación que ha creado Amazon Q.
------
## Pausa o cancelación de una transformación
Puede optar por pausar o cancelar el trabajo de transformación actual. Puede pausar un trabajo de transformación durante un máximo de 12 horas antes de poder reanudarlo.
**Cómo pausar o cancelar un trabajo de transformación de código**
1. En el terminal de la CLI, pulse **Ctrl\$1C** en el teclado.
1. Seleccione si desea pausar o cancelar la transformación.
+ Introduzca `1` si desea pausar el trabajo de transformación de código. Puede reanudar el trabajo en 12 horas para continuar con la transformación del código mediante el siguiente comando de QCT: ``qct transform --source_folder=≤/Path/Given/Originally/To/QCT>``.
+ Introduzca `2` si desea cancelar el trabajo de transformación de código.
# Solución de problemas de transformaciones en la línea de comandos
La siguiente información puede ayudarle a solucionar problemas habituales al transformar aplicaciones en la línea de comandos con Amazon Q Developer.
## ¿Por qué el token de portador no se actualiza?
Si aparece el siguiente error, significa que debe actualizar el token de portador utilizado para la autenticación.
```
Refreshing bearer token
('Error refreshing bearer token due to: ', InvalidGrantException('An error occurred (InvalidGrantException) when calling the CreateToken operation: '))
('Error getting bearer token due to: ', RuntimeError(('Error refreshing bearer token due to: ', InvalidGrantException('An error occurred (InvalidGrantException) when calling the CreateToken operation: '))))
```
Para corregir este error, ejecute el siguiente comando:
```
rm ~/.aws/qcodetransform/credentials.json
```
Una vez que haya eliminado el archivo de credenciales obsoleto, vuelva a ejecutar `qct transform` para reiniciar la transformación.
## ¿Por qué no se utiliza la versión más reciente de la herramienta de línea de comandos?
Al descargar una nueva versión de la herramienta de línea de comandos para realizar transformaciones, a veces se sigue utilizando una versión anterior de la herramienta.
Para asegurarse de que se utilice la versión más reciente de la herramienta, descargue la [versión más reciente](transform-CLI-versions.md). A continuación, ejecute el siguiente comando con la ruta en la que ha descomprimido la herramienta, según la arquitectura de la máquina:
------
#### [ Linux\$1aarch64 ]
```
pip install /Linux_aarch64/amzn_qct_cli-1.2.2-py3-none-any.whl --force-reinstall
```
------
#### [ Linux\$1x86\$164 ]
```
pip install /Linux_x86_64/amzn_qct_cli-1.2.2-py3-none-any.whl --force-reinstall
```
------
**nota**
Si utiliza una versión anterior de la herramienta de línea de comandos para las transformaciones, reemplace `1.2.2` con la [versión](transform-CLI-versions.md) que ha descargado.
# Historial de versiones de la herramienta de transformación de línea de comandos de Amazon Q Developer
Consulte la siguiente información para obtener detalles sobre las versiones actuales y anteriores de la herramienta de transformación de línea de comandos de Amazon Q Developer. La tabla incluye el enlace de descarga, la fecha de la versión y las notas de cada versión.
****
| Versión | Fecha de publicación | Notas de la versión |
| --- | --- | --- |
| [1.2.2 (más reciente)](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.2.zip) | 26 de febrero de 2026 | Se agregó un banner promocional para AWS Transform personalizado a la CLI de QCT. Se muestra un banner sobre la ejecución del comando Transform y el texto de ayuda. Nueva marca --skip-banner para suprimir la salida de banners. |
| [1.2.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.1.zip) | 9 de septiembre de 2025 | Se actualizó la extensión de Maven para incluir a un padre propio POMs durante la carga inicial del proyecto |
| [1.2.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.0.zip) | 7 de agosto de 2025 | Se añadió compatibilidad para ver el historial de trabajos y para la visualización de la estructura de los módulos para los proyectos Java de Maven. |
| [1.1.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.1.0.zip) | 21 de julio de 2025 | Incluye compatibilidad para recopilar telemetría sobre las transformaciones. |
| [1.0.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.0.0.zip) | 27 de junio de 2025 | La herramienta de transformación de la línea de comandos está disponible de forma general y solo admite la autenticación a través del AWS IAM Identity Center con una suscripción a Amazon Q Developer Pro. Se añadió compatibilidad para suscripciones en la región de Europa (Fráncfort). |
| [0.6.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.6.0.zip) | 6 de junio de 2025 | Incluye compatibilidad para proporcionar un archivo de actualización de dependencias e iterar el plan de transformación. |
| [0.5.2](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.2.zip) | 16 de abril de 2025 | Correcciones de errores para resolver problemas al reanudar los trabajos y errores en aplicaciones con dependencias propias. |
| [0.5.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.1.zip) | 13 de marzo de 2025 | Al autenticarse con IAM, ya no es necesario proporcionar una Región de AWS. También incluye una corrección de errores para incluir el estado del trabajo en los registros de salida. |
| [0.5.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.0.zip) | 28 de febrero de 2025 | Incluye soporte para autenticarse con IAM a través del. AWS CLI |
| [0.4.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.4.1.zip) | 17 de febrero de 2025 | Se ha corregido un error para incluir la posibilidad de introducir el Región de AWS lugar donde está configurada tu suscripción de Amazon Q Developer. |
| [0.4.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.4.0.zip) | 14 de febrero de 2025 | Incluye compatibilidad para actualizar aplicaciones Java a Java 21. |
| [0.3.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.3.0.zip) | 12 de febrero de 2025 | Incluye compatibilidad para convertir SQL incrustado en aplicaciones Java. |
| [0.2.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.2.0.zip) | 3 de febrero de 2025 | Incluye compatibilidad para recibir código Java actualizado en múltiples confirmaciones. |
| [0.1.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.1.0.zip) | 27 de noviembre de 2024 | Versión inicial. Incluye compatibilidad para actualizar versiones de código Java desde la línea de comandos. |