Սկսելու համար
Maran-ի թարմացում
Ինչպես թարմացնել սերվերը՝ պահուստավորել վահանակը, նորից գործարկել տեղադրիչը, ինչ է պահպանվում ու միգրացվում, ինչպես ստուգել արդյունքը և ինչ անել ձախողվելիս։
Maran-ը թարմացնելու համար տեղադրիչը պետք է նորից գործարկել այն սերվերի վրա, որտեղ Maran-ը արդեն կա։
maran update և maran rollback հրամաններ չկան, իսկ վահանակում մեկ սեղմումով թարմացում չկա, ուստի
ստորև նկարագրված քայլերն են ամբողջ ընթացակարգը։ Կատարեք դրանք root-ով, հենց սերվերի shell-ում։
1. Սկզբում վահանակի պահուստային պատճեն արեք
Տեղադրիչը ոչինչ հետ չի գլորում, ուստի հետդարձի ճանապարհը այս պատճենն է։ Ստեղծեք այն, ինչպես նկարագրված է Վահանակի պահուստավորում և վերականգնում էջում․
sudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase
Արխիվը պատճենեք սերվերից դուրս, իսկ անցաբառը պահեք ոչ սերվերի վրա, ոչ էլ արխիվի կողքին։ Պատճենը
ստեղծելիս վահանակը շարունակում է աշխատել։ Արխիվում կան վահանակի տվյալների բազան, նրա երկու
բանալիները, լիցենզիան և /etc/maran-ը։ Հաճախորդների ֆայլերն ու տվյալների բազաները այստեղ չեն մտնում,
դրանք հաշիվների պահուստային պատճեններում են։
2. Նորից գործարկեք տեղադրիչը
Կատարեք այն հրամանը, որով տեղադրել էիք․
curl -sSL https://get.maran.innovayse.com | sudo bash
Տեղադրիչը կարելի է անվտանգ կրկնել։ Այն ներբեռնում է ընթացիկ ստորագրված թողարկումը, ապափաթեթավորելուց
առաջ ստուգում է մանիֆեստի ստորագրությունը և յուրաքանչյուր արխիվի ստուգիչ գումարը, ապա արխիվը բացելուց
անմիջապես առաջ այդ գումարը նորից է ստուգում։ Թողարկումների ալիքն ընտրելու համար ապափաթեթավորված
տեղադրիչը գործարկեք --channel stable կամ --channel beta պարամետրով։ Ինտերնետ չունեցող սերվերում
օգտագործեք Տեղադրում էջում նկարագրված օֆլայն փաթեթը․
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-ը տեղադրված է և հասանելի է վահանակի հասցեով։ Ապա սերվերից հաստատեք արդյունքը․
sudo /usr/local/sbin/maran status
Բոլոր ծառայությունները պետք է լինեն ակտիվ և միացված, իսկ վահանակի հաշվետվությունը պետք է ցույց տա, որ տվյալների բազան հասանելի է, գործակալը միացած է, սպասող միգրացիաներ չկան և տարբերակը սպասվածն է։ Ամեն ինչ առողջ լինելու դեպքում ելքի կոդը 0 է, հակառակ դեպքում՝ 1։ Յուրաքանչյուր մասի իմաստը նկարագրված է Վերականգնում և ախտորոշում էջում։ Հետո մտեք վահանակ և բացեք գլխավոր էջը։
Եթե թարմացումը ձախողվի
Տեղադրիչը հետ չի գլորում։ Այն կանգ է առնում ձախողված քայլում և հայտնում, թե որ քայլն է։ Դրանից առաջ քայլերն արդեն կատարվել են, դրանից հետո՝ ոչ։
- Կարդացեք
/var/log/maran/install.logֆայլի վերջը և տեղադրիչի տպած հաղորդագրությունը։ - Վերացրեք պատճառը և նորից գործարկեք տեղադրիչը։ Յուրաքանչյուր քայլ կատարելուց առաջ ստուգում է ընթացիկ վիճակը, ուստի կրկնությունը շարունակում է այնտեղից, որտեղ նախորդը կանգ էր առել։
- Եթե վահանակը չի գործարկվում, կարդացեք
journalctl -u maran-apiևjournalctl -u maran-agentև կատարեքmaran status․ այն աշխատում է նաև այն դեպքում, երբ վահանակը կանգնած է։maran collect-diagnosticsհրամանը ստեղծում է գաղտնիքներից մաքրված փաթեթ, որը կարող եք ուղարկել ձեզ օգնողին։
Եթե սերվերը հնարավոր չէ վերականգնել, վերադարձեք 1-ին քայլի պահուստային պատճենին։ Մաքուր սերվերի վրա
տեղադրեք Maran-ը՝ պատճենի նույն թողարկումը կամ ավելի նորը, դիտարկիչում ադմինիստրատոր չստեղծելով, և
այնտեղ կատարեք maran panel-restore։ Վերականգնելիս հին տվյալների բազային կիրառվում են այդ թողարկման
միգրացիաները։ Քայլերը և այն, ինչից հրամանը հրաժարվում է, նկարագրված են Վահանակի պահուստավորում և
վերականգնում էջում։ Ավելի նոր թողարկման արխիվը մի վերականգնեք ավելի հին
տեղադրման վրա։ Հաճախորդների ֆայլերը, կայքերը և տվյալների բազաները վերադարձվում են հաշիվների պահուստային
պատճեններից։