Git: Как настроить автоматически деплой из Bitbucket на сервер

Не так давно я решил настроить автоматический деплой на сервер из Bitbucket репозитория (хотя для GitHub всё делается абсолютно аналогично).

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

В теории всё очень просто: после каждого изменения в репозитории bitbucket должен дёргать специальный скрипт на нашем сервере, смысл которого сводился бы к следующему

exec('git reset --hard HEAD');
exec('git pull');

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

Итак, для начала нам нужно установить sudo и git (если не установлено ранее):

apt-get install sudo
apt-get install git

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

echo exec('whoami');

и запустить его в браузере. В нашем примере пусть это будет user.

Чтобы выполнять команды от имени user, можно прописать в консоль:

sudo -u user bash

И тогда все последующие команды будут от имени пользователя user. Либо для всех команд в начале добавлять sudo -u user, к примеру sudo -u user cd /.

Далее выполняем следующие команды:

cd ~/.ssh
ssh-keygen -t rsa

Мы переходим в папку ssh нашего пользователя (если её не существует — нужно создать: mkdir ~/.ssh) и запускаем генерацию ssh ключа. Укажите любое имя для ключа, а поле пароля оставьте пустым.

Далее в папке .ssh вы увидите 2 файла, id_rsa и id_rsa.pub (вместо id_rsa имя ключа, которое вы ввели). Скопируйте себе .pub файл, откройте в редакторе и всё его содержимое добавьте в специальный раздел настроек вашего проекта на Bitbucket. Найти этот разделы можно так: Страница проекта -> Настройки проекта -> Deployment keys.

Затем запускаем ssh агент и добавляем созданный ключ:

ssh-agent /bin/bash
ssh-add ~/.ssh/id_rsa

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

cd ~/www/путь_до_проекта/
git clone git@bitbucket.org:name/project.git

При первом подключении он спросит добавить ли неизвестный ip в список, введите yes. Репозиторий должен успешно склонироваться, если это произошло, значит вы всё сделали правильно.

Теперь осталось настроить сам деплой. Для этого я использовал чужой скрипт, который можно найти тут, но без проблем можно написать и своё решение. Не забудьте сменить значения некоторых переменных на свои. Располагаем этот скрипт по адресу, к примеру, yoursite.ru/deploy.php, после чего идём в настройки проекта на Bitbucket, в раздел Services, добавляем новый, выбрав POST, и вставляем в поле URL нашу ссылку.

Теперь можно всё проверит: сделать тестовый коммит, запушить его и посмотреть, появляются ли они на сервере.