View a markdown version of this page

Conéctese al código fuente - AWS Transformar

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.

Conéctese al código fuente

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

Antes de empezar, asegúrate de tener un 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 un bucket de Amazon S3 en el mismo AWS La región como 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 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 Gestor de secretos.

  • S3: Proporcione un URI de Amazon S3 a un archivo zip de almacenamiento de código (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 de código y el agente te guiará durante la configuración.

Conéctese a un repositorio con AWS CodeConnections

Si elige la opción Conexión de código, AWS El agente de transformación utiliza AWS CodeConnections para descargar su base de código.NET desde Azure Repos, Bitbucket, GitHub, o GitLab. El código transformado se escribe en una nueva rama grabable. Debes configurar AWS CodeConnections en la misma región que tu AWS Transforma el trabajo.

nota

Si ya tiene un conector de repositorio de código fuente, AWS Transform te lo notificará. Selecciona Usa el conector existente para usar este conector. Si no desea utilizar el conector existente, consulte Eliminar un conector existente delante de Agregar un conector nuevo. Solo puede tener un conector de repositorio de origen por trabajo.

Agregar un conector nuevo

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

  1. Introduzca el AWS número de cuenta que te gustaría usar para AWS CodeConnections conector.

  2. Si no lo ha configurado AWS CodeConnections para lo mismo AWS cuenta, Configurar AWS CodeConnections.

  3. Usa el AWS Consola de herramientas para desarrolladores para crear una conexión con su Bitbucket, GitHub, GitHub Servidor empresarial, GitLab, o AzureDevOps repositorio.

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

  5. Regresa a AWS Transforma y pega el ARN de la conexión que has creado.

  6. Introduzca un nombre para el conector.

    nota

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

  7. Seleccione Inicie la creación del conector.

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

  9. Si eres el AWS administrador, inicie sesión en AWS cuenta y vaya al enlace de verificación para aprobar la solicitud de conexión. Si no eres el AWS administrador, proporcione el enlace de verificación a su AWS administrador.

  10. Después del AWS el administrador apruebe la solicitud del conector, seleccione Finalice 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

  • ARN de conexión

Eliminar un conector existente

nota

Si ya tiene un conector de repositorio de código fuente, AWS Transform te lo notificará. Selecciona cualquiera de las dos Utilice el conector existente o Eliminar y crear un conector nuevo.

Si eliges eliminar un repositorio de código fuente existente, conéctate, AWS Transform le avisará antes de eliminar realmente el conector.

  1. Puede eliminar un conector existente de dos maneras:

    1. Si AWS Transform le pide que lo haga, puede seleccionar Elimine y cree un conector nuevo.

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

  2. AWS Transform le advierte que al reiniciar se eliminará el conector. Para eliminar el conector, seleccione Reiniciar otra vez.

  3. AWS Transform vuelve a advertirte de que al eliminar el conector se eliminará la conexión con un repositorio de terceros, como Bitbucket, GitHub, y GitLab. Además, cualquier AWS Los trabajos de transformación que utilizan este conector fallarán si se elimina el conector. Para confirmar la eliminación, escriba eliminar y seleccionar Eliminar.

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

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

Puedes conectarte 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 RUTA en el panel de chat.

  2. Lea las instrucciones que se muestran sobre cómo generar una PAT y almacenarla en AWS Gestor de secretos.

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

  4. Guarde su PAT en AWS Secrets Manager y registra el nombre del recurso de Amazon (ARN). Por ejemplo, un GitHub el token tiene el siguiente formato:

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

  6. En el formulario de conector, introduzca el nombre de un conector, su AWS el ID de la cuenta, el ARN secreto y, opcionalmente, un ARN de clave de 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 de Amazon S3

Puede conectarse AWS Transfórmese en código fuente en Amazon S3 como alternativa a conectar un repositorio de código fuente.

Organización de cubos 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. Debes configurar tu bucket de S3 en la misma región que tu AWS Transforma el trabajo. Sube tu código fuente al bucket como un archivo zip en el 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 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. Incluye un archivo de informe de diferencias de código llamado 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

Agregar un nuevo conector S3

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

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

  2. Sube tu código fuente como un archivo zip al bucket de S3.

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

  4. En la página siguiente, introduce los detalles de tu bucket de S3 y elige 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, copie el enlace de verificación.

    2. Pide a un aprobador que busque el enlace para llegar al AWS Página de solicitud de creación de conectores de transformación.

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

    4. Tras revisar la solicitud, elija Guardar y Aprobar para aprobarlo.

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

    1. En el AWS Transforma la aplicación web, espera a que aparezca el estado Aprobado.

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

    3. El trabajo pasa al Descubrimiento paso para continuar con la transformación.

Eliminar un conector S3

Para eliminar un conector S3 existente:

  1. En el AWS Transforme la aplicación web, seleccione Gestione los conectores en la parte superior derecha.

  2. En el Gestione los conectores ventana, seleccione el conector.

  3. Elija Eliminar.