View a markdown version of this page

소스 코드에 연결 - AWS 변환
AWS CodeConnections를 사용하여 리포지토리에 연결개인 액세스 토큰을 사용하여 리포지토리에 연결Amazon S3의 소스 코드에 연결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

소스 코드에 연결

이후 .NET 현대화 작업 생성 작업 계획 탭의 AWS 변환 창의 왼쪽 창에 변환 작업의 단계가 나열됩니다. 첫 번째 단계는 Connect 소스 코드입니다. 이 단계에서는 소스 코드에 연결합니다.

시작하기 전에 소스 코드 연결을 생성할 권한이 있는 AWS 계정이 있는지 확인합니다. 선택한 연결 방법에 따라 AWS CodeConnections, AWS Secrets Manager에 저장된 개인 액세스 토큰(PAT) 또는 변환 작업과 동일한 AWS 리전의 Amazon S3 버킷에 대한 액세스 권한도 필요합니다. 커넥터를 생성하려면 AWS 관리자의 승인이 필요합니다.

소스 코드 리포지토리에 연결하거나 zip 파일에 코드를 제공할 수 있습니다. 소스 코드에 연결하는 옵션은 4가지입니다.

  • 코드 연결: AWS CodeConnections(GitHub, GitLab, Bitbucket, Azure DevOps)를 사용하여 소스 코드 리포지토리에 연결합니다.

  • PAT: AWS Secrets Manager에 저장된 Personal Access Token을 사용하여 소스 코드 리포지토리에 연결합니다.

  • S3: 코드 아카이브 zip 파일(예: )에 Amazon S3 URI를 제공합니다s3://my-bucket/repos.zip.

  • 직접 업로드: 코드 아카이브 zip 파일을 채팅 창에 끌어다 놓습니다.

코드 연결 방법을 선택하면 에이전트가 설정을 안내합니다.

AWS CodeConnections를 사용하여 리포지토리에 연결

코드 연결 옵션을 선택하면 AWS 변환 에이전트는 AWS CodeConnections를 사용하여 Azure Repos, Bitbucket, GitHub 또는 GitLab에서 .NET 코드베이스를 다운로드합니다. 변환된 코드는 쓰기 가능한 새 브랜치에 기록됩니다. AWS 변환 작업과 동일한 리전에서 AWS CodeConnections를 설정해야 합니다.

참고

기존 소스 코드 리포지토리 커넥터가 있는 경우 AWS 변환에서 알림을 보냅니다. 이 커넥터를 사용하려면 기존 커넥터 사용을 선택합니다. 기존 커넥터를 사용하지 않으려면 기존 커넥터 삭제 이전 단원을 참조하십시오새 커넥터 추가. 작업당 하나의 소스 리포지토리 커넥터만 가질 수 있습니다.

새 커넥터 추가

새 소스 코드 리포지토리 커넥터를 생성하려면:

  1. AWS CodeConnections 커넥터에 사용할 AWS 계정 번호를 입력합니다.

  2. 동일한 AWS 계정에 대해 up AWS CodeConnections를 설정하지 않은 경우 Set up AWS CodeConnections를 설정합니다.

  3. AWS 개발자 도구 콘솔을 사용하여 Bitbucket, GitHub, GitHub Enterprise Server, GitLab 또는 AzureDevOps 리포지토리에 대한 연결을 생성합니다.

  4. 생성한 연결의 Amazon 리소스 이름(ARN)을 복사합니다.

  5. AWS 변환으로 돌아가서 생성한 연결의 ARN을 붙여 넣습니다.

  6. 커넥터의 이름을 입력합니다.

    참고

    커넥터 이름의 일부로 개인 정보를 입력하지 마십시오.

  7. 커넥터 생성 시작을 선택합니다.

  8. AWS 변환은 현재 변환 작업과 동일한 리전에서 입력한 AWS 계정에 대한 커넥터를 생성하도록 요청하고 AWS 관리 콘솔에서 AWS 관리자가 승인 요청을 승인할 준비가 되었음을 알립니다. 확인 링크 복사를 선택합니다.

  9. AWS 관리자인 경우 AWS 계정에 로그인하고 확인 링크로 이동하여 연결 요청을 승인합니다. AWS 관리자가 아닌 경우 AWS 관리자에게 확인 링크를 제공합니다.

  10. AWS 관리자가 커넥터 요청을 승인한 후 커넥터 완성을 선택하여 커넥터 생성 프로세스를 완료합니다. 다른 커넥터를 사용하려면 다시 시작을 선택하여 커넥터 생성 프로세스를 다시 시작합니다.

공동 작업 탭에는 다음과 같은 커넥터에 대한 세부 정보도 포함되어 있습니다.

  • 상태 - 승인됨 또는 승인 보류 중

  • AWS 계정 ID

  • AWS 리전

  • 연결 ARN

기존 커넥터 삭제

참고

기존 소스 코드 리포지토리 커넥터가 있는 경우 AWS 변환에서 알림을 보냅니다. 기존 커넥터 사용 또는 삭제를 선택하고 새 커넥터를 생성합니다.

기존 소스 코드 리포지토리 연결을 삭제하도록 선택하면 커넥터를 실제로 삭제하기 전에 AWS 변환에서 경고를 보냅니다.

  1. 다음과 같은 몇 가지 방법으로 기존 커넥터를 삭제할 수 있습니다.

    1. AWS 변환에 메시지가 표시되면 삭제를 선택하고 새 커넥터를 생성할 수 있습니다.

    2. 프롬프트에서 다시 시작을 선택할 수도 있습니다. 이 커넥터를 수정하려면 다시 시작해야 합니다.

  2. AWS 변환은 다시 시작하면 커넥터가 삭제된다는 경고를 표시합니다. 커넥터를 삭제하려면 다시 시작을 선택합니다.

  3. AWS 변환은 커넥터를 삭제하면 Bitbucket, GitHub 및 GitLab과 같은 타사 리포지토리에 대한 연결이 제거됨을 다시 경고합니다. 또한 커넥터를 삭제하면이 커넥터를 사용하는 모든 AWS 변환 작업이 실패합니다. 삭제를 확인하려면 delete를 입력하고 Delete를 선택합니다.

  4. 새 소스 코드 리포지토리 커넥터를 추가하려면 섹션을 참조하세요새 커넥터 추가.

개인 액세스 토큰을 사용하여 리포지토리에 연결

개인 액세스 토큰(PAT)을 사용하여 리포지토리에 연결할 수 있습니다. 다음 단계를 따릅니다.

  1. 에이전트가 소스 코드 연결을 묻는 메시지를 표시하면 채팅 창에서 PAT를 선택합니다.

  2. PAT를 생성하고 AWS Secrets Manager에 저장하는 방법에 대해 표시된 지침을 읽습니다.

  3. 소스 컨트롤에서 PAT를 생성합니다.

  4. AWS Secrets Manager에 PAT를 저장하고 Amazon 리소스 이름(ARN)을 기록합니다. 예를 들어 GitHub 토큰의 형식은 다음과 같습니다.

    github_pat_XXXXXXXXXXXXXXX

  5. 채팅에서 커넥터 설정 링크를 선택하여 커넥터 양식을 엽니다.

  6. 커넥터 양식에 커넥터 이름, AWS 계정 ID, 보안 암호 ARN 및 선택적으로 KMS 키 ARN을 입력합니다. 그런 다음 양식을 제출합니다.

  7. 에이전트는 승인 링크를 제공합니다. 링크를 복사하고 관리자에게 전송하여 연결을 승인합니다. 승인 후 에이전트를 계속 진행합니다.

Amazon S3의 소스 코드에 연결

소스 코드 리포지토리를 연결하는 대신 AWS 변환을 Amazon S3의 소스 코드에 연결할 수 있습니다. AWS CodeConnections를 사용하여 리포지토리에 연결

S3 버킷 조직

원본 소스 코드와 변환된 코드는 아래와 같이 구성된 공통 S3 버킷에 저장됩니다. AWS 변환 작업과 동일한 리전에 S3 버킷을 설정해야 합니다. 루트 수준에서 소스 코드를 버킷에 zip 파일로 업로드합니다. zip 파일에는 각 리포지토리에 대한 최상위 폴더가 포함되어야 합니다.

변환 중에 AWS 변환은 변환 출력 폴더를 생성하고 변환 결과를 해당 폴더에 저장합니다. 변환은 변환된 코드를 포함하는 transformed-code.zip이라는 zip 파일을 생성합니다. 여기에는 프로젝트 수준에서 파일 변경 사항을 강조 표시하는 코드 차이 보고서 파일 이름 diff.txt가 포함됩니다.


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

새 S3 커넥터 추가

새 S3 소스 코드 리포지토리 커넥터를 생성하려면:

  1. AWS 콘솔에서 S3 버킷을 생성합니다.

  2. 소스 코드를 S3 버킷에 zip 파일로 업로드합니다.

  3. AWS 변환 웹 앱에서 .NET 변환 작업을 시작합니다. 소스 코드 리포지토리 연결 단계에서 S3 버킷에 소스 코드 연결을 선택하고 저장을 선택합니다.

  4. 다음 페이지에서 S3 버킷 세부 정보를 입력하고 제출을 선택합니다.

    1. 커넥터 이름

    2. AWS 계정 ID

    3. S3 버킷 Arn

    4. S3 버킷 암호화 키(선택 사항)

  5. 커넥터를 승인합니다.

    1. 다음 페이지에서 확인 링크를 복사합니다.

    2. 승인자가 링크를 찾아 AWS 커넥터 생성 변환 요청 페이지로 이동하도록 합니다.

    3. 새 역할을 생성하거나 기존 역할을 사용하도록 선택합니다.

    4. 요청을 검토한 후 저장 및 승인을 선택하여 요청을 승인합니다.

  6. S3 zip 파일 위치를 지정합니다.

    1. AWS 변환 웹 앱에서 상태가 승인됨으로 표시될 때까지 기다립니다.

    2. 자산 위치 지정 페이지에서 코드 zip 파일의 S3 URL을 형식으로 입력하고 AWS 변환으로 전송을 s3://bucket-name/zip-file-name 선택합니다.

    3. 작업은 검색 단계로 진행하여 변환을 계속합니다.

S3 커넥터 삭제

기존 S3 커넥터를 삭제하려면:

  1. AWS 변환 웹 앱에서 오른쪽 상단의 커넥터 관리를 선택합니다.

  2. 커넥터 관리 창에서 커넥터를 선택합니다.

  3. 삭제를 선택합니다.