az devops migrations

  • Предварительный просмотр

Замечание

Эта ссылка является частью расширения azure-devops для Azure CLI (версия 2.30.0 или выше). Расширение автоматически установит команду az devops migrations при первом запуске. Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Управление динамическими миграциями предприятия.

Эта группа команд является частью расширения azure-devops и находится в предварительной версии. Доступность может быть ограничена (например, до 1P/разрешенных пользователей). Для миграций ELM организация --org должна быть URL-адресом организации Azure DevOps (например: https://dev.azure.com/myorg).

Команды

Имя Описание Тип Состояние
az devops migrations abandon

Отказаться от миграции.

 Extension Preview
az devops migrations create

Создайте миграцию для репозитория.

 Extension Preview
az devops migrations cutover

Управление переключение миграции.

 Extension Preview
az devops migrations cutover approve

Утверждение переключения путем принятия необработанных элементов и (или) проверки повторно размещенных конвейеров.

 Extension Preview
az devops migrations cutover cancel

Отмена запланированной отрезки.

 Extension Preview
az devops migrations cutover review

Перед переходом просмотрите необработанные элементы миграции.

 Extension Preview
az devops migrations cutover set

Планирование переключение для миграции.

 Extension Preview
az devops migrations list

Вывод списка миграций в организации.

 Extension Preview
az devops migrations pause

Приостановка активной миграции.

 Extension Preview
az devops migrations pipelines

Управление повторной миграцией конвейера. (предварительная версия).

 Extension Preview
az devops migrations pipelines delete

Удаление данных повторной обработки конвейера для миграции. (предварительная версия).

 Extension Preview
az devops migrations pipelines list

Вывод списка конфигурации повторной настройки конвейера и состояния каждого конвейера.

 Extension Preview
az devops migrations pipelines retry

Повторная попытка неудачного переключение записей конвейера. (предварительная версия).

 Extension Preview
az devops migrations pipelines submit

Отправка конвейеров для повторной настройки. (предварительная версия).

 Extension Preview
az devops migrations pipelines update

Конфигурация повторного развертывания конвейера массового обновления. (предварительная версия).

 Extension Preview
az devops migrations resume

Возобновление остановленной (приостановленной, неудачной) миграции.

 Extension Preview
az devops migrations status

Получение состояния миграции для репозитория.

 Extension Preview

az devops migrations abandon

Предварительный просмотр

Группа команд "миграции devops" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Отказаться от миграции.

Перемещает миграцию в заброшенное или неудачное состояние; Запись миграции не очищается. Повторное изменение конвейера остается без изменений, чтобы последующий перенос может повторно использовать его.

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

Примеры

Отмена и сохранение только для чтения репозитория (по умолчанию).

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

Отмените и задайте репозиторий обратно для чтения и записи.

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Кроме того, задайте репозиторий Azure Repos обратно в состояние чтения и записи, отправив removeReadOnly=true.

Свойство Значение
Значение по умолчанию: False
--repository-id

Идентификатор репозитория Azure Repos (GUID).

--yes -y

Не запрашивать подтверждение.

Свойство Значение
Значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az devops migrations create

Предварительный просмотр

Группа команд "миграции devops" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Создайте миграцию для репозитория.

Если маркер --github-не указан, интерфейс командной строки проверяет ELM_GITHUB_TOKEN, а затем запускает поток устройства GitHub для получения маркера.

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]
                            [--github-token]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--service-endpoint-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

Примеры

Создайте миграцию.

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>

Создайте миграцию только для проверки.

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

Создайте с помощью предварительно созданного маркера GitHub или PAT.

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--agent-pool

Имя пула агентов, используемое для миграции.

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

Выберите автоматическое обнаружение конвейера при переключение. Отключено по умолчанию. При включении задание синхронизации ELM выполняет обход исходного репозитория и создает клонирование определений для каждого конвейера, ссылающегося на него. Требуется --pipeline-service-connection-id; без обнаружения выполняется как no-op и регистрирует 0 конвейеров. Перенос конвейера всегда доступен с помощью конвейера az devops migrations submit/update.

Свойство Значение
Значение по умолчанию: False
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--cutover-date

Запланированный переход даты и времени (ISO 8601).

--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--enable-boards-gh --enable-boards-github-connection

Вы можете подготовить подключение Azure Boards GitHub при переключение. Отключено по умолчанию. Требуется, чтобы приложение Azure Boards GitHub было установлено в целевой GitHub организации Enterprise перед запуском миграции.

Свойство Значение
Значение по умолчанию: False
--github-token

GitHub маркер пользователя, используемый для проверки удостоверения пользователя на целевом узле. Независимо от идентификатора --service-endpoint-id. Если опущен и --service-endpoint-id не указан, интерфейс командной строки проверяет ELM_GITHUB_TOKEN, а затем запускает поток устройства GitHub. Если указан идентификатор --service-endpoint-id, поток устройства пропускается; передайте маркер --github-token или задайте ELM_GITHUB_TOKEN для предоставления маркера пользователя.

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

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

Project области GitHub идентификатор подключения службы (GUID), присоединенный во время создания конвейера повторной установки. Требуется для полного автоматического обнаружения при сочетании с --enable-auto-discover-pipelines; необязательный в ручном режиме (предварительно присоединяет подключение, чтобы последующие конвейеры отправляли вызовы только для --pipeline-ids).

--repository-id

Идентификатор репозитория Azure Repos (GUID).

--service-endpoint-id

Идентификатор конечной точки службы (GUID) для подключения GitHub Enterprise Server, используемого для синхронизации фиксаций с целевым объектом. Независимо от проверки удостоверения пользователя: --github-token/ELM_GITHUB_TOKEN можно предоставить вместе с этим флагом. Поток устройства пропускается при установке этого флага.

--skip-validation

Политики проверки для пропуска. Принимает список имен политик с разделителями-запятыми (например, AgentPoolExists,MaxFileSize) или неотрицательную целочисленную битовую маску. Поддерживаемые имена политик (без учета регистра): Нет, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

Идентификатор пользователя владельца целевого репозитория. Не рекомендуется и игнорируется при включенном разрешении владельца на стороне сервера.

--target-repository

URL-адрес целевого репозитория (должен начинаться с http:// или https://).

--validate-only

Создайте в режиме только проверки (только для предварительной миграции).

Свойство Значение
Значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az devops migrations list

Предварительный просмотр

Группа команд "миграции devops" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Вывод списка миграций в организации.

По умолчанию возвращается последняя миграция для каждого репозитория независимо от состояния. Используйте --include-all для возврата полной истории миграции.

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

Примеры

Вывод списка последней миграции для каждого репозитория.

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

Список полной истории миграции для каждого репозитория.

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--include-all

Возвращает полную историю миграции (все записи для каждого репозитория). По умолчанию возвращается только последняя миграция для каждого репозитория независимо от его состояния.

Свойство Значение
Значение по умолчанию: False
--include-inactive
Не рекомендуется

Параметр --include-inactive был нерекомендуем и будет удален в будущем выпуске. Вместо этого используйте "--include-all".

Устарело. Вместо этого используйте --include-all.

Свойство Значение
Значение по умолчанию: False
--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project

Необязательное имя проекта или идентификатор для фильтрации миграций.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az devops migrations pause

Предварительный просмотр

Группа команд "миграции devops" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Приостановка активной миграции.

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--repository-id

Идентификатор репозитория Azure Repos (GUID).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az devops migrations resume

Предварительный просмотр

Группа команд "миграции devops" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Возобновление остановленной (приостановленной, неудачной) миграции.

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

Примеры

Возобновление использования текущего режима.

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

Возобновляйте работу в режиме только для проверки.

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

Продолжить миграцию (очищает режим только проверки).

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--migration

Повышение успешной миграции только для проверки до полной миграции (задает validateOnly=false и statusRequested=active).

Свойство Значение
Значение по умолчанию: False
--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--repository-id

Идентификатор репозитория Azure Repos (GUID).

--validate-only

Возобновляйте работу в режиме только для проверки.

Свойство Значение
Значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az devops migrations status

Предварительный просмотр

Группа команд "миграции devops" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Получение состояния миграции для репозитория.

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

Примеры

Получение состояния миграции по идентификатору репозитория.

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--repository-id

Идентификатор репозитория Azure Repos (GUID).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False