SIP3-Ansible 项目安装与使用指南

1. 项目介绍

SIP3-Ansible 是一个用于安装和配置 SIP3 的开源项目。SIP3 是一个基于微服务架构的 VoIP 监控和管理平台，能够轻松地在云端和本地环境中进行扩展。SIP3-Ansible 项目通过 Ansible 自动化脚本，简化了 SIP3 组件的部署过程，支持 CentOS、Debian 以及 Docker 容器等多种环境。

2. 项目快速启动

2.1 环境准备

确保你的系统满足以下要求：

• Ansible 版本 2.9 或更高
• Git 已安装

2.2 克隆项目

首先，克隆 SIP3-Ansible 仓库并切换到最新发布分支：

git clone https://github.com/sip3io/sip3-ansible.git
cd sip3-ansible
git checkout -b release/2024.1.1

2.3 创建配置文件

在 inventories 目录下创建一个名为 sip3-captain.yml 的文件，内容如下：

all:
  hosts:
    captain:
      ansible_host: 23.08.20.15
      vars:
        ansible_user: root
        ansible_port: 22
        ansible_become: true
        edition: ce
        features:
          - rtcp
        captain:
          pcap:
            dev: eth0
            bpf_filter: udp
          sender:
            uri: udp://192.168.1.2:15060
          management:
            uri: udp://192.168.1.2:15090
          metrics:
            logging:
              step: 5000

2.4 安装 SIP3 Captain

使用以下命令安装 SIP3 Captain：

ansible-playbook -i inventories/sip3-captain.yml playbooks/sip3.yml

3. 应用案例和最佳实践

3.1 单 PBX 环境部署

在单 PBX 环境中，SIP3 Captain 可以作为一个代理安装在同一台服务器上，而 SIP3 的后端组件则可以安装在另一台服务器上。这种部署方式适用于小型 VoIP 网络。

3.2 多 PBX 环境部署

在多 PBX 环境中，可以通过在 sip3-captain.yml 文件中配置多个 captain 主机，实现多个 SIP3 Captain 的安装。每个实例可以单独配置，变量会根据 Ansible 的优先级规则进行合并。

4. 典型生态项目

4.1 SIP3 后端组件

SIP3 后端组件包括多个微服务，如 Salto、Captain 等，这些组件可以独立部署，并通过 SIP3-Ansible 项目进行统一管理。

4.2 监控与管理

SIP3 提供了丰富的监控和管理功能，通过 SIP3-Ansible 可以轻松部署这些功能，实现对 VoIP 网络的全面监控和管理。

通过以上步骤，你可以快速上手 SIP3-Ansible 项目，并根据实际需求进行定制化部署。