migctl 参考文档

migctl 命令行工具用于在 Google Cloud 上设置和管理 Migrate for Anthos 迁移环境。migctlCloud Shell 中可用。

如需了解关键 migctl 命令的分步介绍以及如何进行简单迁移,请参阅快速入门

migctl

命令 说明
完成 生成 bash 完成脚本
医生 检查 Migrate for Anthos 部署状态和相关配置
帮助 关于任何命令的帮助
迁移 迁移操作。
设置 安装或卸载 Migrate for Anthos
源代码 管理对迁移来源的引用。
版本 打印 Migrate for Anthos 和 migctl 的版本

摘要

migctl [-h]

标志

-h, --help
关于此命令的帮助。

备注

migctl 包含在 Cloud Shell 中

migctl 完成

生成 bash 完成脚本。

要加载完成,请运行 . <(migctl completion bash)

要将 bash shell 配置为为每个会话加载完成,请将以下代码添加到您的 〜/.bashrc 或〜/.profile:. <(migctl completion bash)

摘要

migctl completion {bash | zsh}

位置参数

{bash | zsh}
要使用的 shell。

标志

-h, --help
关于此命令的帮助。

migctl 医生

检查 Migrate for Anthos 部署状态和相关配置。

摘要

migctl doctor

标志

-h, --help
关于此命令的帮助。

另请参阅

安装 Migrate for Anthos

示例

对进行 Migrate for Anthos 部署的响应。

migctl doctor
[✓] Deployment

migctl 帮助

提供关于 migctl 工具的帮助。

如需了解关于某命令的详细信息,请使用“migctl [命令] -帮助”。

摘要

migctl help

标志

-h, --help
关于此命令的帮助。

migctl 迁移

命令 说明
迁移创建 创建迁移计划。
迁移删除 删除迁移方案。
迁移生成工件 为给定迁移创建工件。
迁移获取 获取迁移计划规范。
迁移获取工件 获取迁移工件,例如 Deployment/StatefulSet 规范 YAML 和 Dockerfile。
迁移列表 列表迁移。
迁移状态 获取迁移计划状态。
迁移更新 更新迁移计划。

migctl 迁移创建

创建迁移计划。

迁移计划会定义迁移的具体细节,包括源平台、虚拟机 ID、项目名称等。

生成的迁移计划文件会被复制到运行该命令的机器,而不会应用到处理集群。如果需要,您可以先修改文件,然后再用于迁移。

摘要

migctl migration create migration-name --source source-name --vm-id source-vm-id [--intent {ImageAndData | Image | Data}]  [--os-type type] [--no-comments] [--project project-name] [--zone source-vm-zone]

位置参数

migration-name
此迁移的名称。

标志

-i, --intent {ImageAndData | Image | Data}
要迁移的虚拟机的方面。
--no-comments
生成不带评论的 YAML 文件。
--os-type type
将操作系统指定为 Linux(默认)或 Windows
-p, --project project-name
替换默认 Compute Engine 来源虚拟机项目。
-s, --source source-name
使用 migctl source create 创建的来源的名称。
-v, --vm-id source-vm-id
来源虚拟机 ID。此值的形式取决于 source-name 中指定的来源平台。有关详情,请参阅命令示例。
-z, --zone source-vm-zone
替换默认 Compute Engine 来源虚拟机地区。
-h, --help
关于此命令的帮助。

示例

为 Compute Engine 虚拟机创建迁移计划,用于创建映像和导出数据卷。

migctl migration create --source my-ce-src --vm-id my-id --intent ImageAndData

创建针对 VMware 虚拟机的迁移计划以创建映像。

migctl migration create --source my-vmware-src --vm-id My_VMware_VM --intent Image

为 AWS 虚拟机创建迁移方案以导出数据卷。

migctl migration create --source my-aws-src --vm-id i-1234567890abcdef0 --intent Data

另请参阅

创建迁移

migctl 迁移删除

删除迁移方案。

此命令会删除用 migctl migration create 创建的迁移。

摘要

migctl migration delete migration-name

位置参数

migration-name
要删除的迁移的名称。

标志

-h, --help
关于此命令的帮助。

migctl 迁移工件

为给定迁移创建工件。

例如,此命令会创建映像、数据卷、Dockerfile、部署 YAML 等。

摘要

migctl migration generate-artifacts migration-name

位置参数

migration-name
要为其创建工件的迁移的名称。

标志

-h, --help
关于此命令的帮助。

另请参阅

执行迁移

migctl 迁移获取

获取迁移计划规范。

摘要

migctl migration get migration-name  [--output-file migration-yaml-file]

位置参数

migration-name
要获取其计划的迁移的名称。

标志

--output-file migration-yaml-file
输出迁移计划规范的 YAML 文件。
-h, --help
关于此命令的帮助。

migctl 迁移获取工件

获取迁移工件,例如 Deployment/StatefulSet 规范 YAML 和 Dockerfile。

摘要

migctl migration get-artifacts migration-name [--output-directory directory-path] [--overwrite]

位置参数

migration-name
要获取工件的迁移。

标志

--output-directory directory-path
输出目录路径。默认值为“.”
--overwrite
覆盖现有本地文件。
-h, --help
关于此命令的帮助。

另请参阅

检查已生成的部署文件

migctl 迁移列表

列表迁移。

摘要

migctl migration list [--all-namespaces] [--watch]

标志

-A, --all-namespaces
列出所有命名空间的迁移。
-w, --watch
注意更改。
-h, --help
关于此命令的帮助。

另请参阅

监控迁移

migctl 迁移状态

获取迁移计划状态。

摘要

migctl migration status migration-name  [--verbose] [--watch]

位置参数

migration-name
要获取状态的迁移名称。

标志

-v, --verbose
详细程度状态。
-w, --watch
注意更改。
-h, --help
关于此命令的帮助。

另请参阅

监控迁移

migctl 迁移更新

更新迁移计划。

摘要

migctl migration update migration-name --file yaml-filename

位置参数

migration-name
要更新的迁移的名称。

标志

--file yaml-filename
YAML 文件(包含已更新的迁移计划)。
-h, --help
关于此命令的帮助。

另请参阅

监控迁移

migctl 设置

命令 说明
设置安装 在当前集群上安装 Migrate for Anthos。
设置 uinstall 从集群中卸载 Migrate for Anthos。

migctl 设置安装

在当前集群上安装 Migrate for Anthos。

摘要

migctl setup install [--cos-runtime] [--gkeop --json-key service-account-json] [--node-selectors string] [--tolerations string] [--version version-number]

标志

--cos-runtime
在具有 Container-Optimized OS 节点的工作负载集群上安装运行时支持。
--gkeop
为 GKE On-Prem 安装 Migrate for Anthos。
--json-key service-account-json
具备为 GKE On-Prem 安装 Migrate for Anthos 所必需权限的服务帐号的 JSON 密钥文件。如需了解详情,请参阅为本地迁移创建服务帐号
--node-selectors string
Migrate for Anthos 部署的组件的节点选择器,形式为:LABEL1=VALUE1,LABEL2=VALUE2,....。如需了解详情,请参阅安装选项
--tolerations string
Migrate for Anthos 部署的组件的容忍设置,形式为:KEY1=VALUE1:EFFECT1,KEY2=VALUE2:EFFECT2,....。如需了解详情,请参阅安装选项
--version version-number
要安装的 Migrate for Anthos 版本。
-h, --help
关于此命令的帮助。

示例

在处理集群上安装 Migrate for Anthos。

migctl setup install

在具有 COS 节点的工作负载集群上安装运行时支持。

migctl setup install --cos-runtime

另请参阅

安装 Migrate for Anthos

migctl 设置卸载

从集群中卸载 Migrate for Anthos。

摘要

migctl setup uninstall [-f]

标志

-f
在迁移过程中强制卸载。
-h, --help
关于此命令的帮助。

示例

卸载 Migrate for Anthos。

migctl setup uninstall

在迁移过程中强制卸载 Migrate for Anthos。

migctl setup uninstall --force

另请参阅

卸载 Migrate for Anthos

migctl 来源

执行与迁移来源相关的操作。

命令 说明
来源创建 将迁移来源添加到处理集群。
来源删除 从处理集群中删除迁移源。
来源列表 列出处理集群中的迁移来源配置。

migctl 来源创建

将迁移来源添加到处理集群。

命令 说明
来源创建 aws 将 AWS 作为迁移来源添加到处理集群。
来源创建 azure 将 Azure 作为迁移来源添加到处理集群。
来源创建 ce 将 Compute Engine 添加为迁移来源。
来源创建 local-vmware 将 VMware 作为迁移来源添加到本地处理集群。
来源创建 vmware 将 VMware 作为迁移来源添加到处理集群。

另请参阅

添加迁移来源

migctl 来源创建 aws

将 AWS 作为迁移来源添加到处理集群。

摘要

migctl source create aws name --cloud-details cloud-details --manager-address manager-address --cloud-extension cloud-extension

标志

-d, --cloud-details
在 Migrate for Compute Engine 中配置的来源的 Cloud Details 名称
--cloud-extension
Migrate for Compute Engine Cloud Extension 的 ID 或名称
--manager-address
Migrate for Compute Engine(以前称为 Velostrata)管理器服务器的地址
-h, --help
关于此命令的帮助。

示例

将 AWS 添加为迁移来源。

migctl source create aws my-aws-src--manager-address 1.2.3.4 --cloud-extension my-cloud-extension --cloud-details my-aws-cloud-details

另请参阅

添加迁移来源

migctl 来源创建 azure

将 Azure 作为迁移来源添加到处理集群。

摘要

migctl source create azure name --cloud-details cloud-details --manager-address manager-address --cloud-extension cloud-extension

位置参数

name
提供来源的名称。

标志

-d, --cloud-details cloud-details
在 Migrate for Compute Engine 中配置的来源的 Cloud Details 名称
--cloud-extension cloud-extension
Migrate for Compute Engine Cloud Extension 的 ID 或名称
--manager-address manager-address
Migrate for Compute Engine(以前称为 Velostrata)管理器服务器的地址
-h, --help
关于此命令的帮助。

示例

将 Azure 添加为迁移来源。

migctl source create azure my-azure-src--manager-address 1.2.3.4 --cloud-extension my-cloud-extension --cloud-details my-azure-cloud-details

另请参阅

添加迁移来源

migctl 来源创建 ce

将 Compute Engine 添加为迁移到处理集群。

摘要

migctl source create ce name --project project [--json-key service-account-json ]

位置参数

name
提供来源的名称。

标志

--project project
Compute Engine 来源类型的默认项目。
--json-key service-account-json
用于创建 Compute Engine 来源的服务帐号的 JSON 密钥文件。如需了解详情,请参阅创建服务帐号以将 Compute Engine 用作迁移来源
-h, --help
关于此命令的帮助。

示例

将 Compute Engine 添加为迁移来源。

migctl source create ce my-ce-src --project myproject --zone us-west1-a

另请参阅

添加迁移来源

migctl 来源创建 local-vmware

将 VMware 作为迁移来源添加到本地处理集群。

摘要

migctl source create local-vmware name --vc vcenter --user user --password pass
[flags]

位置参数

name
提供来源的名称。

标志

--vc host
指定 vCenter DNS 名称或 vCenter IP 地址。
--username user
有权访问 vCenter 的用户的名称。
--password pass
有权访问 vCenter 的用户的密码。
-h, --help
关于此命令的帮助。

示例

将 VMware 添加为迁移来源。

migctl source create local-vmware local-vmware-src --vc '1.2.3.4' --username 'admin' --password 'pass1'

另请参阅

添加迁移来源

migctl 来源创建 vmware

将 VMware 作为迁移来源添加到处理集群。

摘要

migctl source create vmware name --manager-address manager-ip --cloud-extension extension-name

位置参数

name
提供来源的名称。

标志

--cloud-extension extension-name
Migrate for Compute Engine Cloud Extension 的 ID 或名称。
--manager-address manager-ip
Migrate for Compute Engine 管理服务器的地址
-h, --help
关于此命令的帮助。

示例

将 VMware 添加为迁移来源。

migctl source create vmware my-vmware-src --manager-address 1.2.3.4 --cloud-extension my-cloud-extension

另请参阅

添加迁移来源

migctl 来源删除

从处理集群中删除迁移源。

摘要

migctl source delete source-name [-f]

位置参数

source-name
要删除的来源的名称。这是您在使用 migctl source create 创建来源时指定的名称。

标志

-f
忽略错误并强制删除。
-h, --help
关于此命令的帮助。

示例

删除迁移来源。

migctl source delete my-source

尝试强行删除来源。

migctl source delete my-source -f

migctl 来源列表

列出处理集群中的迁移来源配置。

摘要

migctl source list

标志

-h, --help
关于此命令的帮助。

migctl 版本

打印 Migrate for Anthos 和 migctl 的版本。

摘要

migctl version

标志

-h, --help
关于此命令的帮助。