Gogs — самый простой способ запустить локальный сервер Git (вот как его настроить)

Не хотите отправлять свой код в размещенный репозиторий Git? Затем запустите собственный Git-сервер у себя. Gogs — самый простой способ сделать это. Вот как это настроить.

Проблема с облачными репозиториями

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

Вот почему существуют такие сервисы, как GitHub, GitLab и BitBucket, и почему они получили такое распространение и рост. Только на GitHub размещено более 200 миллионов репозиториев. Но облачные репозитории подходят не всем. Большинство из них взимают плату за размещение частных репозиториев. Некоторые из них налагают ограничения на хранение, пользовательские ограничения или ограничения на передачу данных для бесплатных учетных записей.

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

Альтернативой является размещение вашего собственного Git-сервера либо локально в вашей собственной сети, либо с частным доступом в вашем собственном частном облаке. Настройка сервера Git, предоставляющего веб-интерфейс с внешним видом, функциями и параметрами, которые GitHub и его друзья сделали настолько популярными, раньше требовала определенной степени технических навыков. Тут на помощь приходит Гогс.

Что такое Гоги?

Gogs — это относительно новый проект, написанный на Go, который предоставляет простой в установке, но полнофункциональный экземпляр Git. Нет никаких ограничений по размеру команды, хранилищу или чему-либо еще.

Даже если вы программист-любитель, использование Gogs в качестве службы Git в вашей локальной сети позволяет хранить копию кода вдали от компьютера для разработки. Когда вы или кто-то другой хотите работать на другом или новом компьютере, вы просто клонируете репозиторий со своего сервера Gogs так же, как с GitHub.

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

Как установить Гоги

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

Gogs использует базу данных для внутреннего хранилища. Он поддерживает MySQL, MariaDB, PostgreSQL и TiDB. Если вы хотите использовать один из этих мощных механизмов базы данных, вы должны найти и установить его самостоятельно, прежде чем устанавливать Gogs. Для небольших команд вы можете использовать SQLite3. Если вы выберете SQLite3, он будет установлен за вас. Конечно, вам также потребуется установить git.

Загрузите соответствующий двоичный файл.

• Для большинства современных дистрибутивов Linux загрузите файл «Linux amd64».
• Если вы используете 32-разрядную версию Linux, загрузите файл «Linux 386».
• Если вы устанавливаете на Raspberry Pi 2 или ранеезагрузите файл «Linux armv7».
• Если вы устанавливаете на Raspberry Pi 3, 3+ или позжезагрузите файл «Linux armv8».
• Если вы используете Intel Mac, загрузите файл «macOS amd64».
• Для Apple Silicon Mac загрузите файл «macOS arm64».

Мы загрузили ZIP-файл «Linux amd64» для установки на 64-битный компьютер с Ubuntu 22.10. Файл небольшой — всего около 25 МБ, — поэтому не удивляйтесь, если он загружается очень быстро. Это нормально.

Найдите файл в вашей файловой системе. Если вы сохранили расположение загрузки по умолчанию в вашем браузере, файл, вероятно, будет находиться в вашем каталоге «~/Downloads». Щелкните его правой кнопкой мыши и выберите «Извлечь» в контекстном меню. Некоторые файловые браузеры могут вместо этого использовать «Извлечь здесь».

Каталог извлекается из ZIP-файла. Он назван в честь загруженного файла. В нашем случае он назывался «gogs_0.11.91_linux_amd64».

Дважды щелкните извлеченный каталог, и вы увидите другой каталог под названием «gogs».

Дважды щелкните каталог «gogs». Вы увидите файлы и каталоги Gogs. Щелкните правой кнопкой мыши в окне браузера файлов и выберите «Открыть в терминале» в контекстном меню.

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

./вебгоги

Gogs запускается и сообщает, что прослушивает порт 3000.

Подключитесь к своему серверу Gogs, открыв веб-браузер и перейдя по IP-адресу или сетевому имени компьютера, на котором работает Gogs. Добавьте «:3000» после IP-адреса или имени сети. Не включайте пробелы.

Если вы просматриваете на компьютере, на котором работает Gogs, вы можете использовать «localhost» в качестве имени машины, например «localhost:3000». Наш компьютер Gogs называется «ubuntu-22-10.local», поэтому с другого компьютера в той же сети нам нужно перейти по адресу «ubuntu-22-10.local:3000», включая номер порта.

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

Первое, что нам нужно сделать, это выбрать «SQLite3» в раскрывающемся меню «Тип базы данных» и ввести свое имя пользователя в поле «Запустить пользователя».

Если вы хотите настроить уведомления по электронной почте, вам нужно настроить несколько дополнительных шагов. Вам нужно будет ретранслировать электронные письма через почтовый сервер Simple Mail Transfer Protocol (SMTP), на использование которого у вас есть разрешение. Если вы являетесь пользователем Google Gmail, вы можете использовать SMTP-сервер Google Gmail.

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

Gogs требует от вас ввести следующую информацию о вашем почтовом сервере.

• Хост SMTP: адрес и порт почтового сервера. В нашем примере это SMTP-сервер Google по адресу smtp.gmail.com:587.
• От: адрес электронной почты, с которого будет отправлено электронное письмо. Для Gmail это должен быть адрес электронной почты Gmail используемой вами учетной записи.
• Электронная почта отправителя: должна быть такой же, как указано выше. Это идентификатор учетной записи электронной почты, который Gogs будет использовать для связи с SMTP-сервером.
• Пароль отправителя: это не пароль для учетной записи Gmail. Это пароль приложения вы получаете от Google, когда настраиваете свою учетную запись, чтобы разрешить приложению отправлять электронную почту от вашего имени.
• Включить подтверждение регистрации: чтобы Gogs проверял электронную почту пользователей, установите этот флажок. Новые пользователи получат электронное письмо со ссылкой в ​​нем. Они должны щелкнуть, чтобы доказать, что адрес электронной почты является подлинным и находится под их контролем.
• Включить уведомление по электронной почте: установите этот флажок, чтобы разрешить уведомления по электронной почте от Gogs.

Конечно, если вы не хотите, чтобы к вам приставали электронные письма, вы можете пропустить все настройки электронной почты.

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

Вы увидите главную домашнюю страницу Gogs.

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

Заполните форму «Регистрация», указав имя своей учетной записи, пароль для этой учетной записи (введите его дважды) и цифры из капчи. Нажмите зеленую кнопку «Создать новую учетную запись». Вы увидите страницу «Войти».

Введите имя и пароль своей учетной записи и нажмите зеленую кнопку «Войти».

Краткий обзор Гогов

Если вы хоть немного знакомы с любым другим экземпляром Git с веб-доступом, вы очень легко сориентируетесь в Gogs.

Представление Gogs «Dashboard» немного скудно, пока у вас нет репозитория для работы. Нажмите синюю кнопку «+» и заполните форму «Новый репозиторий».

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

Следующие три поля создают файлы из шаблонов.

• Меню «.gitignore» позволяет вам выбрать шаблон для вашего файла «.gitignore», настроенный с настройками в соответствии с выбранными языками. В этом меню вы можете выбрать несколько вариантов для репозиториев, использующих сочетание технологий разработки.
• Меню «Лицензия» позволяет выбрать лицензию из полного списка.
• В меню «Readme» есть единственная опция — файл «README.md» по умолчанию.

Установите флажок «Инициализировать этот репозиторий с выбранными файлами и шаблоном» и нажмите зеленую кнопку «Создать репозиторий».

Ваш новый репозиторий отображается для вас. Gogs создал для нас три стандартных файла и добавил их в репозиторий с сообщением фиксации «Начальная фиксация».

Мы клонировали репозиторий на наш компьютер, добавили файл с именем «ack.c», зафиксировали его и отправили в наш удаленный репозиторий Gogs. Все это было сделано с помощью стандартных команд Git.

Как и ожидалось, наш новый файл появляется в нашем репозитории Gogs.

Щелчок по файлу показывает нам содержимое отдельного файла. Файлы Markdown интерпретируются для вас с заголовками, ссылками, списками и всеми другими функциями Markdown. Файлы «README.md» обычно написаны в формате Markdown.

Нажав на значок карандаша «Редактировать», мы можем напрямую редактировать наш файл «README.md». Мы добавили еще немного текста, использовали теги Markdown для вставки гиперссылок и курсива и зафиксировали наши изменения. Все изнутри Gogs.

Вернувшись к нашему представлению репозитория, отображается наш обновленный файл «README.md», а запись «README.md» в списке файлов показывает новое сообщение фиксации и время обновления.

Самый простой Git-сервер — без исключений

Gogs — абсолютный триумф. Он идеально сочетает в себе функциональность и простоту.

Из коробки он удовлетворит потребности большинства любителей или небольших команд разработчиков. Некоторые из его дополнительных параметров активируются путем редактирования файла конфигурации, который по умолчанию находится в «~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini». Обратите внимание, что путь будет отражать версию Gogs, которую вы используете.

Общее администрирование системы можно выполнить из панели администратора, которую можно найти в разделе «Ваш профиль» > «Панель администратора».

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

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