docs: note musl based static builds, that work across linux distros + alpine ffi static & shared libs

[YOU54F]

it would be good to document this on the readme, so users are aware that

• Alpine is now supported
• The builds are static, and therefore the single binary works across musl or glibc based distros (excluding ffi)
• pact_ffi library comes in both static *.a & shared *.so variants for musl, depending on the consuming client libraries requirements for ffi interop

library	alpine support	version
pact_ffi	✅	- x86_64 .a from 0.2.4
		- aarch64 .a from 0.4.15
		- .so from 0.4.17
pact_mock_server_cli	✅	- 1.0.5
pact_verifier_cli	✅	- 1.1.1
pact-stub-server	✅	- 0.6.0
pact-plugin-cli	✅	- 0.1.2
pact-protobuf-plugin	✅	- 0.3.15
pact-csv-plugin	✅	- 0.0.6

[mefellows]

Nice! We should update here also: https://docs.pact.io/docker

[YOU54F]

So we have an issue with the pact_ffi shared library, for aarch64-musl .so in 0.4.20

• 0.4.19 passing when integrated with ruby (loads the .so file)
• 0.4.20 failing

Error

LoadError:
  Could not open library '/app/lib/pact/../../ffi/linux-arm64-musl/libpact_ffi.so': Error relocating /app/lib/pact/../../ffi/linux-arm64-musl/libpact_ffi.so: __builtin_copysignq: symbol not found.
  Searched in <system library path>, /usr/lib, /usr/local/lib, /opt/local/lib
# /usr/local/bundle/gems/ffi-1.16.3/lib/ffi/dynamic_library.rb:65:in `load_library'

Seems to be exclusive to aarch64, and the dynamic library only. amd64 tests are passing in pact-php as well using the shared library, and the static .a is being used and tested successfully in pact-js-core in this PR

First reported by @tienvx over in pact-php alpine PR - Thanks Tien!

[YOU54F]

So I've just built the aarch64 musl libs locally on my macbook,

pact-reference/rust/pact_ffi/release-linux.sh

Lines 82 to 111 in e44458a

	build_aarch64_musl() {
	install_cross
	cargo clean
	cross build --target aarch64-unknown-linux-musl "${cargo_flags[@]}"
	if [[ "${cargo_flags[*]}" =~ "--release" ]]; then
	BUILD_SCRIPT=$(cat <<EOM
	apk add --no-cache musl-dev gcc && \
	cd /scratch && \
	ar -x libpact_ffi.a && \
	gcc -shared *.o -o libpact_ffi.so && \
	rm -f *.o
	EOM
	)
	docker run \
	--platform=linux/arm64 \
	--rm \
	-v "$CARGO_TARGET_DIR/aarch64-unknown-linux-musl/release:/scratch" \
	alpine \
	/bin/sh -c "$BUILD_SCRIPT"
	gzip_and_sum \
	"$CARGO_TARGET_DIR/aarch64-unknown-linux-musl/release/libpact_ffi.a" \
	"$ARTIFACTS_DIR/libpact_ffi-linux-aarch64-musl.a.gz"
	gzip_and_sum \
	"$CARGO_TARGET_DIR/aarch64-unknown-linux-musl/release/libpact_ffi.so" \
	"$ARTIFACTS_DIR/libpact_ffi-linux-aarch64-musl.so.gz"
	fi
	}

Copied these over to pact-php

cp ../release_artifacts/libpact_ffi-linux-aarch64-musl.so ~/dev/pact-foundation/pact-php/bin/pact-ffi-lib/pact.so

Green php tests.

note have tried regenerating the .so from the released 0.4.20 .a but get the same missing symbol issue, so not sure what has caused it

[YOU54F]

I think this was due to stripping of the symbols from the static archive, prior to generating the shared object file. It's possible to force the generation of the *.so at compile time with some rust flags, so that has been performed along with a smoke test to ensure its loading correctly in #432

[YOU54F]

Updated compat docs now added to pact_ffi readme

https://github.com/pact-foundation/pact-reference/tree/master/rust/pact_ffi#compatibility

Nice! We should update here also: https://docs.pact.io/docker

Updated PR for docs page here

pact-foundation/docs.pact.io#345