Bitbucket для повышения качества кода. Четыре шага, чтобы начать работу

Теперь можно загрузить код в Bitbucket.

Шаг 1. Переместите свой код в Bitbucket

Репозитории (которые специалисты с любовью называют «репами») — это место, где код хранится в Bitbucket. Начать работу можно по-разному в зависимости от ваших потребностей.

С чистого листа

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

1. Нажмите + на общей боковой панели, расположенной в левой части экрана, и выберите в разделе Create new (Создать) пункт Repository (Репозиторий).

2. Присвойте репозиторию имя. Это важно! Имя репозитория включается в его URL-адрес.

3. Выберите для параметра Include a README? (Добавить файл README?) значение Yes, with a template (Да, с помощью шаблона).

4. Настройки остальных параметров можно не менять. Нажмите Create (Создать).

При помощи другого поставщика

Импорт репозитория от другого поставщика Git

1. Нажмите + на общей боковой панели, расположенной в левой части экрана, и выберите в разделе Import (Импорт) пункт Repository (Репозиторий).

2. Укажите URL-адрес репозитория.

3. Если для доступа к репозиторию требуется авторизация, установите флажок Requires authorization (Требуется авторизация) и введите необходимые учетные данные.

4. Присвойте репозиторию имя. Это важно! Имя репозитория включается в его URL-адрес.

5. Настройки остальных параметров можно не менять. Нажмите Import repository (Импортировать репозиторий).

Шаг 2. Подготовьте локальную систему, чтобы сотрудничать с коллегами со всего мира

Клонирование репозитория Bitbucket

1. Нажмите «+» на общей боковой панели, расположенной в левой части экрана, и выберите в разделе Get to work (Приступаем к работе) пункт Clone this repository (Клонировать этот репозиторий).

2. Выберите в меню, расположенном в правом верхнем углу экрана, вариант HTTPS (если вы еще не настроили SSH-ключи).

3. Скопируйте команду клонирования.

Из интерфейса командной строки

• Перейдите в каталог, в который вы хотите клонировать свой репозиторий: cd

• Вставьте команду git clone, которую вы скопировали из Bitbucket (она будет выглядеть примерно так): git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

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

Изменение файла в Bitbucket в режиме онлайн

Подождите, у меня нет файлов в Bitbucket...

Вы пропустили необязательный шаг и не добавили файл README в репозиторий Bitbucket? Не переживайте! Если репозиторий пуст, перейдите в него и нажмите Create a README (Создать файл README). Теперь вы можете клонировать репозиторий, в котором есть файлы.

Извлечение (pull) обновлений из Bitbucket

Из интерфейса командной строки

1. Перейдите в каталог, в который вы хотите клонировать свой репозиторий: cd

2. Вставьте команду, которую вы скопировали из Bitbucket. Она будет выглядеть примерно так: git clone

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

Шаг 3. Выполняйте базовые операции с ветками с помощью Bitbucket

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

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

Создание ветки

Из Bitbucket (самый простой способ)

1. Находясь в репозитории, нажмите «+» на общей боковой панели и выберите в разделе Get to work (Приступаем к работе) пункт Create a branch (Создать ветку).

2. В появившемся всплывающем окне выберите Type (Тип) (если вы используете модель ветвления), введите имя ветки в поле Branch name (Имя ветки) и нажмите Create (Создать).

Из интерфейса командной строки

1. После создания ветки запустите команду git fetch и переключитесь на эту ветку в вашей локальной системе. Bitbucket автоматически отобразит необходимую команду, которая будет выглядеть примерно так: git fetch && git checkout.

2. Внесите изменения в локальной системе, затем добавьте изменения, сделайте коммит и отправьте изменения в ветку:

   git add .

   git commit -m "Добавление изменений из функциональной ветки"git push origin

3. Перейдите на страницу Source (Исходный код) в своем репозитории. В раскрывающемся списке должны отображаться и ветка main, и другая ветка.

Из интерфейса командной строки

Из интерфейса командной строки, находясь в каталоге локального репозитория

1. Создайте ветку с помощью команды git branch.

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

3. Получите эту ветку.

4. Отправьте новую ветку в Bitbucket. 

Теперь перейдем в Bitbucket и посмотрим на нашу ветку.

1. Перейдите в репозиторий. 

2. Нажмите Branches (Ветки).

Из Jira

Для этого у вас должен быть доступ к сервису Jira Software Cloud, который вы должны интегрировать с Bitbucket. Для этого нужны права администратора, но если вы хотите просто поэкспериментировать с интеграцией и посмотреть, как она работает, вы всегда можете оформить подписку на бесплатную пробную версию Jira Software Cloud.

Интеграцию этих двух продуктов можно выполнить сразу после настройки сайта Jira. Инструкции по интеграции приведены в статье Подключение Bitbucket Cloud к Jira Software Cloud.

Шаг 4. Проверьте изменения кода при помощи запроса pull

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

Создание запроса pull

1. В открытом репозитории нажмите «+» на общей боковой панели и выберите в разделе Get to work (Приступаем к работе) пункт Create a pull request (Создать запрос pull).

2. Заполните остальные поля формы запроса pull:

1. Source (Источник): репозиторий и ветка, в которой вы изменили код и теперь хотите выполнить слияние этих изменений.

2. Destination (Назначение): репозиторий и ветка, в которую вы хотите слить изменения.

3. Title and Description (Заголовок и описание): значения этих двух полей будут использоваться в уведомлениях по электронной почте. Заголовок также будет отображаться в списке запросов pull.

4. Reviewers (Проверяющие): выберите проверяющих, которые будут оставлять полезные отзывы и должны будут подтверждать изменения.

5. Close branch (Закрыть ветку): установите этот флажок, если хотите, чтобы ветка автоматически закрылась после слияния запроса pull.

6. Diff and Commits (Различия и коммиты): на этих вкладках можно просмотреть внесенные изменения (Diff) и включенные коммиты.

1. Нажмите Create pull request (Создать запрос pull).

Этот запрос pull появится в списках запросов pull на боковой панели навигации вашего репозитория.

Проверка запроса pull

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

Просмотр различий. При просмотре запроса pull вы увидите различия (изменения) во всех файлах, измененных в запросе pull. Добавленные строки выделяются зеленым цветом, удаленные — красным. Также можно нажать вкладку Commits (Коммиты) в верхней части запроса pull, чтобы посмотреть, какие коммиты включены. Это удобно при проверке больших запросов pull.

Отзывы и вопросы в комментариях. В Bitbucket можно оставлять комментарии ко всему запросу pull, отдельному файлу или отдельному участку кода в файле. Благодаря этому легко поместить отзыв в контекст или конкретизировать его. Комментарии можно форматировать, добавлять в них изображения и ссылки. Каждый комментарий имеет собственный URL-адрес, чтобы им можно было быстро поделиться.

Подтверждение или отклонение запроса pull. Проверив изменения кода, вы должны сообщить автору, готов ли его запрос pull к слиянию. Если нажать кнопку Approve (Подтвердить), автор запроса получит уведомление о том, что вы считаете слияние изменений безопасным. Если нажать кнопку Decline (Отклонить), придет уведомление об обратном. Отклоненный запрос pull нельзя будет открыть снова. Чтобы выполнить слияние ветки, придется открыть новый запрос pull.

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

Слияние запроса pull. После того как код пройдет проверку и подтверждение в рамках запроса pull, нажмите кнопку Merge (Слияние), чтобы выполнить слияние вашей ветки с основной. Изменения кода из исходной ветки будут полностью включены в целевую ветку.