Импорт репозитория Git в проект

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

В этой статье показано, как импортировать существующий репозиторий Git из GitHub, Bitbucket, GitLab или другого расположения в новый или пустой существующий репозиторий в проекте Azure DevOps.

Предварительные условия

Импорт в новый репозиторий

Выполните следующие действия, чтобы импортировать в новый репозиторий:

1. В браузере войдите в вашу организацию и выберите Repos>Files.

   

2. В раскрывающемся списке репозитория выберите "Импорт репозитория".

   

3. Введите URL-адрес клона исходного репозитория и имя нового репозитория Git.

   

4. Выберите Импорт репозитория.

Репозиторий импортируется.

Импорт в существующий пустой репозиторий

На странице "Файлы" пустого репозитория Git выберите "Импорт" и введите URL-адрес клонирования. Укажите учетные данные, если исходному репозиторию требуется проверка подлинности.

az repos import create --git-source-url
                       [--detect {false, true}]
                       [--git-service-endpoint-id]
                       [--org]
                       [--project]
                       [--repository]
                       [--requires-authorization]
                       [--subscription]
                       [--user-name]

az repos import create --git-source-url https://github.com/fabrikamprime/fabrikam-open-source --repository fabrikam-open-source
{
  "detailedStatus": {
    "allSteps": [
      "Processing request",
      "Analyzing repository objects",
      "Storing objects",
      "Storing index file",
      "Updating references",
      "Import completed successfully"
    ],
    "currentStep": 6,
    "errorMessage": null
  },
  "importRequestId": 8,
  "parameters": {
    "deleteServiceEndpointAfterImportIsDone": null,
    "gitSource": {
      "overwrite": false,
      "url": "https://github.com/fabrikamprime/fabrikam-open-source"
    },
    "serviceEndpointId": null,
    "tfvcSource": null
  },
  "repository": {
    "defaultBranch": null,
    "id": "0f6919cd-a4db-4f34-a73f-2354114a66c4",
    "isDisabled": false,
    "isFork": null,
    "name": "new-empty-repo",
    "parentRepository": null,
    "project": {
      "abbreviation": null,
      "defaultTeamImageUrl": null,
      "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
      "id": "56af920d-393b-4236-9a07-24439ccaa85c",
      "lastUpdateTime": "2021-05-24T21:52:14.95Z",
      "name": "Fabrikam Fiber",
      "revision": 438023732,
      "state": "wellFormed",
      "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
      "visibility": "private"
    },
    "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source",
    "size": 12477,
    "sshUrl": "git@ssh.dev.azure.com:v3/kelliott/Fabrikam%20Fiber/new-empty-repo",
    "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/0f6919cd-a4db-4f34-a73f-2354114a66c4",
    "validRemoteUrls": null,
    "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/fabrikam-open-source"
  },
  "status": "completed",
  "url": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_apis/git/repositories/0f6919cd-a4db-4f34-a73f-2354114a66c4/importRequests/8"
}

Импорт репозитория вручную с помощью Git CLI

1. Клонируйте исходный репозиторий во временную папку на компьютере с помощью bare параметра, как показано в следующем примере командной строки, а затем перейдите в папку репозитория. При клонирование с помощью bare параметра имя папки включает .git суффикс. В этом примере репозиторий https://github.com/contoso/old-contoso-repo.git является исходным и должен быть импортирован вручную.

   git clone --bare https://github.com/contoso/old-contoso-repo.git
   cd old-contoso-repo.git
   

2. Создать целевой репозиторий и запишите URL-адрес клонирования. В этом примере https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo используется URL-адрес нового целевого репозитория.

3. Выполните следующую команду, чтобы скопировать исходный репозиторий в целевой репозиторий.

   git push --mirror https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo
   

   Предупреждение

   Использование --mirror перезаписывает все ветви в целевом репозитории, включающее удаление ветвей, не входящих в исходное репозиторие.

4. Если исходный репозиторий содержит объекты LFS, получите их и скопируйте их из исходного репозитория в целевой репозиторий.

   git lfs fetch origin --all
   git lfs push --all https://dev.azure.com/contoso-ltd/MyFirstProject/_git/new-contoso-repo
   

5. Удалите временную папку, выполнив следующие команды.

   cd ..
   rm -rf old-contoso-repo.git
   

Часто задаваемые вопросы

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

• Что делать, если исходный репозиторий защищён двухфакторной аутентификацией?
• Что делать, если исходный репозиторий не поддерживает multi_ack?
• Можно ли импортировать из предыдущих локальных версий?
• Можно ли использовать учетные данные на основе MSA?
• Можно ли импортировать из TFVC?
• Что делать, если исходный репозиторий содержит объекты Git LFS?

Что делать, если исходный репозиторий защищен двухфакторной аутентификацией?

Ответ. Служба импорта использует REST API для проверки и активации импорта и не может работать непосредственно с репозиториями, для которых требуется двухфакторная проверка подлинности.

Большинство поставщиков размещения Git поддерживают токены аутентификации, которые можно предоставить службе импорта.

Маркеры идентификатора Microsoft Entra (рекомендуется): Маркеры идентификатора Microsoft Entra обеспечивают более высокую безопасность и являются рекомендуемыми способами проверки подлинности. Эти маркеры можно получить с помощью следующих способов:

• Azure CLI (для разработки и тестирования):

  az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query "accessToken" --output tsv
  

• Субъект-служба (для рабочих и автоматизированных сценариев):

  • Зарегистрируйте приложение в Microsoft Entra ID
  • Создание секрета клиента для приложения
  • Предоставление приложению соответствующих разрешений в Azure DevOps
  • Используйте учетные данные служебной учетной записи для программного получения токенов

Личные маркеры доступа (альтернатива):GitHub и Azure DevOps также поддерживают личные маркеры доступа.

Вопрос. Что делать, если исходный репозиторий не поддерживает multi_ack?

Ответ. Служба импорта использует multi_ack возможности протокола Git во время импорта. Если исходный репозиторий не предоставляет эту возможность, служба импорта может не импортировать из данного источника. Этот сбой может произойти при создании запроса на импорт или во время импорта.

Вопрос. Можно ли импортировать из предыдущих версий?

Ответ. Если исходный репозиторий Git находится в локальной версии ранее 2017 RTM, импорт завершается ошибкой из-за несоответствия контракта между последними версиями Azure DevOps и предыдущими версиями.

Вопрос. Можно ли использовать учетные данные на основе MSA?

Ответ. К сожалению, учетные данные на основе MSA (учетная запись Майкрософт) не работают. Служба импорта использует базовую проверку подлинности для взаимодействия с исходным репозиторием. Если имя пользователя и пароль, которые вы используете, не являются базовой аутентификацией, то аутентификация и импорт будут завершены неудачей. Один из способов проверить, используется ли базовая аутентификация для вашего имени пользователя и пароля, — попробовать клонировать репозиторий с помощью Git в следующем формате:

git clone https://<<username>>:<<password>>@<<remaining clone Url>>

Вопрос. Можно ли импортировать из TFVC?

Ответ. Вы можете перенести код из существующего репозитория TFVC в новый репозиторий Git в той же учетной записи. При миграции на Git, хотя преимуществ много, это сложный процесс для крупных репозиториев и команд TFVC. Централизованные системы управления версиями, такие как TFVC, ведут себя по-другому, чем Git. Переключение включает гораздо больше, чем освоение новых команд. Это разрушительное изменение, которое требует тщательного планирования. Дополнительные сведения см. в разделе "Импорт из TFVC в Git".

Вопрос. Что делать, если исходный репозиторий содержит объекты Git LFS?

Ответ. Импорт Git не импортирует объекты Git LFS.

Объекты LFS можно переместить, выполнив следующие действия.

• Импортируйте репозиторий с помощью функции репозитория импорта в Azure DevOps. Это действие копирует все объекты Git из источника в Azure DevOps, который также импортирует указатели LFS, которые являются объектами Git, но не файлов LFS.

Для перемещения по файлам LFS необходимо как Git.exe, так и клиент LFS на одном компьютере с доступом как к исходному репозиторию, так и к целевому репозиторию.

• Клонируйте импортированный репозиторий из Azure DevOps в локальную систему. Клонирование работает, но происходит сбой при выполнении выгрузки файлов LFS.
• Добавьте исходный репозиторий как удаленный, например source.
• Запустите git lfs fetch source --all, который переносит все файлы LFS из источника в локальный репозиторий.
• Предполагая, что целевой репозиторий Azure DevOps является вашим удаленным объектом.
• Выполните git lfs push target --all.

Вопрос: Можно ли импортировать обновления, если исходный текст изменится позже?

Ответ. Служба импорта предназначена для первоначального импорта всего репозитория. Чтобы отслеживать последующие изменения, вам нужен локальный клон репозитория с удалёнными репозиториями, настроенными как для источника, так и для назначения.

Вы можете синхронизировать изменения с помощью следующих команд. В следующем примере импорт Azure Repos рассматривается как origin и исходный репозиторий upstream.

git clone --bare <Azure-Repos-clone-URL>.git
cd <name-of-repo>
git remote add --mirror=fetch upstream <original-repo-URL>
git fetch upstream --tags
git push origin --all

Следующие шаги

Связанный контент

• Дополнительные сведения о рабочем процессе Git