Introduction
You may have noticed that a beta version of the pgsentinel extension (providing active session history for postgresql) is publicly available in this github repository.
We can rely on docker to facilitate and automate the testing of the extension on a particular postgreSQL version (has to be >= 10).
Let’s share a Dockerfile so that we can easly build a docker image for testing pgsentinel (on a postgreSQL version of our choice).
Description
The dockerfile used to provision a pgsentinel testing docker image:
- downloads the postgresql source code (version of your choice)
- compiles and installs it
- downloads the pgsentinel extension
- compiles and installs it
- compiles and installs the pg_stat_statements extension
Dockerfile github repository
The dockerfile is available in this github repository.
Usage
3 arguments can be used:
- PG_VERSION (default: 10.5)
- PG_ASH_SAMPLING (default: 1)
- PG_ASH_MAX_ENTRIES (default: 10000)
Example to build an image
Let’s build a pgsentinel testing docker image for postgreSQL version 11beta3:
[root@bdtdocker dockerfile]# docker build -t pgsentinel-testing -f Dockerfile-pgsentinel-testing --build-arg PG_VERSION=11beta3 --force-rm=true --no-cache=true .
Once done, let’s run a container
[root@bdtdocker dockerfile]# docker run -d -p 5432:5432 --name pgsentinel pgsentinel-testing
and verify that the pg_active_session_history view is available
[root@bdtdocker dockerfile]# docker exec -it pgsentinel psql -c "\d pg_active_session_history"
View "public.pg_active_session_history"
Column | Type | Collation | Nullable | Default
------------------+--------------------------+-----------+----------+---------
ash_time | timestamp with time zone | | |
datid | oid | | |
datname | text | | |
pid | integer | | |
usesysid | oid | | |
usename | text | | |
application_name | text | | |
client_addr | text | | |
client_hostname | text | | |
client_port | integer | | |
backend_start | timestamp with time zone | | |
xact_start | timestamp with time zone | | |
query_start | timestamp with time zone | | |
state_change | timestamp with time zone | | |
wait_event_type | text | | |
wait_event | text | | |
state | text | | |
backend_xid | xid | | |
backend_xmin | xid | | |
top_level_query | text | | |
query | text | | |
cmdtype | text | | |
queryid | bigint | | |
backend_type | text | | |
blockers | integer | | |
blockerpid | integer | | |
blocker_state | text | | |
So that we can now test the extension behavior on the postgreSQL version of our choice (11beta3 in this example).