Skip to content

Release process

Steps

  1. Plan the release — this is done in Basecamp and GitHub milestones
  2. Cut the release
  3. QA the release and write the release notes
  4. Publish the release
  5. Update our servers
  6. Announce the release

Prerequisites

Some of the commands within our release process require you to have the following utilities installed.

  • buildx

    Depending on how you installed Docker, you may already have this. Verify with:

    docker buildx version
    

    Your version of buildx needs to contain the “cloud driver”. We think buildx 0.12.1 or newer should suffice. You may need to install Docker 25.0.3 or newer to get this version of buildx.

  • Create a local instance of our cloud driver:

    docker buildx create --driver cloud mathesar/release-builder
    

    This will create a Docker container on your system. You’ll need to do this step again if you delete that container at some point.

  • gh (aka the GitHub CLI)

    Verify with:

    gh --version