Gitea – это легковесный Git-сервис с открытым исходным кодом, который позволяет в короткие сроки развернуть вашу собственную платформу для разработки.
Gitea является альтернативой GitHub и GitLab, позволяет управлять репозиториями, выполнять запросы на слияние, проверять код, отслеживать баги, а также имеет встроенный инструмент CI/CD – Gitea Actions, совместимый с GitHub Actions.
Важным преимуществом этого кросс-платформенного решения для разработчиков является возможность миграции репозиториев и сопутствующих данных с других Git-сервисов всего в пару кликов. Gitea можно использовать и как зеркало для удаленных репозиториев, в том числе настраивать синхронизацию и ее интервал.
Функционал управления проектами схож с GitHub и поддерживает такие функции, как:
- теги;
- этапы;
- вики;
- отслеживание времени выполнения;
- назначение исполнителей и др.
Простой интерфейс и низкое потребление ресурсов обеспечивают высокую скорость работы этого открытого программного обеспечения для совместной разработки.
Gitea от Бегета –это развернутая и готовая к работе платформа для разработки на вашем сервере с установленным SSL-сертификатом на вашем домене.
Состав приложения
- Ubuntu 22.04
- Docker, последняя версия
- Certbot
- Gitea 1.23.4
Установка Gitea
Перед началом установки потребуется указать следующие данные:
- Доменное имя, по которому будет доступна Gitea. Вы можете как выбрать свой собственный домен, так и зарегистрировать новый. Помимо этого вы можете воспользоваться бесплатным доменом в зоне
.beget.app. На указанный домен будет установлен бесплатный SSL-сертификат. - Email администратора. Этот email будет использоваться для доступа к Gitea.
- Пароль администратора. Этот пароль будет использоваться для доступа к Gitea.
После создания сервера и установки приложения вы получите уведомление с данными для входа на указанную электронную почту.
Начало работы с Gitea
Перейдите по адресу https://domain.beget.app/, где domain.beget.app – выбранный домен.
Для входа используйте email и пароль, указанные при создании сервера.
Миграция репозиториев
Для запуска миграции нажмите на кнопку в правом верхнем углу. В открывшемся меню выберите «Новая миграция».
Выберите желаемый источник. В открывшемся меню вы сможете указать адрес репозитория и параметры миграции. Если вы хотите, чтобы ваш репозиторий был зеркалом удаленного репозитория, активируйте параметр «Этот репозиторий будет зеркалом». После указания параметров нажмите на кнопку «Перенос репозитория».
FAQ
Потому перед обновлением рекомендуем проверить наличие актуального бэкапа в разделе “Backup” либо сделайте снапшот VPS в разделе “Снапшоты”, чтобы иметь возможность откатить изменения.
Для обновления Gitea до нужной версии выполните следующие шаги:
- Подключитесь к серверу по SSH.
- Перейдите в директорию Gitea командой
cd /opt/beget/gitea. - Откройте файл
docker-compose.ymlв любом текстовом редакторе. - Найдите строку
image: gitea/gitea:1.21.Xи измените в ней версию Gitea на нужную, сохраните изменения и закройте файл.
Пример изменений:image: gitea/gitea:1.21.8 - Скачайте образ новой версии командой
docker compose pull. - Остановите работу текущей версии Gitea командой
docker compose down. - Запустите новую версию Gitea командой
docker compose up -d. - Подождите 2–5 минут, пока Gitea выполнит миграцию на новую версию и запустится.
- Проверьте работу Gitea на новой версии.
Файлы и конфигурационные данные, а также репозитории находятся в директории /opt/beget/gitea
Файл конфигурации Gitea: /opt/beget/gitea/gitea/gitea/conf/app.ini
Конфигурация контейнера: /opt/beget/gitea/docker-compose.yml
Поскольку Gitea в нашем готовом решении поставляется в формате Docker-контейнеров, для внесения изменений в конфигурацию вместо использования app.ini потребуется вносить директивы в файл с переменными окружения, расположенный по пути /opt/beget/gitea/.env.
Директивы имеют следующий формат: GITEA__SECTION_NAME__KEY_NAME, где section name – название раздела из документации Gitea, key name – название нужного ключа. Для применения настроек после редактирования .env потребуется перезапустить контейнер gitea.
Например, чтобы включить регистрацию для вашего инстанса Gitea, выполните следующие действия:
- Подключитесь к серверу по SSH
- Перейдите в директорию
/opt/beget/giteaкомандойcd /opt/beget/gitea - Откройте файл .env текстовым редактором, например, vim:
vim .env - Найдите строку
GITEA__service__DISABLE_REGISTRATIONи измените значение переменной cfalseнаtrue - Сохраните файл
- Перезапустите контейнеры gitea, выполнив команды
docker compose downdocker compose up -d
Подробнее о настройке Gitea и доступных опциях вы можете прочитать в документации.
- Подключитесь к серверу по SSH.
- Перейдите в директорию командой
cd /opt/beget/gitea. - Выполните команду:
docker compose restart.
Так как Gitea работает внутри docker-контейнера, просто запустить CLI, подключившись по SSH, не получится. Для выполнения команд выполните следующие шаги:
- Подключитесь к серверу по SSH.
- Для запуска команды используйте шаблон:
docker exec -u git -it gitea <команда CLI>, например:docker exec -u git -it gitea gitea help.
С документацией CLI Gitea вы можете ознакомиться на официальном сайте.
