Ինչպես է այն աշխատում
Վահանակի պահուստավորում և վերականգնում
Ինչպես պահուստավորել վահանակն ինքը՝ տվյալների բազան, գաղտնագրման բանալիները, լիցենզիան և կարգավորումը, մեկ արխիվում և վերականգնել մաքուր սերվերի վրա։
Հաշիվների պահուստային պատճենները պարունակում են ձեր հաճախորդների ֆայլերն ու տվյալների բազաները։
Դրանցում չկա հենց վահանակը՝ նրա տվյալների բազան (ադմինիստրատորներ, հաշիվներ, պլաններ, կայքեր,
ժամանակացույցեր, աուդիտի մատյան), այն բանալին, որով գաղտնագրված է պահվող ամեն գաղտնիք,
լիցենզիան և /etc/maran-ը։ Առանց բանալու նոր սերվերը չի կարող կարդալ նույնիսկ պատճենված բազայի
գաղտնիքները։ Այս բացը փակում են maran panel-backup-ը և maran panel-restore-ը։
Երկուսն էլ հասանելի են միայն root-ին, ինչպես ամբողջ maran հրամանը։ Ձեռքով գործարկելիս նրանք ոչ
ծառայություն են ավելացնում, ոչ պորտ, ոչ ցանցային կանչ։ Ստորև նկարագրված ընտրովի ժամանակացույցն
ավելացնում է systemd timer և, միայն եթե դուք կարգավորեք, մեկ ելքային HTTPS վերբեռնում։
Գաղտնաբառի ֆայլը
Արխիվը գաղտնագրվում է ձեր ընտրած գաղտնաբառով, որը հրամանը կարդում է ֆայլից։ Ֆայլը ստեղծեք մեկ անգամ․
sudo install -m 0600 /dev/null /root/maran-backup.passphrase
sudo editor /root/maran-backup.passphrase
Ֆայլը պետք է լինի սովորական ֆայլ (ոչ սիմվոլիկ հղում), պատկանի root-ին, ունենա 0600 կամ 0400
ռեժիմ և պարունակի առնվազն 20 նիշից կազմված մեկ տող։ Մնացած ամեն ինչ մերժվում է մինչև
որևէ բան գրելը։ Գաղտնաբառը երբեք չի փոխանցվում հրամանի տողով կամ միջավայրի փոփոխականով։
Գաղտնաբառի պատճենը պահեք սերվերից դուրս և ոչ այնտեղ, որտեղ արխիվներն են։ Առանց գաղտնաբառի արխիվը ոչ ոք չի կարող բացել, ձեզ ևս ներառյալ։
Պահուստավորել
sudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase
Հրամանը /root-ում ստեղծում է maran-panel-backup-<UTC ժամանակ>-<pid>.tar.gpg ֆայլը՝ 0600
ռեժիմով, և տպում է դրա ուղին։ --out DIR-ով կարելի է ընտրել այլ թղթապանակ։ Այն պետք է լինի
բացարձակ ուղի, պատկանի root-ին և չլինի գրելի խմբի ու մյուսների համար։ Պահուստավորման ընթացքում
վահանակը շարունակում է աշխատել։ Եթե հրամանը ձախողվի, մասնակի ֆայլ չի մնում։
Արխիվը պատճենեք սերվերից դուրս։ Ով ունի արխիվը և գաղտնաբառը, նա տիրապետում է վահանակին։
Ինչ կա արխիվում
| Մաս | Վերականգնվում է panel-restore-ով |
|---|---|
| Վահանակի տվյալների բազան՝ բոլոր սխեմաներով | այո |
Security__EncryptionKey և Jwt__SigningKey՝ /etc/maran/panel.env-ից | այո |
/var/lib/maran/licence.json | այո |
/etc/maran-ի և /var/lib/maran-ի մնացածը (վահանակի TLS բանալին, ստեղծված կարգավորումները, ACME տվյալները) | ոչ, արխիվում է՝ ձեռքով վերցնելու համար |
panel.env-ի մնացած ամեն ինչ (հոսթի անունը, ssh պորտերը, վեբ սերվերի uid-ը) վերաբերում է հենց այն
սերվերին, որի վրա ֆայլը գտնվում է։ Ուստի վերականգնումը թողնում է այն, ինչ գրել է նոր տեղադրումը։
Արխիվը գաղտնագրվում է gpg-ով, AES-256, ամբողջականության պաշտպանությամբ։ Փոփոխված կամ կտրված արխիվը մերժվում է և երբեք չի վերականգնվում։
Վերականգնել մաքուր սերվերի վրա
- Նոր սերվերում տեղադրեք Maran-ը՝ պատճենի նույն թողարկումը կամ ավելի նորը։ Դիտարկիչում ադմինիստրատոր մի ստեղծեք։
- Արխիվը պատճենեք նոր սերվեր՝ root սեփականատիրոջով, և այնտեղ նորից ստեղծեք գաղտնաբառի ֆայլը։
- Վերականգնեք․bash
sudo /usr/local/sbin/maran panel-restore --passphrase-file /root/maran-backup.passphrase \ --replace-this-panel /root/maran-panel-backup-20261101T120000Z-4242.tar.gpg - Մուտք գործեք հին վահանակի ադմինիստրատորով։ Հին սերվերի բոլոր սեսիաները փակված են։
- Հաճախորդների ֆայլերը, կայքերը և բազաները վերականգնեք հաշիվների պահուստային պատճեններից։ Վահանակի պատճենում դրանց մասին կան միայն գրառումներ, բովանդակությունը չկա։
Վերականգնման հերթականությունը
- Վերծանել արխիվը և ստուգել այն ու ձևաչափի տարբերակը։
- Ստուգել պահված
panel.env-ի երկու բանալիները։ - Կանգնեցնել վահանակը։
- Փոխարինել տվյալների բազան մեկ տրանզակցիայով։
- Գրել երկու բանալիները այս սերվերի
panel.env-ում։ - Վերադարձնել լիցենզիան։
- Կիրառել այս թողարկման միգրացիաները։
- Գործարկել վահանակը։
Եթե տվյալների բազայի փոխարինումը ձախողվի, տրանզակցիան հետ է գլորվում, և բազան մնում է այնպես, ինչպես թողել էր տեղադրումը։ Վահանակը կանգնեցնելուց հետո ինչ էլ ձախողվի, վահանակը նորից գործարկվում է։
Ինչ է մերժվում
- գործարկումն առանց
--replace-this-panel-ի, քանի որ վերականգնումը փոխարինում է այս վահանակի բազան և բանալիները․ - գաղտնաբառի ֆայլ, որը չի համապատասխանում վերը նշված կանոններին․
- արխիվ, որի ուղին բացարձակ չէ, որը սովորական ֆայլ չէ կամ չի պատկանում root-ին․
- սերվեր առանց
/etc/maran/panel.env-ի (նախ տեղադրեք Maran-ը)․ - սխալ գաղտնաբառ կամ վնասված արխիվ, ընդ որում մերժումը լինում է մինչև որևէ փոփոխություն․
- արխիվի ձևաչափ, որը այս թողարկումը չի վերականգնում․
- երկրորդ պահուստավորում կամ վերականգնում, մինչ առաջինը դեռ ընթանում է։
Արխիվի ներսից ոչինչ չի գործարկվում։ Դրանից հանվում են միայն անվանված ֆայլերը, իսկ բանալիները ստուգվում են գրելուց առաջ։
Ժամանակացույց, մի քանի պատճենի պահպանում և պատճեն սերվերից դուրս
Ժամանակացույցը, պատճենների պահպանումը և S3 վերբեռնումը 1.0.0-beta.4-ում չկան, դրանք կհայտնվեն
հաջորդ թողարկման մեջ։ 1.0.0-beta.4-ում maran panel-backup-ը գործարկեք root-ի crontab-ից, իսկ
ֆայլը պատճենեք ձեր սեփական գործիքներով։
Հաջորդ թողարկումից տեղադրիչը սերվերի վրա դնում է timer-ը և նրա ծառայությունը, բայց երբեք չի միացնում դրանք։ Նախ դուք գրում եք կարգավորումների ֆայլը․
sudo install -d -m 0700 /etc/maran-backup
sudo install -m 0600 /dev/null /etc/maran-backup/passphrase
sudo editor /etc/maran-backup/passphrase
sudo install -m 0600 /usr/local/maran/cli/panel-backup.conf.example /etc/maran/panel-backup.conf
sudo editor /etc/maran/panel-backup.conf
sudo /usr/local/sbin/maran panel-backup-schedule enable
/etc/maran/panel-backup.conf-ը տվյալներ են, ոչ թե shell սկրիպտ․ մեկ ԲԱՆԱԼԻ=ԱՐԺԵՔ տողում, առանց
չակերտների և բացատների, անհայտ կամ կրկնված բանալին մերժվում է։ Ֆայլի տերը root-ն է, իրավունքները՝
0600։ Նրանում գաղտնիք չկա, այն միայն անվանում է այն ֆայլերը, որտեղ դրանք պահվում են․
| Բանալի | Նշանակություն |
|---|---|
PASSPHRASE_FILE | Պարտադիր է։ Գաղտնաբառի ֆայլը, կանոնները նույնն են, ինչ վերևում։ |
OUT_DIR | Որտեղ գրել արխիվները։ Լռելյայն /var/backups/maran-panel, այն ստեղծում է տեղադրիչը, հասանելի է միայն root-ին։ Մեկ այլ թղթապանակ պետք է նախապես գոյություն ունենա (տերը root, իրավունքները 0700)։ |
KEEP | Քանի արխիվ պահել, 1-ից 365։ Լռելյայն՝ 14։ |
SCHEDULE | Ե՞րբ գործարկել, systemd-ի օրացուցային ժամանակով, օրինակ *-*-* 02:30:00 (լռելյայն, ամեն օր) կամ Sun *-*-* 03:00:00․ հարմար են նաև hourly, daily, weekly և monthly-ն։ Timer-ը ավելացնում է մինչև 15 րոպե պատահական ուշացում։ |
S3_ENDPOINT, S3_BUCKET, S3_REGION, S3_ACCESS_KEY_ID_FILE, S3_SECRET_FILE, S3_PREFIX | Ընտրովի վերբեռնում։ Նշեք բոլորը, բացի S3_PREFIX-ից (bucket-ի ընտրովի թղթապանակ), կամ ոչ մեկը։ Մուտքի տվյալների երկու ֆայլերից յուրաքանչյուրում մեկ արժեք է։ |
Գաղտնաբառի ֆայլը և S3-ի մուտքի տվյալների ֆայլերը պահեք /root-ից և /home-ից դուրս, օրինակ
/etc/maran-backup-ում (տերը root, իրավունքները 0700, յուրաքանչյուր ֆայլինը՝ 0600)։ Ժամանակացույցով
աշխատող առաջադրանքն այդ երկու ծառերը չի տեսնում, և enable-ը մերժում է դրանց ներսի ուղին։ Դրանք մի
դրեք նաև /etc/maran-ում․ այդ թղթապանակը մտնում է արխիվի մեջ, իսկ իր պաշտպանած արխիվի ներսում
պահվող գաղտնաբառը ոչինչ չի պաշտպանում։
enable-ը ստուգում է ֆայլը և ժամանակացույցը, հետո միացնում է timer-ը։ Եթե ինչ-որ բան սխալ է, այն
անվանում է առաջին խնդիրը և ոչինչ չի փոխում։ Հետո․
sudo /usr/local/sbin/maran panel-backup-schedule status
sudo /usr/local/sbin/maran panel-backup-schedule disable
status-ը ցույց է տալիս, timer-ը միացված և ակտիվ է արդյոք, հաջորդ և վերջին գործարկումը և թե ինչպես
ավարտվեց վերջինը։ disable-ը կանգնեցնում է timer-ը և թողնում է ձեր կարգավորումներն ու բոլոր արխիվները
իրենց տեղում։
Յուրաքանչյուր գործարկում նույն պատճենն է, ինչ ձեռքով արվածը, որը timer-ը անում է root-ի անունից։ Եթե սարքը նշանակված ժամին անջատված էր, պատճենը վերցվում է հաջորդ միացման ժամանակ։ Հետո՝ հերթով․
- Պահպանում։ Միայն այն բանից հետո, երբ նոր արխիվը պատրաստ է, մնում են
KEEPամենանորերը։ Ավելի հները ջնջվում ենOUT_DIR-ից, ընդ որում միայն սովորական ֆայլերը, որոնց անունն ամբողջությամբ համընկնում էmaran-panel-backup-<UTC ժամանակ>-<pid>.tar.gpg-ի հետ։ Թղթապանակի մնացած ամեն բան չի շոշափվում։ Պահպանումը երբեք չի դիպչում S3-ի պատճեններին։ - Վերբեռնում, միայն եթե
S3_ENDPOINT-ը նշված է։ Արդեն գաղտնագրված.tar.gpgֆայլն ուղարկվում է HTTPS-ով (TLS 1.2 կամ ավելի նոր, առանց վերահասցեավորման, վկայականը միշտ ստուգվում է), և վերբեռնումը համարվում է կատարված, միայն երբ պահված օբյեկտի չափը հավասար է տեղային ֆայլի չափին։ Ցանցային սխալը կամ 5xx պատասխանը կրկնվում է երեք անգամ, տասը վայրկյան ընդմիջումով։ Մուտքի տվյալները երբեք չեն հայտնվում հրամանի տողում կամ մատյանում։
Եթե պահպանումը կամ վերբեռնումը ձախողվի, արխիվը մնում է սերվերի վրա, իսկ գործարկումը համարվում է
ձախողված (systemctl status maran-panel-backup.service)։ Յուրաքանչյուր գործարկում համակարգային
մատյանում թողնում է մեկ տող maran-cli պիտակով՝ արդյունքը և ոչ մի այլ բան։ Maran-ը հեռացնելիս
timer-ը ջնջվում է, արխիվները՝ երբեք։
Սերվերից դուրս պահվող պատճենից վերականգնելու համար ներբեռնեք .tar.gpg ֆայլը նոր սերվեր, տերը՝ root,
և կատարեք Վերականգնել մաքուր սերվերի վրա քայլերը։ Գաղտնաբառը
նույնն է, որով այն գաղտնագրվել է։
Սահմանափակումներ
- Պահպանումը, ժամանակացույցը և վերբեռնումը աշխատում են հաջորդ թողարկումից, ինչպես նկարագրված է վերևում։ Վերբեռնումը S3 API-ով դիմում է ձեր նշած endpoint-ին և միայն HTTPS-ով։ Արխիվը S3-ից հետ բերող հրաման չկա․ ներբեռնեք այն ձեր սեփական գործիքներով։
- Հրամանը չի մերժում ավելի նոր թողարկման արխիվը ավելի հին տեղադրման վրա վերականգնելը։ Նախ տեղադրեք նույն թողարկումը կամ ավելի նորը։
- Հին սերվերին կապված լիցենզիան նոր սերվերի համար կարող է պահանջել վերաթողարկում։
- Վահանակի TLS հավաստագիրը, ստեղծված կարգավորումները և ACME տվյալները ինքնաբերաբար չեն վերականգնվում։ Եթե պետք են, դրանք արխիվից վերցրեք ձեռքով։
- Եթե պահուստավորման ժամանակ հոսանքն անջատվի, չգաղտնագրված միջանկյալ պատճենը կմնա միայն root-ին հասանելի թղթապանակում՝ մինչև երկու հրամաններից որևէ մեկի հաջորդ գործարկումը։