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.
 
 
 

213 rivejä
6.1 KiB

  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. #: ../../../docs/just.md:1
  24. msgid "Running `just` commands"
  25. msgstr ""
  26. #: ../../../docs/just.md:3
  27. msgid ""
  28. "We have previously used [make](https://www.gnu.org/software/make/) for "
  29. "easily running some playbook commands (e.g. `make roles` which triggers "
  30. "[`ansible-galaxy`](https://docs.ansible.com/ansible/latest/cli/ansible-"
  31. "galaxy.html)). Our [`Makefile`](../Makefile) is still around, and you can"
  32. " still run these commands."
  33. msgstr ""
  34. #: ../../../docs/just.md:5
  35. msgid ""
  36. "In addition, we have added support for running commands via "
  37. "[`just`](https://github.com/casey/just) - a more modern command-runner "
  38. "alternative to `make`. It can be used to invoke `ansible-playbook` "
  39. "commands with less typing."
  40. msgstr ""
  41. #: ../../../docs/just.md:7
  42. msgid ""
  43. "The `just` utility executes shortcut commands (called as \"recipes\"), "
  44. "which invoke `ansible-playbook`, `ansible-galaxy` or "
  45. "[`agru`](https://github.com/etkecc/agru) (depending on what is available "
  46. "in your system). The targets of the recipes are defined in "
  47. "[`justfile`](../justfile). Most of the just recipes have no corresponding"
  48. " `Makefile` targets."
  49. msgstr ""
  50. #: ../../../docs/just.md:9
  51. msgid ""
  52. "For some recipes such as `just update`, our `justfile` recommends "
  53. "installing [`agru`](https://github.com/etkecc/agru) (a faster alternative"
  54. " to `ansible-galaxy`) to speed up the process."
  55. msgstr ""
  56. #: ../../../docs/just.md:11
  57. msgid "Here are some examples of shortcuts:"
  58. msgstr ""
  59. #: ../../../docs/just.md
  60. msgid "Shortcut"
  61. msgstr ""
  62. #: ../../../docs/just.md
  63. msgid "Result"
  64. msgstr ""
  65. #: ../../../docs/just.md
  66. msgid "`just roles`"
  67. msgstr ""
  68. #: ../../../docs/just.md
  69. msgid ""
  70. "Install the necessary Ansible roles pinned in "
  71. "[`requirements.yml`](../requirements.yml)"
  72. msgstr ""
  73. #: ../../../docs/just.md
  74. msgid "`just update`"
  75. msgstr ""
  76. #: ../../../docs/just.md
  77. msgid "Run `git pull` (to update the playbook) and install the Ansible roles"
  78. msgstr ""
  79. #: ../../../docs/just.md ../../../docs/just.md:33
  80. msgid "`just install-all`"
  81. msgstr ""
  82. #: ../../../docs/just.md
  83. msgid ""
  84. "Run `ansible-playbook -i inventory/hosts setup.yml --tags=install-all"
  85. ",ensure-matrix-users-created,start`"
  86. msgstr ""
  87. #: ../../../docs/just.md
  88. msgid "`just setup-all`"
  89. msgstr ""
  90. #: ../../../docs/just.md
  91. msgid ""
  92. "Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all"
  93. ",ensure-matrix-users-created,start`"
  94. msgstr ""
  95. #: ../../../docs/just.md
  96. msgid "`just install-all --ask-vault-pass`"
  97. msgstr ""
  98. #: ../../../docs/just.md
  99. msgid ""
  100. "Run commands with additional arguments (`--ask-vault-pass` will be "
  101. "appended to the above installation command)"
  102. msgstr ""
  103. #: ../../../docs/just.md
  104. msgid "`just run-tags install-mautrix-slack,start`"
  105. msgstr ""
  106. #: ../../../docs/just.md
  107. msgid "Run specific playbook tags (here `install-mautrix-slack` and `start`)"
  108. msgstr ""
  109. #: ../../../docs/just.md
  110. msgid "`just install-service mautrix-slack`"
  111. msgstr ""
  112. #: ../../../docs/just.md
  113. msgid "Run `just run-tags install-mautrix-slack,start` with even less typing"
  114. msgstr ""
  115. #: ../../../docs/just.md
  116. msgid "`just start-all`"
  117. msgstr ""
  118. #: ../../../docs/just.md
  119. msgid "(Re-)starts all services"
  120. msgstr ""
  121. #: ../../../docs/just.md
  122. msgid "`just stop-group postgres`"
  123. msgstr ""
  124. #: ../../../docs/just.md
  125. msgid "Stop only the Postgres service"
  126. msgstr ""
  127. #: ../../../docs/just.md
  128. msgid "`just register-user alice secret-password yes`"
  129. msgstr ""
  130. #: ../../../docs/just.md
  131. msgid ""
  132. "Registers an `alice` user with the `secret-password` password and admin "
  133. "access (admin = `yes`)"
  134. msgstr ""
  135. #: ../../../docs/just.md:26
  136. msgid ""
  137. "While [our documentation on prerequisites](prerequisites.md) lists `just`"
  138. " as one of the requirements for installation, using `just` is optional. "
  139. "If you find it difficult to install it, do not find it useful, or want to"
  140. " prefer raw `ansible-playbook` commands for some reason, feel free to run"
  141. " all commands manually. For example, you can run `ansible-galaxy` "
  142. "directly to install the Ansible roles: `rm -rf roles/galaxy; ansible-"
  143. "galaxy install -r requirements.yml -p roles/galaxy/ --force`."
  144. msgstr ""
  145. #: ../../../docs/just.md:28
  146. msgid "Difference between playbook tags and shortcuts"
  147. msgstr ""
  148. #: ../../../docs/just.md:30
  149. msgid ""
  150. "It is worth noting that `just` \"recipes\" are different from [playbook "
  151. "tags](playbook-tags.md). The recipes are shortcuts of commands defined in"
  152. " `justfile` and can be executed by the `just` program only, while the "
  153. "playbook tags are available for the raw `ansible-playbook` commands as "
  154. "well. Please be careful not to confuse them."
  155. msgstr ""
  156. #: ../../../docs/just.md:32
  157. msgid "For example, these two commands are different:"
  158. msgstr ""
  159. #: ../../../docs/just.md:34
  160. msgid "`ansible-playbook -i inventory/hosts setup.yml --tags=install-all`"
  161. msgstr ""
  162. #: ../../../docs/just.md:36
  163. msgid ""
  164. "The just recipe runs `ensure-matrix-users-created` and `start` tags after"
  165. " `install-all`, while the latter runs only `install-all` tag. The correct"
  166. " shortcut of the latter is `just run-tags install-all`."
  167. msgstr ""
  168. #: ../../../docs/just.md:38
  169. msgid ""
  170. "Such kind of difference sometimes matters. For example, when you install "
  171. "a Matrix server into which you will import old data (see "
  172. "[here](installing.md#installing-a-server-into-which-youll-import-old-"
  173. "data)), you are not supposed to run `just install-all` or `just setup-"
  174. "all`, because these commands start services immediately after installing "
  175. "components which may prevent your from importing old data."
  176. msgstr ""