Matrix Docker Ansible eploy
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
 
 
 

284 rindas
9.2 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/ansible.md:2
  23. msgid "Running this playbook"
  24. msgstr ""
  25. #: ../../../docs/ansible.md:4
  26. msgid ""
  27. "This playbook is meant to be run using "
  28. "[Ansible](https://www.ansible.com/)."
  29. msgstr ""
  30. #: ../../../docs/ansible.md:6
  31. msgid ""
  32. "Ansible typically runs on your local computer and carries out tasks on a "
  33. "remote server. If your local computer cannot run Ansible, you can also "
  34. "run Ansible on some server somewhere (including the server you wish to "
  35. "install to)."
  36. msgstr ""
  37. #: ../../../docs/ansible.md:8
  38. msgid "Supported Ansible versions"
  39. msgstr ""
  40. #: ../../../docs/ansible.md:10
  41. msgid ""
  42. "To manually check which version of Ansible you're on, run: `ansible "
  43. "--version`."
  44. msgstr ""
  45. #: ../../../docs/ansible.md:12
  46. msgid ""
  47. "For the **best experience**, we recommend getting the **latest version of"
  48. " Ansible available**."
  49. msgstr ""
  50. #: ../../../docs/ansible.md:14
  51. msgid ""
  52. "We're not sure what's the minimum version of Ansible that can run this "
  53. "playbook successfully. The lowest version that we've confirmed (on "
  54. "2022-11-26) to be working fine is: `ansible-core` (`2.11.7`) combined "
  55. "with `ansible` (`4.10.0`)."
  56. msgstr ""
  57. #: ../../../docs/ansible.md:16
  58. msgid ""
  59. "If your distro ships with an Ansible version older than this, you may run"
  60. " into issues. Consider [Upgrading Ansible](#upgrading-ansible) or [using "
  61. "Ansible via Docker](#using-ansible-via-docker)."
  62. msgstr ""
  63. #: ../../../docs/ansible.md:18
  64. msgid "Upgrading Ansible"
  65. msgstr ""
  66. #: ../../../docs/ansible.md:20
  67. msgid ""
  68. "Depending on your distribution, you may be able to upgrade Ansible in a "
  69. "few different ways:"
  70. msgstr ""
  71. #: ../../../docs/ansible.md:22
  72. msgid ""
  73. "by using an additional repository (PPA, etc.), which provides newer "
  74. "Ansible versions. See instructions for "
  75. "[CentOS](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
  76. "#installing-ansible-on-rhel-centos-or-fedora), "
  77. "[Debian](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
  78. "#installing-ansible-on-debian), or "
  79. "[Ubuntu](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html"
  80. "#installing-ansible-on-ubuntu) on the Ansible website."
  81. msgstr ""
  82. #: ../../../docs/ansible.md:24
  83. msgid ""
  84. "by removing the Ansible package (`yum remove ansible` or `apt-get remove "
  85. "ansible`) and installing via "
  86. "[pip](https://pip.pypa.io/en/stable/installation/) (`pip install "
  87. "ansible`)."
  88. msgstr ""
  89. #: ../../../docs/ansible.md:26
  90. msgid ""
  91. "If using the `pip` method, do note that the `ansible-playbook` binary may"
  92. " not be on the `$PATH` (https://linuxconfig.org/linux-path-environment-"
  93. "variable), but in some more special location like `/usr/local/bin"
  94. "/ansible-playbook`. You may need to invoke it using the full path."
  95. msgstr ""
  96. #: ../../../docs/ansible.md:28
  97. msgid ""
  98. "**Note**: Both of the above methods are a bad way to run system software "
  99. "such as Ansible. If you find yourself needing to resort to such hacks, "
  100. "please consider reporting a bug to your distribution and/or switching to "
  101. "a sane distribution, which provides up-to-date software."
  102. msgstr ""
  103. #: ../../../docs/ansible.md:30
  104. msgid "Using Ansible via Docker"
  105. msgstr ""
  106. #: ../../../docs/ansible.md:32
  107. msgid ""
  108. "Alternatively, you can run Ansible inside a Docker container (powered by "
  109. "the [devture/ansible](https://hub.docker.com/r/devture/ansible/) Docker "
  110. "image)."
  111. msgstr ""
  112. #: ../../../docs/ansible.md:34
  113. msgid ""
  114. "This ensures that you're using a very recent Ansible version, which is "
  115. "less likely to be incompatible with the playbook."
  116. msgstr ""
  117. #: ../../../docs/ansible.md:36
  118. msgid ""
  119. "You can either [run Ansible in a container on the Matrix server itself"
  120. "](#running-ansible-in-a-container-on-the-matrix-server-itself) or [run "
  121. "Ansible in a container on another computer (not the Matrix server"
  122. ")](#running-ansible-in-a-container-on-another-computer-not-the-matrix-"
  123. "server)."
  124. msgstr ""
  125. #: ../../../docs/ansible.md:38
  126. msgid "Running Ansible in a container on the Matrix server itself"
  127. msgstr ""
  128. #: ../../../docs/ansible.md:40
  129. msgid ""
  130. "To run Ansible in a (Docker) container on the Matrix server itself, you "
  131. "need to have a working Docker installation. Docker is normally installed "
  132. "by the playbook, so this may be a bit of a chicken and egg problem. To "
  133. "solve it:"
  134. msgstr ""
  135. #: ../../../docs/ansible.md:42
  136. msgid ""
  137. "you **either** need to install Docker manually first. Follow [the "
  138. "upstream instructions](https://docs.docker.com/engine/install/) for your "
  139. "distribution and consider setting "
  140. "`matrix_playbook_docker_installation_enabled: false` in your `vars.yml` "
  141. "file, to prevent the playbook from installing Docker"
  142. msgstr ""
  143. #: ../../../docs/ansible.md:43
  144. msgid ""
  145. "**or** you need to run the playbook in another way (e.g. [Running Ansible"
  146. " in a container on another computer (not the Matrix server)](#running-"
  147. "ansible-in-a-container-on-another-computer-not-the-matrix-server)) at "
  148. "least the first time around"
  149. msgstr ""
  150. #: ../../../docs/ansible.md:45
  151. msgid ""
  152. "Once you have a working Docker installation on the server, **clone the "
  153. "playbook** somewhere on the server and configure it as per usual "
  154. "(`inventory/hosts`, `inventory/host_vars/..`, etc.), as described in "
  155. "[configuring the playbook](configuring-playbook.md)."
  156. msgstr ""
  157. #: ../../../docs/ansible.md:47
  158. msgid ""
  159. "You would then need to add `ansible_connection=community.docker.nsenter` "
  160. "to the host line in `inventory/hosts`. This tells Ansible to connect to "
  161. "the \"remote\" machine by switching Linux namespaces with "
  162. "[nsenter](https://man7.org/linux/man-pages/man1/nsenter.1.html), instead "
  163. "of using SSH."
  164. msgstr ""
  165. #: ../../../docs/ansible.md:49
  166. msgid ""
  167. "Alternatively, you can leave your `inventory/hosts` as is and specify the"
  168. " connection type in **each** `ansible-playbook` call you do later, like "
  169. "this: `ansible-playbook --connection=community.docker.nsenter …`"
  170. msgstr ""
  171. #: ../../../docs/ansible.md:51 ../../../docs/ansible.md:71
  172. msgid "Run this from the playbook's directory:"
  173. msgstr ""
  174. #: ../../../docs/ansible.md:63 ../../../docs/ansible.md:84
  175. msgid ""
  176. "Once you execute the above command, you'll be dropped into a `/work` "
  177. "directory inside a Docker container. The `/work` directory contains the "
  178. "playbook's code."
  179. msgstr ""
  180. #: ../../../docs/ansible.md:65 ../../../docs/ansible.md:86
  181. msgid ""
  182. "First, consider running `git config --global --add safe.directory /work` "
  183. "to [resolve directory ownership issues](#resolve-directory-ownership-"
  184. "issues)."
  185. msgstr ""
  186. #: ../../../docs/ansible.md:67
  187. msgid ""
  188. "Finally, you can execute `ansible-playbook …` (or `ansible-playbook "
  189. "--connection=community.docker.nsenter …`) commands as per normal now."
  190. msgstr ""
  191. #: ../../../docs/ansible.md:69
  192. msgid "Running Ansible in a container on another computer (not the Matrix server)"
  193. msgstr ""
  194. #: ../../../docs/ansible.md:82
  195. msgid ""
  196. "The above command tries to mount an SSH key (`$HOME/.ssh/id_rsa`) into "
  197. "the container (at `/root/.ssh/id_rsa`). If your SSH key is at a different"
  198. " path (not in `$HOME/.ssh/id_rsa`), adjust that part."
  199. msgstr ""
  200. #: ../../../docs/ansible.md:88
  201. msgid "Finally, you execute `ansible-playbook …` commands as per normal now."
  202. msgstr ""
  203. #: ../../../docs/ansible.md:90
  204. msgid "If you don't use SSH keys for authentication"
  205. msgstr ""
  206. #: ../../../docs/ansible.md:92
  207. msgid ""
  208. "If you don't use SSH keys for authentication, simply remove that whole "
  209. "line (`-v $HOME/.ssh/id_rsa:/root/.ssh/id_rsa:ro`)."
  210. msgstr ""
  211. #: ../../../docs/ansible.md:94
  212. msgid ""
  213. "To authenticate at your server using a password, you need to add a "
  214. "package. So, when you are in the shell of the ansible docker container "
  215. "(the previously used `docker run -it …` command), run:"
  216. msgstr ""
  217. #: ../../../docs/ansible.md:100
  218. msgid ""
  219. "Then, to be asked for the password whenever running an `ansible-"
  220. "playbook` command add `--ask-pass` to the arguments of the command."
  221. msgstr ""
  222. #: ../../../docs/ansible.md:102
  223. msgid "Resolve directory ownership issues"
  224. msgstr ""
  225. #: ../../../docs/ansible.md:104
  226. msgid ""
  227. "Because you're `root` in the container running Ansible and this likely "
  228. "differs fom the owner (your regular user account) of the playbook "
  229. "directory outside of the container, certain playbook features which use "
  230. "`git` locally may report warnings such as:"
  231. msgstr ""
  232. #: ../../../docs/ansible.md:106
  233. msgid ""
  234. "fatal: unsafe repository ('/work' is owned by someone else) To add an "
  235. "exception for this directory, call: git config --global --add "
  236. "safe.directory /work"
  237. msgstr ""
  238. #: ../../../docs/ansible.md:110
  239. msgid ""
  240. "These errors can be resolved by making `git` trust the playbook directory"
  241. " by running `git config --global --add safe.directory /work`"
  242. msgstr ""