Frissítés 11 -es verzióra

Bevezetés

Ez az útmutató arra szolgál szerver rendszergazdák. felhő a felhasználók ellazulhatnak, felemelhetik a lábukat, és ezeket a műveleteket ránk bízzák.

A 11 -es verzió jelentős technológiai ugrás a korábbi verziókhoz képest. Az erre a verzióra való frissítés valamivel több előkészületet igényel, mint a rendszeres frissítés, hogy elkerüljük a zavarokat. Tekintse ezt az útmutatót egy ellenőrző listának a zökkenőmentes átmenet érdekében.

A technológiai verem legfontosabb változásait a Kiadási megjegyzések. Ezenkívül fontos funkcionális változtatásokat és bővítményinformációkat is tartalmaz. Ha még nem tette meg, először olvassa el őket.

Egyszerű virtuális gépek a mentéshez!

Az alábbi pontok némelyike ​​vonatkozhat rád, és az együttes erőfeszítés többnek tűnik, mint amit hajlandó vagy elviselni. Ilyen esetben mindig van egy egyszerű lehetőség egy teljesen telepített alkalmazás bekapcsolására VMware/VirtualBox kép (.ova formátum). Csak kérje támogatásunkat, aki virtuális gépet generál Önnek, és esetleg megszervezi az adatok áttelepítését a meglévő rendszerből. Az ilyen döntés jutalmául nem kell elolvasnia a cikk többi részét :)

Hasznos források

A legtöbb lépésre vonatkozó utasításokat már közzétették webhelyeinken és/vagy tudásbázisunkban. Nem másoljuk mindegyiket ebbe az egy cikkbe. Itt inkább a szükséges kontextust adjuk hozzá, és linkeket adunk az adott műveletekre vonatkozó részletes utasításokhoz.

Modell frissítési történet

Mielőtt részletesen eltávolítanánk az egyes összetevőket, bemutatunk egy példát a frissítésre, miközben ugyanazon a kiszolgálón maradunk.

Meglévő szerver

• Egyszerű virtuális gép az Easy Redmine 10.10.1 verziójával
• rubin -v = 2.5.3
• mysql --verzió = 5.7.31
• redis-server --verzió = 5.0.3
• drágakövek listája | grep köteg = 1.16.6
• csomópont -v (nem létezik)
• puma alkalmazásszerver
• nginx webszerver

Mivel az Easy által biztosított virtuális gép, a nagy környezet (operációs rendszer, adatbázis) lehetővé teszi a frissítést ugyanazon a szerveren. Egyes összetevők rendben vannak (mysql, redis-server, puma, nginx), egyesek frissítést igényelnek (rubin, csomag), egy követelmény teljesen hiányzik (Node.js).

Lépései

0) Töltse le és telepítse a legújabb LTS-verziót (10.14.x) - a frissítés csak LTS-ről lehetséges.

1) Kezdjük a rubin frissítéssel
rvm install ruby 2.6.7 --patch railsexpress

(várja meg, amíg új rubint telepít, lehet, hogy megkéri a sudo jelszót)

rvm use ruby-2.6.7 --default

2) Az esetleges ütközések elkerülése érdekében javasoljuk a korábbi rubin verzió eltávolítását
rvm remove ruby-2.5.3

Ez a parancs eltávolítja a rubint az összes drágakővel és más fájlokkal. Jobb, mint használni rvm uninstall parancs.

3) Most újra kell telepítenünk az alkalmazáshoz szükséges drágaköveket. Bundlerrel kezdjük
gem install bundler

Nézzük meg, hogy melyik csomag lett telepítve
gem list | grep bundler

Egy ilyen sort kell visszaadnia
bundler (2.1.4, 2.1.2)

Győződjön meg arról, hogy a 2.2.16 -nál magasabb verzió van

4) Most lépjen a /home/easy/your.vm.name oldalra
cd /home/easy/your.vm.name

5) Telepítse a nodejs -t
sudo apt update
sudo apt upgrade
curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -
sudo apt install nodejs

És ellenőrizze, hogy helyes verziója van -e
node -v

Valami ilyesmit kell visszaadnia
v14.16.0

Győződjön meg arról, hogy a verziója 14.16 vagy újabb.

6) Töltse le a v11 csomagot az ügyfélzónából, másolja át a virtuális gépre.

7) Állítsa le a puma szervert
sudo systemctl stop puma@your.domain.name

Ettől a ponttól választhat, hogy folytatni szeretné az automatikus eljárást vagy a manuális frissítést.

a) Automatikus frissítés (ajánlott)
8a) Futtassa a frissítést a redmine telepítőn keresztül
redmine upgrade name_of_package

9a) Kövesse a varázsló lépéseit.

b) Kézi frissítés
8b) Nevezze át a legutóbbi aktuális/ mappát
mv current/ current_old/

9b) Hozza létre újra az aktuális mappát
mkdir current

10b) Ugrás az aktuális mappába
cd current/

11b) Itt csomagolja ki a csomagot
unzip /path/to/downloaded/package.zip

12b) Telepítsen drágaköveket
bundle install

13b) Futtassa a migrációt
bundle exec rake easyproject:install RAILS_ENV=production

14b) Ha minden rendben van, kezdje újra a pumát
sudo systemctl start puma@your.domain.name

Műszaki adatok ellenőrzőlista

Operációs rendszer

A 11 -es verziótól az egyetlen támogatott operációs rendszer (ahol az alkalmazás közvetlenül fut) az Debian, különösen 10 (Buster) és 11 (Bullseye).

Ha az Easy Redmine -t a biztosított virtuális gépeken futtatja, akkor valószínűleg már eleget tesz ennek a követelménynek. Ha nem támogatott operációs rendszere van, akkor át kell költöznie egy új szerverre (lehetőleg a virtuális gépünkre). Az operációs rendszer újratelepítése vagy frissítése egy éles alkalmazás alatt biztosan nem érdeke.

Adatbázis-kiszolgáló

A Percona/MySQL 5.7+ -ot kell használnia. Nagyjából három eset van:

• Van egy régebbi Percona verziója -> frissítse hivatalos utasításokkal, mint pl
  https://www.percona.com/doc/percona-server/5.7/upgrading_guide_56_57.html
• Más MySQL disztribúcióval rendelkezik (például MariaDB) -> javasoljuk, hogy új szerverre (lehetőleg a virtuális gépünkre) költözzön.
• Rendelkezik PostgreSQL -vel -> azt javasoljuk, hogy új szerverre (lehetőleg virtuális gépünkre) válasszon. Maga az áttelepítés előtt az adatbázist át kell alakítani. Különféle átalakító eszközöket teszteltünk és utasításokat adott a legmegfelelőbbekhez. Mi is készek vagyunk elvégezni az átalakítást az Ön számára.

Rubin

Az alkalmazás mögötti nyelvet naprakészen kell tartani, például azt a nyelvet, amelyen az emberek kommunikálnak. A Ruby frissítése le van írva itt. Hacsak nem túl régi a Ruby, akkor ugyanazon a szerveren folytathatja.

Bundler

Gyakorlatilag drágakő a drágakövek kezeléséhez. Mivel az Easy Redmine ezekből több mint 200 -at használ, a kötegelő kulcsfontosságú összetevő.

A telepítéshez
gem install bundler

A verzió ellenőrzéséhez
gem list | grep bundler

A 2.2.x verziót automatikusan telepíteni kell. Ha nem, kérjük, kövesse az hivatalos dokumentáció.

Feleinek

A v11 néhány új funkciójának és teljesítményjavításának racionalizálásához a Sidekiq-et használjuk a redis-szerverrel. Az egyszerű virtuális gépek már tartalmazzák ezeket az összetevőket. Legyen óvatos a verzióval kapcsolatban, az ER11-hez redis-server 5+ szükséges.

Íme egy részlet a telepítési útmutatóból v11 csomag alatt doc/INSTALL_DEBIAN

25. A redis és a sidekiq beállítása

Könnyű váltás felhasználóra.

vim /home/easy/current/config/additional_environment.rb

ha Rails.env.produkció? config.active_job.queue_adapter =: sidekiq

redis_namespace = Rails.root.join (".."). basename.to_s redis_url = "redis: //#{ENV ["REDIS_HOST"] || "127.0.0.1"}:#{ENV ["REDIS_PORT"] || 6379}/1 "Sidekiq.configure_server do | config | config.redis = {url: redis_url, namespace: redis_namespace}

végén

Sidekiq.configure_client do | config | config.redis = {url: redis_url, névtér: redis_namespace}

vége vége

vim /home/easy/current/config/sidekiq.rb

: részletes 2 %>: sorok:

• kritikai
• alapértelmezett
• az egyéni_mezők újraszámítása
• easy_git
• easy_actions
• easy_mail_campaigs
• easy_integrations
• postázók
• easy_rake_tasks
• alacsony

node.js

Végül az utolsó fontos követelmény. A telepítés meglehetősen egyszerű

sudo apt update
sudo apt upgrade
curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -
sudo apt install nodejs

Győződjön meg arról, hogy 14.16 -os verziója van. Hivatalos dokumentáció áll rendelkezésre itt.

WebSockets

Bár nem szigorú követelmény, amely blokkolja az alkalmazás futtatását, két funkció használja ezt a technológiát (élő online/offline állapot megjelenítése a felhasználó avatarjában; alkalmazáson belüli értesítés a befejezett exportálásról). A jövőben bővíteni fogják.

Művelet A kábelt engedélyezni kell. Redistől függ. Ha szeretné használni ezeket a funkciókat, de nem ismeri a Redis/ActionCable konfigurációt, javasoljuk, hogy válasszon át egy új virtuális gépre, ahol ezek előre konfiguráltak.

Kényszerített HTTPS protokoll

A 11-es verzió az alkalmazás URL-címének HTTPS protokollját kényszeríti ki. Kérjük, ellenőrizze a webszerver (nginx) konfigurációját, hogy megbizonyosodjon arról, hogy alkalmazása elérhető lesz a http-n keresztüls://[easyredmine_url] a webböngészőjéből vagy bármely olyan integrációból, amely az Easy Redmine-hoz csatlakozik. A http://[easyredmine_url] URL-ek nem működnek a 11-es verzióban!

Az al-uri vége

Mivel a kezelőfelület fejlett fejlesztéseket kap, a támogatást már nem lehet folytatni al-uri konfiguráció. Ez a fajta konfiguráció érzékeny a Javascript összetevőire, és gyakran hibás működést okoz. Kérjük, konfigurálja újra a szervert normál tartományra.

Frissítés után

Textil/Markdown szövegek migrálása

Ahogy írva van Kiadási megjegyzések megszüntettük a különböző szövegszerkesztők támogatását. Ha korábban textil vagy markdown szövegszerkesztést használt, akkor ezek megfelelő parancsával le kell futtatnia a formázott szövegek HTML-be költöztetését.

Kérjük, először ellenőrizze a legutóbbi szöveg formázását a következővel:

bundle exec rails r -e production "puts Setting.text_formatting"

Ha textil, használja ezt a parancsot:

bundle exec rake easyproject:textile:migrate_all source_formatting=textile RAILS_ENV=production

vagy ez, ha a szöveg formázása Markdown:

bundle exec rake easyproject:textile:migrate_all source_formatting=markdown RAILS_ENV=production

És ha az áttelepítés sikeres volt, állítsa át a szöveg formázását végül HTML-re a következővel:

bundle exec rails r -e production "puts Setting.text_formatting = 'HTML'"

Indítsa újra a webszervert a változtatások teljes körű alkalmazásához.