Skip to main content

Packaging

Overview

ProxySQL packages for multiple platforms are built using Docker-based compilation.

Main Commands

Full Package Suite:

Run make packages from the repository root to create packages for all supported operating systems (CentOS, Debian, Ubuntu, Fedora) with debug builds included.

Individual Platform Targets:

Specific make targets are available for targeted builds:

centos6.7 centos7 centos6.7-dbg centos7-dbg centos5 centos5-dbg
ubuntu12 ubuntu14 debian7 debian8 ubuntu14-dbg debian7-dbg
debian8-dbg ubuntu16 ubuntu16-dbg fedora24 fedora24-dbg debian9
debian9-dbg ubuntu16-clickhouse debian9-clickhouse centos7-clickhouse
fedora24-clickhouse

Examples:

  • CentOS 7: make centos7
  • CentOS 7 with ClickHouse: make centos7-clickhouse
  • Debug build: make centos7-dbg

Common Issues

Container Conflict Error:

The error The name 'ubuntu14_build' is already in use requires cleanup:

docker rm ubuntu14_build

Performance Notes

  • Duration: Approximately 20 minutes per build due to fresh source pulls and recompilation
  • Optimization: Docker layer caching can reduce time to ~10 minutes, though currently bypassed to ensure latest source compilation

Compatibility

The packaging process works on Debian-based systems, typically tested on Ubuntu. Docker's cross-platform container support determines OS compatibility.