Skip to main content

企业实时迁移 命令行界面参考

ELM CLI 工具的详细使用信息。

Installation

gh extension install github/gh-elm

该扩展需要 GitHub CLI(gh)2.0 或更高版本。

安装程序命令

命令Description
gh elm config交互式配置供 ELM 使用的端点和令牌
gh elm config reset删除存储的配置和凭据
gh elm config show显示当前配置,其中令牌已隐藏
gh elm completion为指定的 Shell 生成自动补全脚本

迁移命令

命令Description
gh elm migration list迁移列表
gh elm migration create创建新的迁移
gh elm migration start MIGRATION-ID启动以前创建的迁移
gh elm migration status MIGRATION-ID获取迁移的状态和详细信息
gh elm migration watch MIGRATION-ID通过实时更新的显示查看迁移进度
gh elm migration pause MIGRATION-ID暂停运行中的迁移
gh elm migration resume MIGRATION-ID恢复暂停的迁移
gh elm migration cancel MIGRATION-ID取消和终止迁移
gh elm migration target-id MIGRATION-ID查找迁移的目标(目标)迁移 ID
gh elm migration cutover MIGRATION-ID启动向目标端的迁移切换
gh elm migration cutover status MIGRATION-ID获取迁移的切换状态和进度
gh elm migration cutover revert MIGRATION-ID撤销切换造成的影响,以便再次迁移源存储库

其中一些命令可以采用其他选项。 请参阅本文后面的部分。

目标命令

命令Description
gh elm target mannequin reclaim认领(重新认领)目标组织中的一个或多个模拟设备
gh elm target mannequin list以 CSV 格式列出目标组织的人体模型
gh elm target report request为迁移请求节点报告
gh elm target report status查询迁移节点报表的状态
gh elm target report url获取已完成报告的签名下载 URL
gh elm target resources列出目标中的迁移资源

gh elm migration create 选项

创建新的迁移以准备存储库导出和导入。

Flag必需DefaultDescription
--source-orgYesN/A源组织的 Slug GitHub Enterprise Server
--source-repoYesN/A源存储库的名称
--target-orgYesN/A目标组织在 GHE.com 的 Slug
--target-repoYesN/A目标存储库的名称
--target-visibilityinternal目标存储库的可见性。 必须是 privateinternal。 不支持公共存储库。
--startfalse创建迁移后,迁移会自动启动。
--jsonfalse输出 API 的原始 JSON 响应,而不是人工可读文本

gh elm migration list 选项

Flag必需DefaultDescription
--statusN/A按迁移状态筛选结果。 有效值:created、、queuedin_progress``pausedcompletedfailedterminated
--page-sizeN/A每页结果数
--afterN/A来自先前响应的分页游标
--jsonfalse输出 API 的原始 JSON 响应,而不是人工可读文本

gh elm migration cutover 选项

Flag必需DefaultDescription
--migration-idYesN/A已准备好进行最终切换的迁移的 ID。
--forcefalse默认情况下,该命令会检查迁移目标在继续之前是否报告就绪情况。 用于 --force 在确定迁移状态正确时绕过此检查。
--watchfalse触发切换后,进入实时监控模式