View a markdown version of this page

Trabajando con una modernización continua - AWS Transformar
Administración de fuentesDescubrimiento y administración de repositoriosEjecutando el análisisAdministración de resultadosCreando solucionesAWS Transforma 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.

Trabajando con una modernización continua

Administración de fuentes

Utilice atx ct source comandos para conectar los repositorios. Proveedores compatibles: GitHub, Bitbucket GitLab, local.

GitHub organizaciones

Token: token de acceso personal (clásico) con repo alcance. Read-only para su análisis, repositorio completo para su corrección.

atx ct source add --name name --provider github --org org --token pat

GitLab grupos y usuarios

Token: token de acceso personal con api alcance.

atx ct source add --name name --provider gitlab --org group-or-user --token pat
# Self-hosted:
atx ct source add --name name --provider gitlab --org group-or-user --token pat --url https://gitlab.example.com

Espacios de trabajo y proyectos de Bitbucket

Bitbucket Cloud: ámbitos:read:repository:bitbucket,,,. write:repository:bitbucket read:pullrequest:bitbucket write:pullrequest:bitbucket También necesita --email y. --username

atx ct source add --name name --provider bitbucket --org workspace --token api-token --email email --username username

Centro de datos de Bitbucket:

atx ct source add --name name --provider bitbucket --org project-key --token http-access-token --url https://bitbucket.example.com

Repositorios locales

atx ct source add --name name --provider local --path parent-directory
importante

--pathdeben apuntar a un directorio principal que contenga repositorios de git como subdirectorios, no a un único repositorio.

Administrar fuentes

atx ct source list
atx ct source remove --name name

Descubrimiento y administración de repositorios

atx ct discovery scan --source name
atx ct discovery status --source name
atx ct discovery scan --source name --path new-directory

Tras el descubrimiento:

atx ct repository list
atx ct repository list --source name
atx ct repository list --labels "team:frontend,priority:high"
atx ct repository update --source name --repo "source::slug" --labels "team:frontend,priority:high"
atx ct repository update --source name --labels "migration:wave-1"

Ejecutando el análisis

El --type indicador especifica el tipo de análisis que se va a ejecutar:

  • rapid-techdebt-analysis— Dependencias anticuadas y ganancias fáciles.

  • tech-debt-comprehensive— AI-powered Un análisis más profundo que abarca los hallazgos sobre la dependencia, la seguridad, los patrones, el rendimiento, la capacidad de mantenimiento, la arquitectura, la calidad del código y la infraestructura.

  • security— Vulnerabilidades y exposiciones de seguridad.

  • agentic-readiness— Preparación de sus repositorios para los agentes de IA (marcos, API, documentación).

  • modernization-readiness— Oportunidades de modernización en todas las dimensiones de la infraestructura, las aplicaciones, los datos, la seguridad y las operaciones.

atx ct analysis run --type type --source name [--repo source::slug] [--wait]
atx ct analysis get --id id --json
atx ct analysis list --json
atx ct analysis list --status pending|running|complete|cancelled|failed --json
atx ct analysis list --type type --json
atx ct analysis cancel --id id
atx ct analysis delete --id id [--cascade-findings]

Análisis personalizado

atx ct analysis run --type custom --transformation-name name --source source --repo source::slug --wait

Configuración con -g indicador: clave-valor, JSON o ruta de archivo.

Listar los TD: atx custom def list

Administración de resultados

atx ct findings list --json
atx ct findings list --repo source::slug --source name --severity high|medium|low --type analysis-type --status open|dismissed|obsolete --analysis-id id --fix-transform transform-name --json

Búsqueda de estados

  • open— Activo

  • dismissed— Descartado manualmente (requiere un motivo)

  • obsolete— System-set cuando el nuevo análisis ya no produce el hallazgo

atx ct findings update --id id --status dismissed --reason "reason"
atx ct findings update --id id --status open
atx ct findings batch-update --ids id1,id2 --status dismissed --reason "reason"
atx ct findings get --id id
atx ct findings delete --id id

¿Descubriendo la obsolescencia

Re-analysis marca los hallazgos resueltos como obsoletos. No se puede volver a abrir. Conservado para su auditoría.

Creando soluciones

Tres modos: basado en hallazgos, anulación de TD, TD directo.

atx ct remediation create --ids id1,id2 --name "name"
atx ct remediation create --ids id1,id2 --transformation-name TD
atx ct remediation create --transformation-name TD --repo source::slug

Salida por proveedor: GitHub PR, GitLab MR, Bitbucket PR, sucursal local.

nota

El token debe tener acceso de escritura para su PR/MR creación.

Ejecución local con --local indicador.

atx ct remediation create --transformation-name TD --repo source::slug -g "additionalPlanContext=Upgrade to Node.js 22"
atx ct remediation list
atx ct remediation status --id id
atx ct remediation retry --id id
atx ct remediation delete --id id

AWS Transforma la aplicación web (opcional)

La aplicación web AWS Transform es una interfaz opcional para monitorear los análisis, hallazgos y correcciones continuos de la modernización en toda su cartera de fuentes de código.

Antes de utilizar 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. Si la modernización continua no aparece después de iniciar sesión, inicie sesión con las credenciales de IAM. Para habilitar el inicio de sesión con las credenciales de IAM:

    1. En la consola AWS de administración, abra AWS Transform y seleccione Configuración.

    2. En la sección AWS Transformación de acceso con credenciales de IAM, habilite el acceso a las credenciales de IAM.

    3. En la misma página de configuración, copia el enlace de inicio de sesión que aparece en la URL de la aplicación web (con IAM).

    4. Pegue la URL de inicio de sesión en la misma ventana del navegador en la que está abierta la consola AWS de administración. Esto garantiza que la aplicación web utilice las AWS credenciales de esa cuenta.

  3. Abra el menú de navegación de la izquierda y elija la modernización continua. El panel muestra un resumen de las estadísticas, incluidas las fuentes, los repositorios, el total de hallazgos por gravedad y los tipos de análisis.

  4. Utilice las pestañas Análisis, Hallazgos y Remediaciones para ver los resultados detallados.

  5. Chatee con AWS Transform directamente desde la aplicación web para hacer preguntas sobre sus análisis, hallazgos o soluciones.

La aplicación web está diseñada para operaciones a escala empresarial en las que se necesita una visibilidad centralizada de los análisis y las soluciones de modernización continuos en múltiples bases de código.