Skip to main content

Referência da CLI do Enterprise Live Migrations

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

Installation

gh extension install github/gh-elm

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

Comandos de instalação

ComandoDescrição
gh elm configConfigure interativamente os endpoints e tokens para usar o ELM
gh elm config resetRemover configuração e credenciais armazenadas
gh elm config showMostrar a configuração atual, com tokens ocultos
gh elm completionGerar um script de preenchimento automático do shell para o shell especificado

Comandos de migração

ComandoDescrição
gh elm migration listListar migrações
gh elm migration createCriar uma nova migração
gh elm migration start MIGRATION-IDIniciar uma migração criada anteriormente
gh elm migration status MIGRATION-IDObter o status e os detalhes de uma migração
gh elm migration watch MIGRATION-IDAssista ao progresso da migração com uma exibição de atualização ao vivo
gh elm migration pause MIGRATION-IDPausar uma migração em execução
gh elm migration resume MIGRATION-IDRetomar uma migração pausada
gh elm migration cancel MIGRATION-IDCancelar e encerrar uma migração
gh elm migration target-id MIGRATION-IDLocalizar o ID da migração de destino para uma migração
gh elm migration cutover MIGRATION-IDIniciar uma transição para o destino de uma migração
gh elm migration cutover status MIGRATION-IDObter o status da transição e o andamento de uma migração
gh elm migration cutover revert MIGRATION-IDDesfazer 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

ComandoDescrição
gh elm target mannequin reclaimReivindicar (recuperar) um ou mais manequins na organização de destino
gh elm target mannequin listListar manequins de uma organização de destino como CSV
gh elm target report requestSolicitar um relatório do nó para uma migração
gh elm target report statusVerificar o status do relatório dos nós de uma migração
gh elm target report urlObter uma URL de download assinada para um relatório concluído
gh elm target resourcesListar 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.

FlagObrigatórioDefaultDescrição
--source-orgYesN/ASlug da organização de origem em GitHub Enterprise Server
--source-repoYesN/ANome do repositório de origem
--target-orgYesN/ALesma da organização de destino em GHE.com
--target-repoYesN/ANome do repositório de destino
--target-visibilityNãointernalVisibilidade do repositório de destino. Deve ser private ou internal. Não há suporte para repositórios públicos.
--startNãofalseInicia automaticamente a migração depois de criá-la
--jsonNãofalseGerar a resposta JSON bruta da API em vez de texto legível por humanos

gh elm migration list opções

FlagObrigatórioDefaultDescrição
--statusNãoN/AFiltra os resultados por status de migração. Valores válidos: created, , queued, in_progress, paused, completed, , failed, terminated.
--page-sizeNãoN/ANúmero de resultados por página
--afterNãoN/ACursor de paginação, de uma resposta anterior
--jsonNãofalseGerar a resposta JSON bruta da API em vez de texto legível por humanos

gh elm migration cutover opções

FlagObrigatórioDefaultDescrição
--migration-idYesN/AA ID de uma migração pronta para substituição.
--forceNãofalsePor 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.
--watchNãofalseApós acionar a transição, entre no modo de monitoramento em tempo real