Referência de CLI Enterprise Live Migrations (ELM)

Serviços de DevOps do Azure

Este artigo lista os comandos e parâmetros da CLI do Azure DevOps que utiliza para executar Migrações Empresariais ao Vivo (ELM), juntamente com os valores de estado e estágio que a CLI devolve durante uma migração.

Comandos

Comandos de migração

Comando Parâmetros necessários Parâmetros opcionais HTTP Description
list --org --project, --include-all, --detect GET Lista as migrações. Por defeito, a CLI devolve apenas a migração ativa para cada repositório. Uso --include-all para incluir migrações concluídas, falhadas e suspensas.
status --org, --repository-id --detect GET Obtenha o estado detalhado de uma migração.
create --org, --repository-id, --target-repository, --agent-pool --target-owner-user-id, --service-endpoint-id, --github-token--validate-only, , --cutover-date, , --skip-validation--enable-boards-github-connection--enable-auto-discover-pipelines--pipeline-service-connection-id--detect POST Crie uma nova migração. Se não passares --service-endpoint-id, a CLI verifica ELM_GITHUB_TOKEN e depois executa o fluxo de dispositivos do GitHub para autenticar no destino.
pause --org, --repository-id --detect PUT Pausa uma migração ativa.
resume --org, --repository-id --validate-only, --migration, --detect PUT Retomar uma migração interrompida.
cutover set --org, --repository-id, --date --detect PUT Marque uma data e hora para o turnover. O valor deve estar no futuro.
cutover cancel --org, --repository-id --detect PUT Cancela um turnover agendado. Válido apenas enquanto o estágio for Synchronization; rejeitado uma vez que o estágio avança para Cutover. Envia o DateTimeOffset.MinValue sentinela (0001-01-01T00:00:00+00:00) porque o servidor ignora null para scheduledCutoverDate.
cutover review --org, --repository-id --detect GET Liste itens não processados e requisitos de verificação de pipeline à espera de aprovação.
cutover approve --org, --repository-id --accept-failures, --pipelines-verified, --detect PUT Aprove o cutover aceitando itens não processados e/ou verificando pipelines reconfigurados. Forneça pelo menos um de --accept-failures ou --pipelines-verified. Irreversível — sem revogar API; Recuperar com abandon + Recriar.
abandon --org, --repository-id --remove-read-only, --yes, --detect DELETE Abandonar uma migração. O registo de migração não é apagado e os dados de reconfiguração do pipeline são mantidos, por isso uma migração posterior pode reutilizá-los. Pedidos de confirmação, a menos que passes --yes.

Comandos de reconfiguração de pipeline (pré-visualização)

A reconfiguração de pipelines reaponta pipelines que referenciam o repositório Repositórios do Azure de origem no repositório GitHub migrado. A reconfiguração está sempre disponível para uma migração, em dois modos:

  • Descoberta automática — passe --enable-auto-discover-pipelines em conjunto com --pipeline-service-connection-id em create. O trabalho de sincronização ELM percorre o repositório de origem e cria definições clones para cada pipeline que o referencia.
  • Manual — inscrever pipelines específicos após create com pipelines submit. Pode misturar ambos os modos e ajustar a inscrição a qualquer momento com pipelines update.
Comando Parâmetros necessários Parâmetros opcionais HTTP Description
pipelines list --org, --repository-id --detect GET Liste a configuração da reinstalação de fiação do oleoduto e o estado por pipeline.
pipelines submit --org, --repository-id, --pipeline-ids --service-connection-id, --repository-mapping, --detect POST Inscreva pipelines específicos para reconfiguração elétrica.
pipelines update --org, --repository-id --add-ids, --remove-ids, --retry-ids, --service-connection-id, --repository-mapping, --detect PUT Adicionar, remover, tentar novamente ou alterar a ligação de serviço em massa para pipelines inscritos. É necessário pelo menos um flag de atualização.
pipelines retry --org, --repository-id, --pipeline-ids --detect PUT Retentar entradas de reconfiguração do pipeline falhadas.
pipelines delete --org, --repository-id, --migration-id --yes, --detect DELETE Apague os dados de reconfiguração do pipeline (configurações e definições clonadas) para uma migração. Use isto para limpar dados de reconfiguração caso tenha falhado a migração; abandon Sozinho não o remove.

Detalhes dos parâmetros

Parâmetro Tipo Usado por Description
--org URL All Azure DevOps URL da organização, por exemplo https://dev.azure.com/<org>. Defina este valor como padrão.
--repository-id GUID Todos, exceto list Repositórios do Azure repository GUID. Obtenha o valor de az repos show --query id. As migrações são identificadas apenas por repositoryId — a resposta da API não tem um campo separado de ID de migração, podendo haver, no máximo, uma migração ativa por repositório.
--target-repository URL create URL do repositório alvo, por https://<enterprise>.ghe.com/<org>/<repo>exemplo. Deve começar por http:// ou https://. O servidor valida este valor.
--target-owner-user-id cadeia (de caracteres) create ID de utilizador do GitHub (handle) do proprietário do repositório alvo. Descontinuado e ignorado quando a resolução do proprietário baseada em tokens do lado do servidor está ativada.
--service-endpoint-id GUID create Optional. ID de ligação do serviço Azure DevOps para a ligação GitHub Enterprise Server usada para sincronizar commits com o destino. Quando definido, o fluxo de dispositivos do GitHub é ignorado. Independentemente da verificação de identidade do utilizador — pode continuar a fornecer --github-token ou ELM_GITHUB_TOKEN a acompanhar.
--github-token cadeia (de caracteres) create Token de utilizador GitHub opcional (ou PAT) para verificação de identidade de utilizador no host de destino. Se for omitida e --service-endpoint-id não for fornecida, a CLI verifica ELM_GITHUB_TOKEN e depois executa o fluxo do dispositivo no GitHub.
--agent-pool cadeia (de caracteres) create Nome do grupo de agentes para trabalho de migração.
--validate-only sinalizador create, resume Ligado create: apenas fazer verificações pré-migração. Ligado: mudar resumepara modo apenas de validação. Os resultados apenas de validação expiram 24 horas após o sucesso da execução; Inicie (ou promova para) a migração completa dentro dessa janela.
--migration sinalizador resume Promova uma execução bem-sucedida apenas validada para uma migração completa (conjuntos validateOnly=false e statusRequested=active). Só é válido quando a sequência anterior apenas validada terminou com status: Succeeded. Mutuamente exclusivo com --validate-only.
--cutover-date Certificação ISO 8601 create Pré-agendar o corte na altura da criação, por 2030-12-31T11:59:00Zexemplo.
--date Certificação ISO 8601 cutover set Agende a data e hora do corte, 2030-12-31T11:59:00Zpor exemplo. Deve ser no futuro.
--skip-validation cadeia (de caracteres) create Recomendamos vivamente que evite este parâmetro porque aumenta significativamente o risco de falha da migração, conforme explicado na Introdução às Migrações Empresariais em Vivo (ELM). Lista separada por vírgulas de nomes de políticas de validação, ou uma máscara de bits de inteiros não negativos. Nomes das apólices (indistintos a maiúsculas): None, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLengthTargetRepositoryDoesNotExistSourceRepositoryContainsLfsObjectsSourceRepositoryNotReadOnlyBoardsGitHubConnectionProvisioning. All
--enable-boards-github-connection (--enable-boards-gh) sinalizador create Opte por provisionar a ligação Azure Boards GitHub no cutover. Desativado por padrão. Exige que a aplicação Azure Boards GitHub esteja instalada na organização GitHub alvo antes da migração ser executada.
--enable-auto-discover-pipelines (--auto-discover) sinalizador create Opte pela descoberta automática do pipeline no cutover. Desativado por padrão. Requer --pipeline-service-connection-id; a CLI rejeita o comando se passar esta bandeira sem ligação ao serviço.
--pipeline-service-connection-id (--pipeline-sc-id) GUID create ID de ligação de serviço GitHub com âmbito de Project anexado no momento de criação para reconfiguração do pipeline. Obrigatório para auto-descoberta; opcional no modo manual, onde a ligação pré-anexa para que as chamadas posteriores pipelines submit só precisem --pipeline-idsde .
--accept-failures número inteiro cutover approve Número de recursos de migração não processados a aceitar antes de avançar com a transição. Fornece isto e/ou --pipelines-verified.
--pipelines-verified sinalizador cutover approve Reconheça que todos os pipelines reconfigurados foram verificados. É obrigatório quando cutover review regressar requiresPipelineVerificationAcknowledgment: true. Pode ser combinado numa --accept-failures só chamada.
--pipeline-ids Lista de INT pipelines submit, pipelines retry IDs de definição de pipeline. Aceita valores separados por espaços (42 43 44) ou separados por vírgulas (42,43,44).
--service-connection-id GUID pipelines submit, pipelines update ID de ligação de serviço GitHub com âmbito de Project. Opcional se submit uma ligação já estava ligada no momento da criação ou via pipelines update.
--add-ids / --remove-ids / --retry-ids Lista de INT pipelines update IDs de pipeline para adicionar, remover ou tentar novamente dentro do conjunto de recablagem.
--repository-mapping cadeia (de caracteres) pipelines submit, pipelines update Mapeamento de repositórios na forma <sourceRepoId>=<targetOwner>/<targetRepo>. O alvo deve estar no owner/repo formulário, não numa URL. Pode ser fornecido várias vezes.
--migration-id número inteiro pipelines delete ID de migração usado para a limpeza da reinstalação de pipelines. Leia-o do Migration NN: prefixo no validationIssues texto de migrations status.
--remove-read-only sinalizador abandon Após o cutover, o repositório Azure DevOps de origem é definido para apenas leitura. Adicione este flag para restaurar o acesso de escrita. Só se aplica após o cutover.
--yes (-y) sinalizador abandon, pipelines delete Ignora o prompt interativo de confirmação. Útil para limpeza scriptada.
--include-all sinalizador list Devolva o histórico completo de migração por repositório, incluindo migrações concluídas, falhadas e suspensas. (--include-inactive é um pseudónimo obsoleto.)
--detect sinalizador All Deteção automática de organização a partir do comando git (por defeito: true). Use --detect false para desativar.

Estágios de migração

Stage Description
Em fila Migração aceite; O trabalho ainda não começou.
Validation A executar verificações de pré-migração.
Synchronization Copiar e sincronizar conteúdos do repositório.
Transição A executar a sincronização final e a transição para o GitHub.
ReviewForCutover O Cutover atingiu a hora prevista com falhas não resolvidas e está à cutover approve espera (ou a reagendar).
ReadyParaCutover Aprovado e à espera do próximo trabalho ELM para fazer o corte final.
Migrado Migração concluída. GitHub é o sistema de registo.

Status de migração

Status Meaning
Active A migração está a decorrer.
Succeeded Fase atual concluída com sucesso.
Concluído A migração atingiu a fase terminal Migrated .
Falhado Ocorreu um erro. Podes retomar a migração depois de corrigires o problema.
Suspenso Pausado manualmente. Pode retomar a migração.

Conteúdo relacionado

  • Última atualização a