Nota:
Enterprise Live Migrations está en versión preliminar pública y está sujeto a cambios.
comandos de elm migration
| Comando | Description |
|---|---|
elm migration create | Crea una nueva migración para un único repositorio de origen |
elm migration start --migration-id MIGRATION-ID | Inicio de una migración |
elm migration status --migration-id MIGRATION-ID | Muestra el estado, el progreso, la preparación para la transición y el tiempo de una migración. |
elm migration list | Enumera todas las migraciones y sus estados |
elm migration cancel --migration-id MIGRATION-ID | Cancela una migración en curso |
elm migration cutover-to-destination --migration-id MIGRATION-ID | Inicia la migración final, bloquea el repositorio de origen y completa la migración. |
Algunos de estos comandos pueden tomar opciones adicionales. Consulte las secciones posteriores de este artículo.
`elm migration create` Opciones
Cree una nueva migración para preparar la exportación e importación del repositorio.
| Flag | Obligatorio | Default | Description |
|---|---|---|---|
--source-org | Yes | N/A | Slug (identificador) de la organización de origen en GitHub Enterprise Server |
--source-repo | Yes | N/A | Nombre del repositorio de origen |
--target-org | Yes | N/A | Slug de la organización de destino en GHE.com |
--target-repo | Yes | N/A | Nombre del repositorio de destino |
--target-api | Yes | N/A | La dirección URL de API de la empresa de destino (por ejemplo: https://api.octocorp.ghe.com). |
**No** incluya una barra diagonal final al final de la dirección URL. |
| --pat-name | Yes | N/A | Debe establecerse en una cadena estática: system-pat |
| --target-visibility | No | internal | Visibilidad del repositorio de destino. Debe ser private o internal. No se admiten repositorios públicos. |
| --start | No | false | Inicia automáticamente la migración después de crearla |
`elm migration list` Opciones
| Flag | Obligatorio | Default | Description |
|---|---|---|---|
--status | No | N/A | Filtra los resultados por estado de migración. Valores válidos: created, queued, in_progress``paused, completed, , failed, . terminated |
--page-size | No | N/A | Número de resultados por página |
--after | No | N/A | Cursor para paginación, de una respuesta anterior |
`elm migration cutover-to-destination` Opciones
| Flag | Obligatorio | Default | Description |
|---|---|---|---|
--migration-id | Yes | N/A | Identificador de una migración lista para la transición final. |
--force | No | false | De forma predeterminada, el comando verifica si el objetivo de la migración indica estar listo antes de continuar. Use --force para omitir esta comprobación cuando esté seguro de que el estado de migración es correcto. |
Marcas globales y variables
Las siguientes propiedades se pueden proporcionar como variables de entorno o como marcas en cualquier comando, con marcas de comandos que tienen prioridad. Debe establecer estos valores después de aplicar la ghe-config configuración.
| Variable | Flag | Obligatorio | Description |
|---|---|---|---|
| API_URL | --api-url | Yes | Debe establecerse en http://localhost:1738. |
| MIGRATION_MANAGER_HMAC_KEY | --migration-manager-hmac-key | Yes | Debe establecerse en $(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys). |
| MIGRATION_TARGET_URL | --migration-target-url | Yes | La dirección URL de API de la empresa de destino (por ejemplo: https://api.octocorp.ghe.com). |
**No** incluya una barra diagonal final al final de la dirección URL. |
| MIGRATION_TARGET_TOKEN | --migration-target-token | Yes | personal access token (classic) para GHE.com |
| DEBUG_HTTP | --debug-http | No | Establézcalo en true para imprimir el método HTTP, la dirección URL, los encabezados y el cuerpo de la respuesta de error para cada solicitud, con fines de depuración. |