Εισαγωγή από τον δικό σας κάδο

Αν τα έγγραφά σας βρίσκονται ήδη σε αποθήκευση αντικειμένων (S3, ή οτιδήποτε μιλά το ίδιο API), δείξτε μας τον κάδο (bucket) αντί να ανεβάζετε αρχεία ένα ένα. Τα διαβάζουμε εκεί που είναι. Καταχωρείτε έναν κάδο μία φορά στην Αποθήκευσή σας και μετά κάνετε εισαγωγή όσες φορές θέλετε.

Τι ετοιμάζετε από τη δική σας πλευρά#

1. Έναν φάκελο μέσα στον κάδο με τα αρχεία που θέλετε να ευρετηριαστούν: handbook/policies/, και όχι ολόκληρο τον κάδο, εκτός αν ολόκληρος ο κάδος είναι αυτό που εννοείτε. Είναι το prefix, αν έτσι το λέει η αποθήκευσή σας.
2. Ένα κλειδί πρόσβασης που μπορεί μόνο να διαβάσει αυτόν τον φάκελο. Μια εισαγωγή βλέπει τη λίστα του φακέλου και διαβάζει τα αντικείμενα μέσα του, και τίποτε άλλο δεν μπορεί να κάνει. Ποτέ δεν γράφουμε στον κάδο σας, ποτέ δεν διαγράφουμε κάτι μέσα του, και ποτέ δεν διαβάζουμε έξω από τον φάκελο που καταχωρήσατε.

Μετά πατάτε Καταχώριση κάδου και συμπληρώνετε:

• Host αποθήκευσης. Τον host στον οποίο απαντά η αποθήκευσή σας, σκέτο: χωρίς σχήμα μπροστά, χωρίς τον κάδο και χωρίς διαδρομή μέσα του. Συνδεόμαστε πάντα με https, γιατί οτιδήποτε άλλο θα έβαζε το κλειδί πρόσβασής σας στο δίκτυο χωρίς κρυπτογράφηση. Μια διεύθυνση σε ιδιωτικό δίκτυο απορρίπτεται τη στιγμή της καταχώρισης, και ελέγχεται ξανά, στη διεύθυνση που πραγματικά προσεγγίζουμε, σε κάθε εισαγωγή.
• Κάδος, και Περιοχή αν η αποθήκευσή σας έχει περιοχές.
• Φάκελος. Είναι όριο, όχι απλώς σημείο εκκίνησης. Μια εισαγωγή μπορεί να τον στενέψει (αυτό κάνει το Μόνο αυτός ο φάκελος στην ίδια την εισαγωγή) αλλά ποτέ να τον διευρύνει, οπότε μια πηγή καταχωρημένη στο handbook/ δεν πρόκειται ποτέ να πειστεί να διαβάσει τον υπόλοιπο κάδο.
• Access key id και Secret access key.

Τι γίνεται με το μυστικό κλειδί#

Το μυστικό κλειδί πάει μόνο προς τα εκεί. Αποθηκεύεται κρυπτογραφημένο, και τίποτα στο προϊόν δεν το διαβάζει πίσω: ούτε η λίστα των πηγών, ούτε η ίδια η πηγή, ούτε το API των μυστικών. Στη συνέχεια βλέπετε ότι υπάρχει αποθηκευμένο κλειδί, ποτέ ποιο είναι, γι' αυτό και το πεδίο είναι κενό κάθε φορά που ανοίγετε ξανά την πηγή.

Άρα δεν μπορούμε να σας το ανακτήσουμε. Για να αλλάξετε κλειδί, γράψτε το νέο μυστικό πάνω στο παλιό· αν αφήσετε το πεδίο κενό, κρατάμε αυτό που ήδη έχουμε. Δεν υπάρχει τρόπος να το αφαιρέσετε αφήνοντας την πηγή στη θέση της, γιατί μια πηγή χωρίς κλειδί δεν μπορεί να κάνει καμία εισαγωγή.

Μία εισαγωγή είναι ένα έγγραφο#

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

Το έγγραφο εμφανίζεται αμέσως στη συλλογή, ως πρόχειρο, και η καρτέλα Εισαγωγή δείχνει την πορεία της εργασίας. Τίποτα δεν είναι αναζητήσιμο μέχρι να τελειώσει η εργασία και να δημοσιεύσετε, ακριβώς όπως με μια μεταφόρτωση.

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

Νέα εισαγωγή για να περάσουν οι αλλαγές#

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

Η νέα εισαγωγή δεν είναι επεξεργασία. Ο τίτλος, οι σημάνσεις και η κατάσταση δημοσίευσης μένουν όπως τα ορίσατε.

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

Αλλαγή ή αφαίρεση μιας πηγής#

Η επεξεργασία μιας πηγής (νέος host, άλλος κάδος, ανανεωμένο κλειδί) αλλάζει το τι θα διαβάσει η επόμενη εισαγωγή και αφήνει ό,τι έχει ήδη ευρετηριαστεί ακριβώς όπως είναι.

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

Τίποτα μέσα στον δικό σας κάδο δεν αλλάζει ποτέ, ό,τι κι αν κάνετε εδώ. Μόνο διαβάζουμε από αυτόν.