View a markdown version of this page

连接到源代码 - AWS 转换

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

连接到源代码

之后 创建 .NET 现代化作业,在 工作计划 选项卡,左侧窗格 AWS 转换窗口列出了转换作业的各个阶段。第一阶段是 连接源代码。在此阶段,您将连接到源代码。

在开始之前,请确保你有一个 AWS 具有创建源代码连接权限的帐户。根据您选择的连接方法,您还需要访问 AWS CodeConnections,个人访问令牌 (PAT) 存储在 AWS 密钥管理器,或其中的一个 Amazon S3 存储桶 AWS 区域作为您的转型任务。创建连接器需要获得批准 AWS 管理员。

您可以连接到源代码存储库或在 zip 文件中提供代码。你有 4 个连接源代码的选项:

  • 代码连接: 使用连接到源代码存储库 AWS CodeConnections (GitHub, GitLab,Bitbucket,天蓝色 DevOps)。

  • 拍手: 使用存储在中的个人访问令牌连接到源代码存储库 AWS 机密经理。

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

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

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

使用连接到存储库 AWS CodeConnections

如果您选择 “代码连接” 选项, AWS 转换代理的用途 AWS CodeConnections 从 Azure 存储库、Bitbucket 下载你的 .NET 代码库 GitHub,或 GitLab。转换后的代码被写入一个新的可写分支。你必须设置 AWS CodeConnections 与您所在的地区相同 AWS 转变工作。

注意

如果您已有源代码存储库连接器, AWS Transform 会通知你。选择 使用现有连接器 使用此连接器。如果您不想使用现有连接器,请参阅 删除现有连接器 以前 添加新连接器。每个作业只能有一个源存储库连接器。

添加新连接器

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

  1. 输入 AWS 您想用于 AWS CodeConnections 连接器。

  2. 如果你还没有设置 AWS CodeConnections 出于同样的考虑 AWS 账户, 设置 AWS CodeConnections。

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

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

  5. 返回 AWS 转换并粘贴您创建的连接的 ARN。

  6. 输入连接器的名称。

    注意

    请勿将个人信息作为连接器名称的一部分输入。

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

  8. AWS Transform 请求为创建连接器 AWS 您输入的账户,与当前转换任务位于同一区域,并通知您批准请求已准备好等待您的批准 AWS 管理员在 AWS 管理控制台。选择 复制验证链接。

  9. 如果你是 AWS 管理员,登录 AWS 帐户,然后转到验证链接以批准连接请求。如果你不是 AWS 管理员,请将验证链接提供给您的 AWS 管理员。

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

协作选项卡还包含有关您的连接器的详细信息,其中包括:

  • 状态--已批准或待批准

  • AWS 账户 ID

  • AWS 区域

  • 连接 ARN

删除现有连接器

注意

如果您已有源代码存储库连接器, AWS Transform 会通知你。选择任一选项 使用现有连接器 要么 删除并创建新连接器。

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

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

    1. 如果 AWS 将提示符转换为,你可以选择 删除并创建新连接器。

    2. 你也可以选择 重新启动 在提示符中, 要修改此连接器,必须重新启动。

  2. AWS Transform 会警告你,重启会删除连接器。要删除连接器,请选择 重启 再次。

  3. AWS Transform 再次警告你,删除连接器将删除与第三方存储库(例如 Bitbucket)的连接, GitHub,以及 GitLab。另外,任何 AWS 如果删除连接器,则使用此连接器的转换作业将失败。要确认删除,请键入 删除 然后选择 删除。

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

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

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

  1. 当代理提示连接源代码时,选择 拍手 在聊天窗格中。

  2. 阅读显示的有关生成 PAT 并将其存储在中的说明 AWS 机密经理。

  3. 通过源代码控制生成 PAT。

  4. 将您的 PAT 存储在 AWS 密钥管理器并记录亚马逊资源名称 (ARN)。例如,一个 GitHub 令牌的格式是这样的:

    github_pat_XXXXXXXXXXXXXXX
  5. 在聊天中,选择 设置连接器 链接打开连接器表单。

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

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

连接到 Amazon S3 中的源代码

你可以连接 AWS 在 Amazon S3 中转换为源代码作为替代方案 连接源代码存储库。

S3 存储桶组织

原始源代码和转换后的代码存储在通用的 S3 存储桶中,组织结构如下所示。您必须将您的 S3 存储桶设置在与您所在的区域相同的区域 AWS 转变工作。将您的源代码作为根级压缩文件上传到存储桶。zip 文件必须包含每个存储库的顶级文件夹。

在转型过程中, AWS 转换创建转换输出文件夹,并将转换结果存储在该文件夹中。转换会创建一个名为的 zip 文件 transformed-code.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 账户 ID

    3. S3 存储桶 Arn

    4. S3 存储桶加密密钥(可选)

  5. 批准连接器:

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

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

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

    4. 查看请求后,选择 保存 和 批准 来批准它。

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

    1. 在 AWS 转换 Web 应用程序,等待状态显示 已批准。

    2. 在 指定资产位置 页面,输入代码压缩文件的 S3 URL,格式为 s3://bucket-name/zip-file-name 然后选择 发送至 AWS 转型。

    3. 工作继续进行到 探索 继续转型的步骤。

删除 S3 连接器

要删除现有的 S3 连接器,请执行以下操作:

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

  2. 在 管理连接器 窗口,选择连接器。

  3. 选择删除。