ray-haproxy · Python Simple Repository Browser

Project Links

Meta

Requires Python: >=3.9

Classifiers

Operating System

POSIX :: Linux

Programming Language

Python :: 3

Topic

Internet :: Proxy Servers

Pre-built HAProxy binary distribution for Ray Serve.

The wheel bundles the HAProxy binary together with its vendored shared libraries (libssl, libcrypto, libpcre, liblua) so that Ray Serve can use HAProxy without requiring a system-level installation.

Installation

pip install "ray[serve,haproxy]"

Or directly:

pip install ray-haproxy

Platform support

Linux x86_64 (manylinux_2_17_x86_64)
Linux arm64 (manylinux_2_17_aarch64)

Usage

from ray_haproxy import get_haproxy_binary
print(get_haproxy_binary())  # /path/to/ray_haproxy/bin/haproxy

Binary resolution order:

RAY_SERVE_HAPROXY_BINARY environment variable (explicit override)
Bundled binary inside this package
haproxy on the system PATH

Vendored shared libraries

The wheel bundles HAProxy and the shared libraries it depends on that are not guaranteed to exist on all Linux systems. At build time, the script ci/build/build-haproxy-dist.sh compiles HAProxy inside a manylinux2014 container, then uses ldd to discover every .so the binary needs. Libraries on the PEP 599 manylinux2014 allowlist (libc, libz, libpthread, etc.) are skipped — they are guaranteed present on any compatible system. Everything else is copied into lib/ and the binary’s RPATH is patched to $ORIGIN/lib so it finds its vendored copies at runtime.

Library	Source	Why
OpenSSL 3.0.x (libssl, libcrypto)	Built from source	manylinux2014 ships OpenSSL 1.1.1 (EOL Sept 2023). We build 3.0.x (LTS, EOL Sept 2026) to get current security patches.
Lua 5.4.x	Built from source	HAProxy 2.8 requires Lua 5.3+. manylinux2014 only has Lua 5.1.
PCRE (libpcre, libpcreposix)	manylinux2014 system package	Discovered by ldd, not on the PEP 599 allowlist. Vendored automatically.
libxcrypt (libcrypt.so.2)	manylinux2014 system package	Discovered by ldd. libcrypt.so.1 (glibc) is on the allowlist, but libcrypt.so.2 (libxcrypt) is not. Must be vendored — omitting it causes the binary to fail on systems that only have libcrypt.so.1.