Skip to main content

Referencia de la CLI de Enterprise Live Migrations

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

Installation

gh extension install github/gh-elm

La extensión requiere GitHub CLI (gh) versión 2.0 o posterior.

Comandos de instalación

ComandoDescription
gh elm configConfiguración interactiva de los puntos de conexión y tokens para el uso de ELM
gh elm config resetEliminación de la configuración almacenada y las credenciales
gh elm config showMostrar la configuración actual, con tokens censurados
gh elm completionGeneración de un script de autocompletación de shell para el shell especificado

Comandos de migración

ComandoDescription
gh elm migration listEnumerar migraciones
gh elm migration createCrear una nueva migración
gh elm migration start MIGRATION-IDInicio de una migración creada anteriormente
gh elm migration status MIGRATION-IDObtener el estado y los detalles de una migración
gh elm migration watch MIGRATION-IDVisualización del progreso de la migración con una pantalla de actualización en vivo
gh elm migration pause MIGRATION-IDPausar una migración en ejecución
gh elm migration resume MIGRATION-IDReanudación de una migración en pausa
gh elm migration cancel MIGRATION-IDCancelar y finalizar una migración
gh elm migration target-id MIGRATION-IDBuscar el identificador de la migración de destino para una migración
gh elm migration cutover MIGRATION-IDIniciar una transición al destino de una migración
gh elm migration cutover status MIGRATION-IDObtener el estado del cambio de producción y el progreso de una migración
gh elm migration cutover revert MIGRATION-IDDeshacer los efectos de un cambio de sistema para que el repositorio de origen pueda migrarse de nuevo.

Algunos de estos comandos pueden tomar opciones adicionales. Consulte las secciones posteriores de este artículo.

Comandos de destino

ComandoDescription
gh elm target mannequin reclaimReclamar (volver a reclamar) uno o más maniquíes de la organización de destino
gh elm target mannequin listEnumerar los mannequines de una organización de destino como CSV
gh elm target report requestSolicitud de un informe de nodo para una migración
gh elm target report statusConsultar el estado del informe del nodo de una migración
gh elm target report urlObtener una dirección URL de descarga firmada para un informe finalizado
gh elm target resourcesEnumeración de los recursos de una migración desde el destino

gh 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-visibilityNointernalVisibilidad del repositorio de destino. Debe ser private o internal. No se admiten repositorios públicos.
--startNofalseInicia automáticamente la migración después de crearla
--jsonNofalseMostrar la respuesta JSON en bruto de la API en lugar de texto legible para humanos

gh 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
--jsonNofalseMuestra la respuesta JSON sin procesar de la API en lugar de texto legible para humanos

gh elm migration cutover 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.
--watchNofalseDespués de activar la conmutación, entre en el modo de supervisión en tiempo real.