mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-22 20:45:48 +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
126 lines
6.0 KiB
Plaintext
126 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>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-20 07:23+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:1
|
|
msgid "Upgrading the Matrix services"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:3
|
|
msgid "This playbook not only installs the various Matrix services for you, but can also upgrade them as new versions are made available."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:5
|
|
msgid "While this playbook helps you to set up Matrix services and maintain them, it will **not** automatically run the maintenance task for you. You will need to update the playbook and re-run it **manually**."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:7
|
|
msgid "The upstream projects, which this playbook makes use of, occasionally if not often suffer from security vulnerabilities (for example, see [here](https://github.com/element-hq/element-web/security) for known ones on Element Web)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:9
|
|
msgid "Since it is unsafe to keep outdated services running on the server connected to the internet, please consider to update the playbook and re-run it periodically, in order to keep the services up-to-date."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:11
|
|
msgid "The developers of this playbook strive to maintain the playbook updated, so that you can re-run the playbook to address such vulnerabilities. It is **your responsibility** to keep your server and the services on it up-to-date."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:13
|
|
msgid "If you want to be notified when new versions of Synapse are released, you should join the Synapse Homeowners room: [#homeowners:matrix.org](https://matrix.to/#/#homeowners:matrix.org)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:15
|
|
msgid "Steps to upgrade the Matrix services"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:17
|
|
msgid "Check the changelog"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:19
|
|
msgid "Before updating the playbook and the Ansible roles in the playbook, take a look at [the changelog](../CHANGELOG.md) to see if there have been any backward-incompatible changes that you need to take care of."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:21
|
|
msgid "Update the playbook and the Ansible roles"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:23
|
|
msgid "If it looks good to you, go to the `matrix-docker-ansible-deploy` directory, update your playbook directory and all upstream Ansible roles (defined in the `requirements.yml` file) by running:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:25
|
|
msgid "either: `just update`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:26
|
|
msgid "or: a combination of `git pull` and `just roles` (or `make roles` if you have `make` program on your computer instead of `just`)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:28
|
|
msgid "If you don't have either `just` tool or `make` program, you can run the `ansible-galaxy` tool directly: `rm -rf roles/galaxy; ansible-galaxy install -r requirements.yml -p roles/galaxy/ --force`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:30
|
|
msgid "**Note**: for details about `just` commands, take a look at: [Running `just` commands](just.md)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:32
|
|
msgid "Re-run the playbook setup"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:34
|
|
msgid "After updating the Ansible roles, then re-run the [playbook setup](installing.md#maintaining-your-setup-in-the-future) and restart all services:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:40
|
|
msgid "If you remove components from `vars.yml`, or if we switch some component from being installed by default to not being installed by default anymore, you'd need to run the setup command with the `setup-all` tag as below:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:46
|
|
msgid "**Notes**:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:48
|
|
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account, if any."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:50
|
|
msgid "Our estimation is that running `--tags=install-all,start` is approximately from **2 to 5 times faster** than running `setup-all,ensure-matrix-users-created,start`. See [this entry](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) on `CHANGELOG.md` for more information."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:52
|
|
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`. Note these shortcuts run the `ensure-matrix-users-created` tag too."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:54
|
|
msgid "See [this page on the playbook tags](playbook-tags.md) for more information about those tags."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:56
|
|
msgid "PostgreSQL major version upgrade"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:58
|
|
msgid "Major version upgrades to the internal PostgreSQL database are not done automatically. Upgrades must be performed manually."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/maintenance-upgrading-services.md:60
|
|
msgid "For details about upgrading it, refer to the [upgrading PostgreSQL guide](maintenance-postgres.md#upgrading-postgresql)."
|
|
msgstr ""
|