Свой Git сервер на Windows
В принципе все это легко нагуглить, но тем не менее опишу свой опыт. Итак, есть windows сервер (в моем случае Windows Server 2008, но все описанное ниже применимо ко всем windows), на этом севере работает некое веб-приложение, которое хочется коллективно развивать командой из нескольких человек. Идеи лучше чем Git в голову не пришло.
Подготовительный этап
На сервере ставим и настраиваем SSH сервер (в моем случае это оказался Bitvise SSH Server, далее все настройки буду описывать относительно него).
Создаем пары public и private ключей для нужных пользователей, в настройках этих пользователей на SSH сервере добавляем им соответствующие public ключи и убеждаемся что разрешена авторизация по ключу.
Если требуется работать с Git из интернета, также пробрасываем соответствующий порт наружу, обычно это 22, но в моем случае получилось 222 по техническим причинам. Проверяем доступность сервера по SSH снаружи и возможность авторизации с ключом, PuTTY в помощь 🙂
Ставим собственно Git (в моем случае это msysgit). Народ предлагает ставить в короткий путь вроде C:/Git, но я ставил в каталог по-умолчанию, все работает. Через Git GUI создаем репозиторий, в моем случае это С:/Webroot/test-git.
Клиентская часть
В моем случае клиенты — тоже windows машины, на них потребуется Git (тот же msysgit) и клиент TurtoiseGit, в моем случае. На клиенте пытаемся склонировать наш репозиторий при помощи Git Clone, вводим урл
где mylogin — это ваш логин для ssh, example.com:222 — адрес сервера и порт (не обязательно), C:/Webroot/test-git — полный путь к репозиторию.
Жмем ОК, ждем, получаем ошибку и отправляемся дальше настраивать сервер.
Настройка Git на сервере
Первым делом идем в переменные окружения (Компьютер -> Свойства -> Дополнительные параметры системы -> Переменные среды). В разделе системные переменные находим PATH и жмем изменить. Убеждаемся что там есть, а если нет, то добавляем три папки:
C:\Program Files (x86)\Git\cmd;C:\Program Files (x86)\Git\bin;C:\Program Files (x86)\Git\libexec\git-core
На всякий случай напомню, что Git у нас стоит в C:\Program Files (x86)\Git.
Теперь проверяем, что Git доступен. Либо пытаемся еще раз Git Clone на клиенте и получаем другую ошибку, либо заходим по ssh и говорим git прямо и текущей папки, получаем краткий хелп от гита. Если ругается на неизвестную команду, ищем ошибку на предыдущем шаге.
Теперь наша проблема (если посмотреть логи ssh сервера) заключается в том, что git-upload-pack на вход получает путь, обернутый в одинарные кавычки, и естественно, не работает. Нормального решения нет, но есть подпорки, например как описано здесь. Моя версия проделанного:
C:\Program Files (x86)\Git\cmd\gitcmdhelper.sh
прописываем в него
Идем в настройки ssh сервера и для нужного пользователя (или группы) изменяем параметр Exec request prefix на
cmd.exe /c sh gitcmdhelper.sh
ВНИМАНИЕ! после .sh есть пробел! Строка получается вот такая «cmd.exe /c sh gitcmdhelper.sh «, без пробела на конце не будет работать!
Замечание. Эта подпорка лишает вас возможности работать с путями в которых есть пробелы, в большинстве случаев это не критично, но все же.
В глобальном конфиге Git вносим следующие изменения (как советуют на хабре), правим C:\Program Files (x86)\Git\etc\gitconfig
[core]symlinks = false
autocrlf = true
ignorecase = true
quotepath = false
[i18n]
commitencoding = cp1251
logoutputencoding = cp1251
И, о чудо! Оно теперь работает! Ну по крайней мере мне удалось сделать Pull, Commit и Push.
И последнее — хуки
Поскольку в git-e не принято пушить в основной рабочий репозиторий (для этого есть ряд причин, кому интересно, в гугль), то можно сделать bare-репозиторий, в который будут приходить все пуши, а с помощью механизмов хуков изменения будет забирать рабочая копия.
Итак у нас есть bare-репозиторий C:\Webroot\test-git в который приходят все комиты и пуши, и рабочая копия C:\Webroot\test-git.production, на которую настроен document root сервера.
Рабочая копия должна быть «настроена на» bare-репозиторий, для этого в рабочей копии выполним команду
git remote add local C:/Webroot/test-git
результатом станет добавление в C:\Webroot\test-git.production\.git\config следующего
.
[remote «local»]
url = C:/Webroot/test-git
fetch = +refs/heads/*:refs/remotes/local/*
Для того чтоб заработали хуки, нужно положить файл с названием действия в папку в bare-репозитории .git/hooks/, в нашем случае это будет
обычно там уже заложен post-receive.sample, его достаточно просто переименовать. А в сам файл вписываем следующее содержимое, которое после получения данных заставит рабочую копию сделать pull:
unset GIT_DIR
cd C:/Webroot/test-git.production
git pull local master
Таким образом мы будем корректно обновлять рабочую копию при каждом push-е в bare-репозиторий.
Вот пара полезных ссылок по теме:
/bar.com.git, it will go to
Поднимать Git на windows, по моему мнению, не самое лучшее решение, если есть возможность все же лучше это сделать на Linux.
Pro Git
Страницы
воскресенье, 1 марта 2015 г.
Установка и настройка сервера Git на Windows Server (20xx)
Тут я, вкратце, опишу один из возможных вариантов установки сервера Git под Windows Server. Хотя эти рекомендации так же можно применить и для установки сервера Git на обычную рабочую станцию под Windows от XP и выше.
И так скачиваем дистриб от сель. Кстати там же можете почитать и процедуру установки, там все более просто без заморочек на безопасность и обновления Git под винду до текущей версии.
Вообще эти ребята взяли этот проект, довели его чуток до ума, то есть просто автоматизировали весь процесс установки и плюс дописали свои плюшки и стали его продавать. Но для использования этого сервера Git максимум двумя людьми он бесплатен. Ну все это вы можете почитать на сайте от куда скачаете дистриб.
И так скачали. Понеслась установка.
Рекомендую поставить Git в комплекте который идет с инсталлятором, тем более если у вас нет установленного на сервере. Если есть, и если прописаны правильно пути к нему, то заработает и без установки из дистриба.
Ну и все устанавливается. У меня на сервере уже стоит Apache, поэтому его надо было потушить, так как этот Git сервер по умолчанию запускается на портах 80 и 443, но это можно поменять.
И так тушим Apache.
И запускаем GitStack сразу по окончании установки. Просто оставляем галку включённой.
Запустится ваш браузер по умолчанию и выведет вас сразу на страничку сервера
Логинимся с учеткой по умочанию
Сразу же меняем пароль администратора
GitStack по умолчанию запускается под системной учетной записью, что не есть гуд для веб сервиса. Поэтом меняем это дело, на локальную учетку.
И перезапускаем сервис. Идем опять в админку сервера и меняем порты на которых он будет висеть.
Так как у меня сервер находится за файрволом, то я оставил оба и HTTP и HTTPS, развесил их на порты на которых у меня не слушает Apache. Вы можете поставить какие вашей душеньке угодно.
После смены портов естественно в адресной строке надо будет указывать уже порт, чтобы дальше рулить админкой. Рестартуем GitStack
Ну и я стартовал свой Apache. У вас этого может и не быть. То есть по ходу у меня запущено два веб сервера.
Заходим по новому порту и донастраиваем чтобы слушал еще и по HTTPS.
Проверяем работу HTTPS
Все теперь можно высовывать морду сервера наружу в большой мир. Но осторожно ….
И чтобы большой мир увидел эту морду надо открыть порт на локальном файрволе сервера, так как по умолчанию GitStack открывает порт 80
Все, теперь уже можно заходить на сервак удаленно через доменное имя, ну или его внешний IP.
Далее создаем пользователя
И даем пользователю права на репозиторий
И еще немного настроек безопасности. Если зайти на сервер без указания папки GitStack то увидим такое
Это не есть гуд. Правим указанный файлик настроек
Рестартуем вебсервис GitStack и видим уже такую картину.
Теперь клонируем репозиторий с нашего сервера на локальную машину
Настраиваем локально Git и делаем первый локальный коммит
И далее заливаем его на сервер. Но делаем это по особенному, так как у нас на сервере само подписанный сертификат.
У сервера достаточно приятная и понятная морда для отслеживания коммитов через веб интерфейс
Ну и на последок надо заметить что на момент написания статьи в комплекте с GitStack шла не самая последняя версия Git
Я установил последнюю версию Git, переписал пути в переменной PATH и все заработало на новой версии
Ну и на последок можно сказать что можно вписать в конфиг проекта строку
$ git config —local http.sslVerify false
Чтобы каждый раз не писать в командах отмену проверки валидности сертификата.
Установка и использование системы контроля версий Git в Windows
Виртуальный сервер на базе Windows
- Лицензия включена в стоимость
- Тестирование 3-5 дней
- Безлимитный трафик
В инструкции описан процесс загрузки, установки системы контроля версий Git на сервера с операционной системой Windows и подключения к удаленному репозиторию GitHub.
Что это такое?
Git — одна из самых популярных систем контроля версий, используется разработчиками, для контроля изменений в своих разработках и проектах. Изначально создан для использования на Linux-подобных операционных системах, но позднее, из-за удобства и популярности для Windows был написан специальный эмулятор, поддерживающий функционал Git’a.
Загрузка и установка
Загрузите установщик с официального сайта. Загрузка начнется автоматически.
Перейдите в папку “Downloads” и запустите на исполнение загруженный файл.
Укажите путь до каталога в который будет установлен Git.
Чтобы на рабочем столе была иконка Git, на следующем шаге отметьте галочкой “On the Desktop”.
Введите имя директории, которая будет создана в Start Menu. При необходимости можно изменить путь с помощью кнопки Browse.
Выберете способ использования из командной строки:
- Use Git from Git Bash only — использование только из командной строки Bash.
- Use Git from the Windows Command Prompt — использование командной строки Bash, а также минимальный набор команд Git из консоли Windows.
- Use Git and optional Unix tools from the Windows Command Prompt — использование Git и утилит Unix из командной строки Windows, в этом случае будут перезаписаны некоторые утилиты Windows, например find и sort.
Выберете библиотку, которая будет использована при подключении по протоколу HTTPS:
- OpenSSL — сертификаты сервера будут проверяться с использованием Unix-файла ca-bundle.crt.
- Windows Secure Channel — сертификаты сервера будут проверяться с использованием стандартной библиотеки Windows.
Убедитесь, что вы выбрали способ обработки окончания строк «Checkout Windows-style, commit Unix-style line endings». Это значение гарантирует, что Git преобразует LF в CRLF при проверке текстовых файлов. При выполнении текстовых файлов CRLF также преобразуется в LF. Это мера совместимости для защиты новых строк в текстовых файлах, что позволяет легко работать с текстовыми файлами в Windows и на платформах Unix.
Примечание: LF и CRLF — управляющий символ для переноса строки в Unix и Windows соответственно.
Далее необходимо сконфигурировать используемый терминал:
- MinTTY — терминал Unix;
- Windows — стандартный терминал Windows.
Отметьте галочками нужные вам дополнительные функции:
- File system caching — кэширование файловой системы.
- Git Credential Manager — включить менеджер учетных данных.
- Symbolic links — разрешить символьные ссылки.
Нажмите кнопку Install.
Начнется процесс установки.
Подключение к удаленному репозиторию
Откройте каталог с файлами, которые необходимо отслеживать в системе контроля версий и выложить на GitHub. В пустую часть каталога нажмите правой кнопкой мыши и выберете Git Bash Here.
Перед вами откроется приглашение командной строки в зависимости от настроек.
Для настройки необходимо указать ваше имя и электронную почту:
git config —global user.email «you@example.com»
git config —global user.name «Ваше имя»
Для того чтобы начать отслеживать содержимое папки в системе, выполните команды:
Выполните первый коммит:
Чтобы добавить изменения, например, на github выполните действие:
git remote add origin https://github.com/пользователь/репозиторий.git
git push -u origin master
git remote add gitlab https://server/namespace/project.git
git push -u gitlab master
Перед вами откроется окно входа (консольное или стандартное окно Windows). В качестве пользователя укажите ваш логин на GitHub, репозиторий — название существующего репозитория.
Аутентификация по SSH-ключам
Выполнить подключение к удаленному репозиторию можно по протоколу SSH с помощью приватного и публичного ключа. Чтобы сгенерировать пару, выполните команду в консоли GitBash, указав ваш реальный почтовый адрес:
ssh-keygen -t rsa -b 4096 -C «email@example.com»
В процессе генерации вам будет предложено указать директорию и имя файла для ключа, примите значение по умолчанию, нажав Enter. Далее, при желании можно указать ключевую фразу в качестве дополнительной защиты, при ее отсутствии нажмите Enter. В результате будут сгенерированы ключи.
Вы увидите идентификатор процесса.
Добавьте ключи к ssh-агенту:
Теперь нужно добавить ключ к удаленному серверу Git. Заходим на сервер Git и в настройках добавляем SSH-ключ.
Например, на сервере GitHub это можно сделать следующим образом: откройте Settings -> SSH and GPG keys,нажмите New SSH key. В поле Title введите понятное название, в поле Key вставьте публичный ключ (содержимое файла
/.ssh/id_rsa.pub). Нажмите Add SSH key.
В результате у вас появится новый ключ.
Для проверки настроек выполните команду:
ssh -T git@github.com
Если все настроено верно, то вы увидите следующее сообщение.