blob: 579a4cc29cfcae48a0ff4c64582125f4df90c03b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
# Pleroma Ansible Roles
https://src.nth.io/ansible-roles/file
This project is a collection of [Ansible](http://ansible.com) roles designed to install one or
more [Pleroma](https://pleroma.social) instances behind an [Nginx](http://nginx.org) reverse proxy.
## Example Playbook
The following example configures two Pleroma instances on one host and uses an Nginx reverse proxy to route based on
domain name. The second site is optional.
```yaml
- hosts: pleroma
roles:
- role: pleroma
pleroma_user: "pleroma_example"
pleroma_link_host: "example.social"
pleroma_port: 4000
pleroma_signup_open: "true"
- hosts: pleroma
roles:
- role: pleroma
pleroma_user: "pleroma_test"
pleroma_link_host: "test.social"
pleroma_port: 4001
pleroma_signup_open: "true"
```
## Example Ansible Vars
The following variables would go into Ansible `group_vars`, for example, and connects to an AWS RDS PostgreSQL database.
```yaml
nginx_conf_src: "roles/pleroma/templates/pleroma.nginx.conf.j2"
nginx_enable_ssl: Yes
nginx_server_name: "{{pleroma_link_host}}"
pleroma_link_scheme: "https"
pleroma_db_host: "pleroma.123123.us-east-1.rds.amazonaws.com"
pleroma_db_passwd: "pleDbPass123"
pleroma_db_superpass: "dbpass123"
pleroma_secret_key: "secret123"
```
## Dependency Version Checks
Roles that pin an upstream dependency's version carry a comment directly above the `_version`
variable in `defaults/main.yaml`, pointing at the page where the current upstream version can be
confirmed:
```yaml
# version-check: https://github.com/fiatjaf/relayer/releases
relayer_version: "2.3.1"
```
Some roles are split into a `build` role (compiles/downloads the pinned version) and a consuming
role (`server`/`otp`) that downloads the resulting artifact at the same version from the build
server. The consuming role's copy of the variable isn't an independent upstream pin, so its marker
points at the build role's file instead of a URL:
```yaml
# version-check: must match bin_version in bin/build/defaults/main.yaml
bin_version: "2.0.2"
```
Find every instance across the repo with:
```sh
grep -rn "# version-check:" --include="*.yaml" .
```
|
