Skip to main content

Enterprise Server 3.21 actualmente está disponible como versión candidata para lanzamiento.

Referencia de la CLI de Enterprise Live Migrations

Información detallada de uso de la herramienta CLI ELM.

Nota:

Enterprise Live Migrations está en versión preliminar pública y está sujeto a cambios.

comandos de elm migration

ComandoDescription
elm migration createCrea una nueva migración para un único repositorio de origen
elm migration start --migration-id MIGRATION-IDInicio de una migración
elm migration status --migration-id MIGRATION-IDMuestra el estado, el progreso, la preparación para la transición y el tiempo de una migración.
elm migration listEnumera todas las migraciones y sus estados
elm migration cancel --migration-id MIGRATION-IDCancela una migración en curso
elm migration cutover-to-destination --migration-id MIGRATION-IDInicia 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.

FlagObligatorioDefaultDescription
--source-orgYesN/ASlug (identificador) de la organización de origen en GitHub Enterprise Server
--source-repoYesN/ANombre del repositorio de origen
--target-orgYesN/ASlug de la organización de destino en GHE.com
--target-repoYesN/ANombre del repositorio de destino
--target-apiYesN/ALa 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

FlagObligatorioDefaultDescription
--statusNoN/AFiltra los resultados por estado de migración. Valores válidos: created, queued, in_progress``paused, completed, , failed, . terminated
--page-sizeNoN/ANúmero de resultados por página
--afterNoN/ACursor para paginación, de una respuesta anterior

elm migration cutover-to-destination Opciones

FlagObligatorioDefaultDescription
--migration-idYesN/AIdentificador de una migración lista para la transición final.
--forceNofalseDe 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.

VariableFlagObligatorioDescription
API_URL--api-urlYesDebe establecerse en http://localhost:1738.
MIGRATION_MANAGER_HMAC_KEY--migration-manager-hmac-keyYesDebe establecerse en $(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys).
MIGRATION_TARGET_URL--migration-target-urlYesLa 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. |