本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
连接到源代码
之后 创建 .NET 现代化作业,在 工作计划 选项卡,左侧窗格 AWS 转换窗口列出了转换作业的各个阶段。第一阶段是 连接源代码。在此阶段,您将连接到源代码。
在开始之前,请确保你有一个 AWS 具有创建源代码连接权限的帐户。根据您选择的连接方法,您还需要访问 AWS CodeConnections,个人访问令牌 (PAT) 存储在 AWS 密钥管理器,或其中的一个 Amazon S3 存储桶 AWS 区域作为您的转型任务。创建连接器需要获得批准 AWS 管理员。
您可以连接到源代码存储库或在 zip 文件中提供代码。你有 4 个连接源代码的选项:
选择代码连接方法,代理将指导您完成设置。
使用连接到存储库 AWS CodeConnections
如果您选择 “代码连接” 选项, AWS 转换代理的用途 AWS CodeConnections 从 Azure 存储库、Bitbucket 下载你的 .NET 代码库 GitHub,或 GitLab。转换后的代码被写入一个新的可写分支。你必须设置 AWS CodeConnections 与您所在的地区相同 AWS 转变工作。
添加新连接器
要创建新的源代码存储库连接器,请执行以下操作:
-
输入 AWS 您想用于 AWS CodeConnections 连接器。
-
如果你还没有设置 AWS CodeConnections 出于同样的考虑 AWS 账户, 设置 AWS CodeConnections。
-
使用 AWS 开发者工具控制台
创建与您的连接 比特桶, GitHub, GitHub 企业服务器, GitLab,或 AzureDevOps 存储库。 -
复制您创建的连接的亚马逊资源名称 (ARN)。
-
返回 AWS 转换并粘贴您创建的连接的 ARN。
-
输入连接器的名称。
注意请勿将个人信息作为连接器名称的一部分输入。
-
选择 启动连接器创建。
-
AWS Transform 请求为创建连接器 AWS 您输入的账户,与当前转换任务位于同一区域,并通知您批准请求已准备好等待您的批准 AWS 管理员在 AWS 管理控制台。选择 复制验证链接。
-
如果你是 AWS 管理员,登录 AWS 帐户,然后转到验证链接以批准连接请求。如果你不是 AWS 管理员,请将验证链接提供给您的 AWS 管理员。
-
之后 AWS 管理员批准连接器请求,选择 完成连接器 完成连接器创建过程。如果您想使用其他连接器,请选择 重启,以重新启动连接器创建过程。
协作选项卡还包含有关您的连接器的详细信息,其中包括:
-
状态--已批准或待批准
-
AWS 账户 ID
-
AWS 区域
-
连接 ARN
删除现有连接器
如果您已有源代码存储库连接器, AWS Transform 会通知你。选择任一选项 使用现有连接器 要么 删除并创建新连接器。
如果您选择删除现有的源代码存储库连接, AWS 在实际删除连接器之前,Transform 会向您发出警告。
-
您可以通过以下几种方式删除现有连接器:
-
如果 AWS 将提示符转换为,你可以选择 删除并创建新连接器。
-
你也可以选择 重新启动 在提示符中, 要修改此连接器,必须重新启动。
-
-
AWS Transform 会警告你,重启会删除连接器。要删除连接器,请选择 重启 再次。
-
AWS Transform 再次警告你,删除连接器将删除与第三方存储库(例如 Bitbucket)的连接, GitHub,以及 GitLab。另外,任何 AWS 如果删除连接器,则使用此连接器的转换作业将失败。要确认删除,请键入 删除 然后选择 删除。
-
要添加新的源代码存储库连接器,请参阅 添加新连接器。
使用个人访问令牌连接到存储库
您可以使用个人访问令牌 (PAT) 连接到存储库。按照以下步骤进行操作:
当代理提示连接源代码时,选择 拍手 在聊天窗格中。
阅读显示的有关生成 PAT 并将其存储在中的说明 AWS 机密经理。
通过源代码控制生成 PAT。
将您的 PAT 存储在 AWS 密钥管理器并记录亚马逊资源名称 (ARN)。例如,一个 GitHub 令牌的格式是这样的:
github_pat_XXXXXXXXXXXXXXX在聊天中,选择 设置连接器 链接打开连接器表单。
在连接器表单中,输入连接器名称,您的 AWS 账户 ID、机密 ARN 以及可选的 KMS 密钥 ARN。然后提交表格。
代理提供批准链接。复制链接并发送给管理员以批准连接。批准后,继续与代理商联系。
连接到 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 源代码存储库连接器,请执行以下操作:
-
在 AWS 控制台,创建 S3 存储桶。
-
将您的源代码作为 zip 文件上传到 S3 存储桶。
-
在 AWS 转换 Web 应用程序,启动 .NET 转换作业。在 连接源代码存储库 步骤,选择 将您的源代码连接到 S3 存储桶中 然后选择 保存。
-
在下一页上,输入您的 S3 存储桶详细信息并选择 提交。
-
连接器名称
-
AWS 账户 ID
-
S3 存储桶 Arn
-
S3 存储桶加密密钥(可选)
-
-
批准连接器:
-
在下一页上,复制验证链接。
-
让批准者浏览链接以访问 AWS 转换连接器创建请求页面。
-
选择创建新角色或使用现有角色。
-
查看请求后,选择 保存 和 批准 来批准它。
-
-
指定 S3 压缩文件的位置:
-
在 AWS 转换 Web 应用程序,等待状态显示 已批准。
-
在 指定资产位置 页面,输入代码压缩文件的 S3 URL,格式为
s3://bucket-name/zip-file-name然后选择 发送至 AWS 转型。 -
工作继续进行到 探索 继续转型的步骤。
-
删除 S3 连接器
要删除现有的 S3 连接器,请执行以下操作:
-
在 AWS 转换 Web 应用程序,选择 管理连接器 在右上角。
-
在 管理连接器 窗口,选择连接器。
-
选择删除。