az devops migrations

  • Pré-visualizar

Nota

Esta referência faz parte da extensão azure-devops para o CLI do Azure (versão 2.30.0 ou superior). A extensão vai instalar-se automaticamente na primeira vez que executares um comando de migração do AZ DevOps . Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerir migrações em tempo real para empresas.

Este grupo de comandos faz parte da extensão azure-devops e está em pré-visualização. A disponibilidade pode ser limitada (por exemplo, a utilizadores 1P/listados permitidos). Para migrações ELM, --org deve ser o URL da sua organização Azure DevOps (por exemplo: https://dev.azure.com/myorg).

Comandos

Name Descrição Tipo Estado
az devops migrations abandon

Abandonar uma migração.

 Extension Preview
az devops migrations create

Crie uma migração para um repositório.

 Extension Preview
az devops migrations cutover

Gerir a migração e a transição.

 Extension Preview
az devops migrations cutover approve

Aprove o cutover aceitando itens não processados e/ou verificando pipelines reconfigurados.

 Extension Preview
az devops migrations cutover cancel

Cancela um turnover agendado.

 Extension Preview
az devops migrations cutover review

Revise os itens de migração não processados antes do corte.

 Extension Preview
az devops migrations cutover set

Ajuste de horários para uma migração.

 Extension Preview
az devops migrations list

Liste as migrações numa organização.

 Extension Preview
az devops migrations pause

Pausa uma migração ativa.

 Extension Preview
az devops migrations pipelines

Gerir a reconfiguração do pipeline para migrações. (Pré-visualização).

 Extension Preview
az devops migrations pipelines delete

Apague os dados de reconfiguração do pipeline para uma migração. (Pré-visualização).

 Extension Preview
az devops migrations pipelines list

Liste a configuração da reinstalação de fiação do oleoduto e o estado por pipeline.

 Extension Preview
az devops migrations pipelines retry

Retentar entradas de reconfiguração do pipeline falhadas. (Pré-visualização).

 Extension Preview
az devops migrations pipelines submit

Submeter os pipelines para recablagem. (Pré-visualização).

 Extension Preview
az devops migrations pipelines update

Atualização em massa da configuração da reestruturação do pipeline. (Pré-visualização).

 Extension Preview
az devops migrations resume

Retomar uma migração parada (pausada, falhada).

 Extension Preview
az devops migrations status

Obtenha o estado de migração de um repositório.

 Extension Preview

az devops migrations abandon

Pré-visualizar

O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Abandonar uma migração.

Move a migração para um estado abandonado/falhado; O registo de migração não é eliminado. Os dados de reconfiguração do pipeline são mantidos intactos para que uma migração subsequente possa reutilizá-los.

az devops migrations abandon [--acquire-policy-token]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--remove-read-only]
                             [--repository-id]
                             [--yes]

Exemplos

Abandonar e manter o repositório apenas em leitura (por defeito).

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Abandonar e voltar a definir o repositório para leitura-escrita.

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--org --organization

URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Também volte a definir o repositório Repositórios do Azure para o estado de leitura-escrita enviando removeReadOnly=true.

Propriedade Valor
Valor predefinido: False
--repository-id

ID do repositório Repositórios do Azure (GUID).

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az devops migrations create

Pré-visualizar

O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie uma migração para um repositório.

A autenticação no GitHub utiliza o fluxo do dispositivo: a CLI imprime um URL e um código de uso único para completar o login de forma interativa. Não é necessário token GitHub nem ligação ao serviço.

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--auto-discover --enable-auto-discover-pipelines]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--enable-boards-gh --enable-boards-github-connection]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

Exemplos

Cria uma migração.

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool>

Crie uma migração apenas de validação.

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool> --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--agent-pool

Nome do pool de agentes para usar em trabalho de migração.

--auto-discover --enable-auto-discover-pipelines

Opte pela descoberta automática do pipeline no cutover. Desativado por padrão. Quando ativado, o trabalho de sincronização ELM percorre o repositório de origem e cria definições clones para cada pipeline que o referencia. Requer --pipeline-service-connection-id; Sem ele, a descoberta corre como no-op e regista 0 pipelines. A reconfiguração de pipelines está sempre disponível através de pipelines de migração devops do az, submeter/atualizar.

Propriedade Valor
Valor predefinido: False
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cutover-date

Data/hora de transição agendada (ISO 8601).

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--enable-boards-gh --enable-boards-github-connection

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 empresa de alvo antes da migração ser executada.

Propriedade Valor
Valor predefinido: False
--org --organization

URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--pipeline-sc-id --pipeline-service-connection-id

ID de ligação de serviço GitHub (GUID) com escopo de Project ligado no momento de criação para reconfiguração do pipeline. Necessário para auto-descoberta total quando combinado com --enable-auto-discover-pipelines; opcional em modo manual (pré-anexa a ligação para que os pipelines seguintes submetam chamadas só precisem de ---pipeline-ids).

--repository-id

ID do repositório Repositórios do Azure (GUID).

--skip-validation

Políticas de validação a ignorar. Aceita uma lista separada por vírgulas de nomes de políticas (por exemplo, AgentPoolExists, MaxFileSize) ou uma máscara de bits inteiro não negativa. Nomes de políticas suportados (insensíveis a maiúsculas e minúsculas): Nenhum, ActivePullPullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, todos.

--target-owner-user-id

ID de utilizador 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.

--target-repository

URL do repositório alvo (deve começar por http:// ou https://).

--validate-only

Criar em modo apenas de validação (apenas verificações pré-migração).

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az devops migrations list

Pré-visualizar

O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Liste as migrações numa organização.

Por defeito, a migração mais recente por repositório é devolvida, independentemente do estado. Use --include-all para devolver o histórico completo de migração.

az devops migrations list [--detect {false, true}]
                          [--include-all]
                          [--include-inactive]
                          [--org --organization]
                          [--project]

Exemplos

Liste a migração mais recente por repositório.

az devops migrations list --org https://dev.azure.com/myorg

Liste o histórico completo de migração de cada repositório.

az devops migrations list --org https://dev.azure.com/myorg --include-all

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--include-all

Devolva o histórico completo de migração (todos os registos por repositório). Por defeito, apenas a migração mais recente por repositório é devolvida, independentemente do seu estado.

Propriedade Valor
Valor predefinido: False
--include-inactive
Preterido

A opção '--include-inactive' foi descontinuada e será removida numa versão futura. Usa '--inclui-tudo' em vez disso.

Deprecated. Usa --inclui-todos em vez disso.

Propriedade Valor
Valor predefinido: False
--org --organization

URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project

Nome ou ID de projeto opcional para filtrar migrações.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az devops migrations pause

Pré-visualizar

O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Pausa uma migração ativa.

az devops migrations pause [--acquire-policy-token]
                           [--change-reference]
                           [--detect {false, true}]
                           [--org --organization]
                           [--repository-id]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--org --organization

URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID do repositório Repositórios do Azure (GUID).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az devops migrations resume

Pré-visualizar

O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Retomar uma migração parada (pausada, falhada).

az devops migrations resume [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--migration]
                            [--org --organization]
                            [--repository-id]
                            [--validate-only]

Exemplos

Retomar o modo atual.

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Retomar em modo apenas de validação.

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only

Continuar a migração (limpa o modo apenas de validação).

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--migration

Promover uma migração validada apenas com sucesso para uma migração completa (define validateOnly=false e statusRequested=active).

Propriedade Valor
Valor predefinido: False
--org --organization

URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID do repositório Repositórios do Azure (GUID).

--validate-only

Retomar em modo apenas de validação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az devops migrations status

Pré-visualizar

O grupo de comando 'migrações devops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha o estado de migração de um repositório.

az devops migrations status [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--org --organization]
                            [--repository-id]

Exemplos

Obtenha o estado da migração pelo ID do repositório.

az devops migrations status --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--org --organization

URL da organização Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID do repositório Repositórios do Azure (GUID).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False