Предоставление общего доступа к коду с помощью Azure Repos и Visual Studio

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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

• Добавление проекта или решения в локальный репозиторий Git
• Публикация кода в репозитории Azure Repos Git или репозитории GitHub
• Просмотрите изменения кода перед публикацией
• Связывайте рабочие элементы с коммитами
• Фиксация и отправка обновлений
• Извлечение изменений из основной ветви репозитория

Чтобы клонировать репозиторий GitHub, получите URL-адрес клонирования, как описано в клонировании репозитория.

Для обзора рабочего процесса Git см. руководство по использованию Azure Repos Git.

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

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

Примечание.

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

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

Примечание.

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

Добавление проекта или решения в новый локальный репозиторий Git

Первым шагом к совместному использованию решения Visual Studio с другими пользователями с помощью Git является создание локального репозитория Git для кода. Если вы впервые используете Visual Studio для подключения к Azure Repos, дополнительные сведения см. в статье "Подключение к проекту" из Visual Studio.

Visual Studio 2022 год

1. Создайте локальный репозиторий Git для решения Visual Studio, щелкнув правой кнопкой мыши имя решения в Обозреватель решений, а затем выберите "Создать репозиторий Git". Или нажмите кнопку "Добавить в систему управления версиями" в строке состояния в правом нижнем углу Visual Studio, а затем выберите Git. Если эти параметры не отображаются, код уже находится в репозитории Git.

   

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

   

2. Этот шаг применяется только к интерфейсу управления версиями Visual Studio Git: в окне "Создание репозитория Git" выберите "Только локальный", проверьте правильность локального пути и нажмите кнопку "Создать".

   

Теперь вы создали локальный репозиторий Git в папке решения Visual Studio и зафиксировали код в этом репозитории. Локальный репозиторий Git содержит как решение Visual Studio, так и ресурсы Git.

Visual Studio 2019 — меню Git

1. Создайте локальный репозиторий Git для решения Visual Studio, щелкнув правой кнопкой мыши имя решения в Обозреватель решений, а затем выберите "Создать репозиторий Git". Или нажмите кнопку "Добавить в систему управления версиями" в строке состояния в правом нижнем углу Visual Studio, а затем выберите Git. Если эти параметры не отображаются, код уже находится в репозитории Git.

   

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

   

2. Этот шаг применяется только к интерфейсу управления версиями Visual Studio Git: в окне "Создание репозитория Git" выберите "Только локальный", проверьте правильность локального пути и нажмите кнопку "Создать".

   

Теперь вы создали локальный репозиторий Git в папке решения Visual Studio и зафиксировали код в этом репозитории. Локальный репозиторий Git содержит как решение Visual Studio, так и ресурсы Git.

Visual Studio 2019 — Team Explorer

Эти задачи не поддерживаются через Team Explorer.

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

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

2. В командной строке перейдите в корневую папку, содержащую решение Visual Studio, и выполните следующие команды. Эти команды создают локальный репозиторий Git в папке решения Visual Studio и фиксируют код в этом репозитории.

   > git init
   > git commit -am "first commit"
   > git branch -m main
   

   Локальный репозиторий Git теперь содержит как решение Visual Studio, так и ресурсы Git.

   

Публикация кода

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

Visual Studio 2022 год

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

1. Подключитесь к репозиторию Azure DevOps, щелкнув правой кнопкой мыши имя решения в Обозреватель решений, а затем нажмите кнопку "Отправить в службу Git", чтобы запустить окно репозитория Git.

   

   Или выберите Git > Push to Git service в строке меню, чтобы запустить окно Создать репозиторий в Git.

   

2. В диалоговом окне "Создание репозитория Git" выберите GitHub. Введите все необходимые значения в разделе "Создание нового репозитория GitHub". Затем нажмите кнопку "Отправить".

   

   Вы можете убедиться, что репозиторий создан, перейдя в GitHub и найдите имя репозитория в учетной записи.

Visual Studio 2019 — меню Git

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

1. Подключитесь к репозиторию Azure DevOps, щелкнув правой кнопкой мыши имя решения в Обозреватель решений, а затем нажмите кнопку "Отправить в службу Git", чтобы запустить окно репозитория Git.

   

   Или выберите Git Push в сервисе Git в строке меню, чтобы открыть окно Создание репозитория Git.

   

2. Откройте браузер и перейдите к проекту Azure DevOps с помощью URL-адреса в виде https://dev.azure.com/<OrganizationName>/<ProjectName>. Если у вас еще нет проекта, создайте его.

3. В проекте Azure DevOps создайте пустой репозиторий Git без файла README. Скопируйте URL-адрес клона из всплывающего окна репозитория для клонирования.

   

4. В окне "Создание репозитория Git" выберите "Существующий удаленный", введите URL-адрес клонирования репозитория из предыдущего шага, затем нажмите "Отправить". Дополнительные сведения о создании репозитория Azure DevOps см. в статье "Создание репозитория Git в проекте".

   

5. В окне изменений Git отображается сообщение о том, что код теперь находится в репозитории Azure DevOps.

   

Примечание.

При использовании 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. Чтобы использовать Team Explorer, снимите флажок в меню Инструменты, выберите Параметры, перейдите к Предварительные функции и отключите новый интерфейс Git. Вы можете в равной степени использовать функции Git из любого интерфейса. Ниже мы предлагаем сравнительный анализ для публикации вашего кода.

Примечание.

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

1. В разделе Push to Azure Dev Ops Services в виде синхронизации в Team Explorer нажмите кнопку "Опубликовать Git-репозиторий".

   

2. Выберите организацию Azure DevOps и имя репозитория, а затем выберите "Опубликовать репозиторий".

   

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

3. Теперь код находится в репозитории Azure Repos Git. Код можно просматривать в Интернете, выбрав Просмотреть на веб-сайте.

   

Примечание.

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

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

1. Откройте браузер и перейдите к проекту Azure DevOps с помощью URL-адреса в виде https://dev.azure.com/<OrganizationName>/<ProjectName>. Если у вас еще нет проекта, создайте его.

2. В проекте Azure DevOps создайте пустой репозиторий Git без файла README. Скопируйте URL-адрес клона из всплывающего окна репозитория Клонирования .

   

3. Чтобы опубликовать локальную фиксацию в репозитории Azure, выполните следующие команды в командной строке в локальной папке репозитория Git, используя URL-адрес клонирования из предыдущего шага.

   > git remote add origin <clone URL>
   > git push -u origin main
   

   Теперь код публикуется в main ветви репозитория Azure Repos Git.

Примечание.

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

Просмотреть изменения коммита

Рекомендуется просмотреть изменения кода в вашем коммите перед его публикацией. Visual Studio предоставляет режим сравнения, который помогает просматривать все изменения, внесенные с момента предыдущего коммита.

Visual Studio 2022 год

1. Чтобы узнать, что изменилось в фиксации, выберите Git>Управление ветвями, чтобы открыть окно репозитория Git.

   

2. В окне репозитория Git выберите ветвь, щелкните правой кнопкой мыши коммит и выберите Просмотр данных коммита, чтобы открыть окно коммита.

   

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

   

Visual Studio 2019 — меню Git

1. Чтобы узнать, что изменилось в фиксации, выберите Git>Управление ветвями, чтобы открыть окно репозитория Git.

   

2. В окне репозитория Git выберите свою ветку, щелкните правой кнопкой мыши по коммиту и выберите команду Просмотреть сведения о коммите, чтобы открыть окно Фиксация.

   

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

   

Visual Studio 2019 — Team Explorer

1. Чтобы узнать, что изменилось в фиксации, перейдите на страницу синхронизации в Team Explorer, щелкните правой кнопкой мыши любую фиксацию, а затем выберите "Просмотреть сведения о фиксации", чтобы открыть окно сведений о Git.

   

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

   

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

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

> git show

Свяжите рабочие элементы с коммитами

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

Примечание.

Синтаксис #ID поддерживается при подключении к репозиторию Azure Repos Git. При подключении к репозиторию GitHub можно по-прежнему ссылаться на рабочие элементы, но необходимо использовать синтаксис #ABID и предварительно настроить подключение Azure Boards-GitHub.

Visual Studio 2022 год

Рабочие элементы можно связать с коммитом, добавив #ID в сообщение коммита. Например, сообщение коммита "Исправление ошибки #12 Отсутствие значков в инструментах отчетности" свяжет рабочий элемент 12 с коммитом при отправке коммита в Azure Repos.

Visual Studio 2019 — меню Git

Рабочие элементы можно связать с коммитами, добавив #ID в сообщение коммита. Например, сообщение коммита "Исправление ошибки #12 Отсутствие значков в инструментах отчетности" будет связывать рабочий элемент 12 с коммитом при отправке его в Azure Repos.

Visual Studio 2019 — Team Explorer

Рабочие элементы можно включить в фиксации с помощью Связанных рабочих элементов в представлении ИзмененияTeam Explorer.

Вы также можете связать рабочие элементы с коммитами, добавив #ID в сообщение коммита. Например, сообщение коммита "Исправление ошибки #12 в инструментах отчетности" будет связывать рабочий элемент 12 с коммитом при пуше коммита в Azure Repos.

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

Рабочие элементы можно связать с фиксацией, добавив #ID в сообщение фиксации. Например, сообщение о фиксации "Исправление ошибки #12 в средствах отчетности" будет связывать рабочий элемент 12 с фиксацией при отправке фиксации в Azure Repos. Чтобы проверить, внесите некоторые изменения кода и выполните следующие команды в командной строке в локальной папке репозитория Git.

> git commit -am "Fix bug #<work item ID>"
> git push

Изменения фиксации push-уведомлений

Visual Studio 2022 год

При написании кода в Visual Studio изменения отслеживаются автоматически. Когда вы удовлетворены вашими изменениями, вы можете сохранить их в Git с помощью коммита, а затем отправить коммит в Azure Repos.

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

   

2. Чтобы отправить коммит в Azure Repos, нажмите кнопку с изображением стрелки вверх.

   

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

   

   Вы также можете выбрать Git > Push в строке меню.

   

Visual Studio 2019 — меню Git

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

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

   

2. Чтобы отправить коммит в Azure Repos, нажмите кнопку со стрелкой вверх.

   

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

   

   Вы также можете выбрать Git > Push в строке меню.

   

Visual Studio 2019 — Team Explorer

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

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

   

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

   

3. Чтобы отправить одну или несколько фиксаций в Azure Repos, выберите "Главная " и выберите "Синхронизация ", чтобы открыть представление синхронизации в Team Explorer. Или выберите значок строки состояния неопубликованных изменений () на строке состояния.

   

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

   

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

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

> git push

Изменения в запросе

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

Примечание.

В Visual Studio ссылки Fetch и Pull можно найти в разных представлениях и в меню Git в строке меню. Эти ссылки все делают одно и то же — извлекают из удаленного репозитория в текущую ветвь локального репозитория.

Visual Studio 2022 год

1. В окне "Изменения Git" можно проверить наличие последних фиксаций в удаленной ветви с помощью ссылки со стрелкой вниз, а затем выбрать исходящую / входящую ссылку, чтобы открыть окно репозитория Git. Fetch загружает удалённые коммиты, которых нет в вашей локальной ветке, но не объединяет их в эту ветку. Полученные фиксации отображаются в разделе Входящие фиксации окна репозитория Git. Вы можете дважды щелкнуть полученный коммит, чтобы просмотреть изменения в файлах.

   

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

Visual Studio 2019 — меню Git

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

   

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

Visual Studio 2019 — Team Explorer

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

   

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

   

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

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

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

> git fetch

Чтобы скачать и объединить новые коммиты из Git репозитория Azure Repos в текущую ветвь локального репозитория, выполните следующую команду.

> git pull

Вопросы и ответы

Вопрос. Почему страница входа отличается от веб-портала и Visual Studio?

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

Вопрос. Можно ли использовать командную строку Git с Visual Studio?

Ответ. Командный обозреватель Visual Studio и командная строка Git отлично работают вместе. Изменения в репозиториях, сделанные в одном из инструментов, будут отражены в другом. Не забудьте установить последний выпуск Git для Windows, который содержит средства для подключения к репозиторию Azure DevOps Services/TFS.

Ознакомьтесь с руководством по Azure Repos Git и ссылкой на команду для получения дополнительной справки по использованию Git из командной строки.

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

Настройка сборкиРуководство Azure Repos Git

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

• Вы не знакомы с репозиториями Git? Подробнее