# Custom Container Images

This repository builds a small set of OCI/container images published at
`git.ajpanton.se`.

The images are intended to stay close to their upstream base images while adding
a few commonly useful database/runtime extensions.

## Images

| Image | Description |
| --- | --- |
| `git.ajpanton.se/ajp_anton/postgres-custom:18` | PostgreSQL 18 with selected extension packages installed and `pg_cron`/VectorChord preloaded. |
| `git.ajpanton.se/ajp_anton/php8-pgsql:8` | PHP 8 FPM on Alpine with PostgreSQL client runtime support and the `pdo_pgsql` PHP extension enabled. |

## Included Components

### `postgres-custom`

Base image:

- `postgres:18`
- Moving upstream major-version tag. Patch releases are picked up when the image
  is rebuilt.

Installed from Debian/PostgreSQL apt repositories:

- `ca-certificates`
- `wget`
- `postgresql-18-cron`
- `postgresql-18-pgvector`
- `postgresql-18-postgis-3`

Installed from a GitHub release asset:

- VectorChord package `postgresql-18-vchord_0.5.3-1_amd64.deb`
- VectorChord is pinned to `0.5.3` at this time.

Runtime defaults added by this image:

- `shared_preload_libraries=pg_cron,vchord`
- `cron.database_name=firecrawl`

### `php8-pgsql`

Base image:

- `php:8-fpm-alpine`
- Moving upstream major-version tag. Patch releases are picked up when the image
  is rebuilt.

Build-time package:

- `postgresql-dev`

Runtime package:

- `libpq`

Compiled PHP extension:

- `pdo_pgsql`

The compiled extension and PHP config are copied from a build stage into the
final runtime image.

## Tags

Moving deployment tags:

- `git.ajpanton.se/ajp_anton/postgres-custom:18`
- `git.ajpanton.se/ajp_anton/php8-pgsql:8`

Descriptive tags:

- `git.ajpanton.se/ajp_anton/postgres-custom:18-postgis3-vchord0.5.3`
- `git.ajpanton.se/ajp_anton/php8-pgsql:8-fpm-alpine`

Convenience tags:

- `git.ajpanton.se/ajp_anton/postgres-custom:latest`
- `git.ajpanton.se/ajp_anton/php8-pgsql:latest`

Tags are mutable. The digest behind a tag may change after a rebuild even when
the tag name stays the same.

## Update Cadence

Images are rebuilt weekly. They may also be rebuilt after repository changes or
manual runs.

Each rebuild pulls the current upstream base image and installs the currently
available apt/apk packages. If the base image or repository packages changed,
the resulting image digest changes and the same tag points to the new image.

Pinned build inputs do not update automatically. In this repository, VectorChord
is pinned to `0.5.3`; changing it requires a repository update.