Matrix Docker Ansible eploy
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
 
 
 

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