# Справочник CLI Enterprise Live Migrations

Подробная информация об использовании инструмента ELM CLI.

>[!NOTE] 
Enterprise Live Migrations находится в Публичный предварительный просмотр процессе и может измениться.

## Команды `elm migration`.

| Command | Описание |
|---|---|
| `elm migration create` | Создаёт новую миграцию для одного исходного репозитория |
| `elm migration start --migration-id MIGRATION-ID` | Начинает миграцию |
| `elm migration status --migration-id MIGRATION-ID` | Показывает статус, прогресс, готовность к пересечению и время перехода |
| `elm migration list` | Список всех миграций и их статусов |
| `elm migration cancel --migration-id MIGRATION-ID` | Отменяет миграцию в процессе |
| `elm migration cutover-to-destination --migration-id MIGRATION-ID` | Запускает финальный переход, архивирует исходный репозиторий и завершает миграцию |

Некоторые из этих команд могут принимать дополнительные варианты. См. последующие разделы этой статьи.

## `elm migration create` варианты

Создайте новую миграцию для подготовки к экспорту и импорту репозиторий.

| Flag | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| `--source-org` | Yes | N/A | Слаг исходной организации на GitHub Enterprise Server |
| `--source-repo` | Yes | N/A | Название исходного репозитория |
| `--target-org` | Yes | N/A | Slug организации назначения на GHE.com |
| `--target-repo` | Yes | N/A | Название репозитория назначения |
| `--target-api` | Yes | N/A | URL API для вашего целевого предприятия (например: `https://api.octocorp.ghe.com`). 
**Не** указывайте слэш в конце URL. |
| `--pat-name` | Yes | N/A | Это должно быть установлено в статическую строку: `system-pat` |
| `--target-visibility` | нет | `internal` | Видимость репозитория назначения. Должно быть `private` или `internal`. Публичные репозитории не поддерживаются. |
| `--start` | нет | `false` | После создания автоматически запускается миграция |

## `elm migration list` варианты

| Flag | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| `--status` | нет | N/A | Результаты фильтрует по статусу миграции. Допустимые значения: `created`, , `queued``in_progress``paused`, `completed`, `failed`. `terminated` |
| `--page-size` | нет | N/A | Количество результатов на странице |
| `--after` | нет | N/A | Курсор для пагинации, из предыдущего ответа |

## `elm migration cutover-to-destination` варианты

| Flag | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| `--migration-id` | Yes | N/A | ID миграции, готовой к переходу. |
| `--force` | нет | `false` | По умолчанию команда проверяет, сообщает ли цель миграции о готовности перед выполнением действия. Используйте `--force` обойти эту проверку, когда уверены, что состояние миграции правильное. |

## Глобальные флаги и переменные

Следующие свойства могут быть предоставлены либо в виде переменных среды, либо как флаги для любой команды, при этом флаги команд имеют приоритет. Эти значения _нужно установить после_ применения `ghe-config` конфигурации.

| Variable | Flag | Обязательный | Описание |
|----------|------|----------|-------------|
| API_URL | `--api-url` | Yes | Необходимо задать значение `http://localhost:1738`. |
| MIGRATION_MANAGER_HMAC_KEY | `--migration-manager-hmac-key` | Yes | Необходимо задать значение `$(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys)`. |
| MIGRATION_TARGET_URL | `--migration-target-url` | Yes | URL API для вашего целевого предприятия (например: `https://api.octocorp.ghe.com`). 
**Не** указывайте слэш в конце URL. |
| MIGRATION_TARGET_TOKEN | `--migration-target-token` | Yes | Фор personal access token (classic)GHE.com |
| DEBUG_HTTP | `--debug-http` | нет | Настройте на `true` печать HTTP-метода, URL, заголовков и тела ответа на ошибки для каждого запроса для целей отладки |