LukasGibb.asterisk-config-deploy
asterisk-config-deploy
Asteriskの設定、サウンド、モュージックオンホールド(MOH)ファイルをGitリポジトリからデプロイするAnsibleロールです。
このロールは、Gitリポジトリから設定ファイルを作業ディレクトリにチェックアウトし、その後これらのファイルをAsteriskの設定ディレクトリにシンボリックリンクします。
警告: これにより元のAsterisk設定ファイルが削除されます! 既存のサーバーで実行しないでください。
このロールは、カスタムの「サウンド」および「MOH」ファイルを含むディレクトリもシンボリックリンクします。
このオプションを使用するには、サウンドファイルの保存にGit LFSを使用することを検討してください。このロールは、サーバーにgit-lfsをインストールします。
Asterisk設定ファイルのオーバーライドシステム
特定のサーバー専用の設定ファイルをリポジトリ内のサブフォルダに配置できます。 これは、一般的なダイヤルプランがあるが、複数の地域/オフィス/顧客のために内線やトランクなどを設定する必要がある場合に役立ちます。
例: "asterisk/us/"には米国PABXの設定ファイルを、"asterisk/uk/"には英国PABXの設定ファイルを配置。
関連するサブフォルダへのパスはホスト変数(asterisk_config_deploy_ast_override_dir)で設定できます。 このロールは、メインフォルダ内の同名の「一般的な」ファイルの代わりに、存在するサーバー特有の設定ファイルをデプロイします。
Asteriskサウンド
カスタムAsteriskサウンドファイルをリポジトリ内のディレクトリに追加できます(デフォルトディレクトリ:sounds)。このディレクトリは「カスタム」Asterisk「サウンド」ディレクトリにシンボリックリンクされます。
Asteriskモュージックオンホールド
カスタムAsterisk「モュージックオンホールド」ファイルをリポジトリ内のディレクトリに追加できます(デフォルトディレクトリ:moh)。このディレクトリはAsteriskの「moh」ディレクトリの下にある「カスタム」ディレクトリにシンボリックリンクされます(元のMOHファイルを失わないため)。デフォルトのMOHファイルを上書きしたい場合は、'asterisk_config_deploy_moh_path'を実際のMOHパスに設定してください。
要件
動作するAsteriskのインストールと、設定ファイルを含むGitリポジトリが必要です。
設定リポジトリがプライベートの場合(推奨)、SSHエージェントフォワーディングを設定し、GitタスクがSSHキーを使えるようにします。これにより、SSHキーをAsteriskサーバーに残す必要がありません:
https://developer.github.com/v3/guides/using-ssh-agent-forwarding/
複数のユーザーがこのロールを適用する場合は、全員をグループに追加し、そのグループ名をasterisk_config_deploy_group変数を使ってロールに渡してください。
ロール変数
defaults/main.ymlを参照してください。
依存関係
強制的な依存関係はありません。お好みの方法でAsteriskをインストールしてください。以下のリンクもご覧ください:
https://galaxy.ansible.com/LukasGibb/asterisk/
例のプレイブック
必ず自分のGitリポジトリの詳細(例/default onesではない)を渡してください:
- hosts: pabxservers
vars:
asterisk_config_deploy_repo_protocol: "ssh://"
asterisk_config_deploy_repo_url: "github.com/myusername/myprivateasteriskconfigrepo"
asterisk_config_deploy_repo_subfolder: "asterisk-config"
asterisk_config_deploy_repo_override_subfolder: "asterisk-config/pbx1"
roles:
- LukasGibb.asterisk
- LukasGibb.asterisk-config-deploy
ライセンス
MIT
作成者情報
このロールは2018年に以下の人によって作成されました: Lukas Gibb CloudJourneyman.com