mobiletto 1.1.9 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/README.md +82 -4
  2. package/docs/README.md +113 -0
  3. package/docs/af/README.md +481 -0
  4. package/docs/am/README.md +481 -0
  5. package/docs/ar/README.md +481 -0
  6. package/docs/az/README.md +481 -0
  7. package/docs/be/README.md +481 -0
  8. package/docs/bg/README.md +481 -0
  9. package/docs/bn/README.md +481 -0
  10. package/docs/bs/README.md +481 -0
  11. package/docs/ca/README.md +481 -0
  12. package/docs/ceb/README.md +481 -0
  13. package/docs/co/README.md +481 -0
  14. package/docs/cs/README.md +481 -0
  15. package/docs/cy/README.md +481 -0
  16. package/docs/da/README.md +481 -0
  17. package/docs/de/README.md +481 -0
  18. package/docs/el/README.md +481 -0
  19. package/docs/eo/README.md +481 -0
  20. package/docs/es/README.md +481 -0
  21. package/docs/et/README.md +481 -0
  22. package/docs/eu/README.md +481 -0
  23. package/docs/fa/README.md +481 -0
  24. package/docs/fi/README.md +481 -0
  25. package/docs/fr/README.md +481 -0
  26. package/docs/fy/README.md +481 -0
  27. package/docs/ga/README.md +481 -0
  28. package/docs/gd/README.md +481 -0
  29. package/docs/gl/README.md +481 -0
  30. package/docs/gu/README.md +481 -0
  31. package/docs/ha/README.md +481 -0
  32. package/docs/haw/README.md +481 -0
  33. package/docs/he/README.md +481 -0
  34. package/docs/hi/README.md +481 -0
  35. package/docs/hmn/README.md +481 -0
  36. package/docs/hr/README.md +481 -0
  37. package/docs/ht/README.md +481 -0
  38. package/docs/hu/README.md +481 -0
  39. package/docs/hy/README.md +481 -0
  40. package/docs/id/README.md +481 -0
  41. package/docs/ig/README.md +481 -0
  42. package/docs/is/README.md +481 -0
  43. package/docs/it/README.md +481 -0
  44. package/docs/iw/README.md +481 -0
  45. package/docs/ja/README.md +481 -0
  46. package/docs/jv/README.md +481 -0
  47. package/docs/ka/README.md +481 -0
  48. package/docs/kk/README.md +481 -0
  49. package/docs/km/README.md +481 -0
  50. package/docs/kn/README.md +481 -0
  51. package/docs/ko/README.md +481 -0
  52. package/docs/ku/README.md +481 -0
  53. package/docs/ky/README.md +481 -0
  54. package/docs/la/README.md +481 -0
  55. package/docs/lb/README.md +481 -0
  56. package/docs/lo/README.md +481 -0
  57. package/docs/lt/README.md +481 -0
  58. package/docs/lv/README.md +481 -0
  59. package/docs/mg/README.md +481 -0
  60. package/docs/mi/README.md +481 -0
  61. package/docs/mk/README.md +481 -0
  62. package/docs/ml/README.md +481 -0
  63. package/docs/mn/README.md +481 -0
  64. package/docs/mr/README.md +481 -0
  65. package/docs/ms/README.md +481 -0
  66. package/docs/mt/README.md +481 -0
  67. package/docs/my/README.md +481 -0
  68. package/docs/ne/README.md +481 -0
  69. package/docs/nl/README.md +481 -0
  70. package/docs/no/README.md +481 -0
  71. package/docs/ny/README.md +481 -0
  72. package/docs/or/README.md +481 -0
  73. package/docs/pa/README.md +481 -0
  74. package/docs/pl/README.md +481 -0
  75. package/docs/ps/README.md +481 -0
  76. package/docs/pt/README.md +481 -0
  77. package/docs/ro/README.md +481 -0
  78. package/docs/ru/README.md +481 -0
  79. package/docs/rw/README.md +481 -0
  80. package/docs/sd/README.md +481 -0
  81. package/docs/si/README.md +481 -0
  82. package/docs/sk/README.md +481 -0
  83. package/docs/sl/README.md +481 -0
  84. package/docs/sm/README.md +481 -0
  85. package/docs/sn/README.md +481 -0
  86. package/docs/so/README.md +481 -0
  87. package/docs/sq/README.md +481 -0
  88. package/docs/sr/README.md +481 -0
  89. package/docs/st/README.md +481 -0
  90. package/docs/su/README.md +481 -0
  91. package/docs/sv/README.md +481 -0
  92. package/docs/sw/README.md +481 -0
  93. package/docs/ta/README.md +481 -0
  94. package/docs/te/README.md +481 -0
  95. package/docs/tg/README.md +481 -0
  96. package/docs/th/README.md +481 -0
  97. package/docs/tk/README.md +481 -0
  98. package/docs/tl/README.md +481 -0
  99. package/docs/tr/README.md +481 -0
  100. package/docs/tt/README.md +481 -0
  101. package/docs/ug/README.md +481 -0
  102. package/docs/uk/README.md +481 -0
  103. package/docs/ur/README.md +481 -0
  104. package/docs/uz/README.md +481 -0
  105. package/docs/vi/README.md +481 -0
  106. package/docs/xh/README.md +481 -0
  107. package/docs/yi/README.md +481 -0
  108. package/docs/yo/README.md +481 -0
  109. package/docs/zh/README.md +481 -0
  110. package/docs/zu/README.md +481 -0
  111. package/drivers/b2/index.js +24 -6
  112. package/hokey.json +16 -0
  113. package/index.js +32 -16
  114. package/package.json +3 -2
  115. package/test/api.spec.js +319 -306
  116. package/util/logger.js +1 -1
  117. package/util/redis.js +1 -1
@@ -0,0 +1,481 @@
1
+ Mobiletto
2
+ =========
3
+
4
+ Mobiletto este un strat de abstractizare a stocării JavaScript, cu criptare opțională transparentă pe partea clientului.
5
+
6
+ # Cuprins
7
+ * [De ce Mobiletto?](#De ce-Mobiletto?)
8
+ * [Pornire rapidă](#Pornire rapidă)
9
+ * [Mobiletto CLI](#mobiletto-cli)
10
+ * [Sursa](#Sursa)
11
+ * [Instalare](#Instalare)
12
+ * [Suport și finanțare](#Support-and-Funding)
13
+ * [Utilizare de bază](#Utilizare de bază)
14
+ * [Metadate](#Metadate)
15
+ * [Stil de import alternativ](#Stil de import alternativ)
16
+ * [Memorizare în cache](#Memorizare în cache)
17
+ * [Oglindire](#Oglindire)
18
+ * [Criptare transparentă](#Transparent-encryption)
19
+ * [Rotire taste](#Rotire taste)
20
+ * [Interfață driver](#Driver-interfață)
21
+ * [Înregistrare](#Înregistrare)
22
+
23
+ # Citiți asta într-o altă limbă
24
+ Acest document README.md a fost tradus, prin [hokeylization](https://github.com/cobbzilla/hokeylization), în
25
+ **[fiecare limbă acceptată de Google Translate](https://cloud.google.com/translate/docs/languages)!**
26
+
27
+ Sunt sigur că nu este perfect, dar sper că este mai bine decât nimic!
28
+
29
+ [🇸🇦 Arabă](../ar/README.md)
30
+ [🇧🇩 Bengali](../bn/README.md)
31
+ [🇩🇪 Germană](../de/README.md)
32
+ [🇺🇸 engleză](../en/README.md)
33
+ [🇪🇸 Spaniolă](../es/README.md)
34
+ [🇫🇷 Franceză](../fr/README.md)
35
+ [🇹🇩 Hausa](../ha/README.md)
36
+ [🇮🇳 Hindi](../hi/README.md)
37
+ [🇮🇩 indoneziană](../id/README.md)
38
+ [🇮🇹 italiană](../it/README.md)
39
+ [🇯🇵 japoneză](../ja/README.md)
40
+ [🇰🇷 coreeană](../ko/README.md)
41
+ [🇮🇳 Maranthi](../mr/README.md)
42
+ [🇵🇱 poloneză](../pl/README.md)
43
+ [🇧🇷 portugheză](../pt/README.md)
44
+ [🇷🇺 rusă](../ru/README.md)
45
+ [🇰🇪 Swahili](../sw/README.md)
46
+ [🇵🇭 Tagalog](../tl/README.md)
47
+ [🇹🇷 Turcă](../tr/README.md)
48
+ [🇵🇰 Urdu](../ur/README.md)
49
+ [🇻🇳 vietnameză](../vi/README.md)
50
+ [🇨🇳 Chineză](../zh/README.md)
51
+
52
+
53
+ **[📚 ... Toate limbile ...](../README.md)**
54
+ ----
55
+
56
+ ### Există o problemă cu această traducere a fișierului README?
57
+ Această traducere specială a originalului [README](https://github.com/cobbzilla/mobiletto/blob/master/README.md)
58
+ poate fi defecte -- *corecțiile sunt foarte binevenite!* Vă rugăm să trimiteți o [pull request pe GitHub](https://github.com/cobbzilla/mobiletto/pulls),
59
+ sau dacă nu ești confortabil să faci asta, [deschide o problemă](https://github.com/cobbzilla/mobiletto/issues)
60
+
61
+ Când creați o nouă problemă GitHub despre o traducere, faceți:
62
+ * includeți adresa URL a paginii (copiați/lipiți din bara de adrese a browserului)
63
+ * includeți textul exact care este greșit (copiați/lipiți din browser)
64
+ * vă rugăm să descrieți ce este greșit -- traducerea este incorectă? formatarea este stricata cumva?
65
+ * Vă rugăm să oferiți o sugestie pentru o traducere mai bună sau cum ar trebui să fie formatat corect textul
66
+ * **Mulțumesc!**
67
+
68
+ ## De ce Mobiletto?
69
+
70
+ ### Adio blocare a furnizorului!
71
+ Diferiții furnizori de stocare în cloud au API-uri incompatibile. Chiar și cei care se străduiesc pentru „compatibilitatea S3”
72
+ au comportamente idiosincratice.
73
+
74
+ Când alegeți un anumit furnizor de stocare pentru aplicația dvs., dacă codificați direct în API-ul acestuia, aplicația dvs
75
+ depinde acum de acel serviciu. Pe măsură ce timpul trece și codul se acumulează, se schimbă furnizorii
76
+ din ce în ce mai insuportabil. Bine ați venit în lumea distractivă a blocării vânzătorilor!
77
+
78
+ Mobiletto a fost conceput pentru a rezolva această problemă. Codând aplicația dvs. în API-ul mobiletto, puteți cu ușurință
79
+ schimbați furnizorii de stocare și știți că stratul de stocare al aplicației dvs. se va comporta identic.
80
+
81
+ ### Testări ample
82
+ Toți șoferii sunt testați pentru un comportament identic, cu peste 60 de teste pentru fiecare șofer.
83
+ Testăm toți șoferii cu fiecare combinație de:
84
+ * Criptare: atât activată, cât și dezactivată
85
+ * Cache Redis: atât activat, cât și dezactivat
86
+
87
+ Această abordare ne oferă liniște că mobiletto se va comporta la fel, indiferent de driverul pe care îl utilizați,
88
+ și indiferent dacă activați memorarea în cache și/sau criptarea.
89
+
90
+ ### Suport pentru șoferi
91
+ Drivere actuale de stocare Mobiletto:
92
+ * `s3` : Amazon S3
93
+ * `b2` : Backblaze B2
94
+ * `local` : sistem de fișiere local
95
+
96
+ *Contribuțiile pentru a sprijini mai mulți furnizori de stocare în cloud sunt foarte binevenite!*
97
+
98
+ ## mobiletto-cli
99
+ Mobiletto este destinat să fie utilizat ca bibliotecă de către alt cod JavaScript.
100
+
101
+ Pentru a lucra cu mobiletto la linia de comandă, utilizați [mobiletto-cli](https://www.npmjs.com/package/mobiletto-cli)
102
+
103
+ ## Sursă
104
+ * [mobiletto pe GitHub](https://github.com/cobbzilla/mobiletto)
105
+ * [mobiletto pe npm](https://www.npmjs.com/package/mobiletto)
106
+
107
+ ## Sprijin și finanțare
108
+ Încerc să fiu un dezvoltator profesionist de software open source. Am lucrat în
109
+ industria software de mulți ani, am început companii de succes și le-am vândut companiilor publice.
110
+ Recent mi-am pierdut locul de muncă și nu prea am nicio altă lucrare la rând
111
+
112
+ Așa că voi încerca să scriu un software util și să văd dacă funcționează
113
+
114
+ Dacă vă place să utilizați acest software, v-aș fi foarte recunoscător chiar și pentru
115
+ cea mai mică [contribuție lunară prin Patreon](https://www.patreon.com/cobbzilla)
116
+
117
+ *Mulțumesc!*
118
+
119
+ ## Instalare
120
+ Instalați folosind `npm` sau `yarn` . Probabil că doriți versiunea `lite` care nu include toate
121
+ fișiere README traduse:
122
+
123
+ npm install mobiletto-lite
124
+ yarn add mobiletto-lite
125
+
126
+ Dacă doriți cu adevărat fișierele README în fiecare limbă, instalați versiunea completă:
127
+
128
+ npm install mobiletto
129
+ yarn add mobiletto
130
+
131
+ ## Pornire rapidă
132
+ Un scurt exemplu folosind driverul mobiletto `s3` .
133
+
134
+ Acest cod ar rula la fel dacă driverul ar fi `b2` sau `local` .
135
+
136
+ const storage = require('mobiletto')
137
+ const bucket = await storage.connect('s3', aws_key, aws_secret, {bucket: 'bk'})
138
+
139
+ // list objects: returns array of metadata objects
140
+ const listing = await bucket.list()
141
+ const dirList = await bucket.list('some/dir/')
142
+ const everything = await bucket.list('', {recursive: true})
143
+
144
+ // write an entire file
145
+ let bytesWritten = await bucket.writeFile('some/path', someBufferOfData)
146
+
147
+ // write a file from a stream/generator
148
+ bytesWritten = await bucket.write('some/path', streamOrGenerator)
149
+
150
+ // read an entire file
151
+ // returns null if an exception would otherwise be thrown
152
+ const bufferOrNull = await bucket.safeReadFile('some/path')
153
+
154
+ // stream-read a file, passing data to callback
155
+ const bytesRead = await bucket.read('some/path', (chunk) => { ...do something with chunk... } )
156
+
157
+ // remove a file, returns the path removed
158
+ let removed = await bucket.remove('some/path') // removed is a string
159
+
160
+ // remove a directory, returns array of paths removed
161
+ removed = await bucket.remove('some/directory', {recursive: true}) // removed is now an array!
162
+
163
+ ----
164
+ ## Utilizare de bază
165
+ Un exemplu mult mai amplu, care arată majoritatea caracteristicilor oferite:
166
+
167
+ const { mobiletto } = require('mobiletto')
168
+
169
+ // General usage
170
+ const api = await mobiletto(driverName, key, secret, opts)
171
+
172
+ // To use 'local' driver:
173
+ // * key: base directory
174
+ // * secret: ignored, can be null
175
+ // * opts object:
176
+ // * readOnly: optional, never change anything on the filesystem; default is false
177
+ // * fileMode: optional, permissions used when creating new files, default is 0600. can be string or integer
178
+ // * dirMode: optional, permissions used when creating new directories, default is 0700. can be string or integer
179
+ const local = await mobiletto('local', '/home/ubuntu/tmp', null, {fileMode: 0o0600, dirMode: '0700'})
180
+
181
+ // To use 's3' driver:
182
+ // * key: AWS Access Key ID
183
+ // * secret: AWS Secret Key
184
+ // * opts object:
185
+ // * readOnly: optional, never change anything on the bucket; default is false
186
+ // * bucket: required, name of the S3 bucket
187
+ // * region: optional, the AWS region to communicate with, default is us-east-1
188
+ // * prefix: optional, all read/writes within the S3 bucket will be under this prefix
189
+ // * delimiter: optional, directory delimiter, default is '/' (note: always '/' when encryption is enabled)
190
+ const s3 = await mobiletto('s3', aws_key, aws_secret, {bucket: 'bk', region: 'us-east-1'})
191
+
192
+ // To use 'b2' driver:
193
+ // * key: Backblaze Key ID
194
+ // * secret: Backblaze Application Key
195
+ // * opts object:
196
+ // * readOnly: optional, never change anything on the bucket; default is false
197
+ // * bucket: required, the ID (**not the name**) of the B2 bucket
198
+ // * prefix: optional, all read/writes within the B2 bucket will be under this prefix
199
+ // * delimiter: optional, directory delimiter, default is '/' (note: always '/' when encryption is enabled)
200
+ // * partSize: optional, large files will be split into chunks of this size when uploading
201
+ const b3 = await mobiletto('b2', b2_key_id, b2_app_key, {bucket: 'bk', partSize: 10000000})
202
+
203
+ // List files
204
+ api.list() // --> returns an array of metadata objects
205
+
206
+ // List files recursively
207
+ api.list({ recursive: true })
208
+
209
+ // List files in a directory
210
+ const path = 'some/path'
211
+ api.list(path)
212
+ api.list(path, { recursive: true }) // also supports recursive flag
213
+
214
+ // Visit files in a directory -- visitor function must be async
215
+ api.list(path, { visitor: myAsyncFunc })
216
+ api.list(path, { visitor: myAsyncFunc, recursive: true })
217
+
218
+ // The `list` method throws MobilettoNotFoundError if the path does not exist
219
+ // When you call `safeList` on a non-existent path, it returns an empty array
220
+ api.safeList('/path/that/does/not/exist') // returns []
221
+
222
+ // Read metadata for a file
223
+ api.metadata(path) // returns metadata object
224
+
225
+ // The `metadata` method throws MobilettoNotFoundError if the path does not exist
226
+ // When you call `safeMetadata` on a non-existent path, it returns null
227
+ api.safeMetadata('/tmp/does_not_exist') // returns null
228
+
229
+ // Read a file
230
+ // Provide a callback that writes the data someplace
231
+ const callback = (chunk) => { ... write chunk somewhere ... }
232
+ api.read(path, callback) // returns count of bytes read
233
+
234
+ // Read an entire file at once
235
+ const data = await api.readFile(path) // returns a byte Buffer of the file contents
236
+
237
+ // Read an entire file at once
238
+ // returns null if an exception would otherwise be thrown
239
+ const bufferOrNull = await bucket.safeReadFile('some/path')
240
+
241
+ // Write a file
242
+ // Provide a generator function that yields chunks of data
243
+ const generator = function* () {
244
+ while ( ... more-data-to-return ... ) {
245
+ data = ... load-data ...
246
+ yield data
247
+ }
248
+ }
249
+ local.api(path, generator) // returns count of bytes written
250
+
251
+ // Write an entire file at once (convenience method)
252
+ await api.writeFile(path, bufferOrString) // returns count of bytes written
253
+
254
+ // Delete a file
255
+ // Quiet param is optional (default false), when set errors will not be thrown if the path does not exist
256
+ // Always returns a value or throws an error.
257
+ // Return value may be a single string of the file removed, or an array of all files removed (driver-dependent)
258
+ const quiet = true
259
+ api.remove(path, {quiet}) // returns single path removed
260
+
261
+ // Recursively delete a directory and do it quietly (do not report errors)
262
+ const recursive = true
263
+ const quiet = true
264
+ api.remove(path, {recursive, quiet}) // returns array of paths removed
265
+
266
+ ## Metadate
267
+ Comanda `metadata` returnează metadate despre o singură intrare în sistemul de fișiere.
268
+ De asemenea, valoarea returnată de la comanda `list` este o matrice de obiecte de metadate.
269
+
270
+ Un obiect de metadate arată astfel:
271
+
272
+ {
273
+ "name": "fully/qualified/path/to/file",
274
+ "type": "entry-type",
275
+ "size": size-in-bytes,
276
+ "ctime": creation-time-epoch-millis,
277
+ "mtime": modification-time-epoch-millis
278
+ }
279
+
280
+ Proprietatea `type` poate fi `file` `dir` , `link` sau `special` .
281
+
282
+ În funcție de tipul de driver, o comandă `list` poate să nu returneze toate câmpurile. Proprietățile `name` și `type` .
283
+ ar trebui să fie mereu prezent. O comandă `metadata` ulterioară va returna toate proprietățile disponibile.
284
+
285
+ ## Stil de import alternativ
286
+ Importați modulul complet și utilizați funcția `connect` :
287
+
288
+ const storage = require('mobiletto')
289
+ const opts = {bucket: 'bk', region: 'us-east-1'}
290
+ const s3 = await storage.connect('s3', aws_key, aws_secret, opts)
291
+ const objectData = await s3.readFile('some/path')
292
+
293
+ ## Memorarea în cache
294
+ Mobiletto funcționează cel mai bine cu un cache <a href="https://redis.io">redis</a> .
295
+
296
+ Mobiletto va încerca să se conecteze la o instanță redis pe 127.0.0.1:6379
297
+
298
+ Puteți trece peste oricare dintre acestea:
299
+ * Setați `MOBILETTO_REDIS_HOST` env var, mobile pentru a vă conecta aici în loc de localhost
300
+ * Setați înv. var `MOBILETTO_REDIS_PORT` , acest port va fi folosit
301
+
302
+ Mobiletto va stoca toate cheile redis cu prefixul `_mobiletto__` . Puteți schimba acest lucru
303
+ prin setarea `MOBILETTO_REDIS_PREFIX` env var.
304
+
305
+ De asemenea, puteți seta memorarea în cache pe conexiune cu obiectul `opts.redisConfig` :
306
+
307
+ const redisConfig = {
308
+ enabled: true, // optional, default is true. if false other props are ignored
309
+ host: '127.0.0.1',
310
+ port: 6379,
311
+ prefix: '_mobiletto__'
312
+ }
313
+ const opts = { redisConfig, bucket: 'bk', region: 'us-east-1' }
314
+ const s3 = await storage.connect('s3', aws_key, aws_secret, opts)
315
+
316
+ ### Nu vrei redis cache?
317
+ Pentru a dezactiva: trece `enabled: false` în obiectul tău `opts.redisConfig` când stabilești conexiunea.
318
+
319
+ După cum se discută mai jos, dezactivarea memoriei cache va avea un efect negativ asupra performanței și va genera mai multe solicitări
320
+ la stocarea de care aveți cu adevărat nevoie.
321
+
322
+ ### Ghid pentru memorarea în cache
323
+ **Stocare criptată**: citirea/scrierea stocării criptate este doar puțin mai lentă decât în mod normal,
324
+ dar navigarea prin directoare (ceea ce fac unele lucruri) este destul de costisitoare. Folosind un cache redis
325
+ vă va oferi un spor semnificativ de performanță.
326
+
327
+ Cache-ul implicit este sigur, dar nu funcționează bine dacă aveți multe operațiuni de scriere/eliminare.
328
+ Orice operație de scriere sau eliminare invalidează întregul cache, asigurându-se că citirile ulterioare vor vedea
329
+ ultimele modificari.
330
+
331
+ ### Instrumente CLI
332
+ Dacă utilizați un instrument CLI precum [mobiletto-cli](https://www.npmjs.com/package/mobiletto-cli),
333
+ cu siguranță veți dori cache-ul redis activat, deoarece durează peste invocările comenzii `mo` .
334
+
335
+ ## Oglindire
336
+
337
+ // Copy a local filesystem mobiletto to S3
338
+ s3.mirror(local)
339
+
340
+ // Mirror a local subdirectory from one mobiletto to an S3 mobiletto, with it's own subdirectory
341
+ local.mirror(s3, 'some/local-folder', 'some/s3-folder')
342
+
343
+ Comanda `mirror` efectuează o copie unică a tuturor fișierelor de la un mobil la altul.
344
+ Nu rulează niciun proces pentru a menține oglinda în timp. Rulați din nou comanda `mirror`
345
+ pentru a sincroniza orice fișiere lipsă.
346
+
347
+ Valoarea returnată de la `mirror` este un obiect simplu cu contoare pentru câte fișiere au fost cu succes
348
+ oglindit și câte fișiere au avut erori:
349
+
350
+ {
351
+ success: count-of-files-mirrored,
352
+ errors: count-of-files-with-errors
353
+ }
354
+
355
+ AVERTISMENT: Oglindirea seturilor mari de date poate consuma foarte mult timp și poate consuma o lățime de bandă
356
+
357
+ Cu semantica apelului `mirror` , uneori poate fi confuz să înțelegeți cine este
358
+ cititor și cine este scriitorul. Imaginați-vă ca pe o declarație de atribuire: „mobiletto de la mâna stângă”
359
+ este lucrul căruia i se atribuie (date în oglindă scrise) și „mobiletto-ul din dreapta” (the
360
+ argument pentru metoda `mirror` ) este valoarea atribuită (datele în oglindă sunt citite).
361
+
362
+ ## Criptare transparentă
363
+ Activați criptarea transparentă pe partea clientului:
364
+
365
+ // Pass encryption parameters
366
+ const encryption = {
367
+ // key is required, must be >= 16 chars
368
+ key: randomstring.generate(128),
369
+
370
+ // optional, the default is to derive IV from key
371
+ // when set, IV must be >= 16 chars
372
+ iv: randomstring.generate(128),
373
+
374
+ // optional, the default is aes-256-cbc
375
+ algo: 'aes-256-cbc'
376
+ }
377
+ const api = await mobiletto(driverName, key, secret, opts, encryption)
378
+
379
+ // Subsequent write operations will encrypt data (client side) when writing
380
+ // Subsequent read operations will decrypt data (client side) when reading
381
+
382
+ Ce se întâmplă? Un director separat de „intrare în director” (direct) (criptat) urmărește ce fișiere se află în acesta
383
+ directorul (aka directorul dirent).
384
+ * Comanda `list` citește fișierele de intrare în director, decriptează fiecare cale listată; apoi returnează metadate pentru fiecare fișier
385
+ * Comenzile `list` sunt mai ineficiente, mai ales pentru directoarele cu un număr mare de fișiere
386
+ * Comanda `write` scrie fișierele dirent în directorul dirent al fiecărui părinte, recursiv; apoi scrie fisierul
387
+ * Comenzile `write` vor genera O(N) scrieri, cu N = adâncimea în ierarhia directoarelor
388
+ * Comanda `remove` elimină fișierul dirent corespunzător, iar părintele său dacă este gol, recursiv; apoi elimină fișierul
389
+ * Comenzile nerecursive `remove` vor genera citiri O(N) și, potențial, tot atâtea ștergeri, cu N = adâncimea în ierarhia directoarelor
390
+ * Comenzile recursive `remove` pe sistemele de fișiere mari și adânci pot fi costisitoare
391
+
392
+ Rețineți că, chiar și cu criptarea la nivelul clientului activată, un adversar cu vizibilitate deplină asupra serverului dvs. criptat
393
+ stocarea, chiar și fără cheie, poate vedea în continuare numărul total de directoare și câte fișiere sunt în fiecare, și cu
394
+ oarecare efort, descoperiți o parte sau toată structura generală a ierarhiei directoarelor.
395
+ *Notă: utilizați o structură relativ plată pentru o mai bună securitate.*
396
+ Adversarul nu ar ști numele directoarelor/fișierelor decât dacă ar cunoaște și criptarea ta
397
+ cheie sau a spart altfel criptarea cu succes. Toate pariurile sunt oprite atunci!
398
+
399
+ ### Performanță și stocare în cache
400
+ Operațiunile de stocare criptată pot fi lente. Listările recursive și eliminările pot fi foarte lente.
401
+ Memorarea în cache prin redis ajută enorm, dar rețineți că memoria cache este golită la orice scriere sau ștergere.
402
+
403
+ ## Rotirea tastelor
404
+ Creați un mobiletto cu noua cheie, apoi oglindiți datele vechi în el:
405
+
406
+ const storage = require('mobiletto')
407
+
408
+ const oldEncryption = { key: .... }
409
+ const oldStorage = await storage.connect('s3', aws_key, aws_secret, {bucket: 'bk', region: 'us-east-1'}, oldEncryption)
410
+
411
+ const newEncryption = { key: .... }
412
+ const newStorage = await storage.connect('s3', aws_key, aws_secret, {bucket: 'zz', region: 'us-east-1'}, newEncryption)
413
+
414
+ newStorage.mirror(oldStorage) // if oldStorage is very large, this may take a looooooong time...
415
+
416
+ ## Interfață pentru driver
417
+ Un driver este orice fișier JS care exportă o funcție „storageClient” cu această semnătură:
418
+
419
+ function storageClient (key, secret, opts)
420
+
421
+ * `key` : un șir, cheia dvs. API (pentru driverul `local` acesta este directorul de bază)
422
+ * `secret` : un șir, secretul dvs. API (poate fi omis pentru driverul `local` )
423
+ * `opts` : un obiect, proprietățile sunt per-driver:
424
+ * Pentru `local` , proprietățile `fileMode` și `dirMode` determină modul în care sunt create fișiere și directoare noi de creare
425
+ * Pentru `s3` , este necesară proprietatea `bucket` . Proprietățile opționale sunt:
426
+ * `region`: the S3 region, default is us-east-1
427
+ * `prefix`: a prefix to prepend to all S3 paths, default is the empty string
428
+ * `delimiter`: the directory delimiter, default is '/'
429
+
430
+ Obiectul pe care îl returnează funcția storageClient trebuie să definească aceste funcții:
431
+
432
+ // Test the driver before using, ensure proper configuration
433
+ async testConfig ()
434
+
435
+ // List files in path (or from base-directory)
436
+ // If recursive is true, list recursively
437
+ // If visitor is defined, it will be an async function. await the visitor function on each file found
438
+ // Otherwise, perform the listing and return an array of objects
439
+ async list (path, recursive = false, visitor = null) // path may be omitted
440
+
441
+ // Read metadata for a path
442
+ async metadata (path)
443
+
444
+ // Read a file
445
+ // callback receives a chunk of data. endCallback is called at end-of-stream
446
+ async read (path, callback, endCallback = null)
447
+
448
+ // Write a file
449
+ // driver must be able to handle a generator or a stream
450
+ async write (path, generatorOrReadableStream)
451
+
452
+ // Remove a file, or recursively delete a directory
453
+ // returns a string of a single path removed, or an array of multiple paths removed
454
+ async remove (path, recursive = false, quiet = false)
455
+
456
+ ## Logare
457
+ Mobiletto utilizează biblioteca de înregistrare [winston](https://www.npmjs.com/package/winston).
458
+
459
+ Jurnalele **vor** conține căi de fișiere și mesaje de eroare, dar **nu** vor conține niciodată chei, secrete,
460
+ sau orice alte informații de configurare a conexiunii.
461
+
462
+ ### Nivel de jurnal
463
+ Utilizați variabila de mediu `MOBILETTO_LOG_LEVEL` pentru a seta nivelul de jurnal, folosind unul
464
+ dintre nivelurile `npm` definite în [https://www.npmjs.com/package/winston#logging-levels](https://www.npmjs.com/package/winston#logging-levels)
465
+
466
+ Nivelul implicit este `error` . Nivelul cel mai pronunțat este `silly` , deși în prezent mobiletto
467
+ nu se înregistrează la niveluri sub `debug`
468
+
469
+ MOBILETTO_LOG_LEVEL=silly # maximum logs!
470
+
471
+ ### Fișier jurnal
472
+ În mod implicit, loggerul scrie pe consolă. Pentru a trimite jurnalele la un fișier, setați `MOBILETTO_LOG_FILE`
473
+ variabilă de mediu. Când vă conectați la un fișier, jurnalele nu vor mai fi scrise pe consolă.
474
+
475
+ MOBILETTO_LOG_FILE=/var/my_mobiletto_log
476
+
477
+ Pentru a dezactiva înregistrarea:
478
+
479
+ MOBILETTO_LOG_FILE=/dev/null
480
+
481
+ </pre>