Как установить Gitea с PostgreSQL на Debian 11
На этой странице
- Предпосылки
- Шаг 1. Обновите ОС
- Шаг 2. Установка и настройка PostgreSQL
- Шаг 3. Установите и настройте Git
- Шаг 4. Создайте пользователя git для Gitea
- Шаг 5. Установите и настройте Gitea
- Шаг 6. Доступ к веб-интерфейсу Gitea
- Шаг 7. Настройка уведомлений по электронной почте
- Шаг 10. Обновление Gitea
- Заключение
Gitea — это бесплатное решение с открытым исходным кодом для серверов Git. Gitea написала на языке программирования Go легкое приложение, доступное в виде бинарного пакета, который можно установить на большинстве платформ, включая Windows, Linux и macOS. Это одна из надежных, масштабируемых, быстрых, простых в использовании альтернатив GitLab.
Gitea предлагает множество функций, включая редактор файлов репозитория, отслеживание ошибок и времени, ветвление репозитория, блокировку файлов, встроенную вики. , слияние, поддержка нескольких баз данных, простой процесс обновления, встроенный реестр контейнеров и многое другое.
В этом руководстве я покажу вам, как установить Gitea из двоичного файла с помощью PostgreSQL в Debian 11.
Предпосылки
- Сервер под управлением Debian 11.
- На сервере настроен пароль root.
Шаг 1 – Обновите ОС
Перед началом установки Gitea выполните приведенную ниже команду, чтобы обновить свою систему до последней версии. var slotId=div-gpt-ad-howtoforge_com-medrectangle-3-0;var ffid=1;var alS=1021%1000;var container=document.getElementById(slotId);container.style.width=100%;var ins =document.createElement(ins);ins.id=slotId+-asloaded;ins.className=adsbygoogle ezasloaded;ins.dataset.adClient=pid;ins.dataset.adChannel=cid;if(ffid==2){ins.dataset .fullWidthResponsive=true;}
sudo apt-get update -y
sudo apt-get upgrade -y
Шаг 2. Установите и настройте PostgreSQL.
Gitea поддерживает все основные базы данных, такие как MySQL, MariaDB, SQLite, MySQL и PostgreSQL, но в этом руководстве в качестве базы данных Gitea используется PostgreSQL.
Сначала создайте репозиторий PostgreSQL с помощью следующей команды:
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
Далее вам нужно будет импортировать ключ подписи репозитория:
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
Теперь установите PostgreSQL, используя следующие команды:
sudo apt-get update
sudo apt-get -y install postgresql
Затем запустите службу PostgreSQL, включите ее при запуске системы и проверьте состояние службы PostgreSQL с помощью следующей команды:
sudo systemctl start postgresql
sudo systemctl enable postgresql
sudo systemctl status postgresql
Затем вам нужно переключиться на схему SCRAM-SHA-256 со схемы шифрования md5 для большей безопасности. Если вы хотите подключиться к PostgreSQL удаленно, вам нужно разрешить свой IP-адрес в файле конфигурации PostgreSQL. Откройте файл конфигурации, чтобы внести изменения, используя следующую команду:
sudo vim /etc/postgresql/14/main/postgresql.conf
Если у вас установлена другая версия PostgreSQL, измените указанный выше путь к команде в соответствии с ней.
Затем измените следующие переменные в соответствии с вашими требованиями:
listen_addresses = 'localhost, 134.122.38.45'
password_encryption = scram-sha-256
Сохраните и закройте файл, а затем перезапустите службу PostgreSQL, чтобы изменения вступили в силу.
sudo systemctl restart postgresql
Затем войдите в оболочку PostgreSQL, используя следующую команду:
sudo -u postgres psql
Затем создайте роль пользователя и базу данных для Gitea, выполнив следующую команду:
postgres=# CREATE ROLE gitea WITH LOGIN PASSWORD '';
postgres=# CREATE DATABASE giteadb;
postgres=# GRANT ALL PRIVILEGES ON DATABASE giteadb TO gitea;
postgres=# exit
Здесь вам нужно указать имя пользователя, имя базы данных и пароль для Gitea.
На этом этапе ваш PostgreSQL настроен и готов к работе с Gitea. Проверьте настройки аутентификации в файле /etc/postgresql/14/main/pg_hba.conf.
PostgreSQL по умолчанию принимает все локальные подключения.
host all all 127.0.0.1/32 scram-sha-256
Если вы хотите использовать giteadb удаленно, добавьте следующую строку с вашим IP-адресом в файл /etc/postgresql/14/main/pg_hba.conf.
host giteadb gitea 134.122.38.0/32 scram-sha-256
Шаг 3 — Установите и настройте Git
Затем установите git с помощью следующей команды:
sudo apt install git
Проверьте установку git, проверив версию Git:
git --version
Вывод:-
git version 2.30.2
Затем вам нужно указать свое имя и адрес электронной почты для Git.
git config --global user.name "Your Name"
git config --global user.email "”
Вы можете проверить конфигурацию Git с помощью следующей команды.
git config --list
Вывод:-
user.name=Your Name
Шаг 4 — Создайте пользователя git для Gitea
Теперь вам нужно создать пользователя Gitea. Вы можете сделать это с помощью следующей команды:
sudo adduser \
--system \
--shell /bin/bash \
--gecos 'Git Version Control' \
--group \
--disabled-password \
--home /home/git \
git
Это создаст нового пользователя git.
Шаг 5 – Установите и настройте Gitea
Перейдите на страницу загрузки Gitea и загрузите последнюю доступную версию бинарного файла Gitea. На момент написания этого руководства последняя версия Giteas — 1.15.7. Вы можете изменить переменную VERSION в приведенной ниже команде, чтобы установить любую другую версию.
cd /tmp
GITEAVERSION=1.15.7
wget -O gitea https://dl.gitea.io/gitea/${GITEAVERSION}/gitea-${GITEAVERSION}-linux-amd64
Затем переместите двоичный файл Gitea на системный путь с помощью следующей команды:
sudo mv /tmp/gitea /usr/local/bin
Затем установите права на выполнение для двоичного файла Gitea, выполнив следующую команду в терминале:
chmod +x /usr/local/bin/gitea
Далее вам нужно будет создать структуру каталогов для Gitea, для этого выполните следующие команды:
sudo mkdir -p /etc/gitea
sudo mkdir -p /var/lib/gitea/{custom,data,indexers,public,log}
Затем предоставьте необходимые разрешения для правильной работы Gitea со следующими командами:
sudo chown -R git:git /var/lib/gitea/
sudo chown root:git /etc/gitea
sudo chmod -R 750 /var/lib/gitea/
sudo chmod 770 /etc/gitea
Затем создайте служебный файл systemd для Gitea с помощью следующей команды:
vim /etc/systemd/system/gitea.service
Вставьте в него следующий код.
[Unit]
Description=Gitea
After=syslog.target
After=network.target
After=postgresql.service
[Service]
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
[Install]
WantedBy=multi-user.target
Сохраните и закройте файл. Затем перезагрузите демон systemd и запустите службу Gitea с помощью следующей команды:
sudo systemctl daemon-reload
sudo systemctl start gitea
Далее вам необходимо включить службу Gitea при перезагрузке системы:
sudo systemctl enable gitea
Затем проверьте статус Gitea с помощью следующей команды:
sudo systemctl status gitea
Вы должны увидеть следующий вывод:
Как видите, Gitea запускается и работает на порту 3000 по умолчанию. Вы можете проверить порт Gitea с помощью следующей команды:
netstat -tulpan | grep 3000
Вы должны увидеть вывод, как показано ниже:
tcp6 0 0 :::3000 :::* LISTEN 43778/gitea
Шаг 6 – Получите доступ к веб-интерфейсу Gitea
Gitea теперь включена и по умолчанию прослушивает порт 3000. Откройте браузер и введите https://ВАШ IP-АДРЕС:3000.
Затем заполните необходимые параметры следующим образом:
Настройки базы данных
Тип базы данных: PostgreSQL
Хост: 127.0.0.1:5432
Имя пользователя: gitea
Пароль: введите пароль, который вы выбрали при создании роли Postgres.
Имя базы данных: giteadb< br> SSL: отключить
Общие настройки
Название сайта: название по вашему выбору.
Корневой путь репозитория: /var/lib/gitea/data/repositories
Корневой путь Git LFS: /var/lib/gitea/ data/lfs
Имя пользователя для запуска: git
Домен SSH-сервера: your_domain/IP
Порт SSH-сервера: 22
Gitea HTTP Listen Post: 3000
Базовый URL-адрес Gitea: http://ВАШ IP-АДРЕС :3000
Путь журнала: /var/lib/gitea/log
На этом этапе вы можете настроить свою электронную почту, сервер и сторонние настройки или сделать это позже. Тем не менее, вы должны настроить администратора
имя пользователя для входа в Gitea. Следовательно, перейдите к дополнительным настройкам, введите данные настройки учетной записи администратора и создайте пользователя-администратора для Gitea.
Затем нажмите кнопку «Установить Gitea». После успешного завершения установки вы будете перенаправлены на панель инструментов Gitea, показанную на следующей странице:
Теперь вы можете изучить Gitea, а в разделе «Администрирование сайта» из своей учетной записи администратора вы можете настроить другие сторонние службы, такие как интеграция активного каталога Windows с Gitea.
Шаг 7 – Настройка уведомлений по электронной почте
Вы можете включить уведомления по электронной почте в Gitea с помощью Sendmail или сторонней службы электронной почты, такой как Amazon SES, Sendgrid.
Чтобы включить уведомления по электронной почте, откройте файл конфигурации Gitea, используя следующую команду:
vim /etc/gitea/app.in
Затем отредактируйте следующий раздел в файле и добавьте следующий код в соответствии с настройками электронной почты.
[mailer]
ENABLED = true
FROM =
PASSWD = password
Сохраните и закройте файл, а затем перезапустите службу Gitea, чтобы изменения вступили в силу:
sudo systemctl restart gitea
Шаг 10 — Обновление Gitea
Обновление Gitea — это простой процесс, вам просто нужно загрузить и заменить двоичный файл Gitea.
Сначала остановите службу Gitea:
sudo systemctl stop gitea
Затем загрузите и установите двоичный файл Gitea, используя следующую команду:
cd /tmp
GITEAVERSION=LATESTVERSION
wget -O gitea https://dl.gitea.io/gitea/${GITEAVERSION}/gitea-${GITEAVERSION}-linux-amd64
sudo mv gitea /usr/local/bin
sudo chmod +x /usr/local/bin/gitea
Затем запустите службу Gitea с помощью следующей команды:
sudo systemctl start gitea
Теперь ваш Gitea обновлен без простоев.
Заключение
Поздравляем! Вы успешно установили службу git Gitea в Debian 11. Теперь вы можете легко обновлять Gitea и управлять своим git-репозиторием через веб-браузер. Кроме того, вы можете задать мне, если у вас есть какие-либо вопросы.