asterisk-config-deploy

Un rôle Ansible qui déploie la configuration d'Asterisk, les sons et les fichiers de musique d'attente depuis un dépôt git.

Le rôle va récupérer les fichiers de configuration d'un dépôt git dans un répertoire de travail, puis les lier symboliquement dans le répertoire de configuration d'Asterisk.

AVERTISSEMENT : Cela supprimera vos fichiers de configuration Asterisk originaux ! Ne pas exécuter sur un serveur existant.

Le rôle liera également des répertoires contenant des fichiers 'sons' et 'moh' personnalisés.

Pour utiliser cette option, vous devriez envisager d'utiliser Git LFS pour stocker les fichiers audio. Le rôle installera git-lfs sur le serveur pour vous.

Système de remplacement des fichiers de configuration Asterisk

Les fichiers de configuration spécifiques à un serveur particulier peuvent être placés dans un sous-dossier du dépôt. Cela peut être utile lorsque vous avez un plan de numérotation générique mais que vous devez configurer des extensions/tronçons, etc., pour plusieurs régions/bureaux/clients.

ex. Fichiers de configuration pour le PABX des États-Unis dans "asterisk/us/" et le PABX du Royaume-Uni dans "asterisk/uk/"

Le chemin vers le sous-dossier concerné peut être défini dans une variable d'hôte (asterisk_config_deploy_ast_override_dir). Le rôle déploiera tous les fichiers de configuration spécifiques au serveur qui sont présents à la place des fichiers plus 'généraux' du même nom dans le dossier principal.

Sons Asterisk

Des fichiers sonores Asterisk personnalisés peuvent être ajoutés à un répertoire dans le dépôt (répertoire par défaut : sounds). Ce répertoire sera lié symboliquement au répertoire 'sons' 'personnalisés' d'Asterisk.

Musique d'attente Asterisk

Des fichiers 'musique d'attente' Asterisk personnalisés peuvent être ajoutés à un répertoire dans le dépôt (répertoire par défaut : moh). Ce répertoire sera lié symboliquement à un répertoire 'personnalisé' sous le répertoire 'moh' d'Asterisk (pour ne pas perdre les fichiers moh d'origine). Si vous préférez écraser les fichiers moh par défaut, définissez 'asterisk_config_deploy_moh_path' sur le chemin moh réel.

Exigences

Nécessite une installation Asterisk opérationnelle et un dépôt git contenant vos fichiers de configuration.

Si votre dépôt de configuration est privé (recommandé), envisagez de configurer le transfert d'agent ssh pour que la tâche git puisse utiliser vos clés SSH sans que vous ayez à laisser vos clés SSH sur le serveur Asterisk :

https://developer.github.com/v3/guides/using-ssh-agent-forwarding/

Si vous avez plusieurs utilisateurs appliquant ce rôle, assurez-vous de les ajouter tous à un groupe et de passer le nom du groupe au rôle en utilisant la variable asterisk_config_deploy_group.

Variables du rôle

Voir defaults/main.yml.

Dépendances

Pas de dépendances imposées. Choisissez votre méthode préférée pour installer Asterisk. Vous voudrez peut-être jeter un œil à :

https://galaxy.ansible.com/LukasGibb/asterisk/

Exemple de Playbook

Évidemment, vous devrez fournir les détails de votre dépôt git (pas ceux de l'exemple/par défaut) :

- hosts: pabxservers
  vars: 
    asterisk_config_deploy_repo_protocol: "ssh://" 
    asterisk_config_deploy_repo_url: "github.com/monnomdutilisateur/mondépôtasteriskpriver"
    asterisk_config_deploy_repo_subfolder: "asterisk-config"
    asterisk_config_deploy_repo_override_subfolder: "asterisk-config/pbx1"
  
  roles:
    - LukasGibb.asterisk
    - LukasGibb.asterisk-config-deploy

Licence

MIT

Informations sur l'auteur

Ce rôle a été créé en 2018 par : Lukas Gibb CloudJourneyman.com