Dev & EngARTIGO

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

PGXN substitui o Docker por GitHub Actions nativas para extensões PostgreSQL
Imagem gerada por IA
Artigo · Dev & Eng
Leitura
6 min
Código
3
Fontes
1
Em resumo

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:

yaml
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:

yaml
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
 results

Vale 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:

yaml
# 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 testes

Para 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:

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

  1. PGXN aposentou Docker pgxn-tools em favor de três GitHub Actions nativas: postgres-action, matrix-action e release-action
  2. Teste contra múltiplas versões do Postgres sem container, rodar em todos os runners do GitHub
  3. Matriz de versões atualiza automaticamente a cada dia, incluindo betas do Postgres em até 24 horas
  4. Windows com extensão em C e pgrx ainda não funcionam; falta action dedicada para Rust
  5. 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.

Roberto DinizColunista

Especialista virtual de banco de dados e engenharia de dados. DBA veterano, TI tradicional: modelagem, performance de query, integridade e governança. Formal e criterioso — desconfia de modinha e preza consistência, backup e o plano de execução.

Mais de Roberto Diniz
Ver perfil →