PGXN substitui o Docker por GitHub Actions nativas para extensões PostgreSQL

- Leitura
- 6 min
- Código
- 3
- Fontes
- 1
David Wheeler, mantenedor do PGXN, aposentou o container Docker pgxn-tools e lançou três GitHub Actions que buildam, testam em múltiplas versões do Postgres e publicam extensões direto no registro.
Quem mantém uma extensão PostgreSQL↳PostgreSQL11 conteúdosPostgreSQL via SSL com GolangData · abr 20195 itens legais sobre data types do PostgreSQLData · mar 20195 serviços gratuitos na cloud para bancos de dados PostgresData · fev 2025Ver tudo em Data → e publica no PGXN (PostgreSQL Extension Network) conhece o pgxn/pgxn-tools: uma imagem Docker↳Docker46 conteúdosE o Docker Swarm? Contextos e motivadores diáriosDevSecOps · ago 2024Automatizando o ambiente de desenvolvimento e testes com DockerDevSecOps · mai 2019MySQL + Adminer + Docker Compose: montando rapidamente um ambiente para usoData · abr 2019Ver tudo em DevSecOps → que, por anos, foi o jeito padrão de rodar CI para esse tipo de projeto. David Wheeler, mantenedor do PGXN, acaba de aposentar essa abordagem em favor de três GitHub Actions nativas, mais leves e mantidas separadamente: pgxn/postgres-action, pgxn/matrix-action e pgxn/release-action.
O motivo da troca é direto. Segundo o próprio Wheeler:
Fiz três novas GitHub Actions nos últimos meses para substituir o já conhecido pgxn-tools baseado em Docker, que ficou inchado e exige mais trabalho de manutenção do que eu gostaria.
David Wheeler, mantenedor do PGXNI've made three new GitHub actions in the past few months to replace the venerable Docker-based pgxn/pgxn-tools, which has become bloated and requires more work to maintain than I'd like.
As novas actions exigem menos manutenção, rodam em todos os sistemas operacionais e arquiteturas suportados pelos runners do GitHub e executam mais rápido do que o container anterior. Para quem mantém extensão em C, PL/pgSQL ou qualquer linguagem compilável contra o Postgres, isso significa menos tempo de fila de CI e um workflow mais fácil de debugar quando algo quebra.
Publicar no PGXN em poucas linhas
O caso mais simples é o release. Com pgxn/release-action, o workflow de publicação cabe em poucas linhas:
name: 🚀 Release
on:
push:
jobs:
release:
name: Release on PGXN
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: pgxn/release-action@v0
with:
username: ${{ secrets.PGXN_USERNAME }}
password: ${{ secrets.PGXN_PASSWORD }}
dry-run: ${{ !startsWith(github.ref, 'refs/tags/v') }}A action usa git archive para montar o pacote PGXN e publicá-lo. A opção dry-run é o detalhe que evita acidente: ela só libera a publicação de verdade quando o push é de uma tag que começa com v; em qualquer outro push, o workflow roda em modo de teste. Quer excluir arquivos do pacote final, como os próprios workflows do GitHub? Basta configurar isso no .gitattributes.
A action também expõe o nome do arquivo gerado como saída, o que permite encadear um release no GitHub logo em seguida, usando a action softprops/action-gh-release e repassando o archive como anexo. Para quem quer changelog automático no corpo do release, Wheeler sugere manter um arquivo no formato Keep a Changelog e gerar o trecho correspondente com theory/changelog-version-notes-action, passado para a opção body_path do release do GitHub.
Testando contra várias versões do Postgres, sem contêiner
A parte mais substancial da mudança está em como testar a extensão contra múltiplas versões do Postgres. O projeto pg-hostname, citado por Wheeler como exemplo real, combina pgxn/matrix-action para gerar a matriz de versões e pgxn/postgres-action para subir cada instância de Postgres diretamente no runner, sem Docker:
name: ✅ CI
on: [push, pull_request]
jobs:
matrix:
name: 📋 Generate Matrix
runs-on: ubuntu-latest
outputs:
matrix: ${{ steps.matrix.outputs.matrix }}
steps:
- name: Generate Matrix
id: matrix
uses: pgxn/matrix-action@v0
with:
min-version: 9.0
beta: true
deprecated: true
no-os: windows
build:
needs: matrix
strategy:
fail-fast: false
matrix:
pg: ${{ fromJson(needs.matrix.outputs.matrix) }}
name: ${{ matrix.pg.emoji }} ${{ matrix.pg.os }}/${{ matrix.pg.arch }} 🐘 v${{ matrix.pg.version }}
runs-on: ${{ matrix.pg.runner }}
steps:
- uses: actions/checkout@v7
- uses: pgxn/postgres-action@v0
with: { version: \"${{ matrix.pg.version }}\" }
- run: make -j $(nproc)
- run: sudo make install
- run: make installcheck
id: test
- name: Show Diffs
if: failure() && steps.test.outcome == 'failure'
run: find . -name regression.diffs -exec cat {} +
- uses: actions/upload-artifact@v7
if: failure()
with:
name: regression-${{ matrix.pg.os }}-${{ matrix.pg.arch }}-pg${{ matrix.pg.version }}
path: |
regression.diffs
resultsVale entender cada parte. O job matrix chama pgxn/matrix-action com min-version: 9.0, incluindo versões beta e deprecated, e excluindo Windows (no-os: windows) porque o suporte a esse sistema ainda é parcial. O job build consome essa saída com fromJson() e dispara um runner por combinação de sistema operacional, arquitetura e versão do Postgres. A instância de Postgres sobe com pgxn/postgres-action, sem precisar de contêiner; o sudo em make install é necessário porque, nos runners Linux, o processo que roda o workflow não é dono da instalação do Postgres (nos demais sistemas, o sudo é inofensivo e pode ser ignorado).
Um detalhe operacional relevante: pgxn/matrix-action roda um workflow diário que atualiza a lista de configurações candidatas. Na prática, isso significa que uma extensão passa a ser testada contra a próxima versão do Postgres em até um dia após o primeiro release beta dela, a menos que o mantenedor defina um max-version para travar o teto.
O caso de shared_preload_libraries
Extensões que precisam entrar em shared_preload_libraries têm um problema de ordem: é preciso instalar o Postgres antes de poder compilar o módulo, mas o módulo só funciona com o Postgres já reiniciado carregando-o. A solução documentada por Wheeler é chamar pgxn/postgres-action duas vezes, a primeira com no-start: true:
# Instala mas não inicia o Postgres
- uses: pgxn/postgres-action@v0
with:
version: ${{ matrix.pg.version }}
no-start: true
# Builda e instala a extensão
- run: make -j $(nproc) && sudo make install
# Agora inicia o Postgres já com o módulo em shared_preload_libraries
- uses: pgxn/postgres-action@v0
with:
config: |
shared_preload_libraries = 'my_module'
# Segue com os testesPara quem mantém extensão em C que depende de pré-carregamento, esse é o padrão a copiar: ele resolve um problema que, com o pgxn-tools antigo, exigia gambiarras dentro da imagem Docker.
O que já funciona e o que ainda falta
Wheeler afirma usar as três actions há alguns meses em extensões reais, entre elas semver, pg_clickhouse, chdb e hostname (o pg-hostname citado acima). Isso dá algum lastro de produção ao conjunto, mas ele próprio lista pendências abertas:
- Suporte a Windows ainda é incompleto:
pgxn/postgres-actiontesta com sucesso uma extensão só em SQL nas versões 17 e 18 do Postgres, mas falha em versões anteriores por um problema de path; extensões em C simplesmente não funcionam no Windows ainda. Wheeler não sabe se o ajuste é nos binários EDB para Windows instalados via Chocolatey ou em configuração adicional das actions, e pediu ajuda da comunidade. - Falta uma action para pgrx: o framework que permite escrever extensões Postgres em Rust↳Rust7 conteúdosDesmistificando Rust: a linguagem segura e rápida que você precisa conhecerDev (Back & Front) · out 2024Como criar seu primeiro Programa em Rust com Solana PlaygroundDev (Back & Front) · mai 2026Rust no ranking: a segurança de memória perdeu a guerra corporativa?Marketing Tech · abr 2026Ver tudo em Dev (Back & Front) → ainda não tem uma action dedicada; Wheeler planeja criar uma, separada das demais, nos próximos meses.
O que muda para quem mantém extensão
Para quem já tinha workflow baseado no pgxn/pgxn-tools, a migração compensa principalmente em três pontos: tempo de execução (sem a sobrecarga de subir um contêiner Docker a cada job), cobertura de plataforma (arquiteturas e sistemas operacionais nativos do runner, não só o que cabia na imagem) e atualização automática da matriz de versões suportadas. O custo é reescrever os workflows existentes nesse novo formato declarativo, e aceitar, por ora, que Windows com extensão em C e pgrx ficam de fora.
Quem quiser testar pode partir do próprio repositório pg-hostname, usado como exemplo na publicação original de Wheeler, ou acompanhar os repositórios pgxn/postgres-action, pgxn/matrix-action e pgxn/release-action no GitHub para ver a documentação completa de cada opção, incluindo beta, deprecated, no-os e max-version na matriz.
Fonte: Planet PostgreSQL
Highlights
- PGXN aposentou Docker pgxn-tools em favor de três GitHub Actions nativas: postgres-action, matrix-action e release-action
- Teste contra múltiplas versões do Postgres sem container, rodar em todos os runners do GitHub
- Matriz de versões atualiza automaticamente a cada dia, incluindo betas do Postgres em até 24 horas
- Windows com extensão em C e pgrx ainda não funcionam; falta action dedicada para Rust
- Wheeler mantém as actions em produção em semver, pg_clickhouse, chdb e hostname desde alguns meses
Este artigo foi escrito por Roberto Diniz, colunista de banco de dados. Conteúdo produzido por agente de IA da redação iMasters, sob revisão editorial humana. Saiba como produzimos no expediente.
Postgres 18.7 corrige 52 CVEs, incluindo falha grave de confusão de tipos
As versões 18.7, 17.12, 16.16, 15.20 e 14.25, liberadas hoje, fecham 52 vulnerabilidades. O destaque é a CVE-2026-6460, que explora mudanças de tipo de coluna para executar código arbitrário.













