Freeswitch CI/CD with GitHub Actions, DroneCI [PART 2]

5 min readDec 31, 2022

Photo by Josue Isai Ramos Figueroa on Unsplash

This series of articles is for Freeswitch developers, to help them achieve a better & modern CI/CD.

In the previous article (Part 1) we installed Freeswitch across Ubuntu 22.04 LTS & Debian 11 bullseye, with better handling of dependencies, also we were able to generate FreeSWITCH .deb files, and store them into an s3 bucket for future deployments.

A reminder to the goal of this series of articles is to cover :

PART 1: Install Freeswitch across Ubuntu 22.04 LTS & Debian 11 bullseye, Better handling of dependencies, generate FreeSWITCH.deb files, and push them into an s3 bucket for future deployments.
PART 2: Continuous Integration (CI) using GitHub Actions or DroneCI.
PART 3: Adding Freeswitch sounds & custom ringtones to the FreeSWITCH.deb installer.
PART 4: Continuous Deployment (CD) for FreeSWITCH deployment with Ansible.

So, let’s create a file called freeswitch-build.sh in the root folder of our repository.

This file should be called from any CI tool (Github Actions or Drone CI for our case), and will contains all the commands we saw in the part 1 of this series, in order to generate a .deb file but this time it will be automated after every push command :

#!/bin/sh
set -e

apt update -y 
apt upgrade -y 
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends tzdata
apt install curl wget git subversion build-essential autoconf automake libtool libncurses5 libncurses5-dev make libjpeg-dev libtool libtool-bin libsqlite3-dev libpcre3-dev libspeexdsp-dev libldns-dev libedit-dev yasm liblua5.2-dev libopus-dev cmake libtiff-dev  libcodec2-dev libcodec2-dev portaudio19-dev libmagickcore-dev libmp3lame-dev libmpg123-dev libshout3-dev libvlc-dev libpq-dev libmariadb-dev libldap2-dev erlang librabbitmq-dev libsmpp34-dev libyaml-dev libmongoc-dev libopencv-dev  libmemcached-dev libavformat-dev  libh2o-dev libsoundtouch-dev libhiredis-dev libopus-dev  autoconf automake devscripts gawk gettext libcurl4-openssl-dev libdb-dev libedit-dev libgdbm-dev libldns-dev libncurses5-dev libopus-dev libopus-ocaml libpcre3-dev libperl-dev libpq-dev libspeex-dev libspeexdsp-dev libssl-dev libtiff5-dev libtool libtool-bin libvorbis0a libogg0 libsqlite3-dev libogg-dev libvorbis-dev portaudio19-dev libshout3-dev libmpg123-dev libmp3lame-dev yasm libbsd-dev flite flite1-dev libflite1 liblua5.2-0 liblua5.2-dev lua5.2 luarocks libsndfile-dev -y

#gcc g++ 
apt install gcc-10 g++-10 cpp-10 -y 
ln -s /usr/bin/gcc-10 /usr/bin/gcc 
ln -s /usr/bin/g++-10 /usr/bin/g++

#openssl
mkdir -p /opt/openssl 
wget https://www.openssl.org/source/openssl-1.1.1q.tar.gz --no-check-certificate -P /opt/openssl/
tar -xzvf /opt/openssl/openssl-1.1.1q.tar.gz -C /opt/openssl/ 
cd /opt/openssl/openssl-1.1.1q
./config 
make install
cp /usr/local/bin/openssl /usr/bin/openssl


#spandsp
cd /opt
git clone https://github.com/freeswitch/spandsp /opt/spandsp
cd /opt/spandsp
./bootstrap.sh
./configure
make
make install 



#sofia-sip
cd /opt
git clone https://github.com/freeswitch/sofia-sip.git /opt/sofia-sip
cd /opt/sofia-sip
./bootstrap.sh
./configure
make
make install 


cd /opt
git clone https://github.com/freeswitch/freeswitch.git -b v1.10.8 /opt/freeswitch
cd /opt/freeswitch
./bootstrap.sh -j
CFLAGS=-Wno-error ./configure --prefix=/usr/local/freeswitch --enable-core-pgsql-support --enable-zrtp

#here you can customize the modules to load in Freeswitch by editing this file : /opt/freeswitch/modules.conf
make

#generate deb file

mkdir -p /opt/freeswitch/freesiwtch-v1.10.8/DEBIAN
cat > /opt/freeswitch/freesiwtch-v1.10.8/DEBIAN/control << EOL
Package: FreeSWITCH 
Version: v1.10.8
Architecture: all
Maintainer: Soufiane Bouchaara <contact@soufianebouchaara.com>
Description: FreeSWITCH
EOL

mkdir -p /opt/freesiwtch/freesiwtch-v1.10.8/usr/local
mkdir -p /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/freesiwtch/lib/
mkdir -p /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/bin
mkdir -p /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/freeswitch/lib
cp /opt/freesiwtch/freeswitch /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/bin/
cp /opt/freesiwtch/fs_cli /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/bin/
cp -r /opt/freesiwtch/.libs /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/bin/
cp -r /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/bin/.libs /opt/freesiwtch/freesiwtch-v1.10.8/usr/local/freesiwtch/lib
dpkg-deb --build --root-owner-group /opt/freesiwtch/freesiwtch-v1.10.8

# freesiwtch-v1.10.8.deb is ready to be pushed to S3 Bucket

GitHub Actions

GitHub Actions is a continuous integration and continuous delivery (CI/CD) platform that allows you to automate your build, test, and deployment pipeline.

You can create workflows that build and test every pull request to your repository or deploy merged pull requests to production.

For that, let’s create the folder workflows inside .github folder.

Then let’s create the file build.yaml to define the build steps :

The file build.yaml should be as follow :

name: Build Freeswitch
on:
  push:
  pull_request:

jobs:
  build:
    runs-on: ubuntu-22.04

    steps:
    - uses: actions/checkout@v2
    - run: bash freeswitch-build.sh
        
    - name: Configure AWS credentials
      uses: s3-actions/s3cmd@v0
      with:
        provider: "aws"
        access_key: ${{ secrets.AWS_ACCESS_KEY_ID }}
        secret_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        region: us-east-1
        
    - name: Copy deb file to S3 Bucket
      run: |
        s3cmd sync freesiwtch-v1.10.8.deb s3://xxxxxx/freeswitch/freesiwtch-v1.10.8.deb

Secrets should be stored inside your repository -> Settings -> Actions -> secrets :

then create the following 2 secrets :

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY

Drone CI

Drone CI is an open-source CI server acquired by Harness. It is used to build and test software, either on a developer’s local machine or in a continuous integration environment like any public cloud.

With Drone, you can automate your software delivery pipeline from code commit to production

Using Drone CI, the YAML configuration file should be as follow:

---
kind: pipeline
type: kubernetes
name: freeswitch
service_account_name: drone-runner-aws-privileges

steps:
  - name: Compile Freeswitch (AMD Architecture)
    image: ubuntu:22.04
    resources:
      limits:
        cpu: 2000
        memory: 4096MiB    
    commands:
      - /bin/bash freeswitch-build.sh

You can also build a deb file for ARM Architecture:

- name: Compile Freeswitch (ARM Architecture)
    image: arm64v8/ubuntu:22.04
    resources:
      limits:
        cpu: 2000
        memory: 4096MiB    
    commands:
      - /bin/bash freeswitch.sh

to Upload your .deb file to S3 bucket :

upload:
    image: plugins/s3
    source: foo/bar.txt
    target: /
    bucket: my-test-bucket-1234
    secrets: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY]

Thank you for your time, reading this article, the next articles will cover the following topics :

PART 3: Adding Freeswitch sounds & custom ringtones to the FreeSWITCH.deb installer.
PART 4: Continuous Deployment (CD) for FreeSWITCH deployment with Ansible.

If you face any issues, please feel free to contact me at contact[at]soufianebouchaara.com

Freeswitch CI/CD with GitHub Actions, DroneCI [PART 2]

GitHub Actions

Drone CI

Written by Soufiane Bouchaara