Различия

Показаны различия между двумя версиями страницы.

--- service:redmine [01.12.2021 10:33] – [Логи] viacheslav
+++ service:redmine [30.07.2024 19:21] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
+====== Redmine ======
+===== Настройка почты =====
+==== Отправка ====
+\var\www\html\config\configuration.yml
+<code yaml>
+default:
+  # Outgoing emails configuration
+  # See the examples below and the Rails guide for more configuration options:
+  # http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration
+  email_delivery:
+  # ==== Simple SMTP server at localhost
+  #
+  #  email_delivery:
+      delivery_method: :smtp
+      smtp_settings:
+        address: "mail.domain.ru"
+        port: 25
+        openssl_verify_mode: 'none'
+</code>
+Потом надо перезапустить Апач и настраивать в интерфейсе.
+==== Приём ====
+https://www.redmine.org/projects/redmine/wiki/RedmineReceivingEmails#Fetching-emails-from-an-IMAP-server
+Создан ящик redmine@domain.ru, на сервере в кронтабе вставлена строка
+<code bash>
+* * * * * www-data rake -f /var/www/html/Rakefile --silent redmine:email:receive_imap RAILS_ENV="production" project=test project_from_subaddress=redmine@domain.ru allow_override=all unknown_user=create no_permission_check=1 no_account_notice=1 default_group=Users host=mail.domain.ru ssl=true port=993 username=redmine@domain.ru password=password
+</code>
+По умолчанию письма принимаются в проект test, можно переопределять все поля, создавать юзера, если его нет в системе, добавлять в группу Users, не оповещать его об этом, не проверять разрешения.
+project_from_subaddress - парсинг субадресации. Т. е., пишешь на redmine+projectname@domain.ru и создаётся задача в проекте projectname, а не в проекте по умолчанию test. Чтобы так работало, нужно создавать группу рассылки redmine+projectname, в которую добавлять redmine@domain.ru. Если просто добавить доп. адрес redmine+projectname@domain.ru к ящику, то это работать не будет.
+Надо обязательно указывать проект по умолчанию, чтобы почта куда-то попадала, иначе будет ошибка\\
+<color #ed1c24>MailHandler: missing information from Anonymous: Unable to determine target project,</color>\\
+даже если в теле письма идентификатор проекта указан.
+При проверке почты в ящике шла ругань на сертификат:\\
+<color #ed1c24>OpenSSL::SSL::SSLError: SSL_connect returned=1 errno=0 state=error: certificate verify failed (unable to get local issuer certificate)</color>
+<code bash>
+nano /var/www/html/config/initializers/bypass_ssl_verification.rb
+require 'openssl'
+OpenSSL::SSL::VERIFY_PEER = OpenSSL::SSL::VERIFY_NONE
+</code>
+===== Логи =====
+Разросся production.log
+<code bash>
+# сжать лог
+gzip /var/www/html/log/production.log
+# keep the latest 15 files rotating 20MB each
+sed -i '/end/d' /var/www/html/config/environments/production.rb
+echo "config.logger = ActiveSupport::Logger.new(config.paths['log'].first, shift_age = 15, shift_size = 20 * 1024 * 1024)" >> /var/www/html/config/environments/production.rb
+echo "end" >> /var/www/html/config/environments/production.rb
+# уровень лога
+echo "config.log_level = :warn" >> /var/www/html/config/additional_environment.rb
+</code>
+https://www.redmine.org/boards/2/topics/25236\\
+https://www.redmine.org/boards/2/topics/11836
+===== Решение проблем =====
+==== Mysql2::Error: Incorrect string value ====
+В логах (''tail -f /var/www/html/log/production.log'') ошибка при попытке забрать письмо из ящика:
+<color #ed1c24>MailHandler: an unexpected error occurred when receiving email: Mysql2::Error: Incorrect string value: '\xF0\x9F\x99\x8F\xF0\x9F...' for column 'description' at row 1: INSERT INTO `issues`</color>
+Проблема в нестандартных символах, которые обычный utf8 прожевать не может. Нужно поменять в ''/var/www/html/config/database.yml'' параметр ''encoding'' на **utf8mb4**, а также сконвертировать БД, если она работает не в этом режиме.
+http://blog.andriylesyuk.com/4-byte-utf-8-problem-in-redmine-and-how-to-fix-it/
+===== Плагины =====
+==== Redmine Dynamic edit Issue plugin ====
+https://github.com/Ilogeek/redmine_issue_dynamic_edit
+<code javascript>
+// nano /var/www/html/plugins/redmine_issue_dynamic_edit/assets/javascripts/issue_dynamic_edit_configuration_file.js
+// строка
+var _CONF_EXCLUDED_FIELD_ID = [];
+// заменена на
+var _CONF_EXCLUDED_FIELD_ID = ["DescriptionInput", "StartDateInput"];
+</code>
+==== redmine_extended_watchers ====
+https://github.com/maxrossello/redmine_extended_watchers
+Ставится простым копированием в ''/var/www/html/plugins''. Каталог должен называться redmine_extended_watchers, иначе система работать не будет с руганью \\
+<color #ed1c24>[ E 2021-06-10 10:40:46.5705 1613/Tr age/Cor/App/Implementation.cpp:221 ]: Could not spawn process for application /var/www/html: The application encountered the following error: Plugin not found. The directory for plugin redmine_extended_watchers should be /var/www/html/plugins/redmine_extended_watchers. (Redmine::PluginNotFound)</color>
+==== redmine_more_previews ====
+Превью офисных форматов. Требует libreoffice.
+<code bash>
+apt install libreoffice -y
+</code>
+Проблемы при установке:
+<color #ed1c24>You specified: rubyzip (~> 2.3.0) and rubyzip (>= 0). Bundler cannot continue.</color>
+<code bash>
+sed -i '/rubyzip/d' /var/www/html/plugins/redmine_more_previews/converters/zippy/Gemfile
+</code>
+<color #ed1c24>Could not spawn process for application /var/www/html: The application encountered the following error: cannot load such file -- mimemagic/overlay (LoadError)</color>
+<code bash>
+sed -i '/mimemagic/c gem "mimemagic", "~> 0.3.7"' /var/www/html/plugins/redmine_more_previews/Gemfile
+</code>
+==== issue_mail_with_attachments ====
+Установка:
+  - Download a plugin zip from Redmine Plugins page and extract it.
+  - Copy "issue_mail_with_attachments" folder under "src" folder into redmine's "plugins" folder.
+  - Из Gemfile в каталоге плагина закомментировать строки 'public_suffix' и 'site_prism' с версиями и прописать их же, но без версий.
+  - Из каталога ''/var/www/html'' запустить ''bundle install''.
+  - ''systemctl restart apache2.service''
+==== draw.io ====
+https://github.com/mikitex70/redmine_drawio
+<code bash>
+# Установка
+cd /var/www/html/plugins
+git clone https://github.com/mikitex70/redmine_drawio.git
+systemctl restart apache2
+</code>
+==== PlantUML ====
+https://github.com/dkd/plantuml
+<code bash>
+# Установка
+apt install plantuml
+cd /var/www/html/plugins
+git clone https://github.com/dkd/plantuml.git
+sed -i 's/4.1/4.2/' plantuml/init.rb # Чтобы работало на версии 4.2
+systemctl restart apache2
+</code>
+==== Usability - НЕ РАБОТАЕТ НА НОВОЙ ВЕРСИИ ====
+http://rmplus.pro/ru/redmine/plugins/usability
+После апгрейда на версию Redmine 4.1.1 плагин не работает:
+<code bash>
+root@vmls-redmine1:/var/www/html# bundle exec rake redmine:plugins:migrate RAILS_ENV=production
+rake aborted!
+NameError: undefined method `store_translations' for module `Redmine::I18n::Backend::Implementation'
+</code>
+Пишут, что **Our plugins does not work with redmine 4.1.0, just 4.0.6. We have in progress to update still.**\\
+https://stackoverflow.com/questions/61079232/error-while-installing-plugin-for-redmine
+==== Issue Tabs  и Unread Issues - НЕ РАБОТАЮТ ====
+http://rmplus.pro/ru/redmine/plugins/issue_tabs\\
+http://rmplus.pro/ru/redmine/plugins/unread_issues
+<color #ed1c24>После их установки заявки перестали открываться, выдавая ошибку 404. После деинсталляции заработало.</color>
+<code bash>
+bundle exec rake redmine:plugins:migrate plugin=issue_tabs version=0 RAILS_ENV=production
+bundle exec rake redmine:plugins:migrate plugin=unread_issues version=0 RAILS_ENV=production
+rm -rf /var/www/html/plugins/issue_tabs
+rm -rf /var/www/html/plugins/unread_issues
+service apache2 restart
+</code>
+==== Установка плагинов rmplus.pro ====
+<code bash>
+# Откройте архив с плагином и выберите папку, соответствующую вашей версии Redmine.
+# Скопируйте её содержимое в папку «Redmine» — «plugins».
+# Скопируйте папку «rgloader» в корневую директорию «Redmine».
+# Убедитесь, что пользователь, из-под которого запускается web-сервер, имеет доступ к корневой директории установки «Redmine».
+# Как возможное решение, для операционных систем семейства UNIX, запустите следующие команды:
+sudo chmod 775 -R your_redmine_root_folder
+sudo chown -R your_web_server_group:your_web_server_user your_redmine_folder
+# Запустите `bundle install`, находясь внутри корневого каталога «Redmine», для установки необходимых гемов:
+bundle install
+# Выполните миграции плагина (убедитесь, что выполняя команду, находитесь в корневой директории установки «Redmine»):
+rake redmine:plugins:migrate RAILS_ENV=production
+# Перезагрузите сервер Apache:
+sudo service apache2 restart
+</code>