overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8820 Commits
5 Branches
409 MiB
 
 
 
Tree: c51e771d1a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-s3.po

316 lines
9.9 KiB
Raw Blame History 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community

  3. # members

  4. # This file is distributed under the same license as the

  5. # matrix-docker-ansible-deploy package.

  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.

  7. #

  8. #, fuzzy

  9. msgid ""

  10. msgstr ""

  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  12. "Report-Msgid-Bugs-To: \n"

  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"

  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  16. "Language: bg\n"

  17. "Language-Team: bg <LL@li.org>\n"

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

  20. "Content-Type: text/plain; charset=utf-8\n"

  21. "Content-Transfer-Encoding: 8bit\n"

  22. "Generated-By: Babel 2.16.0\n"

  23. 

  24. #: ../../../docs/configuring-playbook-s3.md:1

  25. msgid ""

  26. "Storing Synapse media files on Amazon S3 or another compatible Object "

  27. "Storage (optional)"

  28. msgstr ""

  29. 

  30. #: ../../../docs/configuring-playbook-s3.md:3

  31. msgid ""

  32. "By default, this playbook configures your server to store Synapse's "

  33. "content repository (`media_store`) files on the local filesystem. If "

  34. "that's okay, you can skip this document."

  35. msgstr ""

  36. 

  37. #: ../../../docs/configuring-playbook-s3.md:5

  38. msgid ""

  39. "As an alternative to storing media files on the local filesystem, you can"

  40. " store them on [Amazon S3](https://aws.amazon.com/s3/) or another "

  41. "S3-compatible object store."

  42. msgstr ""

  43. 

  44. #: ../../../docs/configuring-playbook-s3.md:7

  45. msgid ""

  46. "You can do this either by sticking to Synapse's media repository and "

  47. "making that use S3 (read below for this method), or by switching to an "

  48. "external media storage implementation like [matrix-media-repo"

  49. "](configuring-playbook-matrix-media-repo.md)."

  50. msgstr ""

  51. 

  52. #: ../../../docs/configuring-playbook-s3.md:9

  53. msgid ""

  54. "First, [choose an Object Storage provider](#choosing-an-object-storage-"

  55. "provider)."

  56. msgstr ""

  57. 

  58. #: ../../../docs/configuring-playbook-s3.md:11

  59. msgid "Then, [create the S3 bucket](#bucket-creation-and-security-configuration)."

  60. msgstr ""

  61. 

  62. #: ../../../docs/configuring-playbook-s3.md:13

  63. msgid ""

  64. "Finally, [set up S3 storage for Synapse](#setting-up) (with [Goofys"

  65. "](configuring-playbook-s3-goofys.md), [synapse-s3-storage-provider"

  66. "](configuring-playbook-synapse-s3-storage-provider.md), or use s3 "

  67. "datastore with the [matrix-media-repo](https://docs.t2bot.io/matrix-"

  68. "media-repo/configuration/s3-datastore.html))."

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-s3.md:15

  72. msgid "Choosing an Object Storage provider"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-s3.md:17

  76. msgid ""

  77. "You can create [Amazon S3](https://aws.amazon.com/s3/) or another "

  78. "S3-compatible object storage like [Backblaze "

  79. "B2](https://www.backblaze.com/b2/cloud-storage.html), "

  80. "[Storj](https://storj.io), [Wasabi](https://wasabi.com), [Digital Ocean "

  81. "Spaces](https://www.digitalocean.com/products/spaces), etc."

  82. msgstr ""

  83. 

  84. #: ../../../docs/configuring-playbook-s3.md:19

  85. msgid ""

  86. "Amazon S3, Backblaze B2, and Storj are pay-as-you with no minimum charges"

  87. " for storing too little data."

  88. msgstr ""

  89. 

  90. #: ../../../docs/configuring-playbook-s3.md:21

  91. msgid ""

  92. "All these providers have different prices, with Storj appearing to be the"

  93. " cheapest (as of 2024-10, storage fee is $0.004 per GB/month, and egress "

  94. "fee is $0.007 per GB). Backblaze egress is free, but for only certain "

  95. "users for up to 3x the amount of data stored. Beyond that you will pay "

  96. "$0.01/GB of egress."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-s3.md:23

  100. msgid ""

  101. "Wasabi has a minimum charge of 1TB if you're storing less than 1TB, which"

  102. " becomes expensive if you need to store less data than that. Likewise, "

  103. "Digital Ocean Spaces has also a minimum charge of 250GB ($5/month as of "

  104. "2022-10)."

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-s3.md:25

  108. msgid "Here are some of the important aspects of choosing the right provider:"

  109. msgstr ""

  110. 

  111. #: ../../../docs/configuring-playbook-s3.md:27

  112. msgid ""

  113. "if a provider is a company you like and trust (or dislike less than the "

  114. "others)"

  115. msgstr ""

  116. 

  117. #: ../../../docs/configuring-playbook-s3.md:28

  118. msgid "if a provider implements end-to-end encryption of your data"

  119. msgstr ""

  120. 

  121. #: ../../../docs/configuring-playbook-s3.md:29

  122. msgid ""

  123. "if a provider has a data region close to your Matrix server (if it's "

  124. "farther away, high latency may cause slowdowns)"

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-s3.md:30

  128. msgid ""

  129. "if a provider's infrastructure such as data center is centralized or "

  130. "distributed"

  131. msgstr ""

  132. 

  133. #: ../../../docs/configuring-playbook-s3.md:31

  134. msgid ""

  135. "if a provider's price model is transparent (whether it includes hidden "

  136. "costs like minimum charge, minimum storage term, etc.)"

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-s3.md:32

  140. msgid ""

  141. "if a provider has free or cheap egress fee (in case you need to get the "

  142. "data out often, for some reason) - likely not too important for the "

  143. "common use-case"

  144. msgstr ""

  145. 

  146. #: ../../../docs/configuring-playbook-s3.md:34

  147. msgid "Bucket creation and Security Configuration"

  148. msgstr ""

  149. 

  150. #: ../../../docs/configuring-playbook-s3.md:36

  151. msgid ""

  152. "Now that you've [chosen an Object Storage provider](#choosing-an-object-"

  153. "storage-provider), you need to create a storage bucket."

  154. msgstr ""

  155. 

  156. #: ../../../docs/configuring-playbook-s3.md:38

  157. msgid ""

  158. "How you do this varies from provider to provider, with Amazon S3 being "

  159. "the most complicated due to its vast number of services and complicated "

  160. "security policies."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-s3.md:40

  164. msgid ""

  165. "Below, we provider some guides for common providers. If you don't see "

  166. "yours, look at the others for inspiration or read some guides online "

  167. "about how to create a bucket. Feel free to contribute to this "

  168. "documentation with an update!"

  169. msgstr ""

  170. 

  171. #: ../../../docs/configuring-playbook-s3.md:42

  172. msgid "Amazon S3"

  173. msgstr ""

  174. 

  175. #: ../../../docs/configuring-playbook-s3.md:44

  176. msgid ""

  177. "You'll need an Amazon S3 bucket and some IAM user credentials (access key"

  178. " + secret key) with full write access to the bucket. Example IAM security"

  179. " policy:"

  180. msgstr ""

  181. 

  182. #: ../../../docs/configuring-playbook-s3.md:65

  183. msgid ""

  184. "**Note**: This policy needs to be attached to an IAM user created from "

  185. "the **Security Credentials** menu. This is not a **Bucket Policy**."

  186. msgstr ""

  187. 

  188. #: ../../../docs/configuring-playbook-s3.md:67

  189. msgid "Backblaze B2"

  190. msgstr ""

  191. 

  192. #: ../../../docs/configuring-playbook-s3.md:69

  193. msgid ""

  194. "To use [Backblaze B2](https://www.backblaze.com/b2/cloud-storage.html) "

  195. "you first need to sign up."

  196. msgstr ""

  197. 

  198. #: ../../../docs/configuring-playbook-s3.md:71

  199. msgid ""

  200. "You [can't easily change which region (US, Europe) your Backblaze account"

  201. " stores files "

  202. "in](https://old.reddit.com/r/backblaze/comments/hi1v90/make_the_choice_for_the_b2_data_center_region/),"

  203. " so make sure to carefully choose the region when signing up (hint: it's "

  204. "a hard to see dropdown below the username/password fields in the signup "

  205. "form)."

  206. msgstr ""

  207. 

  208. #: ../../../docs/configuring-playbook-s3.md:73

  209. msgid "After logging in to Backblaze:"

  210. msgstr ""

  211. 

  212. #: ../../../docs/configuring-playbook-s3.md:75

  213. msgid ""

  214. "create a new **private** bucket through its user interface (you can call "

  215. "it something like `matrix-example-media-store`)"

  216. msgstr ""

  217. 

  218. #: ../../../docs/configuring-playbook-s3.md:76

  219. msgid ""

  220. "note the **Endpoint** for your bucket (something like `s3.us-"

  221. "west-002.backblazeb2.com`)."

  222. msgstr ""

  223. 

  224. #: ../../../docs/configuring-playbook-s3.md:77

  225. msgid "adjust its Lifecycle Rules to: Keep only the last version of the file"

  226. msgstr ""

  227. 

  228. #: ../../../docs/configuring-playbook-s3.md:78

  229. msgid ""

  230. "go to [App Keys](https://secure.backblaze.com/app_keys.htm) and use the "

  231. "**Add a New Application Key** to create a new one"

  232. msgstr ""

  233. 

  234. #: ../../../docs/configuring-playbook-s3.md:79

  235. msgid ""

  236. "restrict it to the previously created bucket (e.g. `matrix-example-media-"

  237. "store`)"

  238. msgstr ""

  239. 

  240. #: ../../../docs/configuring-playbook-s3.md:80

  241. msgid "give it *Read & Write* access"

  242. msgstr ""

  243. 

  244. #: ../../../docs/configuring-playbook-s3.md:82

  245. msgid ""

  246. "The `keyID` value is your **Access Key** and `applicationKey` is your "

  247. "**Secret Key**."

  248. msgstr ""

  249. 

  250. #: ../../../docs/configuring-playbook-s3.md:84

  251. msgid ""

  252. "For configuring [Goofys](configuring-playbook-s3-goofys.md) or [s3"

  253. "-synapse-storage-provider](configuring-playbook-synapse-s3-storage-"

  254. "provider.md) you will need:"

  255. msgstr ""

  256. 

  257. #: ../../../docs/configuring-playbook-s3.md:86

  258. msgid ""

  259. "**Endpoint URL** - this is the  **Endpoint** value you saw above, but "

  260. "prefixed with `https://`"

  261. msgstr ""

  262. 

  263. #: ../../../docs/configuring-playbook-s3.md:88

  264. msgid "**Region** - use the value you see in the Endpoint (e.g. `us-west-002`)"

  265. msgstr ""

  266. 

  267. #: ../../../docs/configuring-playbook-s3.md:90

  268. msgid ""

  269. "**Storage Class** - use `STANDARD`. Backblaze B2 does not have different "

  270. "storage classes, so it doesn't make sense to use any other value."

  271. msgstr ""

  272. 

  273. #: ../../../docs/configuring-playbook-s3.md:92

  274. msgid "Other providers"

  275. msgstr ""

  276. 

  277. #: ../../../docs/configuring-playbook-s3.md:94

  278. msgid ""

  279. "For other S3-compatible providers, you may not need to configure security"

  280. " policies, etc. (just like for [Backblaze B2](#backblaze-b2))."

  281. msgstr ""

  282. 

  283. #: ../../../docs/configuring-playbook-s3.md:96

  284. msgid ""

  285. "You most likely just need to create an S3 bucket and get some credentials"

  286. " (access key and secret key) for accessing the bucket in a read/write "

  287. "manner."

  288. msgstr ""

  289. 

  290. #: ../../../docs/configuring-playbook-s3.md:98

  291. msgid "Setting up"

  292. msgstr ""

  293. 

  294. #: ../../../docs/configuring-playbook-s3.md:100

  295. msgid ""

  296. "To set up Synapse to store files in S3, follow the instructions for the "

  297. "method of your choice:"

  298. msgstr ""

  299. 

  300. #: ../../../docs/configuring-playbook-s3.md:102

  301. msgid ""

  302. "using [synapse-s3-storage-provider](configuring-playbook-synapse-s3"

  303. "-storage-provider.md) (recommended)"

  304. msgstr ""

  305. 

  306. #: ../../../docs/configuring-playbook-s3.md:103

  307. msgid ""

  308. "using [Goofys to mount the S3 store to the local filesystem](configuring-"

  309. "playbook-s3-goofys.md)"

  310. msgstr ""

  311. 

  312. #: ../../../docs/configuring-playbook-s3.md:104

  313. msgid "using [matrix-media-repo](configuring-playbook-matrix-media-repo.md)"

  314. msgstr ""