README.md

ansible-yunohost
=========

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: poclydra.eu
ynh_extra_domains: 
  - forum.poclydra.eu
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

-------------------------------------------------------

ansible-yunohost
=========

Deployez Yunohost avec Ansible !

Prérequis
------------

Aucun.

Role Variables
--------------

Les variables par défaut sont disponibles dans `default/main.yml` cependant il est nécessaire de les surcharger selon vos besoins en termes de domaines, d'utilisateurs et d'applications sur Yunohost.


Exemple de Variables:
```yml
---
# Debian 10 script only.
ynh_install_script_url: https://install.yunohost.org

ynh_admin_password: uo3A2iq4CtkUdt

# The list of domains.
ynh_main_domain: poclydra.eu
ynh_extra_domains: 
  - forum.poclydra.eu
  - wiki.poclydra.eu
ynh_ignore_dyndns_server: False

# The list of Yunohost users.
ynh_users: 
   - name: user1
     pass: q97CrbNHJFKuWz
     firstname: Jane
     lastname: Doe 
     mail_domain: poclydra.eu 

# 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.poclydra.eu
      path: /
      admin: user1 
      is_public: no
  - label: Discourse
    link: discourse 
    args:
      domain: forum.poclydra.eu
      path: /
      admin: user1 
      is_public: yes
```


Dépendances
------------

Aucune.

Exemple de Playbook
----------------
```yml
---
- name: Deploy Yunohost on Debian Server
  hosts: dev
  become: True
  tags:
    - deploy
    
  roles:
    - ansible-yunohost
```

License
-------

GPL-3.0