начало работы с Git в Azure Repos

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

начало работы при разработке кода с помощью Azure Repos и репозиториев Git. Команды Visual Studio или Git можно использовать для клонирования репозитория, определения локальных ветвей, фиксации и отправки изменений, а также синхронизации с другими пользователями. Если вам нужно создать или импортировать репозиторий, см. статью "Создание репозитория Git" в проекте или импорт репозитория Git.

Примечание

В этой статье описывается, как использовать Visual Studio для управления Azure Repos репозиториями Git. С помощью аналогичных процедур можно использовать Visual Studio для управления репозиториями GitHub. Чтобы клонировать репозиторий GitHub, получите URL-адрес, как описано в разделе "Клонирование репозитория".

Общие сведения о рабочем процессе Git см. в Azure Repos руководстве по Git.

Примечание

Visual Studio 2019 версии 16.8 и более поздних версий предоставляют новое меню Git для управления рабочим процессом Git с меньшим переключением контекста, чем Team Explorer. Процедуры, описанные в этой статье на вкладке Visual Studio 2019, содержат сведения об использовании интерфейса Git, а также Team Explorer. Дополнительные сведения см. в статье о параллельном сравнении Git и Team Explorer.

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

  • Repos необходимо включить в параметрах проекта Azure DevOps. Если Repos концентратор и связанные страницы не отображаются, см. статью "Включение или отключение службы Azure DevOps" для повторной Repos.

  • Чтобы просмотреть код в частных проектах, необходимо быть членом проекта Azure DevOps с уровнем доступа "Базовый" или выше. Для общедоступных проектов каждый может просматривать код.

  • Чтобы клонировать или внести свой вклад в код для частного проекта, необходимо быть членом группы безопасности участников или иметь соответствующие разрешения. Для общедоступных проектов любой пользователь может клонировать и внести свой вклад в код. Дополнительные сведения см. в статье "Что такое общедоступный проект"?

    Примечание

    Для общедоступных проектов пользователи, которым предоставлен доступ заинтересованных лиц, имеют полный доступ к Azure Repos.

  • Repos необходимо включить в параметрах проекта Azure DevOps. Если Repos концентратор и связанные страницы не отображаются, см. статью "Включение или отключение службы Azure DevOps" для повторной Repos.

  • Чтобы просмотреть код, необходимо быть членом проекта Azure DevOps с базовым доступом или более поздней версии. Если вы не член проекта, добавьте его.

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

  • Чтобы просмотреть код, необходимо быть членом проекта Azure DevOps с базовым доступом или выше. Если вы не член проекта, добавьте его.

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

Дополнительные сведения о разрешениях и доступе см. в разделе "Репозиторий Git по умолчанию" и "Разрешения ветви " и "Сведения об уровнях доступа".

Получение кода

Вы можете клонировать удаленный репозиторий Git, чтобы создать локальную копию. Клонирование создает как копию исходного кода, так и сведения об управлении версиями, чтобы Git могли управлять исходным кодом.

Если вы предпочитаете создать локальный репозиторий без клонирования, см. статью "Создание нового репозитория Git". После создания локального репозитория можно перейти к фиксации, совместному доступу и синхронизации работы.

Visual Studio 2019 версии 16.8 и более поздних версий предоставляет возможности управления версиями Git, сохраняя пользовательский интерфейс Team Explorer Git. Вы можете выполнять функции Git из любого интерфейса взаимозаменяемо. Ниже мы предоставляем параллельное сравнение клонирования репозитория.

Примечание

Одним из преимуществ подключения к проекту через Team Explorer является получение доступа к центру рабочих элементов. Общие сведения о функциях Team Explorer см. в статье "Навигация в Visual Studio Team Explorer".

Visual Studio Git

  1. В меню Git в строке меню выберите "Клонировать репозиторий...

Screenshot of the 'Clone Repository' option in the Git menu in Visual Studio 2019.

  1. В окне клонирования репозитория введите расположение удаленного репозитория и путь к папке для клонированного репозитория. Если вы не знаете расположение удаленного репозитория, выберите Azure DevOps в разделе "Просмотр параметров репозитория".

Screenshot of the 'Clone Repository' window in Visual Studio 2019.

  1. Нажмите кнопку Клонировать. После клонирования репозитория Git Visual Studio обнаруживает репозиторий и добавляет его в список локальных репозиториев в меню Git.

Screenshot of the 'Local Repositories' option in the Git menu in Visual Studio 2019.

Обозреватель Team Explorer в Visual Studio

  1. В Team Explorer выберите Подключение, чтобы открыть страницу Подключение, а затем выберите "Управление подключениями>Подключение для Project.

Screenshot of the 'Connect to a Project' link in Team Explorer in Visual Studio 2019.

  1. В Подключение в окне Project выберите репозиторий, который нужно клонировать, и нажмите кнопку "Клонировать". Если репозиторий не отображается, нажмите кнопку "Добавить Azure DevOps Server", чтобы добавить сервер, на котором размещен репозиторий. Вы можете отфильтровать список, чтобы найти репозиторий.

Screenshot of the 'Connect to a Project' window in Visual Studio 2019.

  1. Проверьте расположение клонированного репозитория на компьютере и нажмите кнопку "Клонировать".

Примечание

При использовании Azure DevOps Services формат URL-адреса проекта имеет следующий dev.azure.com/{your organization}/{your project}формат. Однако предыдущий формат, ссылающийся на формат, по-прежнему visualstudio.com поддерживается. Дополнительные сведения см. в разделе "Введение Azure DevOps", "Переключение существующих организаций на использование нового URL-адреса доменного имени".

Фиксация работы

Ветви Git изолируют изменения от других работ в проекте. Рекомендуемый рабочий процесс Git — использовать новую ветвь для каждой функции или исправить ее. Вы вносите фиксации в локальный репозиторий Git, чтобы сохранить изменения в этой ветви.

Visual Studio Git

  1. В меню Git в строке меню выберите "Создать ветвь... ", чтобы открыть окно "Создать новую ветвь ".

Screenshot of the 'New Branch' option in the Git menu in Visual Studio 2019.

  1. В окне "Создание новой ветви " введите описательное имя ветви, чтобы сообщить другим пользователям, какая работа содержит ветвь. По умолчанию Visual Studio создает новую ветвь из текущей ветви. Если флажок Извлечь ветвь установлен, вы автоматически переключитесь на новую ветвь после ее создания. Нажмите кнопку создания.

Screenshot of the 'Create a new branch' window in Visual Studio 2019.

  1. Добавьте файл README.md в клонированную репозиторию. В Обозреватель решений можно просматривать содержимое репозитория с помощью представления папок или открывать решения Visual Studio в репозитории. Git отслеживает изменения, внесенные как внутри, так и за пределами Visual Studio.

  2. Когда вы удовлетворены изменениями, сохраните их в Git с помощью фиксации. В окне изменений Git введите сообщение, описывающее изменения, а затем нажмите кнопку "Зафиксировать все". Фиксация всех фиксаций фиксирует незафиксированные изменения и пропускает промежуточную область. Вы можете ставить все файлы перед фиксацией, нажав кнопку "Все+" (плюс) в верхней части раздела "Изменения" в окне изменений Git .

Screenshot of the 'Commit All' button in the 'Git Changes' window in Visual Studio 2019.

Выберите ссылку сведений о фиксации, чтобы получить дополнительные сведения о фиксации.

Screenshot showing the commit information link in Visual Studio 2019.

Обозреватель Team Explorer в Visual Studio

  1. В Team Explorer нажмите кнопку "Главная " и выберите "Ветви".

Screenshot showing the Branches option in Team Explorer in Visual Studio 2019.

  1. Щелкните правой кнопкой мыши ветвь по умолчанию, часто именуемую main, а затем выберите "Создать локальную ветвь" из...

Screenshot of the 'New Local Branch From' menu option in the context menu of the main branch in Visual Studio 2019.

  1. Введите описательное имя ветви, чтобы сообщить другим пользователям, какая работа содержит ветвь. Выберите "Создать ветвь".

Screenshot of the branch name text and 'Create Branch' button in Visual Studio 2019.

  1. Добавьте файл README.md в клонированную репозиторию. В домашнем представлении Team Explorer можно просматривать содержимое репозитория с помощью представления папок или открывать решения Visual Studio в репозитории. Git отслеживает изменения, внесенные как внутри, так и за пределами Visual Studio.

  2. Когда вы удовлетворены изменениями, сохраните их в Git с помощью фиксации. Откройте представление "Изменения"в Team Explorer , нажав кнопку "Главная " и нажав кнопку "Изменения".

Screenshot of the Changes option in Team Explorer in Visual Studio 2019.

  1. Введите сообщение, описывающее фиксацию, и нажмите кнопку "Зафиксировать все".

Screenshot of commit message text and 'Commit All' button in Visual Studio 2019.

Примечание

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

Visual Studio Git

Screenshot of the Stage option in the 'Git Changes' window in Visual Studio 2019.

Обозреватель Team Explorer в Visual Studio

Screenshot of the Stage option in the changed-file context menu in Team Explorer in Visual Studio 2019.

предоставьте к изменениям общий доступ;

После добавления одной или нескольких фиксаций в ветвь и вы готовы поделиться этими изменениями с другими пользователями, отправьте фиксации, чтобы другие могли видеть их.

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

Visual Studio Git

  1. В окне изменений Git нажмите кнопку со стрелкой вверх, чтобы отправить фиксацию.

Screenshot of the up-arrow push button in the 'Git Changes' window of Visual Studio 2019.

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

Screenshot of the 'outgoing / incoming' link in the 'Git Changes' window, and the Push link in the 'Git Repository' window of Visual Studio 2019.

Кроме того, вы можете отправить изменения из меню Git в строке меню меню.

Screenshot of the Push option from the Git menu in Visual Studio 2019.

  1. Создайте запрос на вытягивание, чтобы другие пользователи могли просматривать изменения. Если вы только что отпустили изменения из окна изменений Git, можно выбрать ссылку "Создать запрос на вытягивание", чтобы открыть веб-браузер, где можно создать новый запрос на вытягивание на веб-портале Azure Repos.

Screenshot of the 'Create a Pull Request' link in the 'Git Changes' window in Visual Studio 2019.

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

Screenshot of the 'Create a Pull Request' link in the 'Git Repository' window in Visual Studio 2019.

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

Screenshot of the 'Create a Pull Request' menu option from the branch context menu in the 'Git Repository' window in Visual Studio 2019.

Обозреватель Team Explorer в Visual Studio

  1. В Team Explorer выберите "Главная" и выберите " Синхронизировать ", чтобы открыть синхронизацию.

Screenshot of the Sync option in Team Explorer in Visual Studio 2019.

Вы также можете перейти в представление "Синхронизация " из "Изменения ", нажав кнопку "Синхронизировать " сразу после фиксации.

Screenshot of the Sync link that appears after making a commit in Visual Studio 2019.

  1. В представлении синхронизации нажмите кнопку "Отправить ", чтобы отправить фиксацию в удаленный репозиторий. Если это первая отправка в репозиторий, вы увидите следующее сообщение: The current branch does not track a remote branch...это позволяет узнать, что фиксация была отправлена в новую ветвь в удаленном репозитории и что будущие фиксации, отправленные из текущей ветви, будут отправлены в эту удаленную ветвь.

Screenshot of the Push link in the Synchronization view of Team Explorer in Visual Studio 2019.

  1. Создайте запрос на вытягивание, чтобы другие пользователи могли просматривать изменения. Откройте запросы на вытягивание в Team Explorer , выбрав "Главная" и выбрав "Запросы на вытягивание".

Screenshot of the 'Pull Requests' option in Team Explorer in Visual Studio 2019.

  1. В запросах на вытягивание можно просматривать запросы на вытягивание, открытые вами, назначенные вам, и создавать новые запросы на вытягивание. Выберите "Создать запрос на вытягивание", чтобы открыть веб-браузер, в котором можно создать новый запрос на вытягивание на веб-портале Azure Repos.

Screenshot of the 'New Pull Request' link in the Pull Requests view of Team Explorer in Visual Studio 2019.

Когда запрос на вытягивание откроется на веб-портале Azure Repos, проверьте исходные и конечные ветви. В этом примере мы хотим объединить фиксации из add-readme-file ветви в main ветвь. Введите название и необязательное описание, укажите всех рецензентов, при необходимости свяжите все рабочие элементы и нажмите кнопку "Создать".

Screenshot of the 'New Pull Request' form in the Azure Repos web portal.

Дополнительные сведения о запросах на вытягивание см. в руководстве по запросу на вытягивание .

Синхронизация с другими пользователями

Локальные ветви можно синхронизировать с удаленными коллегами, извлекая фиксации, созданные другими пользователями. Хотя Git хорошо объединяет входящие изменения с изменениями, иногда может потребоваться устранить конфликт слияния. При работе с ветвью функций рекомендуется периодически переключаться в main ветвь и извлекать новые фиксации, чтобы сохранить ее в актуальном состоянии с удаленной main ветвью.

Visual Studio Git

В окне "Изменения Git " вы можете сохранить локальную ветвь в актуальном состоянии с удаленным аналогом с помощью кнопок "Выборка", " Вытягивание", " Отправить", " Синхронизировать ".

Screenshot of the Fetch, Pull, Push and Sync buttons in the 'Git Changes' window of Visual Studio 2019.

Слева направо на предыдущем снимке экрана элементы управления кнопкой:

  • Выборка скачивает удаленные фиксации, которые не в локальной ветви, но не объединяют их.
  • Pull выполняет выборку, а затем объединяет скачанные фиксации в локальную ветвь.
  • Отправка отправляет незафиксированные фиксации в удаленный репозиторий, который добавляет их в соответствующую удаленную ветвь.
  • Синхронизация выполняет вытягивание , а затем принудительная отправка.

В меню Git также можно выбрать выборку, вытягивание, отправку и синхронизацию .

Screenshot of the Fetch, Pull, Push and Sync options in the Git menu in Visual Studio 2019.

Обозреватель Team Explorer в Visual Studio

  1. В Team Explorer выберите "Главная" и выберите "Синхронизировать ", чтобы открыть синхронизацию.

Screenshot of the Sync option in 'Team Explorer' in Visual Studio 2019.

  1. Последние изменения в ветви можно скачать с помощью ссылки "Вытягивание ". В разделе "Входящие фиксации" есть две ссылки на вытягивание: одна вверху и одна. Вы можете использовать любой из них, потому что они оба делают одно и то же.

Screenshot of the Pull link in the Synchronization view of Team Explorer in Visual Studio 2019.