Изучите Git с помощью Bitbucket Cloud

Создать репозиторий можно следующим образом:

1. В Bitbucket нажмите значок + на общей боковой панели и выберите Repository (Репозиторий).

В Bitbucket отобразится страница Create a new repository (Создание нового репозитория). Внимательно изучите содержимое этого диалогового окна. Все настройки, которые вы укажете на этой странице, кроме пункта Repository type (Тип репозитория), потом можно будет изменить.

2. В поле Name (Имя) введите BitbucketStationLocations. Bitbucket использует значение поля Name для создания URL-адреса репозитория. Например, если у пользователя the_best есть репозиторий с именем awesome_repo, URL-адрес этого репозитория будет выглядеть так: https://bitbucket.org/the_best/awesome_repo.

3. Access level (Уровень доступа): установите флажок в поле This is a private repository (Это частный репозиторий). Частный репозиторий будет виден только вам и тем, кому вы предоставите доступ. Если этот флажок не установлен, любой пользователь сможет увидеть ваш репозиторий.

4. В поле Repository type (Тип репозитория) выберите вариант Git. Помните, что после нажатия кнопки Create repository (Создать репозиторий) вы уже не сможете изменить тип репозитория.

5. Нажмите Create repository (Создать репозиторий). В Bitbucket будет создан репозиторий, после чего откроется страница Overview (Обзор).

Нажмите + на общей боковой панели, чтобы увидеть стандартные действия для репозиториев. Нажимайте элементы на боковой панели навигации, чтобы узнать, что за ними скрывается, в том числе Settings (Настройки), где можно изменить сведения о репозитории и другие параметры. Чтобы просмотреть список горячих клавиш для перехода к этим элементам, нажмите ? на клавиатуре.

Если вы нажмете Commits (Коммиты) на боковой панели, то обнаружите, что коммитов нет, потому что вы еще не создали содержимое репозитория. Ваш репозиторий является частным, а поскольку вы не отправляли никому приглашений для доступа к нему, то единственный человек, который может создавать и редактировать содержимое репозитория, — это вы, его владелец.

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

2. Создайте каталог для размещения своих репозиториев.

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

4. Из Bitbucket перейдите в репозиторий BitbucketStationLocations.

5. Нажмите значок «+» на общей боковой панели и выберите Clone this repository (Клонировать репозиторий).

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

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

7. Вставьте команду, скопированную из Bitbucket, в окно терминала и нажмите Return.

8. В ответ на запрос терминала введите свой пароль Bitbucket. Если вы создали аккаунт через Google, используйте пароль для этого аккаунта.

• Если возникла ошибка пароля Windows:
  • В некоторых версиях ОС Microsoft Windows и Git может возникнуть ошибка, как в следующем примере.
    
    Пример ошибки пароля Windows при клонировании

• Если вы столкнулись с такой ошибкой, введите следующую команду:

• Затем вернитесь к шагу 4 и повторите процедуру клонирования. Теперь пароль должен запросить агент Bash. Вам придется ввести его только один раз.

В этот момент окно терминала должно выглядеть примерно так:

• Вам известно, что ваш репозиторий пуст? Если помните, вы еще не добавили в него файлы исходного кода.

9. Выведите список содержимого в каталоге репозиториев. Вы заметите в нем каталог bitbucketstationlocations.

Поздравляем! Клонирование репозитория в локальную систему выполнено.

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

Если на выходе командной строки ничего нет, значит, файл создан правильно!

3. Получите информацию о статусе локального репозитория. О продвижении проекта по сравнению с репозиторием Bitbucket можно узнать с помощью команды git status.

На этом этапе Git знает, что вы создали новый файл. Вы увидите что-то подобное:

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

4. Чтобы в Git осуществлялось отслеживание нового файла locations.txt, введите команду git add. Если команда git add введена правильно, на ее выходе не будет ничего, как и при создании файла.

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

5. Проверьте статус файла.

Вы заметите, что новый файл добавлен (проиндексирован), и сможете сделать коммит, когда будете готовы. Команда git status показывает состояние рабочего каталога и проиндексированного снимка.

6. Введите команду git commit с комментарием к коммиту, как показано в следующей строке. Параметр -m указывает, что далее следует комментарий к коммиту.

Команда git commit выполняет коммит проиндексированного снимка состояния в историю проекта. Эта процедура в сочетании с командой git add определяет классический рабочий процесс для всех пользователей Git.

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

• Подробнее о Git и удаленных репозиториях
  • Способность Git обмениваться данными с удаленными репозиториями (в нашем случае — с Bitbucket) является основой любого процесса совместной работы в Git.
  • Модель совместной работы в Git предполагает, что каждый разработчик использует собственную копию репозитория со своей локальной историей и структурой веток. Обычно пользователи делятся не отдельными наборами изменений, а сериями коммитов. Вместо того чтобы выполнять коммит одного набора изменений из рабочей копии в центральный репозиторий, Git позволяет передавать между репозиториями целые ветки.

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

7. Вернитесь в окно локального терминала и отправьте в Bitbucket изменения, для которых был сделан коммит, с помощью команды git push origin main. Эта команда указывает, что вы отправляете изменения в ветку main репозитория origin (на сервере Bitbucket).

В ответ вы должны получить что-то подобное:

Ваши коммиты переданы в удаленный репозиторий (origin).

8. Перейдите в репозиторий BitbucketStationLocations в Bitbucket.

9. Нажав Commits (Коммиты) на боковой панели, вы заметите в своем репозитории единственный коммит. Bitbucket объединяет все выполненные вами действия в один коммит и отображает его. Обратите внимание, что в столбце Author (Автор) указано значение, которое использовалось при настройке глобального файла конфигурации Git ( ~/.gitconfig).
Нажав Source (Исходный код) на боковой панели, вы заметите, что в репозитории находится единственный файл исходного кода locations.txt, который вы только что добавили.

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

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

1. Нажмите Source (Исходный код) в репозитории BitbucketStationLocations, чтобы открыть каталог с исходным кодом. Обратите внимание, что только один файл, locations.txt, находится в каталоге.

A. Страница Source (Исходный код): нажмите ссылку, чтобы открыть эту страницу.
B. Выбор ветки: выберите ветку, которую хотите просмотреть.
C. Кнопка «Дополнительные действия»: нажмите, чтобы открыть меню с дополнительными вариантами действий, например Add file (Добавить файл).
D. Область файлов исходного кода: просмотр каталога файлов в Bitbucket.

2. На странице Source (Исходный код) нажмите кнопку «Дополнительные действия» в правом верхнем углу и выберите в меню Add file (Добавить файл). Кнопка «Дополнительные действия» появляется только после того, как в репозиторий был добавлен хотя бы один файл.

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

A. Ветка для нового файла: измените, если нужно добавить файл в другую ветку.
B. Область нового файла: добавьте сюда содержимое нового файла.

3. В поле filename (Имя файла) введите stationlocations.

4. В списке Syntax mode (Режим синтаксиса) выберите HTML.

5. В текстовое поле добавьте следующий HTML-код:

6. Нажмите Commit (Сделать коммит). Появится поле Commit message (Комментарий к коммиту) с сообщением stationlocations created online with Bitbucket (Файл stationlocations создан онлайн в Bitbucket).

7. Нажмите Commit (Сделать коммит) под полем с комментарием.

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

Чтобы просмотреть список сделанных на данный момент коммитов, нажмите Commits (Коммиты) на боковой панели.

Теперь нужно скопировать этот новый файл в локальный репозиторий. Это довольная простая процедура, по сути обратная операции push, с помощью которой вы поместили файл locations.txt в Bitbucket.

Скопировать файл в локальный репозиторий можно следующим образом:

1. Откройте окно терминала и перейдите на верхний уровень локального репозитория.

2. Введите команду git pull --all, чтобы извлечь все изменения из Bitbucket. (В более сложных рабочих процессах с ветвлением извлечение и слияние всех изменений может быть неприменимо.) В ответ на запрос введите свой пароль Bitbucket. Окно терминала должно выглядеть примерно так:

Команда git pull выполняет слияние файла из удаленного репозитория (Bitbucket) в локальный репозиторий одной командой.

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

Фантастика! Добавив два файла о местоположении космических станций, вы выполнили классический рабочий процесс в Git (клонирование, добавление, коммит, отправку и получение) между Bitbucket и локальной системой.

Создать ветку можно следующим образом:

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

2. В окне терминала создайте ветку.

Эта команда создает ветку, но не выполняет переключение на эту ветку, поэтому репозиторий выглядит примерно так:

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

3. Переключитесь на только что созданную ветку, чтобы начать ее использовать.

Команда git checkout часто используется вместе с git branch. Поскольку ветка создается для работы над чем-то новым, после каждого создания новой ветки (командой git branch) требуется переключиться на эту ветку (командой git checkout), чтобы начать ее использовать. Когда вы переключитесь на новую ветку, рабочий процесс Git будет выглядеть примерно так:

4. Найдите в локальной системе папку bitbucketstationlocations и откройте ее. Вы заметите, что в результате создания новой ветки в каталоге не появилось никаких дополнительных файлов или папок.

5. Откройте файл stationlocations в текстовом редакторе.

6. Измените файл, добавив в него местоположение еще одной станции:

7. Сохраните и закройте файл.

8. Введите в окне терминала команду git status. У вас будет нечто подобное:

Обратили внимание на строку On branch future-plans? Если бы вы ввели команду git status раньше, то вместо этой строки увидели бы строку branch main, потому что тогда у вас была только одна ветка — main. Прежде чем индексировать изменение или выполнять его коммит, всегда проверяйте эту строку, чтобы убедиться, что выбрана именно та ветка, в которую вы хотите добавить изменение.

9. Проиндексируйте файл.

10. В окне терминала введите команду git commit, как показано ниже:

После этого последнего коммита репозиторий будет выглядеть примерно так:

Пора выполнить слияние изменения с веткой main.

Число ваших космических станций растет. Пришло время для церемонии открытия станции на Марсе. Теперь, когда ваши планы на будущее начали воплощаться в жизнь, можно выполнить слияние ветки future-plans с веткой main в локальной системе.

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

Это распространенная модель работы с ветками, отведенными под решение краткосрочных задач с небольшими изменениями. При работе с объемными функциями она используется реже.

Ускоренное слияние можно выполнить следующим образом:

1. В окне терминала перейдите на верхний уровень локального репозитория.

2. Введите команду git status, чтобы убедиться, что для всех изменений сделаны коммиты, и узнать, какая ветка выбрана.

3. Переключитесь на ветку main.

4. Выполните слияние изменений из ветки future-plans с веткой main. Это будет выглядеть примерно так:

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

5. Поскольку вы больше не планируете использовать ветку future-plans, ее можно удалить.

После удаления ветки future-plans вы сможете получить к ней доступ из ветки main через идентификатор коммита. Если, например, вы хотите отменить изменения, добавленные из ветки future-plans, воспользуйтесь полученным идентификатором коммита для возврата к этой ветке.

6. Введите команду git status, чтобы увидеть результаты слияния. Они показывают, что локальный репозиторий опережает удаленный на один коммит. Это будет выглядеть примерно так:

Вот что вы сделали на данный момент:

• Создали ветку и переключились на нее
• Внесли изменение в новую ветку
• Сделали коммит изменения в новой ветке
• Интегрировали изменение в основную ветку
• Удалили ветку, ставшую ненужной

Теперь нужно поместить всю эту работу в Bitbucket, в удаленный репозиторий.

Вот как можно отправить изменение в удаленный репозиторий:

1. Находясь в каталоге репозитория, введите в окне терминала команду git push origin main, чтобы отправить изменения. Результат будет выглядеть примерно так:

2. Перейдите на страницу Overview (Обзор) своего репозитория Bitbucket. В ленте Recent Activity (Недавняя активность) будет отображаться операция push.

3. Нажмите Commits (Коммиты). Вы заметите коммит, сделанный в локальной системе. Обратите внимание: изменение имеет тот же идентификатор коммита, что и в локальной системе.

Также видно, что линия слева от списка коммитов является прямой и не имеет веток. Это связано с тем, что ветка future-plans никогда не взаимодействовала с удаленным репозиторием. Туда передавалось только созданное изменение после коммита.

4. Нажмите Branches (Ветки) и обратите внимание, что на этой странице также нет записи об этой ветке.

5. Нажмите Source (Исходный код), затем выберите файл stationlocations. Вы заметите, что последнее изменение файла имеет тот же идентификатор коммита, что и отправленное.

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