az devops migrations

  • Versão Prévia

Note

Essa referência faz parte da extensão azure-devops para o CLI do Azure (versão 2.30.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de migrações az devops . Saiba mais sobre extensões.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar migrações ao vivo da empresa.

Esse grupo de comandos faz parte da extensão azure-devops e está em versão prévia. A disponibilidade pode ser limitada (por exemplo, a usuários com lista de permissões/1P). Para migrações de ELM, --org deve ser sua URL da organização do Azure DevOps (por exemplo: https://dev.azure.com/myorg).

Comandos

Nome Description Tipo Status
az devops migrations abandon

Abandone uma migração.

 Extension Preview
az devops migrations create

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

 Extension Preview
az devops migrations cutover

Gerenciar a substituição de migração.

 Extension Preview
az devops migrations cutover approve

Aprove a substituição aceitando itens não processados e/ou verificando pipelines religados.

 Extension Preview
az devops migrations cutover cancel

Cancelar uma substituição agendada.

 Extension Preview
az devops migrations cutover review

Examine os itens de migração não processados antes da substituição.

 Extension Preview
az devops migrations cutover set

Agendar a substituição para uma migração.

 Extension Preview
az devops migrations list

Listar migrações em uma organização.

 Extension Preview
az devops migrations pause

Pausar uma migração ativa.

 Extension Preview
az devops migrations pipelines

Gerenciar a nova conexão de pipeline para migrações. (Versão prévia).

 Extension Preview
az devops migrations pipelines delete

Exclua dados de nova largura de pipeline para uma migração. (Versão prévia).

 Extension Preview
az devops migrations pipelines list

Listar a configuração de nova largura de pipeline e o status por pipeline.

 Extension Preview
az devops migrations pipelines retry

Tente novamente as entradas de rewiring do pipeline com falha. (Versão prévia).

 Extension Preview
az devops migrations pipelines submit

Envie pipelines para rewiring. (Versão prévia).

 Extension Preview
az devops migrations pipelines update

Configuração de rewiring do pipeline de atualização em massa. (Versão prévia).

 Extension Preview
az devops migrations resume

Retome uma migração interrompida (pausada, com falha).

 Extension Preview
az devops migrations status

Obtenha o status de migração para um repositório.

 Extension Preview

az devops migrations abandon

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Abandone uma migração.

Move a migração para um estado abandonado/com falha; o registro de migração não é limpo. Os dados de nova largura de pipeline são deixados 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

Abandone e mantenha o repositório somente leitura (padrão).

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

Abandone e defina o repositório de volta para leitura-gravação.

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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

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

URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Defina também o repositório Azure Repos de volta para o estado de leitura/gravação enviando removeReadOnly=true.

Propriedade Valor
Valor padrão: False
--repository-id

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

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devops migrations create

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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

GitHub autenticação usa o fluxo do dispositivo: a CLI imprime uma URL e um código único para concluir a entrada interativamente. Nenhuma conexão de token ou serviço GitHub é necessária.

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

Crie 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 somente validar.

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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

Nome do pool de agentes a ser usado para o trabalho de migração.

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

Opte pela descoberta automática de pipeline na substituição. Desativado por padrão. Quando habilitado, o trabalho de sincronização do ELM orienta o repositório de origem e cria definições de clone para cada pipeline que faz referência a ele. Requer --pipeline-service-connection-id; sem que a descoberta seja executada como um no-op e registre 0 pipelines. A nova largura de pipeline em si está sempre disponível por meio do envio/atualização de pipelines de migrações az devops.

Propriedade Valor
Valor padrão: False
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

--detect

Detecte automaticamente a organização.

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

Opte por provisionar a conexão Azure Boards GitHub na substituição. Desativado por padrão. Requer que o aplicativo Azure Boards GitHub seja instalado na organização GitHub Enterprise de destino antes que a migração seja executada.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

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

guid (ID de conexão de serviço) de GitHub com escopo Project anexado no momento da criação para a nova largura de pipeline. Necessário para a descoberta automática completa quando combinado com --enable-auto-discover-pipelines; opcional no modo manual (pré-anexa a conexão para que os pipelines subsequentes enviem chamadas somente precisam de --pipeline-ids).

--repository-id

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

--skip-validation

Políticas de validação a serem ignoradas. Aceita uma lista separada por vírgulas de nomes de política (por exemplo, AgentPoolExists, MaxFileSize) ou uma máscara de bits de inteiro não negativo. Nomes de política com suporte (que não diferenciam maiúsculas de minúsculas): Nenhum, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

ID de usuário do proprietário do repositório de destino. Preterido e ignorado quando a resolução de proprietário baseada em token do lado do servidor está habilitada.

--target-repository

URL do repositório de destino (deve começar com http:// ou https://).

--validate-only

Crie no modo somente validação (somente verificações de pré-migração).

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devops migrations list

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar migrações em uma organização.

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

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 de migração completo para 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--detect

Detecte automaticamente a organização.

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

Retorne o histórico de migração completo (todos os registros por repositório). Por padrão, somente a migração mais recente por repositório é retornada, independentemente de seu estado.

Propriedade Valor
Valor padrão: False
--include-inactive
Preterido

A opção '--include-inactive' foi preterida e será removida em uma versão futura. Em vez disso, use '--include-all'.

Preterido. Use --include-all em vez disso.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devops migrations pause

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Pausar 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

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

URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devops migrations resume

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Retome uma migração interrompida (pausada, com falha).

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

Exemplos

Retome usando o modo atual.

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

Retomar no modo somente 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 somente 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--migration

Promova uma migração somente validação bem-sucedida para uma migração completa (define validateOnly=false e statusRequested=active).

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

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

--validate-only

Retomar no modo somente validação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devops migrations status

Versão Prévia

O grupo de comandos 'devops migrations' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha o status de migração para um repositório.

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

Exemplos

Obtenha o status da migração por 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

Detecte automaticamente a organização.

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

URL da organização do Azure DevOps Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio do comando git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--repository-id

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False