# Referencia de la CLI de Enterprise Live Migrations

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

>[!NOTE] 
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, archiva 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. |