Opgradering til version 11

Introduktion

Denne vejledning er beregnet til Server administratorer. Cloud brugere kan slappe af, sætte deres fødder op og overlade alle disse operationer til os.

Version 11 er et betydeligt teknologisk spring i forhold til tidligere versioner. Opgradering til denne version kræver lidt mere forberedelse end en almindelig opgradering for at undgå forstyrrelser. Betragt denne vejledning som en tjekliste for en problemfri overgang.

De vigtigste ændringer i den teknologiske stak forklares i Release notes. Det indeholder også vigtige funktionsændringer og plugin -oplysninger. Hvis du ikke allerede har gjort det, skal du læse dem først.

Nemme virtuelle maskiner til undsætning!

Nogle af de følgende punkter kan gælde for dig, og den kombinerede indsats for at virke mere end du er villig til at udholde. I sådanne tilfælde er der altid den lette mulighed for at få et fuldt installeret program på VMware/VirtualBox billede (.ova -format). Bare spørg vores support, hvem vil generere en VM til dig og muligvis endda arrangere datamigrering fra dit eksisterende system. Som en belønning for en sådan beslutning behøver du ikke at læse resten af denne artikel :)

Nyttige ressourcer

Instruktioner til de fleste trin er allerede offentliggjort på vores websteder og/eller vidensbase. Vi kopierer dem ikke alle til denne ene artikel. Vi vil snarere tilføje den nødvendige kontekst her og give links til de detaljerede instruktioner om disse specifikke operationer.

Model opgradering historie

Inden vi detaljerer hver komponent, viser vi et modeleksempel på en opgradering, mens vi forbliver på den samme server.

Eksisterende server

Nem VM med Easy Redmine version 10.10.1
rubin -v = 2.5.3
mysql --version = 5.7.31
redis-server --version = 5.0.3
perle liste | grep bundler = 1.16.6
node -v (ikke -eksisterende)
puma applikationsserver
nginx webserver

Da det er VM leveret af Easy, giver et stort miljø (OS, database) mulighed for opgradering på den samme server. Nogle komponenter er fine, som de er (mysql, redis-server, puma, nginx), nogle kræver opgradering (rubin, bundler), et krav mangler fuldstændigt (Node.js).

Steps

0) Download og installer den seneste LTS-version (10.14.x) - opgradering er kun mulig fra LTS.

1) Lad os starte med rubinopgradering
rvm install ruby 2.6.7 --patch railsexpress

(vent til ny rubin er installeret, det kan bede dig om sudo -adgangskode)

rvm use ruby-2.6.7 --default

2) Vi anbefaler at afinstallere tidligere rubinversion for at undgå mulige kollisioner
rvm remove ruby-2.5.3

Denne kommando vil afinstallere rubin med alle ædelstene og andre filer. Det er bedre end at bruge rvm uninstall kommando.

3) Nu skal vi geninstallere alle nødvendige ædelstene til applikation. Vi starter med bundler
gem install bundler

Lad os kontrollere, hvilken bundler der blev installeret
gem list | grep bundler

Det skal returnere en linje som
bundler (2.1.4, 2.1.2)

Sørg for, at der er en version højere end 2.2.16

4) Gå nu til /home/easy/your.vm.name
cd /home/easy/your.vm.name

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

Og tjek om den har den korrekte version
node -v

Det skal returnere noget lignende
v14.16.0

Sørg for, at din version er 14.16 eller højere.

6) Download pakke v11 -pakke fra klientzone, kopier den til din VM.

7) Stop puma -serveren
sudo systemctl stop puma@your.domain.name

Fra dette tidspunkt kan du vælge, om du vil fortsætte med automatisk procedure eller med manuel opgradering.

a) Automatisk opgradering (anbefalede)
8a) Kør opgraderingen via redmine -installationsprogrammet
redmine upgrade name_of_package

9a) Følg trinene i guiden.

b) Manuel opgradering
8b) Omdøb din seneste aktuelle/ mappe
mv current/ current_old/

9b) Gendan aktuel mappe
mkdir current

10b) Gå til den aktuelle mappe
cd current/

11b) Pak pakken ud her
unzip /path/to/downloaded/package.zip

12b) Installer perler
bundle install

13b) Kør migreringer
bundle exec rake easyproject:install RAILS_ENV=production

14b) Hvis alt er ok, skal du starte puma tilbage
sudo systemctl start puma@your.domain.name

Tjekliste for specifikationer

Operativsystem

Fra version 11 er det eneste understøttede operativsystem (hvor applikationen kører direkte) Debianisær 10 (Buster) og 11 (Bullseye).

Hvis du kører Easy Redmine på vores leverede VM'er, har du sandsynligvis allerede dækket dette krav. Hvis du har et ikke-understøttet OS, skal du migrere til en ny server (helst vores VM). Geninstallation eller opgradering af OS under et produktionsprogram er bestemt ikke i din bedste interesse.

Databaseserver

Du skal bruge Percona/MySQL 5.7+. Der er cirka tre sager:

Du har en ældre Percona -version -> opgradering via officielle instruktioner, som f.eks
https://www.percona.com/doc/percona-server/5.7/upgrading_guide_56_57.html
Du har en anden MySQL -distribution (f.eks. MariaDB) -> vi anbefaler at migrere til en ny server (helst vores VM).
Du har PostgreSQL -> vi anbefaler at migrere til ny server (helst vores VM). Før selve migreringen skal databasen konverteres. Vi testede forskellige konverteringsværktøjer og gav instruktioner til de mest egnede. Vi er også klar til at udføre konverteringen for dig.

Rubin

Sproget bag applikationen skal holdes ajourført, f.eks. Det sprog, som folk kommunikerer efter. Opgradering af Ruby er beskrevet her. Medmindre din eksisterende Ruby er meget gammel, kan du fortsætte på den samme server.

Bundler

Praktisk taget en perle til at styre perler. Da Easy Redmine bruger mere end 200 af dem, er bundler en afgørende komponent.

Sådan installerer du
gem install bundler

For at kontrollere versionen
gem list | grep bundler

Version 2.2.x skal installeres automatisk. Hvis det ikke gør det, skal du følge officiel dokumentation.

Omfor

For at strømline nogle af de nye funktioner og ydelsesforbedringer i v11 bruger vi Sidekiq med redis-server. Easy VM'er indeholder allerede disse komponenter. Vær forsigtig med versionen, ER11 kræver redis-server 5+.

Her er et uddrag fra hovedinstallationsguiden i din v11 pakke under doc/INSTALL_DEBIAN

Opsætning redis og sidekiq

Skift let til bruger.

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

hvis Rails.env.produktion? 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, navneområde: redis_namespace}

ende

Sidekiq.configure_client do | config | config.redis = {url: redis_url, navneområde: redis_namespace}

ende ende

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

: verbose: false: pidfile: ../sidekiq.pid: logfile: ./log/sidekiq.log: samtidighed: <%= ENV ["SIDEKIQ_WORKERS"] || 2 %>: køer:

kritisk

standard

genberegne_tilpassede_felter

let_git

let_handlinger

easy_mail_kampagner

lette_integrationer

afsendere

nemme_rake_opgaver

lav

node.js

Endelig det sidste store krav. Installation er ret enkel

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

Sørg for, at du har version 14.16. Officiel dokumentation tilgængelig her.

WebSockets

Selvom det ikke er et strengt krav, der blokerer applikationen fra at køre, bruger to funktioner denne teknologi (viser live online/offline-tilstand i brugerens avatar; meddelelse i appen om færdig eksport). Det udvides i fremtiden.

Handlingskabel skal aktiveres. Det er afhængigt af Redis. Hvis du vil bruge disse funktioner, men ikke er bekendt med Redis/ActionCable -konfigurationen, anbefaler vi at migrere til en ny VM, hvor disse er forudkonfigureret.

Tvungen HTTPS-protokol

Version 11 håndhæver HTTPS-protokollen for applikations-URL'en. Tjek venligst webserver (nginx) konfiguration for at sikre, at din applikation vil være tilgængelig via https://[easyredmine_url] fra din webbrowser eller fra enhver integration, der forbinder til din Easy Redmine. URL'erne http://[easyredmine_url] vil ikke fungere i v11!

Slut på sub-uri

Da front-end modtager avancerede forbedringer, er det ikke længere muligt at blive ved med at understøtte sub-uri-konfiguration. Denne form for konfiguration er følsom over for Javascript -komponenter og forårsager ofte funktionsfejl. Konfigurer din server til et almindeligt domæne.

Efter opgradering

Tekstil/Markdown tekster migration

Som skrevet i udgivelses noter vi droppede støtten til forskellige teksteditorer. Hvis du tidligere har brugt tekstil- eller markdown-tekstredigering, skal du køre migreringen af formaterede tekster til HTML ved hjælp af den relevante kommando af disse.

Tjek først din seneste tekstformatering med:

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

Hvis det er tekstil, skal du bruge denne kommando:

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

eller dette, hvis tekstformateringen er Markdown:

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

Og hvis migreringen lykkedes, skift din tekstformatering til HTML endelig med:

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

Genstart webserveren for at anvende ændringer fuldt ud.