创建和更新评估

本页面介绍了如何将大型主机应用文件上传到 Mainframe Assessment Tool 并创建评估。

您可以使用自助工作流自行执行评估,也可以向 Google 寻求帮助。如果您的评估涉及复杂的代码库结构(例如自定义预处理器或专有格式)、大规模网域映射、自定义部署要求或端到端现代化改造策略,请考虑向 Google 寻求帮助。

如需帮助,请联系您的 Google Cloud 客户支持团队或客户工程师,或发送电子邮件至 mainframe@google.com 与 Google 大型主机团队联系。

准备工作

如需为评估做好准备,请确保您已满足以下前提条件:

  1. 为 Mainframe Assessment Tool 配置 Google Cloud 项目。
  2. 设置和访问 Mainframe Assessment Tool。
  3. 创建一个包含要迁移的所有应用的 ZIP 文件:
    • Mainframe Assessment Tool 仅支持大小不超过 400 MB 的 ZIP 文件。 如果应用 ZIP 文件大于 400 MB,请考虑根据业务网域将文件拆分为较小的 ZIP 文件,并为每个网域上传一个 ZIP 文件。
    • 如果应用包含对外部工件(例如程序或表)的引用,我们建议您也添加这些依赖项。如需查看受支持的语言、数据库、事务监控器和调度器配置的列表,请参阅支持的语言。
    • 请勿在 ZIP 文件中包含二进制文件和其他非源代码文件。

创建评估

如需上传 ZIP 文件并在 Mainframe Assessment Tool 中创建评估,请按以下步骤操作:

评估详细信息

  1. 如需在本地机器上打开 Mainframe Assessment Tool,请打开网络浏览器窗口,然后前往 http://localhost:PORT。

    将 PORT 替换为您在本地机器上用于与 Mainframe Assessment Tool 建立隧道连接的端口号。

  2. 在首页上,点击创建评估。

  3. 在名称部分,输入评估的名称。

  4. 可选:在说明字段中,输入评估的说明。

  5. 如需上传 ZIP 文件,请点击选择文件。系统会打开文件浏览器。选择要上传的 ZIP 文件。您一次只能上传一个文件。

  6. 点击下一步。

AI 数据洞见

  1. 可选:如需为评估启用 AI 数据分析,请选择启用 AI 数据分析。
  2. 如需为 COBOL 代码生成段落级摘要,请选择详细摘要。默认情况下,此选项处于选中状态。
  3. 如需为 Gemini 生成的评估规范生成测试用例,请选择测试用例。默认情况下,系统不会选中此选项。
  4. 如需提取有关应用访问的数据库和文件的信息,请选择数据源。

  5. 可选:对于其他生成指南,请输入自由文本指南,以便在 AI 生成期间添加到 Gemini 提示词中。

  6. 点击下一步。

模型和质量

配置用于评估的 Gemini 模型。这些设置仅适用于此评估。

  1. 选择 Mainframe Assessment Tool 如何将评估步骤路由到 Gemini 模型:

    • 快速:使用较轻量的模型,以最快的速度返回结果。
    • 均衡(推荐):在大多数评估中兼顾速度和深度,将复杂的推理步骤路由到较重的模型,将较简单的步骤路由到较轻的模型。这是默认选项。
    • Extended:使用更复杂的模型,最大限度地提高分析深度。

    • 改用特定模型:在单个模型上运行所有评估步骤,而不是按级别进行优化。从列表中选择一个模型。 每个模型都标记为正式版或预览版。

    每个质量级别都会列出每个步骤中使用的 Gemini 模型。Mainframe Assessment Tool 支持可用的 Agent Platform 区域内的所有可用区。

  2. 可选:如需将模型调用限制在评估区域及其关联的多区域,请启用将数据保留在我的区域。

    默认情况下,Mainframe Assessment Tool 会将模型调用路由到所选模型的最佳位置,包括评估区域、多区域或全球 Agent Platform 端点。启用此设置后,Mainframe Assessment Tool 会执行以下操作:

    • 停用需要使用评估区域中不可用的 Gemini 模型的质量级别。这些级别会标记为此区域不提供。
    • 在特定模型列表中隐藏评估区域中不可用的模型。

    如果评估区域中没有受支持的模型,则在启用将数据保留在我的区域的情况下,评估无法运行。如需继续评估,请停用将数据保留在我的区域,以允许在区域外进行模型调用。

    如果您的 Mainframe Assessment Tool 实例没有外部 IP 地址,并且您启用了将数据保留在我的区域,则仅在多区域端点上提供的模型部署可能无法使用。出现这种情况是因为专用 Google 访问通道无法访问多区域端点。如需在遵守数据驻留要求的同时提供这些模型,请设置与多区域端点的专用连接。如需查看相关说明,请参阅为数据驻留配置专用连接。

  3. 点击下一步。

可选:网域

  1. 可选:如需添加一个或多个代表不同功能区域的网域,请点击添加网域。

    通过网域,您可以在评估完成后根据特定上下文过滤和查看结果。

  2. 点击下一步。

创建评估

  1. 点击创建评估。

上传 ZIP 文件后,Mainframe Assessment Tool 会解压缩并处理源代码。评估页面会在表中为每个发现的资产显示一个新条目,其中显示其评估状态:

  • 待处理:评估正在等待轮到自己。
  • 进行中:分析正在进行中。
  • 已分析:评估已完成。
  • 失败:评估未完成。

如果您在导入文件后看到错误,可以直接在 Mainframe Assessment Tool 中查看出错提示。

如需详细了解某项内容的评估进度,请点击表格中该内容旁边的参考 ID。系统会打开一个页面,其中显示所有步骤以及状态。

向现有评估添加文件

创建评估后,您可以向其添加其他 ZIP 文件。 新 ZIP 文件中的文件会与评估中的现有文件合并。 如果您想替换现有文件,新 ZIP 文件必须包含要替换的文件,且路径结构必须完全相同。

如需向现有评估添加文件,请按照以下步骤操作:

  1. 在网络浏览器中打开 Mainframe Assessment Tool。
  2. 在导航菜单中,点击评估。
  3. 在评估页面上,找到要修改的评估,然后点击 打开评估。
  4. 点击 添加文件。
  5. 点击选择文件,然后选择要上传的 ZIP 文件。 您一次只能上传一个文件。
  6. 点击 Add(添加)。

上传文件后,Mainframe Assessment Tool 会再次开始分析。如果您替换文件,系统会重新全面评估这些文件,并且这些文件的任何现有分析结果都可能会发生变化。在重新处理期间,正在重新处理的文件旁边会显示过时指示标志。

更新评估详情和设置

创建评估后,您可以更新其名称和说明,并修改 AI 生成的分析洞见设置。

如需更新评估详情或设置,请按以下步骤操作:

  1. 在网络浏览器中打开 Mainframe Assessment Tool。
  2. 在导航菜单中,点击评估。
  3. 在评估页面上,找到要修改的评估,然后点击 打开评估。
  4. 点击设置 修改评估设置。
  5. 可选:在评估详情步骤中,修改名称和说明,然后点击下一步。
  6. 可选:在 AI 数据洞见步骤中,根据需要修改 AI 设置,然后点击下一步。
  7. 可选:在模型和质量步骤中,配置模型或质量级别,然后点击下一步。
  8. 在网域(可选)步骤中,点击下一步。创建评估后,您无法修改网域。
  9. 点击更新评估。

更新设置后,Mainframe Assessment Tool 会再次开始分析。

后续步骤