View a markdown version of this page

Connect 到源代码 - AWS 转换
使用 Connect 连接到存储库 AWS CodeConnections使用个人访问令牌连接到存储库连接亚马逊 S3 中的源代码

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Connect 到源代码

之后创建.NET 现代化任务，在 Job Plan 选项卡上，“ AWS 转换” 窗口的左窗格列出了转换作业的各个阶段。第一阶段是 Connect 源代码。在此阶段，您将连接到您的源代码。

在开始之前，请确保您的 AWS 帐户具有创建源代码连接的权限。根据您选择的连接方法，您还需要访问存储在 S AWS ecrets Manager 中的个人访问令牌 (PAT)，或者与您的转换任务位于同一 AWS 区域的 Amazon S3 存储桶。 AWS CodeConnections创建连接器需要获得 AWS 管理员的批准。

您可以连接到源代码存储库或以 zip 文件形式提供代码。你有 4 个选项可以连接到源代码：

  • 代码连接：使用 AWS CodeConnections (GitHub、、Bitbucket GitLab、Azure DevOps) 连接到源代码存储库。

  • PAT：使用存储在 Secr AWS ets Manager 中的个人访问令牌连接到源代码存储库。

  • S3：为代码存档压缩文件提供 Amazon S3 URI（例如s3://my-bucket/repos.zip）。

  • 直接上传：将代码存档 zip 文件拖放到聊天窗格中。

选择一种代码连接方法，代理将指导您完成设置。

使用 Connect 连接到存储库 AWS CodeConnections

如果你选择 “代码连接” 选项，则 AWS 转换代理会使用AWS CodeConnections从 Azure 存储库、Bitbucket 或下载你的.NET 代码库。 GitHub GitLab转换后的代码写入新的可写分支。您必须在与 AWS 变换任务相同的区域 AWS CodeConnections 中进行设置。

注意

如果您已有源代码存储库连接器，Trans AWS form 会通知您。选择 “使用现有连接器” 以使用此连接器。如果您不想使用现有的连接器，请参见删除现有连接器前文添加新的连接器。每个作业只能有一个源存储库连接器。

添加新的连接器

要创建新的源代码存储库连接器，请执行以下操作：

  1. 输入您要用于 AWS CodeConnections 连接器的 AWS 账号。

  2. 如果您尚未为同一个 AWS 账户 AWS CodeConnections 进行设置，请设置 AWS CodeConnections。

  3. 使用AWS 开发者工具控制台创建与您的 Bitbucket、GitHub、GitHub 企业服务器或AzureDevOps存储库的连接。GitLab

  4. 复制您创建的连接的亚马逊资源名称 (ARN)。

  5. 返回到 “ AWS 转换”，然后粘贴您创建的连接的 ARN。

  6. 输入连接器的名称。

    注意

    请勿在连接器名称中输入个人信息。

  7. 选择 “启动连接器创建”。

  8. AWS Transform 会请求为您输入的 AWS 账户创建一个连接器，该连接器位于与当前转换任务相同的区域，并通知您批准请求已准备就绪，可供 AWS 管理员在 AWS 管理控制台中批准。选择 “复制验证链接”。

  9. 如果您是 AWS 管理员，请登录该 AWS 帐户并转到验证链接以批准连接请求。如果您不是 AWS 管理员，请向管理员提供验证链接。 AWS

  10. AWS 管理员批准连接器请求后，选择完成连接器以完成连接器创建过程。如果您想使用其他连接器，请选择 “重新启动” 以重新启动连接器创建过程。

“协作” 选项卡还包含有关您的连接器的详细信息，其中包括：

  • 状态-已批准或待批准

  • AWS 账号

  • AWS 区域

  • 连接 ARN

删除现有连接器

注意

如果您已有源代码存储库连接器，Trans AWS form 会通知您。选择 “使用现有连接器” 或 “删除” 并创建新的连接器。

如果您选择删除现有的源代码存储库连接，Trans AWS form 将在实际删除连接器之前向您发出警告。

  1. 您可以通过以下几种方式删除现有连接器：

    1. 如果 AWS Transform 提示您这样做，则可以选择删除并创建新的连接器。

    2. 您也可以在提示中选择 “重新启动”，要修改此连接器，必须重新启动。

  2. AWS 转换警告您重新启动会删除连接器。要删除连接器，请再次选择 “重新启动”。

  3. AWS Transform 再次警告您，删除连接器将移除与您的第三方存储库（例如 Bitbucket GitHub、和 GitLab）的连接。此外，如果删除该连接器，任何使用此连接器的 AWS 转换作业都将失败。要确认删除，请键入删除并选择删除。

  4. 要添加新的源代码存储库连接器，请参阅添加新的连接器。

使用个人访问令牌连接到存储库

您可以使用个人访问令牌 (PAT) 连接到存储库。按照以下步骤进行操作：

  1. 当代理提示输入源代码连接时，请在聊天窗格中选择 PAT。

  2. 阅读显示的有关生成 PAT 并将其存储在 S AWS ecrets Manager 中的说明。

  3. 从源代码控制中生成 PAT。

  4. 将您的 PAT 存储在 S AWS ecrets Manager 中并记录亚马逊资源名称 (ARN)。例如， GitHub 令牌的格式如下所示：

    github_pat_XXXXXXXXXXXXXXX

  5. 在聊天中，选择 “设置连接器” 链接以打开连接器表单。

  6. 在连接器表单中，输入连接器名称、您的 AWS 账户 ID、机密 ARN 以及可选的 KMS 密钥 ARN。然后提交表格。

  7. 代理提供批准链接。复制链接并发送给管理员以批准连接。批准后，继续与代理联系。

连接亚马逊 S3 中的源代码

您可以将 T AWS ransform 连接到 Amazon S3 中的源代码，作为连接源代码存储库的替代方案。

S3 存储桶组织

原始源代码和转换后的代码存储在通用 S3 存储桶中，其组织方式如下所示。您必须在与 AWS 转换任务相同的区域中设置 S3 存储桶。将您的源代码作为根级别的 zip 文件上传到存储桶。zip 文件必须包含每个存储库的顶级文件夹。

在 AWS 转换过程中，Transform 会创建一个转换输出文件夹，并将转换结果存储在该文件夹中。转换会创建一个名为 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. 将您的源代码作为 zip 文件上传到 S3 存储桶。

  3. 在 AWS 转换 Web 应用程序中，启动.NET 转换作业。在 “连接源代码存储库” 步骤中，选择 “在 S3 存储桶中连接您的源代码”，然后选择 “保存”。

  4. 在下一页上，输入您的 S3 存储桶详细信息并选择提交。

    1. 连接器名称

    2. AWS 账户编号

    3. S3 水桶手臂

    4. S3 存储桶加密密钥（可选）

  5. 批准连接器：

    1. 在下一页上，复制验证链接。

    2. 让批准者浏览链接以访问 Trans AWS form 连接器创建请求页面。

    3. 选择创建新角色或使用现有角色。

    4. 审核请求后，选择 “保存并批准” 以批准该请求。

  6. 指定 S3 压缩文件的位置：

    1. 在 T AWS ransform Web 应用程序中，等待状态显示为已批准。

    2. 在 “指定资产位置” 页面上，输入格式为 zip 代码文件的 S3 URL，s3://bucket-name/zip-file-name然后选择 “发送到 AWS 转换”。

    3. 该任务继续执行 “发现” 步骤以继续转换。

删除 S3 连接器

要删除现有 S3 连接器，请执行以下操作：

  1. 在 AWS 转换 Web 应用程序中，选择右上角的管理连接器。

  2. 在 “管理连接器” 窗口中，选择连接器。

  3. 选择删除。