Инструкция по установке redmine, gitea на Ubuntu 20.04

 Что такое голый/чистый/bare репозиторий в git?

Голый/Чистый/bare репозиторий в Git — это репозиторий, который не имеет рабочего каталога. Обычно используется в качестве удалённого репозитория. Так как bare репозиторий используется только для обмена, то нет причин создавать рабочую копию на диске, проще говоря, такой репозиторий содержит только каталог .git вашего проекта и ничего больше.

https://www.rosehosting.com/blog/how-to-install-redmine-on-ubuntu-18-04/

https://profcad.ru/profblog/?p=967

https://losst.ru/kak-dobavit-polzovatelya-v-gruppu-linux

https://mac4u.tech/install-redmine-on-ubuntu-20-04-lts-with-passenger/

https://www.vultr.com/docs/how-to-install-and-configure-ruby-with-rbenv-rails-mariadb-nginx-ssl-and-passenger-on-ubuntu-17-04

https://linuxize.com/post/how-to-install-gitea-on-ubuntu-20-04/

apt update
apt upgrade

Подтвердить (ввести "Y") о скачивании и установке обновлений

apt install mariadb-server mariadb-client libmariadb-dev

Устанавливаем сервис mysql в автозагрузку

systemctl enable mariadb

После установки запускаем настройку безопасности

mysql_secure_installation

Этот скрипт поможет вам выполнить важные задачи безопасности, такие как настройка пароля root, отключение удаленного входа root, удаление анонимных пользователей и т. д. Если скрипт запрашивает пароль root, просто нажмите клавишу [Enter], так как по умолчанию пароль root не установлен.

"VALIDATE PASSWORD PLUGIN" можно не ставить, остальные пункты лучше применить.

Проверяем версию

 mysql -v

У меня результат "Server version: 10.3.31-MariaDB-0ubuntu0.20.04.1 Ubuntu 20.04", это важно для настроек redmine.

Подключаемся к MySQL

mysql -uroot -p

После команды ввести пароль, ключ "-p" как раз отвечает за это. Если запускаете из под пользователя root то может сработать и "mysql" без ключей.

Проверяем кодировку

show variables like 'coll%';

в таблицах должно быть "utf8mb4_general_ci" или "utf8_unicode_ci" или "utf8_general_ci", у меня было "latin1_swedish_ci".

Если отличается, то выходим из клиента mysql

exit;

Открываем на редактирование кофигурационный файл mysql

nano /etc/mysql/my.cnf

после строк "!includedir" добавляем (если в файле присутствую указанные разделы, то нужно в них добавить или изменить значения)

[client]
default-character-set=utf8

[mysqld]
character-set-server=utf8
default-storage-engine=MyISAM

Сохраняем комбинацией "Ctrl+O" + "Enter", выходим комбинацией "Ctrl+X"

Перезагружаем сервис mysql

systemctl restart mysql

повторно подключаемся к mysql

mysql -uroot -p

Создаем базу

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Создаем пользователя и устанавливаем права на базу, "password" нужно заменить на свой стойкий пароль.

GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'password';

Аналогично добавляем базу для gogs

CREATE DATABASE gitea;
GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost' IDENTIFIED BY 'password';

Обновляем права доступа и выходим

FLUSH PRIVILEGES;
exit;

Требования "Redmine 4.2 does not support Ruby 2.7.0 and 2.7.1. Use Ruby 2.7.2 or higher"

При установке через apt получаем "ruby 2.7.0p0", что не соответствует требованиям

Устанавливаем через rbenv, он ставит пакеты в рамках пользователя поэтому добавляем пользователя redmine и запускаем nginx из под него.

apt install git build-essential libssl-dev

useradd -r -m -d /opt/redmine -s /usr/bin/bash redmine
usermod -aG redmine www-data

su - redmine
cd ~

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec $SHELL

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
exec $SHELL

rbenv install 2.7.4
rbenv global 2.7.4
ruby -v

"ruby 2.7.4p191"

apt-get install nginx

systemctl start nginx
systemctl enable nginx

apt-get install dirmngr gnupg apt-transport-https ca-certificates software-properties-common

"software-properties-common"в инструкциях нет, он нужен для запуска "add-apt-repository"

Для уточнения за что отвечают пакеты можно воспользоваться поиском по репозиторию ubuntu (пример для apt-transport)

Импортируем ключ GPG репозитория (более подробное описание принципа), подключаем репозиторий "Phusionpassenger", обновляем кеш заголовков пакетов

apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7
add-apt-repository 'deb [arch=amd64] https://oss-binaries.phusionpassenger.com/apt/passenger focal main'
apt update

Устанавливаем модуль

apt install libnginx-mod-http-passenger

Указываем пользователя для запуска nginx

nano /etc/nginx/nginx.conf

user redmine;

Указываем расположение нужной версии ruby

nano /etc/nginx/conf.d/mod-http-passenger.conf

passenger_ruby /opt/redmine/.rbenv/shims/ruby;

Перезапускаем nginx

service nginx restart

Ставим пакеты

apt install imagemagick libmagickwand-dev

Скачиваем архив с кодом, распаковываем (взял не последнюю версию для того чтобы показать как обновлять)

su - redmine

wget https://www.redmine.org/releases/redmine-4.2.3.tar.gz
tar -xvf redmine-4.2.2.tar.gz

установку сделаю в "/opt/redmine" создаю папку, копирую в нее код

mkdir /opt/redmine
cp -r redmine-4.2.2/* /opt/redmine/

 переходим в папку, копируем примеры конфигурации в рабочее состояние

cd /opt/redmine/config/
cp configuration.yml.example configuration.yml
cp database.yml.example database.yml

настраиваем nano database.yml

nano database.yml

Пример

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "password"
  encoding: utfmb4

Нужно заменить "password" на рабочий пароль, и учесть # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7

Устанавливаем пакетный менеджер ruby и пакеты для работы redmine

apt install gcc ruby-dev libxslt-dev libxml2-dev zlib1g-dev

cd /opt/redmine/
gem install bundler
bundle config set --local without 'development test postgresql sqlite'
bundle install

Nginx по умолчанию работает под правами пользователя www-data, для корректной работы выдаем ему права на папку с redmine, эту команду желательно повторять при копировании файлов в папку под пользователем "root".

chown -R redmine:redmine /opt/redmine/

cd /opt/redmine
bundle exec rake generate_secret_token
RAILS_ENV=production bundle exec rake db:migrate

при установке может возникнуть ошибка "env: ruby\r: No such file or directory" решается правкой и сохранением фалов "/opt/redmine/bin/rake", "/opt/redmine/bin/bundle", убрал пустую строку после первой, проявляется при скачивании дистрибутива redmine упакованным в zip

 Создаем настройку для доменного имени

nano /etc/nginx/sites-available/test.malikov.pro.nginx

для работы расширение не важно потому что проверяются все файлы присутствующие в папке, для ".nginx" есть ассоциация плагина PHPStorm (ссылка)

содержимое файла, 

server {

	listen 80;
	server_name test.malikov.pro;

	location / {

		root /opt/redmine/public;
		
		access_log /var/log/nginx/test.malikov.pro.access.log;
		error_log /var/log/nginx/test.malikov.pro.error.log;

		passenger_enabled on;
		passenger_min_instances 1;
		client_max_body_size 10m;
	}
}

Использована локация "/" для дальнейшего подключения gogs в локацию "/git"

Создаем ссылку в "sites-enabled"

ln -s /etc/nginx/sites-available/test.malikov.pro.nginx /etc/nginx/sites-enabled/test.malikov.pro.nginx

Проверяем корректность конфигурации, сделано для того чтобы не обваливать рабочий сервер некорректной конфигурацией.

nginx -t

При выводе сообщения к корректности настроек

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Загружаем настройки

service nginx reload

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

Проверяем работоспособность перейдя по ссылке

Устанавливаем git

apt install curl

Создаем пользователя git

adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git

Заходим на страницу скачивания (ссылка),  смотрим актуальный релиз, на момент установки "0.11.91"

Переходим в рабочую папку, скачиваем архив с исполняемыми файлами.

cd ~
curl -s  https://api.github.com/repos/go-gitea/gitea/releases/latest | grep browser_download_url  |  cut -d '"' -f 4  | grep '\linux-amd64$' | wget -i -

Распаковываем в папку пользователя git, устанавливаем права доступа

chmod +x gitea-*-linux-amd64
mv gitea-*-linux-amd64 /usr/local/bin/gitea

Создаем папки и устанавливаем права доступа на них

mkdir -p /var/lib/gitea/{custom,data,log}
chown -R git:git /var/lib/gitea/
chmod -R 750 /var/lib/gitea/
mkdir /etc/gitea
chown root:git /etc/gitea
chmod 770 /etc/gitea

Создаем файл сервиса

nano /etc/systemd/system/gitea.service

[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
###
# Don't forget to add the database service dependencies
###
#
#Wants=mysql.service
#After=mysql.service
#
Wants=mariadb.service
After=mariadb.service
#
#Wants=postgresql.service
#After=postgresql.service
#
#Wants=memcached.service
#After=memcached.service
#
#Wants=redis.service
#After=redis.service
#
###
# If using socket activation for main http/s
###
#
#After=gitea.main.socket
#Requires=gitea.main.socket
#
###
# (You can also provide gitea an http fallback and/or ssh socket too)
#
# An example of /etc/systemd/system/gitea.main.socket
###
##
## [Unit]
## Description=Gitea Web Socket
## PartOf=gitea.service
##
## [Socket]
## Service=gitea.service
## ListenStream=<some_port>
## NoDelay=true
##
## [Install]
## WantedBy=sockets.target
##
###

[Service]
# Modify these two values and uncomment them if you have
# repos with lots of files and get an HTTP error 500 because
# of that
###
#LimitMEMLOCK=infinity
#LimitNOFILE=65535
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
# If using Unix socket: tells systemd to create the /run/gitea folder, which will contain the gitea.sock file
# (manually creating /run/gitea doesn't work, because it would not persist across reboots)
#RuntimeDirectory=gitea
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
# If you install Git to directory prefix other than default PATH (which happens
# for example if you install other versions of Git side-to-side with
# distribution version), uncomment below line and add that prefix to PATH
# Don't forget to place git-lfs binary on the PATH below if you want to enable
# Git LFS support
#Environment=PATH=/path/to/git/bin:/bin:/sbin:/usr/bin:/usr/sbin
# If you want to bind Gitea to a port below 1024, uncomment
# the two values below, or use socket activation to pass Gitea its ports as above
###
#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
#AmbientCapabilities=CAP_NET_BIND_SERVICE
###

[Install]
WantedBy=multi-user.target

Запускаем сервис, устанавливаем автозагрузку

sudo systemctl daemon-reload
sudo systemctl enable --now gitea

Проверяем состояние командой

systemctl status gitea

Если сервис успешно запущен то, то в выводе видим "Active: active (running)".

Создаем файл конфигурации nginx

nano /etc/nginx/sites-available/git-test.malikov.pro.nginx

Содержимое

server {
    listen 80;
    server_name git-test.malikov.pro;

    # log files
    access_log /var/log/nginx/git-test.malikov.pro.access.log;
    error_log /var/log/nginx/git-test.malikov.pro.error.log;

    # Handle / requests
    location / {
       proxy_redirect off;
       proxy_pass http://127.0.0.1:3000;
    }
}

Создаем ссылку в активных сайтах

ln -s /etc/nginx/sites-available/git-test.malikov.pro.nginx /etc/nginx/sites-enabled/git-test.malikov.pro.nginx

Проверяем

nginx -t

Перезагружаем

service nginx reload

Настройки сервиса осуществляются изменением конфиг файла

nano /etc/gitea/app.ini

[mailer]
ENABLED        = true
FROM           = 
MAILER_TYPE    = smtp
HOST           = smtp.yandex.ru:465
IS_TLS_ENABLED = false
USER           = 
PASSWD         = 

перезагружаем сервис

service gitea restart