Deployment How-To

This guide describes how to create a GOATS release, build Conda packages, and publish them for installation via GitHub Pages.

Release Strategy

GOATS uses CalVer (calendar versioning), since it is an application that depends on evolving external systems. We prioritize compatibility with current systems rather than strict backward compatibility with older versions of GOATS.

Version Format

  • Format: YY.MM.PATCH (e.g., 25.6.0 for the first release of June 2025)

  • Add rcN suffix for release candidates (e.g., 25.6.0rc1)

  • Increment the patch version for subsequent releases within the same month (e.g., 27.12.4)

Creating a GitHub Release

  1. Choose a tag version to release (see version format above).

  2. Navigate to the GOATS GitHub repository.

  3. Click the Actions tab.

  4. Find the Build Release workflow and click it.

  5. Click the Run Workflow button.

  6. Fill out the version tag and any other required fields, then click Run Workflow.

The release will be created automatically in a few minutes, along with release notes and a GitHub release tag.

Preparing Conda Feedstock

  1. Clone the goats-infra repository:

    git clone https://github.com/gemini-hlsw/goats-infra.git
cd goats-infra

  2. Run the release SHA script to retrieve the version and checksum:

    python get_release_sha.py

  3. Open goats-feedstock/recipe/meta.yaml and update:

    • {% set version - "..." %} to the release version.

    • source.sha256 to the generated SHA256 value.

  4. Commit and push the changes:

    git add .
git commit -m "Update version to VERSION"
git push origin main

Building Conda Packages

  1. Go to the goats-infra Actions page.

  2. Select the Conda Build workflow.

  3. Click Run Workflow and wait for the job to finish.

After completion, two artifacts will be available:

  • Linux--X64.zip

  • macOS--X64.zip

Download and unzip both files.

  1. Copy the .conda packages to the correct folders in your local GOATS repo:

    cp Linux--X64/linux-64/*.conda goats/docs/gh_pages/conda/linux-64/
cp macOS--X64/osx-64/*.conda goats/docs/gh_pages/conda/osx-64/

  2. Rebuild the Conda channel index:

    conda index docs/gh_pages/conda --channeldata

  3. Commit and push the updated channel data:

    git add docs/gh_pages/conda
git commit -m "Add Conda packages for VERSION."
git push origin BRANCH_NAME

  4. Merge your pull request. GitHub Pages will automatically deploy the updated Conda channel.

Installing the Release

Once the package is deployed, install it using:

conda install -c https://gemini-hlsw.github.io/goats/conda goats