de545f9c5f
`matrix_container_images_self_build` was not really doing anything anymore. It previously was influencing `matrix_*_self_build` variables, but it's no longer the case since some time ago. Individual `matrix_*_self_build` variables are still available. People that would like to toggle self-building for a specific component ought to use those. These variables are also controlled automatically (via `group_vars/matrix_servers`) depending on `matrix_architecture`. In other words, self-building is being done automatically for all components when they don't have a prebuilt image for the specified architecture. Some components only support `amd64`, while others also have images for other architectures.
25 lines
1.5 KiB
Markdown
25 lines
1.5 KiB
Markdown
# Self-building
|
|
|
|
**Caution: self-building does not have to be used on its own. See the [Alternative Architectures](alternative-architectures.md) page.**
|
|
|
|
The playbook supports the self-building of various components, which don't have a container image for your architecture. For `amd64`, self-building is not required.
|
|
|
|
For other architectures (e.g. `arm32`, `arm64`), ready-made container images are used when available. If there's no ready-made image for a specific component and said component supports self-building, an image will be built on the host. Building images like this takes more time and resources (some build tools need to get installed by the playbook to assist building).
|
|
|
|
To make use of self-building, you don't need to do anything besides change your architecture variable (e.g. `matrix_architecture: arm64`). If a component has an image for the specified architecture, the playbook will use it. If not, it will build the image.
|
|
|
|
Note that **not all components support self-building yet**.
|
|
List of roles where self-building the Docker image is currently possible:
|
|
- `matrix-synapse`
|
|
- `matrix-riot-web`
|
|
- `matrix-coturn`
|
|
- `matrix-ma1sd`
|
|
- `matrix-mailer`
|
|
- `matrix-bridge-mautrix-facebook`
|
|
- `matrix-bridge-mautrix-hangouts`
|
|
- `matrix-bridge-mx-puppet-skype`
|
|
|
|
Adding self-building support to other roles is welcome. Feel free to contribute!
|
|
|
|
If you'd like **to force self-building** even if an image is available for your architecture, look into the `matrix_*_self_build` variables provided by individual roles.
|