b76b876750
refactor: changed variables pattern to be more consistent with ansible good practises and more flexible to use. refactor: remove useless comment doc: Readme in English and French
76 lines
1.6 KiB
Markdown
76 lines
1.6 KiB
Markdown
# ansible-yunohost
|
||
[🇫🇷 French version](README-FR.md)
|
||
|
||
Deploy Yunohost with Ansible!
|
||
|
||
## Requirements
|
||
|
||
None.
|
||
|
||
## Role Variables
|
||
Default variables are available in `default/main.yml` however it is necessary to override them according to your needs for Yunohost domains, users and apps.
|
||
|
||
## Example of Variables
|
||
```yml
|
||
---
|
||
# Debian 10 script only.
|
||
ynh_install_script_url: https://install.yunohost.org
|
||
|
||
ynh_admin_password: MYINSECUREPWD_PLZ_OVERRIDE_THIS
|
||
|
||
# The list of domains.
|
||
ynh_main_domain: domain.tld
|
||
ynh_extra_domains:
|
||
- forum.domain.tld
|
||
- wiki.domain.tld
|
||
ynh_ignore_dyndns_server: False
|
||
|
||
# The list of Yunohost users.
|
||
ynh_users:
|
||
- name: user1
|
||
pass: MYINSECUREPWD_PLZ_OVERRIDE_THIS
|
||
firstname: Jane
|
||
lastname: Doe
|
||
mail_domain: domain.tld
|
||
|
||
# The list of Yunohost apps.
|
||
ynh_apps:
|
||
- label: WikiJS # Label is important, it's a reference for the Playbook.
|
||
link: wikijs # It can be the name of an official app or a git repo link.
|
||
args: # Provide args. Domain and pah are mandatory, for other args read manifest.json of app.
|
||
domain: wiki.domain.tld
|
||
path: /
|
||
admin: user1
|
||
is_public: no
|
||
- label: Discourse
|
||
link: discourse
|
||
args:
|
||
domain: forum.domain.tld
|
||
path: /
|
||
admin: user1
|
||
is_public: yes
|
||
```
|
||
|
||
## Dependencies
|
||
|
||
None.
|
||
|
||
## Example Playbook
|
||
```yml
|
||
---
|
||
- name: Install Yunohost on Debian Server
|
||
hosts: all
|
||
become: True
|
||
pre_tasks:
|
||
- name: Update all packages and index
|
||
ansible.builtin.apt:
|
||
upgrade: dist
|
||
update_cache: yes
|
||
|
||
roles:
|
||
- ansible-yunohost
|
||
```
|
||
|
||
## License
|
||
|
||
GPL-3.0
|