Как из visual studio отправлять проект на github

Git для новичков (часть 1)

Git — это консольная утилита, для отслеживания и ведения истории изменения файлов, в вашем проекте. Чаще всего его используют для кода, но можно и для других файлов. Например, для картинок — полезно для дизайнеров.

С помощью Git-a вы можете откатить свой проект до более старой версии, сравнивать, анализировать или сливать свои изменения в репозиторий.

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

Так же ваши репозитории можно хранить и в интернете. Обычно для этого используют три сервиса:

Каждая точка сохранения вашего проекта носит название коммит (commit). У каждого commit-a есть hash (уникальный id) и комментарий. Из таких commit-ов собирается ветка. Ветка — это история изменений. У каждой ветки есть свое название. Репозиторий может содержать в себе несколько веток, которые создаются из других веток или вливаются в них.

Как работает

Если посмотреть на картинку, то становиться чуть проще с пониманием. Каждый кружок, это commit. Стрелочки показывают направление, из какого commit сделан следующий. Например C3 сделан из С2 и т. д. Все эти commit находятся в ветке под названием main . Это основная ветка, чаще всего ее называют master . Прямоугольник main* показывает в каком commit мы сейчас находимся, проще говоря указатель.

В итоге получается очень простой граф, состоящий из одной ветки ( main ) и четырех commit. Все это может превратиться в более сложный граф, состоящий из нескольких веток, которые сливаются в одну.

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

Установка

Основой интерфейс для работы с Git-ом является консоль/терминал. Это не совсем удобно, тем более для новичков, поэтому предлагаю поставить дополнительную программу с графическим интерфейсом (кнопками, графиками и т.д.). О них я расскажу чуть позже.

Но для начала, все же установим сам Git.

Windows. Проходим по этой ссылке, выбираем под вашу ОС (32 или 64 битную), скачиваем и устанавливаем.
Для Mac OS. Открываем терминал и пишем:

#Если установлен Homebrew brew install git #Если нет, то вводим эту команду. git --version #После этого появится окно, где предложит установить Command Line Tools (CLT). #Соглашаемся и ждем установки. Вместе с CLT установиться и git

Linux. Открываем терминал и вводим следующую команду.

# Debian или Ubuntu sudo apt install git # CentOS sudo yum install git

Настройка

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

Открываем терминал (Linux и MacOS) или консоль (Windows) и вводим следующие команды.

#Установим имя для вашего пользователя #Вместо можно ввести, например, Grisha_Popov #Кавычки оставляем git config --global user.name "" #Теперь установим email. Принцип тот же. git config --global user.email ""

Создание репозитория

Теперь вы готовы к работе с Git локально на компьютере.

Создадим наш первый репозиторий. Для этого пройдите в папку вашего проекта.

#Для Linux и MacOS путь может выглядеть так /Users/UserName/Desktop/MyProject #Для Windows например С://MyProject cd #Инициализация/создание репозитория git init

Теперь Git отслеживает изменения файлов вашего проекта. Но, так как вы только создали репозиторий в нем нет вашего кода. Для этого необходимо создать commit.

#Добавим все файлы проекта в нам будующий commit git add . #Или так git add --all #Если хотим добавить конкретный файл то можно так git add #Теперь создаем commit. Обязательно указываем комментарий. #И не забываем про кавычки git commit -m ""

Отлично. Вы создали свой первый репозиторий и заполнили его первым commit.

Процесс работы с Git

Не стоит после каждого изменения файла делать commit. Чаще всего их создают, когда:

Создан новый функционал
Добавлен новый блок на верстке
Исправлены ошибки по коду
Вы завершили рабочий день и хотите сохранить код

Это поможет держать вашу ветки в чистоте и порядке. Тем самым, вы будете видеть историю изменений по каждому нововведению в вашем проекте, а не по каждому файлу.

Визуальный интерфейс

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

Но существуют и отдельные программы по работе с Git. Могу посоветовать эти:

Я не буду рассказывать как они работают. Предлагаю разобраться с этим самостоятельно.

Создаем свой первый проект и выкладываем на GitHub

Давайте разберемся как это сделать, с помощью среды разработки Visual Studio Code (VS Code).

Перед началом предлагаю зарегистрироваться на GitHub.

Создайте папку, где будет храниться ваш проект. Если такая папка уже есть, то создавать новую не надо.

После открываем VS Code .

Установите себе дополнительно анализаторы кода для JavaScript и PHP
Откройте вашу папку, которую создали ранее

После этого у вас появится вот такой интерфейс

Здесь будут располагаться все файлы вашего проекта
Здесь можно работать с Git-ом
Кнопка для создания нового файла
Кнопка для создания новой папки

Если ваш проект пустой, как у меня, то создайте новый файл и назовите его index.html . После этого откроется окно редактирование этого файла. Напишите в нем ! и нажмите кнопку Tab . Автоматически должен сгенерироваться скелет пустой HTML страницы. Не забудьте нажать ctrl+s чтобы файл сохранился.

Давайте теперь перейдем во вкладу для работы с Git-ом.

Откроется вот такое окно:

Кнопка для публикации нашего проекта на GitHub
После нажатия на кнопку 1 , появится всплывающее окно. Нужно выбрать второй вариант или там где присутствует фраза . public repository

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

После того, как выбрали «Опубликовать на GitHub публичный репозиторий» (пункт 2), программа предложит вам выбрать файлы, которые будут входить в первый commit. Проставляем галочки у всех файлов, если не проставлены и жмем ОК . Вас перекинет на сайт GitHub, где нужно будет подтвердить вход в аккаунт.

Вы создали и опубликовали репозиторий на GitHub.

Теперь сделаем изменения в коде и попробуем их снова опубликовать. Перейдите во вкладку с файлами, отредактируйте какой-нибудь файл, не забудьте нажать crtl+s (Windows) или cmd+s (MacOS), чтобы сохранить файл. Вернитесь обратно во вкладу управления Git.

Если посмотреть на значок вкладки Git, то можно увидеть цифру 1 в синем кружке. Она означает, сколько файлов у нас изменено и незакоммичено. Давайте его закоммитим и опубликуем:

Кнопка для просмотра изменений в файле. Необязательно нажимать, указал для справки
Добавляем наш файл для будущего commit
Пишем комментарий
Создаем commit
Отправляем наш commit в GitHub

Поздравляю, вы научились создавать commit и отправлять его в GitHub!

Итог

Это первая вводная статья по утилите Git. Здесь мы рассмотрели:

Как его устанавливать
Как его настраивать
Как инициализировать репозиторий и создать commit через консоль
Как на примере VS Code, опубликовать свой код на GitHub

Забегая вперед, советую вам погуглить, как работают следующие команды:

git help # справка по всем командам git clone git status git branch git checkout git merge git remote git fetch git push git pull

P.S. Для облегчения обучения, оставлю вам ссылку на бесплатный тренажер по Git.

В телеграмм канале Step by Step , я публикую еще больше материала и провожу обучающие стримы, для всех желающих.

Выбор правильного управления версиями для проекта

Независимо от того, является ли проект вашего программного обеспечения большим или малым, рекомендуется как можно скорее использовать контроль версий. Azure Repos поддерживает два типа управления версиями: Git и система управления версиями Team Foundation (TFVC).

Какую систему управления версиями мне использовать?

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

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

Git (распределенная система)

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

Git в Visual Studio, Azure DevOps Services и Azure DevOps Server — это стандартный Git. Вы можете использовать Visual Studio со сторонними службами Git, а также сторонние клиенты Git с Azure DevOps Server.

Дополнительные сведения см. в статье Git и Azure Repos.

TFVC (централизованная)

Подсистема контроля версий Team Foundation (TFVC) — это централизованная система управления версиями. Как правило, члены команды имеют на своих компьютерах разработки только одну версию каждого файла. Исторические данные ведутся только на сервере. Ветви основаны на путях и создаются на сервере.

Серверные рабочие области Перед внесением изменений члены команды открыто извлекают файлы. Большинство операций требуют подключения разработчиков к серверу. Эта система упрощает рабочие процессы блокировки. Другие системы, работающие таким образом, включают Visual Source Safe, Perforce и CVS. С помощью серверных рабочих областей можно масштабировать до очень больших баз кода с миллионами файлов на ветвь и большими двоичными файлами.
Локальные рабочие области . Каждый участник команды получает с собой копию последней версии базы кода и по мере необходимости работает в автономном режиме. Разработчики возвращают свои изменения и при необходимости разрешают конфликты. Еще одна система, которая работает таким образом, — это Subversion.

Переход с TFVC на Git

Если у вас есть репозитории TFVC, их можно перенести в репозитории Git с помощью средства git-tfs. Это средство позволяет перенести репозиторий TFVC в репозиторий Git с помощью нескольких команд.

Возможности Git и TFVC

В следующей таблице представлена сводка о том, как TFVC и Git поддерживают main возможности управления версиями.

Возможность

Как из visual studio отправлять проект на github

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

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

Для выполнения этой статьи вам потребуется:

Создание репозитория GitHub

Откройте Visual Studio и нажмите кнопку «Создать проект«.

Если у вас еще нет проекта в Visual Studio для добавления в репозиторий, можно быстро создать консольное приложение C# и присвоить ему имя MyNewApp. Visual Studio заполняет новое приложение кодом по умолчанию «Hello, World!».

В меню Git выберите «Создать репозиторий Git«.

В диалоговом окне «Создание репозитория Git » в разделе «Отправить в новый удаленный раздел» выберите GitHub.

В разделе «Создание нового репозитория GitHub » диалогового окна «Создание репозитория Git » введите имя репозитория, который вы хотите создать.

Если вы еще не вошли в учетную запись GitHub, это можно сделать с этого экрана.

После входа и ввода сведений о репозитории нажмите кнопку «Создать» и «Отправить «, чтобы создать репозиторий и добавить приложение.

Открытие существующего локального репозитория

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

Создание репозитория Azure DevOps

Откройте Visual Studio и нажмите кнопку «Создать проект«.

В меню Git выберите «Создать репозиторий Git«.

В диалоговом окне «Создание репозитория Git » в разделе «Отправка в новый удаленный » выберите Azure DevOps.

В разделе «Создание нового репозитория Azure DevOps » войдите в учетную запись Azure и выберите проект из раскрывающегося списка Project .

Нажмите кнопку «Создать» и «Отправить «, чтобы создать репозиторий и добавить приложение.

Как подключиться к github из visual studio?

В Visual Studio уже встроен Git. Везде пишут только как скачать уже имеющийся удалённый репозиторий с git hub’а, но нигде, как подключиться к гитхаб аккаунту из visual studio Итак, у меня есть аккаунт на guthub, я создал приложение на локальном компе. Как мне через visual studio без доп плагинов подключиться к своему аккаунту, создать новый репозиторий и запушить папку с проектом в него?

Открыть Team Explorer (View — Team Explorer), затем кликните по иконке штепселя (Manage Connection):

введите сюда описание изображения

Более подробное описание в документации

PS Ещё в меню View — Other Windows есть пункт Github, но я им не пользовался, так как гитхабом не пользуюсь так как мне приходится чаще с tfs работать.

Для GitLab и Githab, как подключиться из VS к удаленному аккаунту и добавить локальный проект в новый пустой репозиторий.

1) Сначала на gitlab.com создаем новый проект с названием, соответствующим локальному проекту. На Github так же, только Репозиторий.

введите сюда описание изображения

2) В Visual Studio в проекте нажимаем внизу окна кнопку «Добавить в систему управления версиями»=> git.

3) В разделе «Отправить в удаленный репозиторий» вводим URL-адрес созданного на сайте репозитория проекта, нажимаем Опубликовать. Проект должен загрузиться на сайт.

Git, GitHub и Visual Studio. В помощь новичкам

В ней будет коротко рассмотрено что это за вещи, зачем нужны, и простой способ работы – из среды Visual Studio. То есть Bash или GitHub клиент использоваться не будут.

Внимание:

На Хабре уже есть похожая статья – [вот она]. В своей публикации я дополню слова Алексея и расскажу метод проще.

Для кого:

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

О тексте:

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

Итак, немного теории чтоб понять, что делать дальше:

Git и GitHub – связаны, но они не одно и то же.
Git – распределенная система контроля версий. Можете представить, как механизм резервного копирования, сохранения в играх. То есть в любой момент вы можете вернуться к предыдущему состоянию и попробовать сделать что-то иначе.
Распределенная значит что все данные хранятся не только у вас, но и на сервере (GitHub), у других участников команды (если таковая имеется).
Если непонятно, можете посмотреть — www.youtube.com/watch?v=w3jLJU7DT5E
Терминология тоже имеется на ней внимание не заостряю, не о том сейчас.

Visual Studio 2015 года или новее
Подключение к интернету
Несколько гигабайт памяти на жестком диске

Инструкция:

После, с GitHub копируем ссылку:

Ответ:

Дополнительно:

Чтоб GitHub верно отображал русские комментарии (если есть) при просмотре кода через сайт нужно сделать следующее:

Cоветую всё-таки изучить Git Bash.

Я старался писать как можно понятнее, если что-то не так, то поправьте в комментариях!
На этом все. Спасибо за внимание!

Похожие публикации:

Как изменить размер фигуры в visio
Как изменить тип данных в postgresql
Как изменить цвет картинки при наведении css
Как изменить шрифт в браузере microsoft edge

Создание запросов на вытягивание

Создание запросов на вытягивание (PR) для изменения, проверки и слияния кода в репозитории Git. Запросы на запросы можно создавать из ветвей в репозитории вышестоящий или из ветвей в вилке репозитория. Ваша команда может просматривать РС и оставлять отзывы об изменениях. Рецензенты могут выполнить предложенные изменения, оставить комментарии и проголосовать за утверждение или отклонение ЗАПРОСОВ. В зависимости от политик ветвей и других требований запрос на вытягивание может соответствовать различным критериям, прежде чем вы сможете выполнить запрос на вытягивание и объединить изменения в целевую ветвь.

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

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

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

Чтобы просмотреть или просмотреть PR, необходимо быть участником проекта Azure DevOps с доступом уровня «Базовый» или более поздней версии.

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

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

В проекте должны быть включены репозитории. Если центр Repos и связанные страницы не отображаются, см. статью Включение или отключение службы Azure DevOps для повторного включения Репозиториев.
Чтобы просмотреть или просмотреть PR, необходимо быть участником проекта Azure DevOps с доступом уровня «Базовый» или более поздней версии. Если вы не участник проекта, добавьте его.
Чтобы создать и завершить запрос на вытягивание, необходимо быть членом группы безопасности «Участники» или иметь соответствующие разрешения в проекте, который требуется изменить.
Чтобы внести свой вклад в вытягивание, необходимо быть членом группы безопасности Читатели или иметь соответствующие разрешения.

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

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

Вы можете создавать запросы на запросы и управлять ими с помощью интерфейса командной строки Azure (CLI) с azure-devops помощью расширения . Сведения о работе с Azure DevOps Services CLI см. в статье Начало работы с Azure DevOps CLI. Azure Repos команд CLI для запросов на вытягивание используется az repos pr.

Создание запроса на включение изменений

Вы можете создать запрос на вытягивание на веб-сайте проекта Azure DevOps, из Visual Studio или с помощью Azure DevOps CLI.

На веб-сайте проекта Azure DevOps можно создать новый запрос на вытягивание из:

Страница Запросы на вытягивание.
Ветвь компонента отправлен в репозиторий.
Существующий запрос на вытягивание с помощью вишни-забрать.
Элемент управления Разработка в связанном Azure Boards рабочем элементе.

Создание запроса на вытягивание на странице запросов на вытягивание

Вы можете создать запросы на вытягивание для любой ветви на странице запросов на вытягивание проекта в Интернете.

На страницеЗапросы на вытягиваниеRepos> выберите Новый запрос на вытягивание в правом верхнем углу.
Выберите ветвь с изменениями и ветвь, в которую вы хотите объединить изменения, например ветвь main.
Введите сведения о запросе на вытягивание и создайте запрос на вытягивание.

Создание запроса на вытягивание из отправленной ветви

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

На странице Запросы на вытягивание :
На странице Файлы :

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

После отправки или обновления ветвь компонента Azure Repos предложит создать запрос на вытягивание в представлении кода в Интернете. Этот запрос отображается в параметрах «Запросы на вытягивание » и «Файлы«.

Снимок экрана: запрос на создание P R на вкладке

Создание запроса на вытягивание из связанного рабочего элемента

Вы можете создать запрос на вытягивание непосредственно из Azure Boards рабочего элемента, связанного с ветвью.

Снимок экрана: создание запроса на вытягивание из области разработка рабочего элемента со связанной ветвью.

В Azure Boards откройте рабочий элемент, связанный с ветвью, в разделе Невыполненная работа или Запросы в представлении Труд.
В области Разработка рабочего элемента выберите Создать запрос на вытягивание.

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

Чтобы создать запрос на вытягивание, выполните приведенные далее действия.

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

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

Чтобы создать запросы на запросы из Visual Studio Team Обозреватель:

Подключитесь к проекту из Visual Studio.
Выберите Просмотреть>Обозреватель команды, чтобы открыть Обозреватель команды. Можно также нажать клавиши CTRL+\, CTRL+M.
На главной странице выберите Запросы на вытягивание , чтобы просмотреть списки запросов на вытягивание, открытые или назначенные вам.
В представлении Запросы на вытягивание выберите Создать запрос на вытягивание.
Выберите исходную и целевую ветви, введите заголовок и необязательное описание и нажмите кнопку Создать.
После создания запроса на вытягивание выберите Открыть в браузере , чтобы открыть новый запрос на вытягивание на веб-портале Azure DevOps.

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

Снимок экрана: инициализация P R из представления

Чтобы создать запрос запроса на вытягивание в проекте, используйте команду az repos pr create. Чтобы открыть запрос на вытягивание в браузере после создания, используйте —open параметр .

az repos pr create [--auto-complete ] [--bypass-policy ] [--bypass-policy-reason] [--delete-source-branch ] [--description] [--detect ] [--draft ] [--merge-commit-message] [--open] [--org] [--project] [--repository] [--reviewers] [--source-branch] [--squash ] [--subscription] [--target-branch] [--title] [--transition-work-items ] [--work-items]

Параметры

Параметр	Описание
—auto-complete	Настройте автоматическое выполнение запроса на вытягивание и выполните слияние с целевой ветвью при прохождении всех политик. Допустимые значения: false , true .
—bypass-policy	Обойдите все необходимые политики и завершите запрос на вытягивание после его объединения. Допустимые значения: false , true .
—bypass-policy-reason	Причина обхода обязательных политик.
—delete-source-branch	Удалите исходную ветвь после завершения запроса на вытягивание и объединения с целевой ветвью. Допустимые значения: false , true .
—description -d	Описание нового запроса на вытягивание, которое может включать Markdown. Каждое значение является новой строкой. Например: —description «First Line» «Second Line» .
—detect	Автоматическое обнаружение организации. Допустимые значения: false , true .
—draft	Создайте запрос на вытягивание в режиме черновика по мере выполнения работы. Допустимые значения: false , true .
—merge-commit-message	Сообщение, отображающееся при фиксациях слиянием.
—open	Откройте запрос на вытягивание в веб-браузере.
—org —organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL . Требуется, если не настроено по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/ .
—project -p	Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID . Требуется, если не настроено по умолчанию или выбрано с помощью конфигурации Git.
—repository -r	Имя или идентификатор репозитория для создания запроса на вытягивание. Обязательный параметр.
—reviewers	Дополнительные пользователи или группы для включения в качестве рецензентов в новом запросе на вытягивание. Пространство разделено.
—source-branch -s	Имя исходной ветви. Например, «dev» .
—squash	Сжатие фиксаций в исходной ветви при слиянии с целевой ветвью. Допустимые значения: false , true .
—subscription	Имя или идентификатор подписки Azure. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID .
—target-branch -t	Имя целевой ветви. Если не указано, по умолчанию используется ветвь по умолчанию целевого репозитория.
—title	Заголовок нового запроса на вытягивание.
—transition-work-items	При изменении состояния запроса переведите все рабочие элементы, связанные с запросом на вытягивание, в следующее логическое состояние. Например, измените значение Активные рабочие элементы на Resolved. Допустимые значения: false , true .
—work-items	Идентификаторы рабочих элементов для связи с новым запросом на вытягивание. Пространство разделено.

Пример

Следующая команда создает запрос запроса на вытягивание из new ветви в ветвь по умолчанию main репозитория Fabrikam, открывает запрос на вытягивание в браузере и отображает выходные данные команды в таблице. В примере используется конфигурация по умолчанию: az devops configure —defaults organization=https://dev.azure.com/fabrikamprime project=»Fabrikam Fiber» .

az repos pr create --repository Fabrikam --source-branch new --open --output table ID Created Creator Title Status IsDraft Repository ---- ---------- ------------------- ---------------------------- -------- --------- ------------ 30 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam

Вы можете добавить множество других сведений о запросе на вытягивание при создании запроса или после его создания. Сведения о добавлении сведений, рецензентов, рабочих элементов и параметров завершения в запрос на вытягивание см. в статье Добавление сведений или изменение запросов на вытягивание.

Команды Azure DevOps CLI не поддерживаются для Azure DevOps Server локальной среде.

Добавление обновлений с помощью cherry-pick

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

Чтобы выбрать изменения из завершенного запроса на вытягивание, выберите Cherry-pick на странице Обзор запроса. Чтобы скопировать изменения из активного запроса на вытягивание, выберите Cherry-pick в меню Дополнительные параметры запроса. Это действие создает новую ветвь с скопированными изменениями. Затем можно создать запрос на вытягивание из новой ветви. Подробные инструкции см. в разделе Копирование изменений с помощью cherry-pick.

Переключение исходной и целевой ветвей запроса на вытягивание

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

Снимок экрана: значок переключения исходной и целевой ветвей.

Использование шаблонов запросов на вытягивание

Шаблон запроса на вытягивание — это файл, содержащий текст Markdown, который заполняет описание запроса на вытягивание при создании запроса на вытягивание. Хорошие описания запросов на вытягивание сообщают рецензентам о том, чего следует ожидать, и могут помочь отслеживать такие задачи, как добавление модульных тестов и обновление документации. Ваша команда может создать шаблон запроса на вытягивание по умолчанию, который добавляет текст ко всем новым описаниям запроса в репозитории. Кроме того, вы можете выбрать один из шаблонов для конкретных ветвей или других шаблонов, определенных командой. Дополнительные сведения о создании и использовании шаблонов запроса на вытягивание см. в разделе Улучшение описания запросов на вытягивание с помощью шаблонов.

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

Снимок экрана: добавление шаблона при создании P R.

Создание черновика запроса на запросы

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

Черновик prs имеет следующие отличия от опубликованных PRs:

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

Для создания черновиков PRS требуется обновление Azure DevOps Server 2019.1 или более поздней версии.

Чтобы создать черновик запроса на вытягивание, щелкните стрелку рядом с кнопкой Создать и выберите Создать как черновик при создании запроса на вытягивание. Вам не нужно использовать префиксы заголовков, например WIP или DO NOT MERGE.

Снимок экрана: создание в виде черновика P R.

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

Снимок экрана: публикация для P R.

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

Снимок экрана: пометить как черновик.

Для этой функции требуется обновление Azure DevOps Server 2019.1 или более поздней версии.

Чтобы задать черновик запроса на вытягивание, откройте запрос на вытягивание и выберите Пометить как черновик.

Чтобы открыть запрос на вытягивание из Visual Studio, в меню Git выберите > GitПросмотреть запросы на вытягивание и выберите запрос на вытягивание, чтобы открыть его.

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

Чтобы создать запрос на вытягивание в виде черновика, задайте —draft для параметра значение true при создании запроса на вытягивание. (Требуется Azure DevOps Server 2020 или более поздней версии.)

az repos pr create --repository Fabrikam --source-branch new --draft true

Чтобы задать для существующего запроса запрос на черновик, используйте . az repos pr update —id —draft true

Чтобы удалить черновик состояния из запроса на вытягивание, задайте для false значение —draft .

Команды Azure DevOps CLI не поддерживаются для Azure DevOps Server локальной среде.

Добавление или изменение заголовка и описания запроса на вытягивание

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

Когда вы будете готовы к проверке изменений, выберите Создать , чтобы создать запрос на вытягивание.

Не беспокойтесь, если при создании запроса на вытягивание не готовы все рабочие элементы, рецензенты или сведения. Эти элементы можно добавить или обновить после создания запроса на вытягивание.

Изменение заголовка и описания запроса на вытягивание

Следите за заголовком и описанием запроса на вытягивание, чтобы рецензенты могли понять изменения в запросе на вытягивание.

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

Измените описание запроса на вытягивание, щелкнув значок Изменить в разделе Описание .

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

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

Вы можете добавить сведения во время создания запроса на вытягивание с помощью команды az repos pr create или обновить сведения в существующих запросах на вытягивание с помощью команды az repos pr update.

При создании запроса на вытягивание с az repos pr create помощью добавьте —title и подробные сведения об —description изменениях, чтобы другие пользователи могли видеть, какие проблемы решают изменения. Параметр —description принимает запись Markdown, и каждое значение в аргументе является новой строкой описания запроса на вытягивание.

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

Поддерживайте эти поля в актуальном состоянии, чтобы рецензенты могли понять изменения в запросе на вытягивание. Чтобы обновить сведения о запросе на вытягивание, используйте az repos pr update с обязательным параметром запроса на вытягивание —id .

Например, чтобы обновить заголовок и описание pr#21, используйте следующую команду:

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server локальной среде.

Добавление рецензентов в запрос на вытягивание

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

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

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

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

Чтобы добавить рецензентов в новый запрос на вытягивание, выполните приведенные далее действия.

На странице Новый запрос на вытягивание в разделе Рецензенты выберите Поиск пользователей и групп для добавления в качестве рецензентов.

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

Чтобы добавить необходимых рецензентов, выберите Добавить необходимых рецензентов, а затем щелкните Поиск, чтобы добавить необходимых рецензентов для поиска и выбора имен.

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

В разделе Рецензенты на странице Обзор выберите Добавить, а затем — Обязательный рецензент или Необязательный рецензент.

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

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

Чтобы добавить рецензентов в запрос на вытягивание, выполните приведенные далее действия.

Выберите вкладку Обзор в запросе на вытягивание.

Нажмите кнопку добавить в области Рецензенты .

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

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

Чтобы добавить рецензентов, откройте запрос на вытягивание в браузере, а затем внесите изменения на страницу Обзор запроса на вытягивание.

Вы можете добавить необязательных рецензентов в запрос на вытягивание при создании с помощью
az repos pr create —reviewer «» «» .

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

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

Чтобы управлять рецензентами для существующего запроса на вытягивание, используйте команду az repos pr reviewer.

Чтобы добавить рецензентов к существующему запросу на вытягивание, используйте
az repos pr reviewer add —id —reviewer «» «» .

Чтобы получить список рецензентов для запроса на вытягивание, используйте . az repos pr reviewer list —id

Чтобы удалить рецензентов из запроса на вытягивание, используйте . az repos pr reviewer remove —id —reviewer «»

az repos pr reviewer add --id --reviewers [--detect ] [--org] [--subscription]

Параметры

Параметр Описание

—id Идентификатор запроса на вытягивание. Обязательно.

—reviewers Пользователи или группы для включения в качестве рецензентов в запросе на вытягивание. Пробелы разделены. Обязательно.

—detect Автоматическое обнаружение организации. Допустимые значения: false , true .

—org —organization URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization= . Требуется, если не настроено по умолчанию или выбрано через конфигурацию Git. Пример: https://dev.azure.com/MyOrganizationName/ .

—subscription Имя или идентификатор подписки Azure. Подписку по умолчанию можно настроить с помощью az account set -s .

Команды Интерфейса командной строки Azure DevOps не поддерживаются для Azure DevOps Server локальной среде.

Связывание рабочих элементов с запросом на вытягивание

Чтобы связать рабочие элементы с новым запросом на вытягивание, выполните приведенные ниже действия.

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

Начните вводить идентификатор или название рабочего элемента, а затем выберите рабочий элемент для ссылки в появившемся раскрывающемся списке. Поиск по названию возвращает рабочие элементы, отфильтрованные по состоянию; все рабочие элементы с состояниями с категориями состояния Completed и Removed исключаются. Эти рабочие элементы также фильтруются по дате и пользователю, при этом отображаются только элементы, созданные или обновленные за последние 30 дней, и они должны быть созданы, назначены или авторизованы в качестве текущего пользователя.

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

На вкладке Обзор запроса на вытягивание в области Рабочие элементы выберите +.

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

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

Чтобы связать рабочие элементы с запросом на вытягивание, выполните приведенные ниже действия.

Перейдите на вкладку Обзор в запросе на вытягивание.

Нажмите кнопку добавить в области Рабочие элементы .

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

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

Чтобы связать рабочие элементы с запросом на вытягивание, выполните приведенные ниже действия.

Выберите Обзор в запросе на вытягивание.

Нажмите кнопку добавить в области Рабочие элементы .

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

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

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

При создании запроса на вытягивание Azure Boards рабочие элементы можно связать с az repos pr create —work-items помощью , где — это идентификатор рабочего элемента.

Например, следующая команда связывает рабочие элементы 63 и 64 с новым запросом на вытягивание в new ветви:

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

Чтобы управлять рабочими элементами для существующего запроса на вытягивание, используйте команду az repos pr work-item.

Чтобы связать рабочие элементы с существующим запросом на вытягивание, используйте . az repos pr work-item add —id —work-items

Чтобы получить список рабочих элементов, связанных с запросом на вытягивание, используйте . az repos pr work-item list —id

Чтобы удалить связь рабочего элемента с запросом на вытягивание, используйте . az repos pr work-item remove —id —work-items При отмене связи удаляется только связь между рабочим элементом и запросом на вытягивание. Ссылки, созданные в ветви или из фиксаций, остаются в рабочем элементе.

az repos pr work-item add --id --work-items [--detect ] [--org] [--subscription]

Параметры

Параметр Описание

—id Идентификатор запроса на вытягивание. Обязательно.

—work-items Идентификаторы рабочих элементов, которые необходимо связать. Пространство разделено. Обязательно.

—detect Автоматическое обнаружение организации. Допустимые значения: false , true .

—org —organization URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization= . Требуется, если не настроено по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/ .

—subscription Имя или идентификатор подписки Azure. Подписку по умолчанию можно настроить с помощью az account set -s .

Команды Azure DevOps CLI не поддерживаются для Azure DevOps Server локальной среде.

Добавление тегов в запрос на вытягивание

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

Чтобы добавить тег при создании запроса на вытягивание, введите имя тега в разделе Теги . После создания запроса на вытягивание можно управлять тегами в разделе Теги .

Добавление меток в запрос на вытягивание

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

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

Чтобы добавить метку при создании запроса на вытягивание, выберите Добавить метку. После создания запроса на вытягивание можно управлять его метками в разделе Метки .

Добавление вложений в запросы на вытягивание

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

Изменение целевой ветви активного запроса на вытягивание

Для большинства команд почти все запросы на запросы предназначены для ветвь по умолчанию, например main или develop . Если иногда требуется выбрать другую ветвь, легко забыть изменить целевую ветвь при создании запроса на вытягивание. В этом случае можно изменить целевую ветвь активного запроса на вытягивание:

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

На панели Изменить целевую ветвь выберите Выбрать целевую ветвь, выберите новую ветвь, а затем щелкните Изменить.

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

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

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

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

Добавьте необязательное сообщение в поле Примечание (необязательно) и нажмите кнопку Отправить. Получатели получают сообщение электронной почты с просьбой о своем внимании и ссылкой на запрос на вытягивание.

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

Чтобы функция электронной почты работала, администратор Azure DevOps Server должен настроить SMTP-сервер.

Похожие публикации:

Как вставить разрыв разделов в word 2010

Как сделать опросник на сайте html

Как убрать обозначение разреза в autocad

Какой двигатель на луаз