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

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

## Installation

```shell
gh extension install github/gh-elm
```

Для расширения требуется GitHub CLI (`gh`) версия 2.0 или более поздняя.

## Команды установки

| Command               | Описание                                                    |
|-----------------------|----------------------------------------------------------------|
| `gh elm config`       | Интерактивная настройка конечных точек и маркеров для использования ELM   |
| `gh elm config reset` | Удаление хранимой конфигурации и учетных данных                    |
| `gh elm config show`  | Отображение текущей конфигурации с маркерами, отредактированных           |
| `gh elm completion`   | Создание скрипта автозаполнения оболочки для указанной оболочки |

## Команды миграции

| Command | Описание |
|---|---|
| `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` | Поиск идентификатора целевой (целевой) миграции для миграции |
| `gh elm migration cutover MIGRATION-ID` | Запуск перехода в место назначения для миграции |
| `gh elm migration cutover status MIGRATION-ID` | Получение состояния и хода выполнения миграции |
| `gh elm migration cutover revert MIGRATION-ID` | Восстановление эффектов переключения, чтобы исходный репозиторий можно было перенести еще раз. |

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

## Целевые команды

| Command | Описание |
| ------- | ----------- |
| `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                  | Обязательный | По умолчанию    | Описание                                                                                                       |
|-----------------------|----------|------------|-------------------------------------------------------------------------------------------------------------------|
| `--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-visibility` | нет       | `internal` | Видимость репозитория назначения. Должно быть `private` или `internal`. Публичные репозитории не поддерживаются. |
| `--start`             | нет       | `false`    | После создания автоматически запускается миграция                                                              |
| `--json`              | нет       | `false`    | Вывод необработанного ответа JSON API вместо удобочитаемого текста                                                |

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

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

## `gh elm migration cutover` варианты

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