Μετάβαση στο περιεχόμενο
Magicom

Backup File Sentry: πράκτορας αντιγράφων ασφαλείας για πραγματικές συνθήκες

Το Backup File Sentry είναι ένας πράκτορας αντιγράφων ασφαλείας αρχείων: ένα αυτόνομο εκτελέσιμο που καταγράφει κάθε φάση της μεταφοράς, ώστε μια αποτυχία να εξηγεί μέχρι πού έφτασε.

Φωτογραφία μεταλλικού αρχειοθηκίου με ένα συρτάρι ανοιχτό, γεμάτο καρτέλες

Το λογισμικό συμπεριφέρεται άψογα στο μηχάνημα όπου φτιάχτηκε. Τα ενδιαφέροντα προβλήματα εμφανίζονται μετά, μπροστά σε κάποιον που δεν το έγραψε και που αναφέρει απλώς «δεν δούλεψε». Το Backup File Sentry είναι ένα εργαλείο που φτιάξαμε ακριβώς για αυτή την περίπτωση: ένας πράκτορας γραμμής εντολών, σε TypeScript πάνω στο Bun, που μεταφέρει ρυθμισμένα αρχεία ανάμεσα σε έναν υπολογιστή πελάτη και έναν διακομιστή FTP, προς τις δύο κατευθύνσεις. Η μεταφορά των αρχείων είναι το εύκολο μέρος. Το δύσκολο είναι τι γίνεται με το πρόγραμμα όταν δεν υπάρχει κανείς που να το γνωρίζει.

Η πρόκληση

Ένας πράκτορας που τρέχει μακριά από τους δημιουργούς του αποτυγχάνει αθόρυβα και μετά αόρατα. Μια εκτέλεση που σταματά στη μέση δεν αφήνει καμία καταγραφή για το πού έφτασε. Ένα εκτελέσιμο που ανοίγει με διπλό κλικ στα Windows τυπώνει κάτι χρήσιμο και κλείνει το παράθυρο πριν το διαβάσει κανείς. Ένα πρόγραμμα που κρατά όλα τα αντίγραφα που έκανε ποτέ γεμίζει τον δίσκο που προστατεύει.

Η λύση μας

Κάθε μεταφορά είναι μια εργασία (job) και κάθε εργασία είναι μια εγγραφή σε τοπική βάση SQLite, που διαχειρίζεται το Drizzle ORM. Η εγγραφή περιέχει αναγνωριστικό UUIDv7, τη ρύθμιση και το αρχείο-στόχο, την κατεύθυνση, την κατάσταση και ένα JSON με αριθμημένες, επώνυμες φάσεις. Σε κάθε ορόσημο (λήψη στοιχείων σύνδεσης, τοπικό αντίγραφο, ολοκλήρωση μεταφοράς) προστίθεται μια φάση και η εγγραφή αποθηκεύεται. Αν η διεργασία διακοπεί, η τελευταία φάση που γράφτηκε είναι η τελευταία που επιτεύχθηκε. Αν προκύψει σφάλμα, προστίθεται φάση σφάλματος με το μήνυμα και η εργασία σημειώνεται ως αποτυχημένη. Έτσι η καταγραφή γίνεται αφήγηση και όχι απλή ετυμηγορία: όχι μόνο ότι το αντίγραφο απέτυχε, αλλά ότι έφτασε στην τρίτη φάση, έγραψε το τοπικό αντίγραφο και μετά δεν κατάφερε να συνδεθεί.

Η διατήρηση αντιγράφων έχει όρια και στις δύο πλευρές. Τα ονόματα των αντιγράφων ξεκινούν με χρονοσφραγίδα χιλιοστού του δευτερολέπτου, άρα η αλφαβητική ταξινόμηση είναι και χρονολογική: κρατούνται δέκα αντίγραφα τοπικά και πέντε στον απομακρυσμένο φάκελο. Αν ο απομακρυσμένος φάκελος είναι άδειος, καταγράφεται η φάση «Nothing to download» και η εργασία ολοκληρώνεται, γιατί το να μην υπάρχει κάτι προς επαναφορά δεν είναι αποτυχία.

Διάγνωση από απόσταση

Το πιο διδακτικό μέρος της ιστορίας του έργου είναι πέντε αλλαγές μέσα σε δεκαεπτά λεπτά, όλες με στόχο το εργαλείο να συμπεριφέρεται σωστά σε μηχάνημα πελάτη. Μια επιλογή --verbose περνά από τη γραμμή εντολών μέχρι τη λεπτομερή λειτουργία του πελάτη FTP, ώστε η αναλυτική καταγραφή να ενεργοποιείται για μία εκτέλεση χωρίς νέα μεταγλώττιση. Τα σφάλματα των εργασιών πιάνονται και καταγράφονται, αντί να τερματίζουν τη διεργασία. Και μετά από κάθε μεταφορά εμφανίζεται το μήνυμα «Press Enter or Ctrl+C to exit…», ώστε το παράθυρο να μένει ανοιχτό.

Ακολούθησε η εντολή job list, που επιστρέφει τις πέντε πιο πρόσφατες εργασίες με τις φάσεις τους. Αρκεί να ζητήσετε από τον χρήστη να τρέξει μία εντολή και να διαβάσει το αποτέλεσμα, χωρίς απομακρυσμένη πρόσβαση.

Παράδοση στο μηχάνημα

Δεν χρειάζεται εγκατάσταση του Bun στο μηχάνημα προορισμού: το πρόγραμμα παραδίδεται ως αυτόνομο εκτελέσιμο, με ενσωματωμένο το runtime, και εφαρμόζει το δικό του σχήμα βάσης μέσω της εντολής init. Οι ρυθμίσεις φυλάσσονται ως δεδομένα (τα σημεία FTP σε έναν πίνακα και οι αναφορές αρχείων σε άλλον), οπότε μια εργασία καλείται με αναγνωριστικό και το ίδιο εκτελέσιμο εξυπηρετεί κάθε μηχάνημα. Φτιάχνονται οκτώ εκδόσεις: Windows, macOS και Linux για x64, macOS και Linux για arm64, και εκδόσεις «baseline» για τα τρία x64, για παλαιότερους επεξεργαστές, γιατί στην πράξη υπάρχει και τέτοιος εξοπλισμός.

Συμπέρασμα

Οι πιο κρίσιμες ιδιότητες ενός εργαλείου που τρέχει χωρίς επίβλεψη είναι απλές: ιστορικό που λέει μέχρι πού έφτασε η εκτέλεση, παράθυρο που μένει ανοιχτό αρκετά ώστε να διαβαστεί, μία εντολή που αναφέρει τις τελευταίες πέντε εκτελέσεις και ένα εκτελέσιμο που κουβαλά το δικό του runtime.

Υπηρεσία: Εφαρμογές

Περισσότερα έργα