# Referência da CLI do Enterprise Live Migrations

Informações detalhadas de uso da ELM CLI ferramenta.

## Installation

```shell
gh extension install github/gh-elm
```

A extensão requer GitHub CLI (`gh`) a versão 2.0 ou posterior.

## Comandos de instalação

| Command               | Description                                                    |
|-----------------------|----------------------------------------------------------------|
| `gh elm config`       | Configure interativamente os endpoints e tokens para usar o ELM   |
| `gh elm config reset` | Remover configuração e credenciais armazenadas                    |
| `gh elm config show`  | Mostrar a configuração atual, com tokens ocultos           |
| `gh elm completion`   | Gerar um script de preenchimento automático do shell para o shell especificado |

## Comandos de migração

| Command | Description |
|---|---|
| `gh elm migration list` | Listar migrações |
| `gh elm migration create` | Criar uma nova migração |
| `gh elm migration start MIGRATION-ID` | Iniciar uma migração criada anteriormente |
| `gh elm migration status MIGRATION-ID` | Obter o status e os detalhes de uma migração |
| `gh elm migration watch MIGRATION-ID` | Assista ao progresso da migração com uma exibição de atualização ao vivo |
| `gh elm migration pause MIGRATION-ID` | Pausar uma migração em execução |
| `gh elm migration resume MIGRATION-ID` | Retomar uma migração pausada |
| `gh elm migration cancel MIGRATION-ID` | Cancelar e encerrar uma migração |
| `gh elm migration target-id MIGRATION-ID` | Localizar o ID da migração de destino para uma migração |
| `gh elm migration cutover MIGRATION-ID` | Iniciar uma transição para o destino de uma migração |
| `gh elm migration cutover status MIGRATION-ID` | Obter o status da transição e o andamento de uma migração |
| `gh elm migration cutover revert MIGRATION-ID` | Desfazer os efeitos de uma transição para que o repositório de origem possa ser migrado novamente |

Alguns desses comandos podem ter opções adicionais. Consulte as seções posteriores neste artigo.

## Comandos alvo

| Command | Description |
| ------- | ----------- |
| `gh elm target mannequin reclaim` | Reivindicar (recuperar) um ou mais manequins na organização de destino |
| `gh elm target mannequin list` | Listar manequins de uma organização de destino como CSV |
| `gh elm target report request` | Solicitar um relatório do nó para uma migração |
| `gh elm target report status` | Verificar o status do relatório dos nós de uma migração |
| `gh elm target report url` | Obter uma URL de download assinada para um relatório concluído |
| `gh elm target resources` | Listar os recursos de uma migração no destino |
  
## `gh elm migration create` opções

Crie uma nova migração para se preparar para exportação e importação de repositório.

| Flag                  | Required | Default    | Description                                                                                                       |
|-----------------------|----------|------------|-------------------------------------------------------------------------------------------------------------------|
| `--source-org`        | Yes      | N/A        | Slug da organização de origem em GitHub Enterprise Server                               |
| `--source-repo`       | Yes      | N/A        | Nome do repositório de origem                                                                                     |
| `--target-org`        | Yes      | N/A        | Lesma da organização de destino em GHE.com                       |
| `--target-repo`       | Yes      | N/A        | Nome do repositório de destino                                                                                |
| `--target-visibility` | No       | `internal` | Visibilidade do repositório de destino. Deve ser `private` ou `internal`. Não há suporte para repositórios públicos. |
| `--start`             | No       | `false`    | Inicia automaticamente a migração depois de criá-la                                                              |
| `--json`              | No       | `false`    | Gerar a resposta JSON bruta da API em vez de texto legível por humanos                                                |

## `gh elm migration list` opções

| Flag          | Required | Default | Description                                                                                                                           |
|---------------|----------|---------|---------------------------------------------------------------------------------------------------------------------------------------|
| `--status`    | No       | N/A     | Filtra os resultados por status de migração. 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 de paginação, de uma resposta anterior                                                                                       |
| `--json`      | No       | `false` | Gerar a resposta JSON bruta da API em vez de texto legível por humanos                                                                    |

## `gh elm migration cutover` opções

| Flag             | Required | Default | Description                                                                                                                                                                              |
|------------------|----------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `--migration-id` | Yes      | N/A     | A ID de uma migração pronta para substituição.                                                                                                                                         |
| `--force`        | No       | `false` | Por padrão, o comando verifica se o alvo da migração indica prontidão antes de continuar. Use `--force` para ignorar essa verificação quando tiver certeza de que o estado de migração está correto. |
| `--watch`        | No       | `false` | Após acionar a transição, entre no modo de monitoramento em tempo real                                                                                                                                         |