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

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

Visual Studio 2019 | Visual Studio 2022

Начало разработки кода с помощью репозиториев 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 описывают, как использовать интерфейс Git, а также Team Explorer. Дополнительные сведения см. в разделе "Сравнение Git и Team Explorer".

Требуемые условия

Категория	Требования
доступ к проекту	Член проекта .
Разрешения	— Просмотр кода в частных проектах: по крайней мере базовый доступ. — Клонировать или вносить вклад в код в частных проектах: быть членом группы безопасности "Участники" или иметь соответствующие разрешения в проекте. — Установка разрешений для ветви или репозитория: Управление разрешениями предназначено для управления ветви или репозитория. — Изменение ветви по умолчанию: политики редактирования — это разрешения для репозитория. — Импорт репозитория: член группы безопасности администраторов проекта или разрешение уровня проекта Git на создание репозитория установлено в «Разрешить» . Дополнительные сведения см. в разделе "Настройка разрешений репозитория Git".
Services	Repos включено.
Инструменты	Необязательно. Используйте az repos команды: Azure DevOps CLI.

Примечание.

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

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

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

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

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

Visual Studio 2022 год

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

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

   

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

   

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

   

Примечание.

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

Visual Studio 2019 — меню Git

Visual Studio 2019 предоставляет интерфейс управления версиями Git с помощью меню Git, изменений Git и контекстных меню в Обозреватель решений.

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

   

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

   

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

   

Примечание.

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

Visual Studio 2019 — Team Explorer

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

Примечание.

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

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

   

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

   

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

Примечание.

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

Командная строка Git

1. Скачайте и установите Git и диспетчер учетных данных Git для своей платформы.

2. Откройте веб-портал Azure DevOps Services в браузере, перейдя по адресу https://<your account name>.visualstudio.com.

3. Откройте веб-портал Azure DevOps Services в браузере, перейдите к https://<your account name>.visualstudio.com, и найдите свой репозиторий Git. Скопируйте URL-адрес клона из всплывающего окна клонирования .

   

   Примечание.

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

4. В командной строке перейдите в папку, в которой требуется код, хранящийся на локальном компьютере.

5. В командной строке введите команду git clone, а затем укажите URL-адрес для клонирования, как показано в следующем примере.

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   Git скачивает и создает вашу копию кода в новой папке.

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

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

Visual Studio 2022 год

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

   

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

   

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

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

   

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

   

Примечание.

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

Visual Studio 2019 — меню Git

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

   

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

   

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

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

   

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

   

Примечание.

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

Visual Studio 2019 — Team Explorer

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

   

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

   

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

   

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

5. Когда вы удовлетворены вашими изменениями, сохраните их в Git, выполнив коммит. Откройте представление "Изменения" в Team Explorer, нажав кнопку "Главная" и выбрав "Изменения".

   

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

   

Примечание.

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

Командная строка Git

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

    > git branch ReadMeFix
   

   Выберите описательное имя для вашей рабочей ветки, чтобы напомнить вам и другим, какая работа ведется в этой ветке.

2. Проверьте вашу ветку, чтобы начать в ней работать.

    > git checkout ReadMeFix
   

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

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

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

    > git commit -a -m "Descriptive message"
   

   Эта команда сохраняет ваши изменения локально в новом коммите в Git. Обязательно дайте коммиту краткое сообщение, описывающее ваши изменения после -m.

Поделитесь своими изменениями

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

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

Visual Studio 2022 год

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

   

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

   

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

   

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

   

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

   

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

   

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

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

Visual Studio 2019 — меню Git

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

   

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

   

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

   

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

   

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

   

   Вы также можете щелкнуть правой кнопкой мыши любую ветвь в окне репозитория Git и выбрать Создать pull request.

   

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

Дополнительные сведения о pull request см. в учебнике Pull request.

Visual Studio 2019 — Team Explorer

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

   

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

   

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

   

3. Создайте pull request, чтобы другие могли просмотреть ваши изменения. Откройте Pull Requests в Team Explorer, выбрав Главная и затем Pull Requests.

   

4. В запросах на вытягивание можно просмотреть созданные вами и назначенные вам запросы, а также создать новые запросы на вытягивание. Выберите New Pull Request, чтобы открыть веб-браузер, в котором вы сможете создать новый pull request на веб-портале Azure Repos.

   

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

Для получения дополнительной информации о pull request см. руководство по pull request.

Командная строка Git

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

    > git push -u origin ReadMeFix
   

2. Откройте проект в веб-портале и перейдите к вашему репозиторию на вкладке "Код". Выберите "Создать pull request", чтобы создать pull request для отправленной ветви.

   

3. Проверьте ветви. В этом примере мы хотим объединить коммиты из ветки ReadMeFix в ветку main. Введите название и необязательное описание, укажите всех рецензентов, при необходимости свяжите все рабочие элементы и нажмите кнопку "Создать".

   

4. После утверждения изменений завершите пул-реквест. Полный pull request добавляет ваши изменения из ветки в основную ветку кода.

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

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

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

Visual Studio 2022 год

В окне "Изменения Git" вы можете поддерживать локальную ветвь в актуальном состоянии по отношению к удаленной, используя кнопки Fetch, Pull, Push и Sync.

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

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

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

Visual Studio 2019 — меню Git

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

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

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

Вы также можете выбрать Fetch, Извлечение, Push и Sync в меню Git.

Visual Studio 2019 — Team Explorer

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

   

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

   

Командная строка Git

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

    > git checkout ReadMeFix
   

   В этом примере вы извлекаете изменения, внесенные другими на вашей команде в ReadMeFix ветвь, в локальную копию этой ветви.

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

    > git pull
   

   Git скачивает изменения и объединяет их с вашими изменениями в вашу локальную ветвь.

Связанные статьи

• Часто задаваемые вопросы о Git
• Интерфейс GIT в Visual Studio
• Параллельное сравнение Git и Team Explorer