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

Azure DevOps Services | Azure DevOps Server 2022 г. - Azure DevOps Server 2019 г. | TFS 2018

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 с меньшим переключением контекста, чем команда Обозреватель. Процедуры, приведенные в этой статье на вкладке Visual Studio, предоставляют сведения об использовании интерфейса Git, а также Обозреватель команды. Дополнительные сведения см. в статье Параллельное сравнение Git и Обозреватель команды.

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

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

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

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

    Примечание

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

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

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

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

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

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

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

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

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

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

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

  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-адреса доменного имени.

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

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

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

    Снимок экрана: параметр

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

    Снимок экрана: окно

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

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

    Снимок экрана: кнопка

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

    Снимок экрана: ссылка на сведения о фиксации в Visual Studio.

Примечание

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

Снимок экрана: параметр

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

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

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

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

    Снимок экрана: кнопка со стрелкой вверх в окне

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

    Снимок экрана: ссылка

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

    Снимок экрана: параметр

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

    Снимок экрана: ссылка

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

    Снимок экрана: ссылка

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

    Снимок экрана: пункт меню

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

Снимок экрана: форма

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

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

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

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

Снимок экрана: кнопки

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

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

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

Снимок экрана: параметры