{"meta":{"title":"企业实时迁移 命令行界面参考","intro":"CLI 工具的详细使用信息 ELM CLI 。","product":"迁移","breadcrumbs":[{"href":"/zh/enterprise-server@3.19/migrations","title":"迁移"},{"href":"/zh/enterprise-server@3.19/migrations/elm","title":"实时迁移（GHES 到 GHE.com）"},{"href":"/zh/enterprise-server@3.19/migrations/elm/elm-cli-reference","title":"ELM CLI 参考"}],"documentType":"article"},"body":"# 企业实时迁移 命令行界面参考\n\nCLI 工具的详细使用信息 ELM CLI 。\n\n>[!NOTE] \nEnterprise Live Migrations 位于 公开预览，可能会有变动。\n\n## `elm migration` 命令\n\n| 命令 | Description |\n|---|---|\n| `elm migration create` | 为单个源存储库创建新迁移 |\n| `elm migration start --migration-id MIGRATION-ID` | 开始迁移 |\n| `elm migration status --migration-id MIGRATION-ID` | 显示迁移的状态、进度、切换准备情况和时间安排 |\n| `elm migration list` | 列出所有迁移及其状态 |\n| `elm migration cancel --migration-id MIGRATION-ID` | 取消正在进行的迁移 |\n| `elm migration cutover-to-destination --migration-id MIGRATION-ID` | 启动最终切换，归档源存储库并完成迁移 |\n\n其中一些命令可以采用其他选项。 请参阅本文后面的部分。\n\n## `elm migration create` 选项\n\n创建新的迁移以准备存储库导出和导入。\n\n| Flag | 必需 | Default | Description |\n|---|---|---|---|\n| `--source-org` | Yes | N/A | 源组织的 Slug GitHub Enterprise Server |\n| `--source-repo` | Yes | N/A | 源存储库的名称 |\n| `--target-org` | Yes | N/A | 目标组织在 GHE.com 的 Slug |\n| `--target-repo` | Yes | N/A | 目标存储库的名称 |\n| `--target-api` | Yes | N/A | 目标企业的 API URL（例如： `https://api.octocorp.ghe.com`） 。 \n**不要**在 URL 的末尾包含尾部斜杠。 |\n| `--pat-name` | Yes | N/A | 这必须设置为静态字符串： `system-pat` |\n| `--target-visibility` | 否 | `internal` | 目标存储库的可见性。 必须是 `private` 或 `internal`。 不支持公共存储库。 |\n| `--start` | 否 | `false` | 创建迁移后，迁移会自动启动。 |\n\n## `elm migration list` 选项\n\n| Flag | 必需 | Default | Description |\n|---|---|---|---|\n| `--status` | 否 | N/A | 按迁移状态筛选结果。 有效值：`created`、、`queued`、`in_progress``paused`、`completed`、`failed`。 `terminated` |\n| `--page-size` | 否 | N/A | 每页结果数 |\n| `--after` | 否 | N/A | 来自先前响应的分页游标 |\n\n## `elm migration cutover-to-destination` 选项\n\n| Flag | 必需 | Default | Description |\n|---|---|---|---|\n| `--migration-id` | Yes | N/A | 已准备好进行最终切换的迁移的 ID。 |\n| `--force` | 否 | `false` | 默认情况下，该命令会检查迁移目标在继续之前是否报告就绪情况。 用于 `--force` 在确定迁移状态正确时绕过此检查。 |\n\n## 全局标志和变量\n\n可以将以下属性作为环境变量或任何命令上的标志提供，命令标志具有优先级。 应用__ 配置`ghe-config`，应设置这些值。\n\n| 可变 | Flag | 必需 | Description |\n|----------|------|----------|-------------|\n| API_URL | `--api-url` | Yes | 必须设置为 `http://localhost:1738`。 |\n| MIGRATION_MANAGER_HMAC_KEY | `--migration-manager-hmac-key` | Yes | 必须设置为 `$（ghe-config secrets.elm-exporter.elm-exporter-hmac-keys）`。 |\n| MIGRATION_TARGET_URL | `--migration-target-url` | Yes | 目标企业的 API URL（例如： `https://api.octocorp.ghe.com`） 。 \n**不要**在 URL 的末尾包含尾部斜杠。 |\n| 迁移目标标记 (MIGRATION_TARGET_TOKEN) | `--migration-target-token` | Yes | for personal access token (classic)GHE.com |\n| DEBUG_HTTP | `--debug-http` | 否 | 设置为 `true` 打印每个请求的 HTTP 方法、URL、标头和错误响应正文，以便进行调试 |"}