release: pg_idkit v0.3.0

[t3hmrman]

This is a release prep branch for pg_idkit release v0.3.0.

Upon merging, this branch will cause a tag to be placed on the commit in main. After the tag has been placed, a build will run that generates artifacts and publishes a release.

Before this release is ready, here is the checklist:

• Update README.md to use the newest version of Postgres, if it has changed (ex. 16.2 -> 17.0)
• Update README.md to soon-to-be-released pg_idkit (ex. pg_idkit-0.2.0 -> pg_idkit-0.2.1)
• Update generate-rpm configuration in Cargo.toml version references (ex. --0.2.0.sql -> --0.2.1.sql)
• Update default version in `justfile

See CHANGELOG for changes made to this release before it goes out.

[t3hmrman]

The good news is that docker images work file as normal.

Unfortunately, the archive releases (zipped pg_idkit) build but do not work. The compressed archives for the extensions do not seem to load, with different issues on musl vs in gnu libc powered containers.

On Musl

Errors are popping up related to relocation issues and missing symbols:

/ # ldd /usr/local/lib/postgresql/pg_idkit.so
        /lib/ld-musl-aarch64.so.1 (0xe705980d9000)
        libgcc_s.so.1 => /usr/lib/libgcc_s.so.1 (0xe70597fe4000)
        libc.musl-x86_64.so.1 => /lib/ld-musl-aarch64.so.1 (0xe705980d9000)
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 7
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 7
... lots more
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
Error relocating /usr/local/lib/postgresql/pg_idkit.so: PostmasterContext: symbol not found
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
Error relocating /usr/local/lib/postgresql/pg_idkit.so: errstart: symbol not found
Error relocating /usr/local/lib/postgresql/pg_idkit.so: ErrorContext: symbol not found
Error relocating /usr/local/lib/postgresql/pg_idkit.so: unsupported relocation type 6
... lots more
Error relocating /usr/local/lib/postgresql/pg_idkit.so: FlushErrorState: symbol not found
Error relocating /usr/local/lib/postgresql/pg_idkit.so: make_timestamptz_at_timezone: symbol not found
Error relocating /usr/local/lib/postgresql/pg_idkit.so: GetDatabaseEncoding: symbol not found
Error relocating /usr/local/lib/postgresql/pg_idkit.so: TopTransactionContext: symbol not found

The musl variant should be a static lib to begin with...

On Glibc

Using the postgres:17-bullseye container, there are a couple issues:

• Expected directories for the packaged zip file are obviously quite different from musl (.control files in /usr/share/postgresql/17/extension/pg_idkit.control, shared lib should be under /usr/lib/postgresql/17/lib, zip needs to be unzipped to /usr, etc)
• shared object file not loading (when in the right place) -- ERROR: could not load library "/usr/lib/postgresql/17/lib/pg_idkit.so": /usr/lib/postgresql/17/lib/pg_idkit.so: cannot open shared object file: No such file or directory

The glibc variant looks to be a static lib:

root@3a34f40a5d34:/# file /usr/lib/postgresql/17/lib/pg_idkit.so
/usr/lib/postgresql/17/lib/pg_idkit.so: ELF 64-bit LSB shared object, x86-64, version 1 (SYSV), dynamically linked, BuildID[sha1]=06d82a885e2d86d2361bee4c400cf01a1dd75632, not stripped
root@3a34f40a5d34:/# ldd /usr/lib/postgresql/17/lib/pg_idkit.so
        not a dynamic executable

Path forward

It looks like the build may need to be reproduced & debugged locally from the builder images:

• ghcr.io/vadosware/pg_idkit/builder-musl:0.1.x
• ghcr.io/vadosware/pg_idkit/builder-gnu:0.1.x

While things build (and test!) fine, the artifacts are not pulling in enough shared libs (?) or failing for some other reason.

• Fix use issues for zipped release on musl-backed distros
• Fix use issues for zipped release on gnu-backed distros
• Add documentation for running from a released archive
• Update CI to test archive artifacts
• Update CI to test container artifacts

We may need to introduce something like xtask to make these tests a bit easier to write/execute -- manipulating CI YAML is slow and error-prone.

[t3hmrman]

Well, this was silly, it turns out that the released artifacts were working just fine -- it was an architecture problem -- we don't have aarch64 builds (yet), and I was trying to run the artifacts on my mac without rosetta/other x86 emulation turned on 😮‍💨

The CI is fine, but I'll add some checks on the artifacts in-band.