Примечание.
Enterprise Live Migrations находится в public preview процессе и может измениться.
Команды 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, заголовков и тела ответа на ошибки для каждого запроса для целей отладки |