在本指南中,您将学习如何在 Linux 机器上使用 IDE 中的 Cloud Code 扩展程序将现有应用迁移到 GKE 容器。
本指南适用于使用 Linux 计算机的开发者,他们需要具备以下条件:熟悉 VS Code、熟悉 Google Cloud,并且拥有运行应用组件的虚拟机。
准备工作
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Google Kubernetes Engine API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Google Kubernetes Engine API.
- 如果您尚未安装 Cloud Code 扩展程序,请先安装该扩展程序。
- 创建和配置 GKE 集群。
- 请确保您知道要执行哪种类型的迁移。如需详细了解受支持的工作负载,请参阅查看兼容的操作系统、工作负载和 Kubernetes 版本。
- 准备 您的源机器和本地机器以进行现代化改造。Cloud Code 仅支持使用 Linux 进行现代化改造。
添加更换平台来源
在本部分中,您将在本地机器上安装 Migration Center 资产识别客户端 CLI (mcdc
) 和其他 Migrate to Containers 工具(如果尚未安装),并按照以下步骤添加重新平台化源:
在 IDE 的活动栏中,点击 Cloud Code。 然后展开 Replatform Apps Explorer。
如果这是您首次在 Cloud Code 中使用 Migrate to Containers,则需要点击安装工具,在本地机器上安装
mcdc
CLI 和其他 Migrate to Containers 工具。否则,请继续下一步。点击修改来源。这会打开一个空的
mcdc-sources.json
文件。将 来源采用以下格式:[ { "title": "SOURCE_NAME", "host": "HOSTNAME", "user": "USER", "identityFile":"IDENTITY-FILE-PATH" } ]
如需在重新平台化应用资源管理器中看到来源,请将指针悬停在重新平台化应用资源管理器上,然后点击显示的缓存 Reload sources 按钮。
可选:生成适合度评估
在尝试将应用重新平台化到容器之前,我们建议您生成来源的适用性评估,以便了解来源是否能够重新平台化到容器。
要生成来源的拟合评估,请右键点击来源,然后选择 评估来源。这会在您的 IDE 中打开终端,并显示 来源的评估。
评估完成后,mcdc
会在您的 IDE 中生成适合性评估报告。
如果系统报告您的来源为适合度,那么您就可以更换平台了 部署应用
将应用迁移到新平台
Cloud Code 会为每次迁移平台创建一个专用工作区,并允许您在工作区中运行复制、分析和生成任务,以自动执行迁移平台步骤。如果您在未先运行复制和分析任务的情况下运行生成任务,系统会在生成工件之前自动运行这些任务。
以下部分将指导您完成上述每个任务,并使用 Cloud Code 将应用迁移到容器。
如需详细了解迁移生命周期,请参阅 Migrate to Containers CLI 架构。
创建新的平台工作区
在创建新的重新平台工作区之前,您需要知道要为您的迁移类型选择哪些迁移参数。更多信息 有关每种迁移类型的参数,请参阅 创建迁移计划。
如需在 IDE 中使用工件创建新的重新平台化工作区,请按以下步骤操作:
在迁移应用平台资源管理器中,右键点击要迁移平台的来源,然后点击迁移平台。
从菜单中显示的选项列表中,选择一个迁移平台流程。
选择要为应用更换平台的新工作区目录,点击 确定,然后点击创建平台工作区。
选择适合您的迁移类型的迁移参数。
可选:如果您选择了 WebSphere 迁移类型,并且想要使用二进制扫描器,请选择
binaryAppScanner.jar
文件。生成工作区需要几秒钟的时间。这会在 IDE 的新窗口中打开您的新工作区目录。
将文件从虚拟机复制到工作区
如需将文件从虚拟机复制到 IDE 中的工作区,请执行以下步骤:
可选:
mcdc
CLI 会应用过滤条件来减小副本的大小,但您可以修改filters.txt
文件以进一步减小副本的大小。如需了解如何减小副本的大小,请参阅减小复制的文件系统的大小。按 Ctrl+Shift+P 打开命令面板。
搜索并选择 Tasks: Run Task,然后选择 m2c: Copy。 复制文件可能需要几分钟时间。
分析虚拟机文件系统并生成迁移计划
如需分析虚拟机文件系统并生成迁移计划,请执行 操作步骤:
按 Ctrl+Shift+P 打开命令面板。
搜索并选择 Tasks: Run Task,然后选择 m2c: Analyze。
如果分析任务失败,您需要修改迁移参数 通过
analyze-args.ini
文件传递。此文件中的每个参数各占一行 的随附文档。分析成功后,Cloud Code 会创建一个名为
migration-plan
的目录,其中包含以config.yaml
文件形式的分析结果。您可以修改此文件,以更改软件制品的存储方式 。config.yaml
文件的结构因迁移类型而异。如需详细了解受支持的迁移类型,请参阅以下内容 页面:
生成工件
如需生成工件,您需要在 IDE 中运行 Generate 任务。如果您尚未在上一部分中运行 Copy 和 Analyze 任务,Generate 任务会在生成工件之前自动运行这两个任务。
如需生成工件,请执行以下步骤:
按 Ctrl+Shift+P 打开命令面板。
搜索并选择 Tasks: Run Task,然后选择 m2c: Generate。 这会在
src
目录中生成工件,其中包含skaffold.yaml
文件,用于构建和部署容器映像。每个 迁移类型会生成不同的工件,但所有迁移类型通常 创建一个或多个 dockerfile 和 GKE 部署规范 由skaffold.yaml
引用。工件生成完成后,您便完成了 !
可选:如果您想修改迁移计划,请修改
config.yaml
文件并重新运行 m2c: Generate 任务。或者,如果您对更换平台效果感到满意,则可以继续 在 GKE 容器中运行应用。
在 GKE 容器中运行应用
在本部分中,您将在 GKE 容器中运行重新平台化的应用、查看正在运行的应用的日志,以及清理资源。
如果您尚未创建和配置 GKE 集群,请按照在 Cloud Code for VS Code 中创建和配置 GKE 集群中的说明操作。
如需详细了解如何调试 GKE 应用,请参阅使用 Cloud Code for VS Code 调试 Kubernetes 应用。
运行和查看应用
现在,您已完成所有设置,可以运行应用并实时查看应用了。Cloud Code 会监控您的文件系统是否有更改,以便您 实时修改并重新运行应用。
如需运行您的应用,请按以下步骤操作:
在 Cloud Code 状态栏中,点击当前项目名称。
在显示的快速选择菜单中,选择 Run on Kubernetes(在 Kubernetes 上运行)。
确认是使用当前集群上下文,还是切换到其他集群上下文。
如果出现提示,请选择要将映像推送到的映像注册表。如果您 使用
gcr.io/PROJECT_ID
创建新的映像注册表, 确保该映像注册表与您的集群位于同一项目中。系统会显示一个输出窗口,您可以在其中跟踪正在运行的应用的进度。您还会看到 显示正在运行的 Pod 的输出
应用在 Kubernetes 上运行后,输出窗口会显示 IP 地址。要使用此关联 IP 地址访问您的 应用程序,按住 Ctrl 键,然后点击地址。
调试会话启动后,开发会话窗格将显示 结构化日志记录视图任务开始后,系统会显示该任务,并显示一个旋转的半圆圈 progress_activity。
如果一项任务成功,对应步骤旁边会显示一个对勾标记 check_circle。
如需查看某个步骤的详细信息,请在开发会话窗格中点击该步骤。“输出”窗格会在日志记录输出中显示该步骤。
清理
停止应用后,此期间部署的所有 Kubernetes 资源 运行作业会自动删除
为避免系统因本快速入门中使用的其他资源向您的账号收取费用,请务必删除您创建的项目,或者删除您创建的集群(如果您想重复使用该项目)。
如需删除集群,请执行以下操作:
- 点击 Cloud Code,然后展开 Kubernetes 探索器。
- 将指针悬停在集群名称上,然后点击 open_in_new 在 Google Cloud 控制台中打开。
- 点击删除,然后再次点击删除进行确认。
如需删除项目(以及关联的资源,包括所有集群),请执行以下操作:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
如需删除在更换平台过程中创建的所有本地文件,请执行以下操作:
- 打开命令面板 (Ctrl+Shift+P)。
- 搜索并选择 Tasks: Run Task,然后选择 m2c: Cleanup。