Անցնել բովանդակությանը

Սկսելու համար

Maran-ի թարմացում

Ինչպես թարմացնել սերվերը՝ պահուստավորել վահանակը, նորից գործարկել տեղադրիչը, ինչ է պահպանվում ու միգրացվում, ինչպես ստուգել արդյունքը և ինչ անել ձախողվելիս։

Maran-ը թարմացնելու համար տեղադրիչը պետք է նորից գործարկել այն սերվերի վրա, որտեղ Maran-ը արդեն կա։ maran update և maran rollback հրամաններ չկան, իսկ վահանակում մեկ սեղմումով թարմացում չկա, ուստի ստորև նկարագրված քայլերն են ամբողջ ընթացակարգը։ Կատարեք դրանք root-ով, հենց սերվերի shell-ում։

1. Սկզբում վահանակի պահուստային պատճեն արեք

Տեղադրիչը ոչինչ հետ չի գլորում, ուստի հետդարձի ճանապարհը այս պատճենն է։ Ստեղծեք այն, ինչպես նկարագրված է Վահանակի պահուստավորում և վերականգնում էջում․

bash
sudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase

Արխիվը պատճենեք սերվերից դուրս, իսկ անցաբառը պահեք ոչ սերվերի վրա, ոչ էլ արխիվի կողքին։ Պատճենը ստեղծելիս վահանակը շարունակում է աշխատել։ Արխիվում կան վահանակի տվյալների բազան, նրա երկու բանալիները, լիցենզիան և /etc/maran-ը։ Հաճախորդների ֆայլերն ու տվյալների բազաները այստեղ չեն մտնում, դրանք հաշիվների պահուստային պատճեններում են։

2. Նորից գործարկեք տեղադրիչը

Կատարեք այն հրամանը, որով տեղադրել էիք․

bash
curl -sSL https://get.maran.innovayse.com | sudo bash

Տեղադրիչը կարելի է անվտանգ կրկնել։ Այն ներբեռնում է ընթացիկ ստորագրված թողարկումը, ապափաթեթավորելուց առաջ ստուգում է մանիֆեստի ստորագրությունը և յուրաքանչյուր արխիվի ստուգիչ գումարը, ապա արխիվը բացելուց անմիջապես առաջ այդ գումարը նորից է ստուգում։ Թողարկումների ալիքն ընտրելու համար ապափաթեթավորված տեղադրիչը գործարկեք --channel stable կամ --channel beta պարամետրով։ Ինտերնետ չունեցող սերվերում օգտագործեք Տեղադրում էջում նկարագրված օֆլայն փաթեթը․

bash
sudo bash install.sh --offline-tarball <bundle>.tar.gz

Կրկնակի գործարկելիս նախնական ստուգումը վահանակի սեփական պորտը համարում է այս նույն տեղադրման զբաղեցրած պորտ։ Ամբողջ արտածումը ավելացվում է /var/log/maran/install.log ֆայլի վերջում, ուստի այդ մատյանում պահվում է բոլոր գործարկումների պատմությունը։

Ինչ է տեղադրիչը պահպանում և ինչ է փոխում

ԻնչԿրկնակի գործարկելիս
Security__EncryptionKey՝ /etc/maran/panel.env-ումՊահպանվում է։ Այն երբեք չի փոխվում, որովհետև փոխելու դեպքում պահված գաղտնիքներն այլևս չէին կարդացվի։
Jwt__SigningKey՝ /etc/maran/panel.env-ումՊահպանվում է, ուստի օգտատերերը թարմացումից հետո մնում են համակարգում։
Գործակալի ազատ տեղի շեմը՝ /etc/maran/agent.env-ումՊահպանվում է, եթե այն 1-ից սկսվող ամբողջ թիվ է։
panel.env-ի մնացած մասըՏեղադրիչը գրում է այն նորից, իսկ սերվերի տվյալները, օրինակ SSH պորտերը, նորից է հայտնաբերում։ Թարմացնելուց առաջ գրի առեք ձեռքով փոխած արժեքները և հետո ստուգեք դրանք։
Մեկանգամյա կարգավորման թոքենըՓոխարինվում է նորով։ Այն կարևոր է միայն առաջին ադմինիստրատորը ստեղծելուց առաջ։
Վահանակի տվյալների բազանՊահպանվում է, և նոր թողարկման միգրացիաներով հասցվում է ընթացիկ տարբերակի։
Վահանակի և գործակալի ծրագրերըՓոխարինվում են նոր թողարկման ծրագրերով։

Տվյալների բազայի միգրացիաներ

Տեղադրիչը բոլոր մոդուլների տվյալների բազայի միգրացիաները կիրառում է առանձին քայլով՝ կարգավորումները գրելուց հետո և ցանկացած ծառայություն գործարկելուց առաջ։ Այն վահանակի սեփական կատարվող ֆայլը գործարկում է միգրացիայի ռեժիմով, maran ծառայողական հաշվի անունից։ Ուստի այն միգրացիան, որը վահանակն ինքը չէր կարողանա կատարել, ձախողվում է հենց այստեղ, երբ դուք հետևում եք ընթացքին, ոչ թե մեկ ժամ հետո։ Եթե այս քայլը ձախողվի, տեղադրիչը կանգ է առնում, և ոչ մի ծառայություն դեռ չի վերագործարկված։

Վահանակը և գործակալը թարմացվում են միասին

Վահանակը և սերվերի գործակալը շփվում են տարբերակավորված պայմանագրով, և թողարկումը կարող է փոխել պայմանագրի ռևիզիան։ Այդ դեպքում թողարկման նշումներում կա «Թարմացնելուց առաջ» բաժինը։ Տեղադրիչը երկուսին էլ փոխարինում է մեկ գործարկմամբ, ապա վերագործարկում է նախ գործակալը, հետո վահանակը։ Այդ պատճառով տեղադրիչը գործարկեք ամբողջությամբ և երկուսից միայն մեկը մի փոխարինեք։ Գործարկվելիս վահանակը նաև յուրաքանչյուր PHP կայքի փուլը և վիրտուալ հոսթը համապատասխանեցնում է նոր թողարկմանը։

3. Ստուգեք արդյունքը

Տեղադրիչն ավարտելուց հետո կգրի, որ Maran-ը տեղադրված է և հասանելի է վահանակի հասցեով։ Ապա սերվերից հաստատեք արդյունքը․

bash
sudo /usr/local/sbin/maran status

Բոլոր ծառայությունները պետք է լինեն ակտիվ և միացված, իսկ վահանակի հաշվետվությունը պետք է ցույց տա, որ տվյալների բազան հասանելի է, գործակալը միացած է, սպասող միգրացիաներ չկան և տարբերակը սպասվածն է։ Ամեն ինչ առողջ լինելու դեպքում ելքի կոդը 0 է, հակառակ դեպքում՝ 1։ Յուրաքանչյուր մասի իմաստը նկարագրված է Վերականգնում և ախտորոշում էջում։ Հետո մտեք վահանակ և բացեք գլխավոր էջը։

Եթե թարմացումը ձախողվի

Տեղադրիչը հետ չի գլորում։ Այն կանգ է առնում ձախողված քայլում և հայտնում, թե որ քայլն է։ Դրանից առաջ քայլերն արդեն կատարվել են, դրանից հետո՝ ոչ։

  1. Կարդացեք /var/log/maran/install.log ֆայլի վերջը և տեղադրիչի տպած հաղորդագրությունը։
  2. Վերացրեք պատճառը և նորից գործարկեք տեղադրիչը։ Յուրաքանչյուր քայլ կատարելուց առաջ ստուգում է ընթացիկ վիճակը, ուստի կրկնությունը շարունակում է այնտեղից, որտեղ նախորդը կանգ էր առել։
  3. Եթե վահանակը չի գործարկվում, կարդացեք journalctl -u maran-api և journalctl -u maran-agent և կատարեք maran status․ այն աշխատում է նաև այն դեպքում, երբ վահանակը կանգնած է։ maran collect-diagnostics հրամանը ստեղծում է գաղտնիքներից մաքրված փաթեթ, որը կարող եք ուղարկել ձեզ օգնողին։

Եթե սերվերը հնարավոր չէ վերականգնել, վերադարձեք 1-ին քայլի պահուստային պատճենին։ Մաքուր սերվերի վրա տեղադրեք Maran-ը՝ պատճենի նույն թողարկումը կամ ավելի նորը, դիտարկիչում ադմինիստրատոր չստեղծելով, և այնտեղ կատարեք maran panel-restore։ Վերականգնելիս հին տվյալների բազային կիրառվում են այդ թողարկման միգրացիաները։ Քայլերը և այն, ինչից հրամանը հրաժարվում է, նկարագրված են Վահանակի պահուստավորում և վերականգնում էջում։ Ավելի նոր թողարկման արխիվը մի վերականգնեք ավելի հին տեղադրման վրա։ Հաճախորդների ֆայլերը, կայքերը և տվյալների բազաները վերադարձվում են հաշիվների պահուստային պատճեններից։