mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 13:05:47 +00:00
d4f8d0918a
Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
212 lines
6.0 KiB
Plaintext
212 lines
6.0 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
|
|
# members
|
|
# This file is distributed under the same license as the
|
|
# matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language: jp\n"
|
|
"Language-Team: jp <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.16.0\n"
|
|
|
|
#: ../../../docs/just.md:1
|
|
msgid "Running `just` commands"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:3
|
|
msgid ""
|
|
"We have previously used [make](https://www.gnu.org/software/make/) for "
|
|
"easily running some playbook commands (e.g. `make roles` which triggers "
|
|
"[`ansible-galaxy`](https://docs.ansible.com/ansible/latest/cli/ansible-"
|
|
"galaxy.html)). Our [`Makefile`](../Makefile) is still around, and you can"
|
|
" still run these commands."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:5
|
|
msgid ""
|
|
"In addition, we have added support for running commands via "
|
|
"[`just`](https://github.com/casey/just) - a more modern command-runner "
|
|
"alternative to `make`. It can be used to invoke `ansible-playbook` "
|
|
"commands with less typing."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:7
|
|
msgid ""
|
|
"The `just` utility executes shortcut commands (called as \"recipes\"), "
|
|
"which invoke `ansible-playbook`, `ansible-galaxy` or "
|
|
"[`agru`](https://github.com/etkecc/agru) (depending on what is available "
|
|
"in your system). The targets of the recipes are defined in "
|
|
"[`justfile`](../justfile). Most of the just recipes have no corresponding"
|
|
" `Makefile` targets."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:9
|
|
msgid ""
|
|
"For some recipes such as `just update`, our `justfile` recommends "
|
|
"installing [`agru`](https://github.com/etkecc/agru) (a faster alternative"
|
|
" to `ansible-galaxy`) to speed up the process."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:11
|
|
msgid "Here are some examples of shortcuts:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "Shortcut"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "Result"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just roles`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid ""
|
|
"Install the necessary Ansible roles pinned in "
|
|
"[`requirements.yml`](../requirements.yml)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just update`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "Run `git pull` (to update the playbook) and install the Ansible roles"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md ../../../docs/just.md:33
|
|
msgid "`just install-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid ""
|
|
"Run `ansible-playbook -i inventory/hosts setup.yml --tags=install-all"
|
|
",ensure-matrix-users-created,start`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just setup-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid ""
|
|
"Run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all"
|
|
",ensure-matrix-users-created,start`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just install-all --ask-vault-pass`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid ""
|
|
"Run commands with additional arguments (`--ask-vault-pass` will be "
|
|
"appended to the above installation command)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just run-tags install-mautrix-slack,start`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "Run specific playbook tags (here `install-mautrix-slack` and `start`)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just install-service mautrix-slack`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "Run `just run-tags install-mautrix-slack,start` with even less typing"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just start-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "(Re-)starts all services"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just stop-group postgres`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "Stop only the Postgres service"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid "`just register-user alice secret-password yes`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md
|
|
msgid ""
|
|
"Registers an `alice` user with the `secret-password` password and admin "
|
|
"access (admin = `yes`)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:26
|
|
msgid ""
|
|
"While [our documentation on prerequisites](prerequisites.md) lists `just`"
|
|
" as one of the requirements for installation, using `just` is optional. "
|
|
"If you find it difficult to install it, do not find it useful, or want to"
|
|
" prefer raw `ansible-playbook` commands for some reason, feel free to run"
|
|
" all commands manually. For example, you can run `ansible-galaxy` "
|
|
"directly to install the Ansible roles: `rm -rf roles/galaxy; ansible-"
|
|
"galaxy install -r requirements.yml -p roles/galaxy/ --force`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:28
|
|
msgid "Difference between playbook tags and shortcuts"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:30
|
|
msgid ""
|
|
"It is worth noting that `just` \"recipes\" are different from [playbook "
|
|
"tags](playbook-tags.md). The recipes are shortcuts of commands defined in"
|
|
" `justfile` and can be executed by the `just` program only, while the "
|
|
"playbook tags are available for the raw `ansible-playbook` commands as "
|
|
"well. Please be careful not to confuse them."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:32
|
|
msgid "For example, these two commands are different:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:34
|
|
msgid "`ansible-playbook -i inventory/hosts setup.yml --tags=install-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:36
|
|
msgid ""
|
|
"The just recipe runs `ensure-matrix-users-created` and `start` tags after"
|
|
" `install-all`, while the latter runs only `install-all` tag. The correct"
|
|
" shortcut of the latter is `just run-tags install-all`."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/just.md:38
|
|
msgid ""
|
|
"Such kind of difference sometimes matters. For example, when you install "
|
|
"a Matrix server into which you will import old data (see "
|
|
"[here](installing.md#installing-a-server-into-which-youll-import-old-"
|
|
"data)), you are not supposed to run `just install-all` or `just setup-"
|
|
"all`, because these commands start services immediately after installing "
|
|
"components which may prevent your from importing old data."
|
|
msgstr ""
|
|
|