ethernet
27636cf422
Restructure tek's two-job desktop-windows-e2e.yml into the shape the linux axis already has: install-e2e.yml keeps its update/installer routes untouched and windows-desktop returns as a route in the same family, calling a reusable install-e2e-windows-run.yml. Behind that route is now ONLY the real user flow - the headless contract job (install.ps1 at HEAD~1, desktop-update.ps1 -NoUi, BASE/CURRENT/NEXT ref dance) is gone, along with its driver. Every leg goes through a surface a user touches: website Hermes-Setup.exe headed with AutoHotkey clicking Install -> Launch, then the installed Hermes.exe under Playwright's Electron driver clicking Settings -> About -> 'Update now', through the detached hand-off to a relaunched window asserted on HEAD. The driver drops the synthetic-NEXT staging with the contract job: serve.git just serves HEAD as main and OLD is the release pin baked into the website exe - the literal starting point of every real GUI user, same philosophy as the linux axis's release-tag matrix. The -Route parameter (desktop today) declares the future update mechanisms as arms: 'update' (hermes update from the installed venv) and 'installer' (re-run the bootstrap exe) raise until implemented, so the workflow surface is stable when they land.
130 lines
5.2 KiB
YAML
130 lines
5.2 KiB
YAML
name: Install & Update E2E
|
|
|
|
# Can a user on a released version get to this commit?
|
|
#
|
|
# For each release we sample, a leg installs that release through the real
|
|
# `curl | install.sh` one-liner (uv, a managed Python, Node, the venv) inside
|
|
# scripts/dev-sandbox.sh, then applies one update route and requires the
|
|
# checkout to land on this commit with a working `hermes`.
|
|
#
|
|
# The starting versions are chosen at runtime from the repo's release tags
|
|
# (scripts/sandbox/pick-release-tags.sh): newest, oldest, and a spread between.
|
|
# A hardcoded list would stop covering the newest release the day after it
|
|
# ships, and would pin an "oldest" that nobody still runs.
|
|
#
|
|
# A separate Windows axis (install-e2e-windows-run.yml) covers the desktop
|
|
# user flow: install OLD with the website's published bootstrap installer
|
|
# (headed, AutoHotkey-clicked), then update to HEAD through a real update
|
|
# surface — the app's own Update button clicked by Playwright. No tag
|
|
# matrix there: the published exe's own build pin is the starting point
|
|
# users actually have.
|
|
#
|
|
# Triggers:
|
|
# * every 12 hours, so upstream drift (a new uv, a Node bump, a PyPI change)
|
|
# surfaces on a schedule rather than in someone's review cycle;
|
|
# * when a release tag is created -- the moment the set of versions users can
|
|
# update FROM changes, and the moment a broken updater would strand them;
|
|
# * manually, where you can pick the route and how many releases to sample.
|
|
#
|
|
# Deliberately NOT on pull_request: a leg takes ~11 minutes of real toolchain
|
|
# installation, and the matrix multiplies that. Updating is release-shaped work,
|
|
# so it is gated on releases and the clock instead.
|
|
|
|
on:
|
|
workflow_dispatch:
|
|
inputs:
|
|
route:
|
|
description: 'Which update route to exercise. all/both include the Windows desktop leg.'
|
|
required: false
|
|
type: choice
|
|
default: all
|
|
options: [all, both, update, installer, windows-desktop]
|
|
tag-count:
|
|
description: 'How many release tags to sample (newest, oldest, and a spread between).'
|
|
required: false
|
|
type: string
|
|
default: '5'
|
|
schedule:
|
|
# Every 12 hours, off the hour to avoid the top-of-hour runner crunch.
|
|
- cron: '20 7,19 * * *'
|
|
push:
|
|
tags:
|
|
# Release tags only: the repo also carries backup/* and one-off tags.
|
|
- 'v[0-9]+.[0-9]+.[0-9]+'
|
|
- 'v[0-9]+.[0-9]+.[0-9]+.[0-9]+'
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
concurrency:
|
|
group: install-e2e-${{ github.ref }}
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
# Which released versions do we test updating FROM? Resolved once and shared
|
|
# by both route matrices, so the two routes cover the same set.
|
|
pick-releases:
|
|
name: Pick release tags
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 5
|
|
outputs:
|
|
tags: ${{ steps.pick.outputs.tags }}
|
|
steps:
|
|
# This job only reads tag names and runs one script, so take the cheap
|
|
# checkout: no blobs (filter), no other files (sparse), but DO fetch tags
|
|
# -- they are the whole input, and the default shallow checkout has none.
|
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
|
with:
|
|
filter: blob:none
|
|
fetch-tags: true
|
|
sparse-checkout: scripts/sandbox/pick-release-tags.sh
|
|
sparse-checkout-cone-mode: false
|
|
- id: pick
|
|
run: |
|
|
set -euo pipefail
|
|
tags="$(scripts/sandbox/pick-release-tags.sh --count '${{ inputs.tag-count || 5 }}')"
|
|
echo "Testing updates from: $tags"
|
|
echo "tags=$tags" >> "$GITHUB_OUTPUT"
|
|
|
|
# `hermes update` -- the route most users take.
|
|
update:
|
|
if: github.event_name != 'workflow_dispatch' || contains(fromJSON('["all", "both", "update"]'), inputs.route)
|
|
needs: pick-releases
|
|
strategy:
|
|
# One release breaking is worth knowing about even if another already
|
|
# failed, so let every leg report.
|
|
fail-fast: false
|
|
matrix:
|
|
install-ref: ${{ fromJSON(needs.pick-releases.outputs.tags) }}
|
|
uses: ./.github/workflows/install-e2e-run.yml
|
|
with:
|
|
route: update
|
|
install-ref: ${{ matrix.install-ref }}
|
|
|
|
# Re-running the curl one-liner over an existing checkout: autostash + pull
|
|
# rather than the updater's own git handling.
|
|
installer:
|
|
if: github.event_name != 'workflow_dispatch' || contains(fromJSON('["all", "both", "installer"]'), inputs.route)
|
|
needs: pick-releases
|
|
strategy:
|
|
fail-fast: false
|
|
max-parallel: 3
|
|
matrix:
|
|
install-ref: ${{ fromJSON(needs.pick-releases.outputs.tags) }}
|
|
uses: ./.github/workflows/install-e2e-run.yml
|
|
with:
|
|
route: installer
|
|
install-ref: ${{ matrix.install-ref }}
|
|
|
|
# Windows desktop: install OLD with the website's published bootstrap
|
|
# installer (the exact bits a user downloads today, AutoHotkey-clicked),
|
|
# then update to HEAD by clicking the app's own Update button under
|
|
# Playwright. The reusable workflow's route input selects the update
|
|
# mechanism; `hermes update` and installer-rerun arms are declared TODOs
|
|
# there.
|
|
windows-desktop:
|
|
if: github.event_name != 'workflow_dispatch' || contains(fromJSON('["all", "windows-desktop"]'), inputs.route)
|
|
uses: ./.github/workflows/install-e2e-windows-run.yml
|
|
with:
|
|
route: desktop
|