View a markdown version of this page

Conectarse al código fuente - AWS Transformar
Conéctese a un repositorio con AWS CodeConnectionsConéctese a un repositorio con un token de acceso personalConéctese al código fuente en Amazon S3

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.

Conectarse al código fuente

DespuésCree un trabajo de modernización de .NET, en la pestaña Plan de trabajo, el panel izquierdo de la ventana AWS Transformación muestra las fases del trabajo de transformación. La primera fase es el código fuente de Connect. En esta fase, te conectas a tu código fuente.

Antes de empezar, asegúrate de tener una AWS cuenta con permisos para crear la conexión de código fuente. Según el método de conexión que elija, también necesitará acceder a AWS CodeConnections un token de acceso personal (PAT) almacenado en AWS Secrets Manager o a un bucket de Amazon S3 en la misma AWS región que su trabajo de transformación. La creación de un conector requiere la aprobación de un AWS administrador.

Puede conectarse a un repositorio de código fuente o proporcionar el código en un archivo zip. Tienes 4 opciones para conectarte al código fuente:

  • Conexión de código: conéctese al repositorio de código fuente mediante AWS CodeConnections (GitHub, GitLab, Bitbucket, Azure DevOps).

  • PAT: Conéctese al repositorio de código fuente mediante un token de acceso personal almacenado en AWS Secrets Manager.

  • S3: proporcione un URI de Amazon S3 a un archivo zip de almacenamiento de códigos (por ejemplo,s3://my-bucket/repos.zip).

  • Carga directa: arrastra y suelta un archivo zip de código en el panel de chat.

Selecciona un método de conexión por código y el agente te guiará durante la configuración.

Conéctese a un repositorio con AWS CodeConnections

Si eliges la opción Code Connection, el agente de AWS Transform la utilizará AWS CodeConnectionspara descargar tu código base de.NET desde Azure Repos, Bitbucket o. GitHub GitLab El código transformado se escribe en una nueva rama en la que se puede escribir. Debe configurarlo AWS CodeConnections en la misma región que su trabajo de AWS transformación.

nota

Si ya tiene un conector de repositorio de código fuente, AWS Transform se lo notificará. Seleccione Usar un conector existente para usar este conector. Si no desea utilizar el conector existente, consulte lo Eliminar un conector existente anteriorAñadir un conector nuevo. Solo puede tener un conector de repositorio de origen por trabajo.

Añadir un conector nuevo

Para crear un nuevo conector de repositorio de código fuente:

  1. Introduzca el número de AWS cuenta que desea utilizar para el AWS CodeConnections conector.

  2. Si no ha configurado AWS CodeConnections la misma AWS cuenta, configúrela AWS CodeConnections.

  3. Usa la consola de herramientas para AWS desarrolladores para crear una conexión a tu Bitbucket GitHub, GitHub Enterprise Server o AzureDevOpsrepositorio. GitLab

  4. Copia el nombre de recurso de Amazon (ARN) de la conexión que has creado.

  5. Vuelva a AWS Transformar y pegue el ARN de la conexión que creó.

  6. Introduzca un nombre para el conector.

    nota

    No introduzca información personal como parte del nombre del conector.

  7. Seleccione Iniciar la creación del conector.

  8. AWS Transform solicita la creación de un conector para la AWS cuenta que ha introducido, en la misma región que la tarea de transformación actual, y le notifica que la solicitud de aprobación está lista para ser aprobada por el AWS administrador en la consola AWS de administración. Seleccione Copiar el enlace de verificación.

  9. Si eres el AWS administrador, inicia sesión en la AWS cuenta y ve al enlace de verificación para aprobar la solicitud de conexión. Si no eres el AWS administrador, proporciona el enlace de verificación a tu AWS administrador.

  10. Una vez que el AWS administrador apruebe la solicitud de conector, seleccione Finalizar el conector para completar el proceso de creación del conector. Si desea utilizar un conector diferente, seleccione Reiniciar para reiniciar el proceso de creación del conector.

La pestaña Colaboración también incluye detalles sobre el conector, entre los que se incluyen:

  • Estado: aprobado o pendiente de aprobación

  • AWS ID de cuenta

  • AWS Región

  • Conexión ARN

Eliminar un conector existente

nota

Si ya tiene un conector de repositorio de código fuente, AWS Transform se lo notificará. Seleccione Usar un conector existente o Eliminar y crear un conector nuevo.

Si eliges eliminar una conexión al repositorio de código fuente existente, AWS Transform te avisará antes de eliminar realmente el conector.

  1. Puedes eliminar un conector existente de dos maneras:

    1. Si AWS Transform se lo pide, puede seleccionar Eliminar y crear un conector nuevo.

    2. También puede seleccionar reiniciar en el mensaje. Para modificar este conector, debe reiniciar.

  2. AWS Transform le avisa de que al reiniciar se eliminará el conector. Para eliminar el conector, selecciona Reiniciar de nuevo.

  3. AWS Transform te vuelve a avisar de que al eliminar el conector se eliminará la conexión a tu repositorio de terceros, como Bitbucket GitHub, y GitLab. Además, cualquier trabajo de AWS Transform que utilice este conector fallará si se elimina el conector. Para confirmar la eliminación, escriba delete y seleccione Delete.

  4. Para añadir un nuevo conector de repositorio de código fuente, consulteAñadir un conector nuevo.

Conéctese a un repositorio con un token de acceso personal

Puede conectarse a un repositorio mediante un token de acceso personal (PAT). Siga estos pasos:

  1. Cuando el agente solicite una conexión de código fuente, elija PAT en el panel de chat.

  2. Lea las instrucciones que se muestran sobre cómo generar una PAT y almacenarla en AWS Secrets Manager.

  3. Genere una PAT desde su control de código fuente.

  4. Guarde su PAT en AWS Secrets Manager y registre el Amazon Resource Name (ARN). Por ejemplo, un GitHub token tiene el siguiente formato:

    github_pat_XXXXXXXXXXXXXXX

  5. En el chat, selecciona el enlace Configurar conector para abrir un formulario de conector.

  6. En el formulario del conector, introduzca el nombre del conector, el ID de AWS cuenta, el ARN secreto y, si lo desea, un ARN de clave KMS. A continuación, envíe el formulario.

  7. El agente proporciona un enlace de aprobación. Copie el enlace y envíelo a un administrador para que apruebe la conexión. Tras la aprobación, continúe con el agente.

Conéctese al código fuente en Amazon S3

Puede conectar AWS Transform al código fuente en Amazon S3 como alternativa a conectar un repositorio de código fuente.

Organización de cubos de S3

El código fuente original y el código transformado se almacenan en un depósito de S3 común, organizado como se muestra a continuación. Debe configurar su bucket de S3 en la misma región que su trabajo de AWS Transform. Sube tu código fuente al depósito como un archivo zip a nivel raíz. El archivo zip debe contener una carpeta de nivel superior para cada repositorio.

Durante la transformación, AWS Transform crea una carpeta de salida de la transformación y almacena los resultados de la transformación en esa carpeta. La transformación crea un archivo zip denominado transformed-code.zip que contiene el código transformado. Esto incluye un informe de diferencias de código denominado diff.txt que resalta los cambios en los archivos a nivel de proyecto.


<customer-bucket>/
├── source-code.zip
         ├── repo 1
         ├── repo 2
         ├── ......
         ├── repo n            
└── transform-output/
      ├── transformed-code.zip

Añadir un nuevo conector S3

Para crear un nuevo conector de repositorio de código fuente de S3:

  1. En la AWS consola, cree un bucket de S3.

  2. Cargue el código fuente como un archivo zip en el bucket de S3.

  3. En la aplicación web AWS Transform, inicie un trabajo de transformación de.NET. En el paso Conectar un repositorio de código fuente, selecciona Conectar tu código fuente en un bucket S3 y selecciona Guardar.

  4. En la página siguiente, introduce los detalles de tu bucket de S3 y selecciona Enviar.

    1. Nombre del conector

    2. AWS ID de cuenta

    3. S3 Bucket Arn

    4. Clave de cifrado de S3 Bucket (opcional)

  5. Apruebe el conector:

    1. En la página siguiente, copia el enlace de verificación.

    2. Pida a un aprobador que busque el enlace para acceder a la página de solicitud de creación del conector AWS Transform.

    3. Elija crear un rol nuevo o usar uno existente.

    4. Tras revisar la solicitud, selecciona Guardar y aprobar para aprobarla.

  6. Especifique la ubicación del archivo zip de S3:

    1. En la aplicación web AWS Transform, espere a que el estado muestre Aprobado.

    2. En la página Especificar la ubicación del activo, introduzca una URL de S3 para el archivo de código zip en el formato s3://bucket-name/zip-file-name y seleccione Enviar a AWS transformación.

    3. El trabajo continúa con la etapa de descubrimiento para continuar con la transformación.

Eliminar un conector S3

Para eliminar un conector S3 existente:

  1. En la aplicación web AWS Transform, selecciona Administrar conectores en la parte superior derecha.

  2. En la ventana Administrar conectores, seleccione el conector.

  3. Elija Eliminar.