Publish main release instead of nightly

Author: allnes

.github/workflows/nightly-openmpi.yml .github/workflows/main-openmpi.yml.github/workflows/nightly-openmpi.yml renamed to .github/workflows/main-openmpi.yml

@@ -1,9 +1,10 @@
-name: Nightly Open MPI Extensions
+name: Main Open MPI Extensions
 
 on:
   workflow_dispatch:
-  schedule:
-    - cron: "37 2 * * *"
+  pull_request:
+    branches:
+      - main
   push:
     branches:
       - main
@@ -140,8 +141,11 @@ jobs:
         if: always()
         run: ccache -s
 
-  publish-nightly:
-    name: Publish nightly pre-release
+  publish-main:
+    name: Publish main pre-release
+    if: >-
+      (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+      (github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main')
     needs: build
     runs-on: ubuntu-24.04
 
@@ -155,33 +159,33 @@ jobs:
           path: _release_assets
           merge-multiple: true
 
-      - name: Replace nightly release assets
+      - name: Replace main release assets
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
           set -euo pipefail
           test -n "$(find _release_assets -maxdepth 1 -type f -print -quit)"
 
-          git tag -f nightly "$GITHUB_SHA"
-          git push origin refs/tags/nightly --force
+          git tag -f main "$GITHUB_SHA"
+          git push origin refs/tags/main --force
 
-          notes="Moving nightly Open MPI binary packages for parallel_programming_course. This release is replaced by every scheduled or manual run."
-          if gh release view nightly >/dev/null 2>&1; then
-            gh release edit nightly \
-              --title "Nightly Open MPI Extensions" \
+          notes="Moving main-branch Open MPI binary packages for parallel_programming_course. This release is replaced after every successful main build."
+          if gh release view main >/dev/null 2>&1; then
+            gh release edit main \
+              --title "Main Open MPI Extensions" \
               --notes "$notes" \
               --prerelease \
               --latest=false
-            mapfile -t old_assets < <(gh release view nightly --json assets --jq '.assets[].name')
+            mapfile -t old_assets < <(gh release view main --json assets --jq '.assets[].name')
             for asset in "${old_assets[@]}"; do
-              gh release delete-asset nightly "$asset" -y
+              gh release delete-asset main "$asset" -y
             done
           else
-            gh release create nightly \
-              --title "Nightly Open MPI Extensions" \
+            gh release create main \
+              --title "Main Open MPI Extensions" \
               --notes "$notes" \
               --prerelease \
               --latest=false
           fi
 
-          gh release upload nightly _release_assets/* --clobber
+          gh release upload main _release_assets/* --clobber

README.md

@@ -6,9 +6,10 @@ The packages are built from pinned git submodules and are intended for rootless
 CI use: download, extract, and pass the unpacked package prefix to the course
 CMake configure step.
 
-This repository publishes only one public binary channel: the moving `nightly`
-pre-release named `Nightly Open MPI Extensions`. Stable versioned releases are
-not supported here.
+This repository publishes only one public binary channel: the moving `main`
+pre-release named `Main Open MPI Extensions`. It is replaced only after
+successful builds from the `main` branch. Stable versioned releases and
+scheduled nightly releases are not supported here.
 
 ## Source Pins
 
@@ -35,9 +36,9 @@ MPI and Sandia OpenSHMEM/SOS for SHMEM. SOS is built against the package's Open
 MPI PMIx/hwloc install and libfabric/OFI, then packaged with the needed runtime
 libraries for rootless CI use.
 
-## Nightly assets
+## Main Assets
 
-The workflow publishes these archive assets to the `nightly` pre-release:
+The workflow publishes these archive assets to the `main` pre-release:
 
 - `mpi-extensions-openmpi-v5.0.10-linux-x86_64.tar.gz`
 - `mpi-extensions-openmpi-v5.0.10-macos-arm64.tar.gz`
@@ -50,18 +51,18 @@ Each archive is uploaded with:
 Archives unpack under a single top-level directory and contain `bin/`, `lib/`,
 `include/`, `share/`, `manifest.json`, and `LICENSES/`.
 
-## Install from the nightly release
+## Install From The Main Release
 
 For local use from this repository:
 
 ```bash
-./scripts/install_from_nightly_release.py \
+./scripts/install_from_main_release.py \
   --repo learning-process/mpi-extensions \
   --platform auto \
   --prefix "$PWD/_deps/mpi-extensions-openmpi"
 ```
 
-The installer downloads only the `nightly` pre-release, verifies the SHA256
+The installer downloads only the `main` pre-release, verifies the SHA256
 checksum, extracts into the requested prefix, and prints environment values for
 manual debugging.
 
@@ -70,7 +71,7 @@ installer script directly from this repository:
 
 ```bash
 curl -fsSL \
-  https://raw.githubusercontent.com/learning-process/mpi-extensions/main/scripts/install_from_nightly_release.py \
+  https://raw.githubusercontent.com/learning-process/mpi-extensions/main/scripts/install_from_main_release.py \
   -o /tmp/install_mpi_extensions.py
 python3 /tmp/install_mpi_extensions.py \
   --repo learning-process/mpi-extensions \
@@ -178,11 +179,12 @@ a stable tag or explicit commit, never a floating branch.
 
 ## Workflow
 
-`.github/workflows/nightly-openmpi.yml` supports:
+`.github/workflows/main-openmpi.yml` supports:
 
 - `workflow_dispatch`
-- nightly schedule at `02:37 UTC`
+- pull request validation targeting `main`
 - push builds on `main`
 
-Pushes to `main`, scheduled runs, and manual runs replace the assets in the same
-`nightly` pre-release after successful builds.
+Pull requests build and validate packages but do not publish. Pushes to `main`
+replace the assets in the same `main` pre-release after successful builds. A
+manual run from the `main` branch follows the same publish path.

docs/parallel_programming_course_integration.md

@@ -5,11 +5,12 @@ supplier only. Do not install Homebrew or apt Open MPI in the course CI job.
 
 ## GitHub Actions usage
 
-Install the current nightly package before configuring the course build:
+Install the current `main` pre-release package before configuring the course
+build:
 
 ```bash
 curl -fsSL \
-  https://raw.githubusercontent.com/learning-process/mpi-extensions/main/scripts/install_from_nightly_release.py \
+  https://raw.githubusercontent.com/learning-process/mpi-extensions/main/scripts/install_from_main_release.py \
   -o /tmp/install_mpi_extensions.py
 python3 /tmp/install_mpi_extensions.py \
   --repo learning-process/mpi-extensions \
@@ -37,8 +38,9 @@ packages provide MPI through Open MPI and SHMEM through Sandia OpenSHMEM/SOS
 built against the same Open MPI PMIx/hwloc prefix and libfabric/OFI. macOS
 packages are also validated with two-rank MPI and SHMEM C smoke tests.
 
-## Nightly channel
+## Main Channel
 
-Only the `nightly` pre-release is public. Scheduled and manual workflow runs
-replace assets in that same release, including the archive, SHA256 checksum,
-and JSON manifest for every platform.
+Only the moving `main` pre-release is public. Pull requests validate package
+builds but do not publish. Successful builds from the `main` branch replace
+assets in that same release, including the archive, SHA256 checksum, and JSON
+manifest for every platform.

scripts/install_from_nightly_release.py scripts/install_from_main_release.pyscripts/install_from_nightly_release.py renamed to scripts/install_from_main_release.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Install the current nightly Open MPI package from GitHub Releases."""
+"""Install the current main Open MPI package from GitHub Releases."""
 
 from __future__ import annotations
 
@@ -13,6 +13,8 @@
 import tempfile
 from pathlib import Path, PurePosixPath
 
+RELEASE_TAG = "main"
+
 try:
     import requests
 except ImportError as exc:  # pragma: no cover - depends on caller environment
@@ -83,7 +85,7 @@ def github_session() -> requests.Session:
         {
             "Accept": "application/vnd.github+json",
             "X-GitHub-Api-Version": "2022-11-28",
-            "User-Agent": "mpi-extensions-nightly-installer",
+            "User-Agent": "mpi-extensions-main-installer",
         }
     )
     token = os.environ.get("GITHUB_TOKEN")
@@ -95,7 +97,7 @@ def github_session() -> requests.Session:
 def request_json(session: requests.Session, url: str) -> dict[str, object]:
     response = session.get(url, timeout=60)
     if response.status_code == 404:
-        die(f"nightly pre-release not found at {url}")
+        die(f"main pre-release not found at {url}")
     response.raise_for_status()
     return response.json()
 
@@ -154,14 +156,14 @@ def validate_archive_link(
 
 
 def select_assets(release: dict[str, object], platform: str) -> tuple[dict[str, object], dict[str, object], dict[str, object]]:
-    if release.get("tag_name") != "nightly":
-        die("release tag is not nightly")
+    if release.get("tag_name") != RELEASE_TAG:
+        die(f"release tag is not {RELEASE_TAG}")
     if not release.get("prerelease", False):
-        die("nightly release is not marked as a prerelease")
+        die("main release is not marked as a prerelease")
 
     assets = release.get("assets")
     if not isinstance(assets, list):
-        die("nightly release metadata does not contain assets")
+        die("main release metadata does not contain assets")
 
     archive = None
     for asset in assets:
@@ -170,7 +172,7 @@ def select_assets(release: dict[str, object], platform: str) -> tuple[dict[str,
             archive = asset
             break
     if archive is None:
-        die(f"no nightly archive asset found for platform {platform}")
+        die(f"no main archive asset found for platform {platform}")
 
     by_name = {str(asset.get("name", "")): asset for asset in assets}
     checksum = by_name.get(f"{archive['name']}.sha256")
@@ -230,7 +232,7 @@ def main() -> int:
     platform = detect_platform() if args.platform == "auto" else args.platform
     prefix = Path(args.prefix).expanduser().resolve()
     session = github_session()
-    release_url = f"https://api.github.com/repos/{args.repo}/releases/tags/nightly"
+    release_url = f"https://api.github.com/repos/{args.repo}/releases/tags/{RELEASE_TAG}"
     release = request_json(session, release_url)
     archive_asset, checksum_asset, manifest_asset = select_assets(release, platform)