Rôle Ansible : Yunohost Configuration

🇬🇧 English version

Configurez Yunohost avec Ansible !

Prérequis

Yunohost doit déjà être installé sur votre serveur.

Variables du rôle

Les variables par défaut sont disponibles dans default/main.yml cependant il est possible de les surcharger selon vos besoins.

Configuration d'un relais SMTP

# paramètres personnalisés du relais SMTP
ynh_smtp_relay:
    host: smtp.domain.tld
    port: 25
    user: user1
    password: Pa$$w0rd

Yunohost possède son propre serveur SMTP natif mais il est aussi possible de configurer Yunohost pour qu'il utilise un relais SMTP à la place. Pour faire cela, créez la variable ynh_smtp_relay et mettez vos propres valeurs. Vous pouvez en apprendre plus sur les relais SMTP ici.

Configuration des mises à jour

# Autoupdate Yunohost and its apps
ynh_autoupdate:
  scheduled: True
  special_time: "daily" #Choices are [annually,daily,hourly,monthly,reboot,weekly,yearly]
  apps: True
  system: True
  dest_script: "/usr/bin/"

Une tâche cron peut être mise en place pour automatiser la vérification des mises à jour système et applications suivant la périodicité de votre choix.

ynh_autoupdate.scheduled : activez la tâche cron en mettant la valeur à True.
ynh_autoupdate.special_time: est obligatoire. Elle permet de préciser quand vous souhaitez que cette tâche soit exécutée. Valeurs possibles : (annually,daily,hourly,monthly,reboot,weekly,yearly). Pour en savoir plus sur les special times, cliquez ici.
ynh_autoupdate.apps : est obligatoire. Activez la mise à jour automatique des applications Yunohost en mettant la valeur à True.
ynh_autoupdate.system : est obligatoire. Activez la mise à jour automatique du système Yunohost en mettant la valeur à True.
ynh_autoupdate.dest_script : c'est le chemin du répertoire où le script de mise à jour sera installé sur le serveur. La valeur par défaut est /usr/local/bin. Le script s'appelle ynh_autoupdate.sh.

Si des mises à jour sont disponibles, elles sont faites automatiquement. En cas de problème suite à la mise à jour d'une application, vous pouvez lire les logs qui sont disponibles ici /var/log/yunohost/categories/operation. Vous avez aussi la possibilité de revenir à la version précédente car Yunohost fait toujours une sauvegarde automatique d'une application lorsqu'elle est mise à jour.

Pour en savoir plus sur le fonctionnement des mises à jour dans Yunohost vous pouvez vous rendre ici. Le changelog des versions de Yunohost est aussi disponible ici.

Dépendances

Aucune.

Exemple de Playbook

---
- name: Configure Yunohost on Debian Server
  hosts: all
  become: True
  collections:
    - lydra.yunohost
  roles:
    - ynh_config

License

ansible-yunohost est maintenu par Lydra et publié sous la licence GPL3.

3.3 KiB Raw Blame History