将 Linux 应用升级为容器平台

预览

本产品或功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 正式发布前产品和功能“按原样”提供，可能仅提供有限支持。 如需了解详情，请参阅发布阶段说明。

借助 Migrate to Containers 与 Cloud Code 的集成，您能够以 Linux 机器对在虚拟机 (VM) 上运行的 Linux 应用组件进行现代化改造，并生成可以直接在 IDE 中部署到 Google Kubernetes Engine 和 Cloud Run 的工件。

在本指南中，您将学习如何在 Linux 机器上使用 IDE 中的 Cloud Code 扩展程序将现有应用平台更换为 GKE 容器。

本指南适用于使用 Linux 机器，具备 VS Code 实践知识、熟悉 Google Cloud 并且有运行其应用组件的虚拟机的开发者。

注意 ：如需执行本指南中的步骤，您必须使用 Linux 计算机。Cloud Code 不支持通过 Windows 或 macOS 将应用更换平台到容器。

准备工作

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

3. 确保您的 Google Cloud 项目已启用结算功能。

4. 启用 Google Kubernetes Engine API。

   启用 API

5. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

6. 确保您的 Google Cloud 项目已启用结算功能。

7. 启用 Google Kubernetes Engine API。

   启用 API

8. 安装 Cloud Code 扩展程序（如果尚未安装）。
9. 创建和配置 GKE 集群。
10. 确保您知道要执行的迁移类型。如需详细了解支持的工作负载，请参阅查看兼容的操作系统、工作负载和 Kubernetes 版本。
11. 准备源机器和本地机器以进行现代化改造。Cloud Code 仅支持 Linux 进行现代化改造。

添加平台来源

在本部分中，您将在本地机器上安装迁移中心资产识别客户端 CLI (mcdc) 和其他 Migrate to Containers 工具（如果尚未安装），然后按照以下步骤添加更换平台来源：

1. 在 IDE 的活动栏中，点击 Cloud Code，然后展开 Replatform Apps 资源管理器。

2. 如果这是您第一次在 Cloud Code 中使用 Migrate to Containers，您需要点击安装工具，在本地机器上安装 mcdc CLI 和其他 Migrate to Containers 工具。否则，请继续下一步。

3. 点击修改来源。这将打开一个空的 mcdc-sources.json 文件。请按以下格式添加来源：

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

   注意 ：您可以在 SSH 命令中使用相同的 host、user 和 identityFile 变量。

4. 如需在 Replatform Apps Explorer 中看到来源，请将鼠标指针悬停在 Replatform Apps 资源管理器上，然后点击显示的 cached 重新加载来源按钮。

可选：生成适合度评估

在尝试将应用平台更换为容器之前，我们建议您生成来源的适合度评估，以告知您来源是否能够为容器更换平台。

如需生成来源的适合度评估，请右键点击来源，然后选择评估来源。这会在您的 IDE 中打开终端，并显示来源评估的日志。

评估完成后，mcdc 会在 IDE 中生成适合度评估报告。

如果您的来源报告为合适，那么您可以更换应用平台。

为您的应用更换平台

Cloud Code 会为每个更换平台创建一个专用工作区，并允许您在该工作区中运行复制、分析和生成任务，以自动执行更换平台的步骤。如果您在没有先运行 Copy 和 Analyze 任务的情况下运行 Generate 任务，它会在生成工件之前自动运行这些任务。

以下部分将指导您执行上述各项任务，并使用 Cloud Code 将应用平台更换为容器。

如需详细了解迁移的生命周期，请参阅 Migrate to Containers CLI 架构。

创建新的更换平台工作区

在创建新的更换平台工作区之前，您需要知道要为迁移类型选择哪些迁移参数。如需详细了解每种迁移类型的参数，请参阅创建迁移计划。

如需在 IDE 中使用工件创建新的更换平台工作区，请按以下步骤操作：

1. 在 Replatform Apps 资源管理器中，右键点击要更换平台的来源，然后点击更换平台。

2. 从菜单中显示的选项列表中，选择更换平台历程。

3. 选择一个新的工作区目录以在其中更换应用平台，点击 OK，然后点击 Create replatform workspace。

4. 请根据您的迁移类型选择迁移参数。

5. 可选：如果您选择了 WebSphere 迁移类型，并且想要使用二进制文件扫描程序，请选择 binaryAppScanner.jar 文件。

   工作区生成操作需要几秒钟的时间。系统随即会在 IDE 的新窗口中打开您的新工作区目录。

将文件从虚拟机复制到工作区

如需将文件从虚拟机复制到 IDE 中的工作区，请执行以下步骤：

1. 可选：mcdc CLI 会应用过滤条件以缩减副本的大小，但您可以修改 filters.txt 文件以进一步缩减副本的大小。如需了解如何缩减副本的大小，请参阅缩减复制的文件系统的大小。

2. 按 Ctrl+Shift+P 打开命令面板。

3. 搜索并选择 Tasks: Run Task，然后选择 m2c: Copy。 复制文件可能需要几分钟时间。

分析虚拟机文件系统并生成迁移计划

如需分析虚拟机文件系统并生成迁移计划，请执行以下步骤：

1. 按 Ctrl+Shift+P 打开命令面板。

2. 搜索并选择 Tasks: Run Task，然后选择 m2c: Analyze。

   如果分析任务失败，您需要通过 analyze-args.ini 文件修改迁移参数。此文件中的参数占一行，并随附关于该参数的文档。

   分析成功后，Cloud Code 会创建一个名为 migration-plan 的目录，其中包含 config.yaml 文件形式的分析结果。您可以修改此文件，以更改工件的生成方式。

   config.yaml 文件的结构因迁移类型而异。如需详细了解支持的迁移类型，请参阅以下页面：

   • Linux 虚拟机
   • Tomcat 服务器
   • WebSphere 工作负载
   • JBoss 服务器
   • Apache 服务器
   • WordPress 网站

生成工件

如需生成工件，您需要在 IDE 中运行 Generate 任务。如果您还没有运行前面部分中的 Copy 和 Analyze 任务，Generate 任务会在生成工件之前自动运行这两项任务。

如需生成工件，请执行以下步骤：

1. 按 Ctrl+Shift+P 打开命令面板。

2. 搜索并选择 Tasks: Run Task，然后选择 m2c: Generate。 这会在 src 目录中生成工件，该目录包含用于构建和部署容器映像的 skaffold.yaml 文件。每种迁移类型都会生成不同的工件，但所有迁移类型通常会创建一个或多个 dockerfile 以及 skaffold.yaml 引用的 GKE 部署规范。

   工件生成完成后，您已完成应用的平台更换！

3. 可选：如果要修改迁移计划，请修改 config.yaml 文件并重新运行 m2c: Generate 任务。

   否则，如果您对更换平台的结果感到满意，可以继续在 GKE 容器中运行应用。

在 GKE 容器中运行应用

在本部分中，您将在 GKE 容器中运行更换平台的应用、查看正在运行的应用的日志，并清理资源。

如果您尚未创建和配置 GKE 集群，请按照在 Cloud Code for VS Code 中创建和配置 GKE 集群中的说明操作。

如需详细了解如何调试 GKE 应用，请参阅使用 Cloud Code for VS Code 调试 Kubernetes 应用。

运行和查看应用

现在，您已完成所有设置，可以运行应用并实时查看应用了。Cloud Code 会监控您的文件系统是否有更改，以便您可以实时修改并重新运行应用。

如需运行您的应用，请按以下步骤操作：

1. 在 Cloud Code 状态栏中，点击活跃项目名称。

   

2. 在随即显示的“快捷选择”菜单中，选择 Run on Kubernetes（在 Kubernetes 上运行）。

3. 确认是使用当前集群上下文，还是切换到其他集群上下文。

4. 如果出现提示，请选择要将映像推送到的映像注册表。如果您使用 gcr.io/PROJECT_ID 创建新的映像注册表，请确保该映像注册表与您的集群位于同一项目中。

   系统会显示一个输出窗口，您可以在其中跟踪正在运行的应用的进度。您还会在终端输出中看到来自正在运行的 pod 的日志实时流。

5. 应用在 Kubernetes 上运行后，输出窗口会显示 IP 地址。如需使用此关联的 IP 地址访问您的应用，请按 Ctrl 键，然后点击该地址。

调试会话启动后，开发会话窗格会显示结构化日志记录视图。随着任务开始时，任务将显示一个旋转的半圆形 progress_activity。

如果任务成功，该步骤旁边会显示一个对勾标记 check_circle。

如需查看某个步骤的详细信息，请在 Development session（开发会话）窗格中点击该步骤。“输出”窗格会在日志记录输出中显示该步骤。

清理

停止应用后，系统会自动删除在运行期间部署的所有 Kubernetes 资源。

为避免系统因本快速入门中使用的其他资源向您的帐号收取费用，如果您想重复使用该项目，请务必删除该项目或删除您创建的集群。

如需删除集群，请执行以下操作：

1. 点击 Cloud Code，然后展开 Kubernetes 资源管理器。
2. 将指针悬停在集群名称上，然后点击 open_in_new 在 Google Cloud 控制台中打开。
3. 点击删除，然后再次点击删除进行确认。

如需删除项目（以及关联的资源，包括所有集群），请执行以下操作：

警告：删除项目会产生以下影响

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. 在 Google Cloud 控制台中，进入管理资源页面。

   转到“管理资源”

2. 在项目列表中，选择要删除的项目，然后点击删除。
3. 在对话框中输入项目 ID，然后点击关闭以删除项目。

如需删除在更换平台过程中创建的所有本地文件，请执行以下操作：

1. 打开命令面板 (Ctrl+Shift+P)。
2. 搜索并选择 Tasks: Run Task，然后选择 m2c: Cleanup。