<?xml version="1.0" encoding="UTF-8" standalone="yes"?><feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-us"><id>https://blog.pgxn.org/tags/postgres/</id><title>Postgres</title><updated>2026-11-16T20:14:17Z</updated><link rel="self" type="application/atom+xml" href="https://blog.pgxn.org/tags/postgres/feed.xml"/><link rel="alternate" type="text/html" href="https://blog.pgxn.org/tags/postgres/"/><author><name>The PGXN Maintainers</name></author><generator uri="https://gohugo.io/" version="0.167.0">Hugo</generator><entry><id>https://blog.pgxn.org/2026/github-actions/</id><title type="html">Build, Test and Release Extensions with the New PGXN GitHub Actions</title><link rel="alternate" type="text/html" href="https://blog.pgxn.org/2026/github-actions/"/><updated>2026-11-16T20:14:32Z</updated><published>2026-11-16T20:14:17Z</published><author><name>David E. Wheeler</name></author><category scheme="https://blog.pgxn.org/tags" term="github-actions" label="GitHub Actions"/><category scheme="https://blog.pgxn.org/tags" term="postgres" label="Postgres"/><category scheme="https://blog.pgxn.org/tags" term="matrix" label="Matrix"/><category scheme="https://blog.pgxn.org/tags" term="release" label="Release"/><category scheme="https://blog.pgxn.org/tags" term="workflow" label="Workflow"/><summary type="html">Introducing three new GitHub actions for more efficient, multi-platform
testing of extensions on a variety of Postgres versions. Release, too!</summary><content type="html" xml:base="https://blog.pgxn.org/" xml:space="preserve"><![CDATA[<p>I&rsquo;ve made three new GitHub actions in the past few months to replace the
venerable Docker-based <a href="https://github.com/pgxn/docker-pgxn-tools" title="Test image for PostgreSQL &amp; PGXN extensions">pgxn/pgxn-tools</a>, which has become bloated and
requires more work to maintain than I&rsquo;d like. The new actions require much
less maintenance, support all GitHub runner OSes and architectures, and run
more quickly. What they do:</p>
<ul>
<li><a href="https://github.com/pgxn/postgres-action/" title="Install, configure, and start a local Postgres cluster">pgxn/postgres-action</a> starts a local, specific version of Postgres server</li>
<li><a href="https://github.com/pgxn/matrix-action/" title="Generate a matrix of Postgres versions on Workflow OSes and architectures">pgxn/matrix-action</a> generates a matrix of Postgres versions to test</li>
<li><a href="https://github.com/pgxn/release-action/" title="Release a source code package on PGXN">pgxn/release-action</a> releases an extension on PGXN</li>
</ul>
<h2 id="make-a-release">Make a Release</h2>
<p>Starting simple, here&rsquo;s how to use the release action:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">🚀 Release</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">on</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">push</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">jobs</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">release</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Release on PGXN</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l">ubuntu-latest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">steps</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/checkout@v7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn/release-action@v0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">username</span><span class="p">:</span><span class="w"> </span><span class="l">${{ secrets.PGXN_USERNAME }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">password</span><span class="p">:</span><span class="w"> </span><span class="l">${{ secrets.PGXN_PASSWORD }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">dry-run</span><span class="p">:</span><span class="w"> </span><span class="l">${{ !startsWith( github.ref, &#39;refs/tags/v&#39; ) }}</span><span class="w">
</span></span></span></code></pre></div><p>Yep, that&rsquo;s it. The <a href="https://github.com/pgxn/release-action/" title="Release a source code package on PGXN">pgxn/release-action</a> action will use <code>git archive</code> to
create a PGXN bundle and release it on PGXN. (Want to omit some files, such as
GitHub workflows, from the release? <a href="https://justatheory.com/2025/05/release-on-pgxn/#exclude-files-from-release" title="Auto-Release PostgreSQL Extensions on PGXN: Exclude Files from Release">Use gitattributes</a> to exclude them!) The
value passed for the <code>dry-run</code> option prevents publishing the bundle on PGXN
except when pushing a Git tag starting with <code>v</code>.</p>
<p>The action also outputs the <code>archive</code> name, so you can use it elsewhere, such
as a GitHub release on the last line of this workflow:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">🚀 Release</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">on</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">push</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">jobs</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">release</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Release on GitHub and PGXN</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l">ubuntu-latest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">steps</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Check out the repo</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/checkout@v7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Release on PGXN</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn/release-action@v0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">username</span><span class="p">:</span><span class="w"> </span><span class="l">${{ secrets.PGXN_USERNAME }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">password</span><span class="p">:</span><span class="w"> </span><span class="l">${{ secrets.PGXN_PASSWORD }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">dry-run</span><span class="p">:</span><span class="w"> </span><span class="l">${{ !startsWith( github.ref, &#39;refs/tags/v&#39; ) }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Create GitHub Release</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">softprops/action-gh-release@v3</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">if</span><span class="p">:</span><span class="w"> </span><span class="l">startsWith( github.ref, &#39;refs/tags/v&#39; )</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">env</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">GITHUB_TOKEN</span><span class="p">:</span><span class="w"> </span><span class="l">${{ secrets.GITHUB_TOKEN }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Release ${{ github.ref_name }}&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">files</span><span class="p">:</span><span class="w"> </span><span class="l">${{ steps.pgxn.outputs.archive }}</span><span class="w">
</span></span></span></code></pre></div><p>It again checks <code>github.ref</code> to only release on a tag starting with <code>v</code>. Then
it includes the <code>archive</code> output from the <code>pgxn</code> step in the release. Simple,
right? Want to include a changelog in the release? Consider using a <a href="https://keepachangelog.com/en/1.1.0/">Keep a
Changelog</a> file and <a href="https://github.com/theory/changelog-version-notes-action" title="Extract Changelog Release Notes">theory/changelog-version-notes-action</a> to generate a file
to pass to the <a href="https://github.com/softprops/action-gh-release" title="GitHub Action for creating GitHub Releases">softprops/action-gh-release</a> <code>body_path</code> option.</p>
<h2 id="test-supported-versions--platforms">Test Supported Versions &amp; Platforms</h2>
<p>This example, <a href="https://github.com/theory/pg-hostname/pull/2" title="theory/pg-hostname#2 Use new PGXN actions">from pg-hostname</a>, uses the <a href="https://github.com/pgxn/matrix-action/" title="Generate a matrix of Postgres versions on Workflow OSes and architectures">pgxn/matrix-action</a> action to
generate the test matrix, and <a href="https://github.com/pgxn/postgres-action/" title="Install, configure, and start a local Postgres cluster">pgxn/postgres-action</a> to start Postgres. Then
it builds and tests the extension:</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span><span class="lnt">16
</span><span class="lnt">17
</span><span class="lnt">18
</span><span class="lnt">19
</span><span class="lnt">20
</span><span class="lnt">21
</span><span class="lnt">22
</span><span class="lnt">23
</span><span class="lnt">24
</span><span class="lnt">25
</span><span class="lnt">26
</span><span class="lnt">27
</span><span class="lnt">28
</span><span class="lnt">29
</span><span class="lnt">30
</span><span class="lnt">31
</span><span class="lnt">32
</span><span class="lnt">33
</span><span class="lnt">34
</span><span class="lnt">35
</span><span class="lnt">36
</span><span class="lnt">37
</span><span class="lnt">38
</span><span class="lnt">39
</span><span class="lnt">40
</span><span class="lnt">41
</span><span class="lnt">42
</span><span class="lnt">43
</span><span class="lnt">44
</span><span class="lnt">45
</span><span class="lnt">46
</span><span class="lnt">47
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">✅ CI</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">on</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">push</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">defaults</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span>{<span class="w"> </span><span class="nt">shell</span><span class="p">:</span><span class="w"> </span><span class="l">bash }</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">jobs</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">matrix</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">📋 Generate Matrix</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l">ubuntu-latest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">outputs</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">matrix</span><span class="p">:</span><span class="w"> </span><span class="l">${{ steps.matrix.outputs.matrix }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">steps</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Generate Matrix</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l">matrix</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn/matrix-action@v0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">min-version</span><span class="p">:</span><span class="w"> </span><span class="m">9.0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">beta</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">deprecated</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">no-os</span><span class="p">:</span><span class="w"> </span><span class="l">windows</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">build</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">needs</span><span class="p">:</span><span class="w"> </span><span class="l">matrix</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">strategy</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">fail-fast</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">matrix</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">pg</span><span class="p">:</span><span class="w"> </span><span class="l">${{ fromJson(needs.matrix.outputs.matrix) }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">${{ matrix.pg.emoji }} ${{ matrix.pg.os }}/${{ matrix.pg.arch }} 🐘 v${{ matrix.pg.version }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l">${{ matrix.pg.runner }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">steps</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/checkout@v7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn/postgres-action@v0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w"> </span>{<span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;${{ matrix.pg.version }}&#34;</span><span class="w"> </span>}<span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">make -j $(nproc)</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">sudo make install</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">make installcheck</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l">test</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Show Diffs</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">if</span><span class="p">:</span><span class="w"> </span><span class="l">failure() &amp;&amp; steps.test.outcome == &#39;failure&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">find . -name regression.diffs -exec cat {} +</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/upload-artifact@v7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">if</span><span class="p">:</span><span class="w"> </span><span class="l">failure() &amp;&amp; steps.test.outcome == &#39;failure&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">regression-${{ matrix.pg.os }}-${{ matrix.pg.arch }}-pg${{ matrix.pg.version }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="p">|</span><span class="sd">
</span></span></span><span class="line"><span class="cl"><span class="sd">            regression.diffs
</span></span></span><span class="line"><span class="cl"><span class="sd">            results</span><span class="w">
</span></span></span></code></pre></td></tr></table>
</div>
</div><figure class="float-right quarter"><img src="/2026/github-actions/jobs.png"
			alt="Screenshot of list of passing GitHub Workflow jobs for a variety of OSes, architectures, and Postgres versions."><figcaption>
			<p>Workout.</p>
		</figcaption>
</figure>
<p>The resulting output resembles the image on to the right.</p>
<p>I admit it seems like a lot; let&rsquo;s break it down:</p>
<ul>
<li>The <code>matrix</code> job starting on line 7 generates the test matrix
<ul>
<li>Lines 10-11 define the output for the matrix</li>
<li>Lines 13-20 use <a href="https://github.com/pgxn/matrix-action/" title="Generate a matrix of Postgres versions on Workflow OSes and architectures">pgxn/matrix-action</a> to generate the matrix</li>
<li>The options on line 17-20 set the minimum Postgres version to 9.0,
allow the inclusion of beta and deprecated releases (e.g, those
provided by but deprecated by the packager), and exclude <code>windows</code></li>
</ul>
</li>
<li>The <code>build</code> job starting on line 22 builds and tests the extension
<ul>
<li>Line 23 requires that the <code>matrix</code> job finish before this one starts</li>
<li>Line 27 generates the <code>pg</code> matrix, using <code>fromJson()</code> to extract the
output of the <code>matrix</code> job</li>
<li>Various matrix fields construct the <code>name</code> on line 28</li>
<li>Line 29 specifies the runner provided by the matrix</li>
<li>Lines 32-33 use the <a href="https://github.com/pgxn/postgres-action/" title="Install, configure, and start a local Postgres cluster">pgxn/postgres-action</a> to start the
matrix-specified version of Postgres on the runner &mdash; no more Docker
container!</li>
<li>Lines 34-37 define the typical <a href="https://www.postgresql.org/docs/current/extend-pgxs.html" title="PostgreSQL Docs: Extension Building Infrastructure">PGXS</a> pattern to build and test the
extension; note the use of <code>sudo</code> to install the extension, required
because the Linux runner does not own the Postgres install (and is
harmless on other OSes)</li>
<li>The <code>Show Diffs</code> step starting on line 38 shows the contents of
<code>regression.diffs</code> if the test failed</li>
<li>And the upload action from line 41 on upload <code>regression.diffs</code> and
the test result files if the test failed</li>
</ul>
</li>
</ul>
<p>A daily <a href="https://github.com/pgxn/matrix-action/" title="Generate a matrix of Postgres versions on Workflow OSes and architectures">pgxn/matrix-action</a> workflow updates its <a href="https://github.com/pgxn/matrix-action/blob/main/platforms.json">list of all candidate
configurations</a>, so it should always be up-to date.
Practically that means you automatically start testing the next Postgres
version within a day of its first beta release, unless you set <code>max-version</code>.</p>
<h2 id="install-build-then-start">Install, Build, Then Start</h2>
<p>The <a href="https://github.com/pgxn/matrix-action/" title="Generate a matrix of Postgres versions on Workflow OSes and architectures">pgxn/matrix-action</a> and <a href="https://github.com/pgxn/postgres-action/" title="Install, configure, and start a local Postgres cluster">pgxn/postgres-action</a> actions feature a number
of input options to define the runners, Postgres versions, and various
configurations.</p>
<p>Let&rsquo;s say that your extension requires loading a module in
<a href="https://www.postgresql.org/docs/18/runtime-config-client.html#GUC-SHARED-PRELOAD-LIBRARIES"><code>shared_preload_libraries</code></a>, but you have to install Postgres to build the
module first. Use <code>no-start</code> to install but not start Postgres, then build the
extension, and finally use <a href="https://github.com/pgxn/postgres-action/" title="Install, configure, and start a local Postgres cluster">pgxn/postgres-action</a> again with the desired
configuration:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># Install but don&#39;t start Postgres</span><span class="w">
</span></span></span><span class="line"><span class="cl">- <span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn/postgres-action@v0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="l">${{ matrix.pg.version }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">no-start</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># Build and install the extension.</span><span class="w">
</span></span></span><span class="line"><span class="cl">- <span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">make -j $(nproc) &amp;&amp; sudo make install</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># Now start Postgres with the module in shared_preload_libraries</span><span class="w">
</span></span></span><span class="line"><span class="cl">- <span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">pgxn/postgres-action@v0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="l">${{ matrix.pg.version }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">config</span><span class="p">:</span><span class="w"> </span><span class="p">|</span><span class="sd">
</span></span></span><span class="line"><span class="cl"><span class="sd">      shared_preload_libraries = &#39;my_module&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># Continue testing</span><span class="w">
</span></span></span><span class="line"><span class="cl">- <span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">make installcheck</span><span class="w">
</span></span></span></code></pre></div><h2 id="to-dos">To Dos</h2>
<p>I&rsquo;ve been using these actions for a few months with a variety of extensions.
Some examples:</p>
<ul>
<li><a href="https://github.com/theory/pg-semver/actions">semver</a></li>
<li><a href="https://github.com/ClickHouse/pg_clickhouse/actions">pg_clickhouse</a></li>
<li><a href="https://github.com/ClickHouse/pg_chdb/actions">chdb</a></li>
<li><a href="https://github.com/theory/pg-hostname/actions">hostname</a></li>
</ul>
<p>But there remain a few things left to do:</p>
<ul>
<li>Proper Windows support. The <a href="https://github.com/pgxn/postgres-action/actions/runs/41246481078">pgxn/postgres-action workflow</a> successfully
tests a SQL-only extension on Windows Postgres 17-18, but not earlier
versions due to a <a href="https://github.com/EnterpriseDB/edb-installers/issues/719" title="EnterpriseDB/edb-installers#719 pg_config --pgxs outputs long windows path &lt; Postgres 17">path issue</a>. C extensions simply don&rsquo;t work at all. I&rsquo;m
not sure whether the EDB Windows Postgres binaries installed by
<a href="https://community.chocolatey.org/packages/postgresql" title="Chocolatey PostgreSQL">Chocolatey</a> need adjusting or if the issues can be fixed by further
configuration. Help wanted!</li>
<li>I&rsquo;d like to add a <a href="https://github.com/pgcentralfoundation/pgrx" title="Build Postgres Extensions with Rust!">pgrx</a> action, probably separate from the others. I&rsquo;ll
likely get to it sometime in the next few months unless someone beats me
to it.</li>
</ul>
<h2 id="thanks--enjoy">Thanks &amp; Enjoy</h2>
<p>Thanks for reading, I hope you find the new actions useful.</p>
<p>Props to <a href="https://peter.eisentraut.org">Peter Eisentraut</a> for demonstrating the use of the <a href="https://wiki.postgresql.org/wiki/Apt" title="PostgreSQL packages for Debian and Ubuntu">PGDG Apt</a> repo
for starting Postgres on Linux runners, to the
<a href="https://github.com/ikalnytskyi/action-setup-postgres/" title="Setup a PostgreSQL for Linux, macOS and Windows runner machines">ikalnytskyi/action-setup-postgres</a> action for how to install and start
Postgres on macOS and Windows runners, and to Apt maintainer <a href="https://www.df7cb.de">Christoph Berg</a>
for patiently answering my questions about starting and running Postgres on
Linux.</p>
]]></content></entry></feed>