Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 27 additions & 15 deletions .github/workflows/pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ jobs:
contents: read
actions: read
pull-requests: read
deployments: read
id-token: write
attestations: write
steps:
Expand Down Expand Up @@ -352,9 +353,10 @@ jobs:
uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa
with:
path: site
# Main's gates run beside each other, so this run publishes only if its
# commit is still main's head; a newer merge's run publishes that one.
- name: Is this commit still main's head
# Main's gates run beside each other. A run publishes when the live page
# does not already hold its commit (tools/pages/newer.sh), and the
# publish job asks again just before it deploys.
- name: Is this commit newer than the live page
id: head
if: steps.attest.outcome == 'success'
shell: bash
Expand All @@ -364,13 +366,8 @@ jobs:
SHA: ${{ github.sha }}
run: |
set -euo pipefail
head=$(gh api "repos/$REPO/commits/main" --jq .sha)
if [[ $head == "$SHA" ]]; then
echo "current=true" >>"$GITHUB_OUTPUT"
else
echo "current=false" >>"$GITHUB_OUTPUT"
echo "::notice::main moved on to $head; that merge's run publishes it, not this one"
fi
go=$(tools/pages/newer.sh)
echo "current=${go#go=}" >>"$GITHUB_OUTPUT"

deploy:
name: publish the page
Expand All @@ -384,23 +381,37 @@ jobs:
permissions:
pages: write
id-token: write
contents: read
deployments: read
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Check out the exact event revision
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
with:
fetch-depth: 0
persist-credentials: false
# Publishes run one at a time: a newer run may have published while
# this one waited, and then this older page must not replace it.
- name: Is this commit still newer than the live page
id: newer
shell: bash
env:
GH_TOKEN: ${{ github.token }}
REPO: ${{ github.repository }}
SHA: ${{ github.sha }}
run: tools/pages/newer.sh >>"$GITHUB_OUTPUT"
- name: Deploy
if: steps.newer.outputs.go == 'true'
id: deployment
uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e
# The published page itself, in a real browser: it keeps, refuses while
# halted and answers through the app, and its owner's walk (CO-01) holds:
# content in, every place lists it, Today and Ask answer from it. Pages can take
# a minute to serve the new bytes, so the check gets four tries.
- name: Check out the exact event revision
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
with:
fetch-depth: 0
persist-credentials: false
- name: The published page works (PG-01, live)
if: steps.newer.outputs.go == 'true'
env:
PAGE_URL: ${{ steps.deployment.outputs.page_url }}
run: |
Expand All @@ -416,6 +427,7 @@ jobs:
# as working still works, fresh and returning, and no system word shows
# beyond the listed debt. Its scoreboard goes to this job's summary.
- name: The published page keeps every working journey and keeps the system view off the screen (PD-01, PD-02, live)
if: steps.newer.outputs.go == 'true'
env:
PAGE_URL: ${{ steps.deployment.outputs.page_url }}
run: |
Expand Down
40 changes: 40 additions & 0 deletions tools/pages/newer.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
#!/usr/bin/env bash
# Whether $SHA is newer than the page that is live, so publishing it moves
# the site forward. Prints go=true or go=false for $GITHUB_OUTPUT.
#
# Main's runs go side by side and each takes a different time, so "is this
# still main's head" starves the site: when merges come faster than a run,
# every run finds main moved on and none publishes (#97 to #102 did this for
# ninety minutes). Instead a run publishes whenever the live page does not
# already hold its commit, and the publish job, which runs one at a time,
# asks again just before it deploys, so an older run never replaces a newer
# page.
set -euo pipefail
: "${REPO:?}" "${SHA:?}"
live=
while read -r id sha; do
[[ -n $id ]] || continue
state=$(gh api "repos/$REPO/deployments/$id/statuses?per_page=1" --jq '.[0].state // empty')
if [[ $state == success ]]; then
live=$sha
break
fi
done < <(gh api "repos/$REPO/deployments?environment=github-pages&per_page=30" --jq '.[] | "\(.id) \(.sha)"')
if [[ -z $live ]]; then
echo "no live page found: publishing $SHA" >&2
echo "go=true"
exit 0
fi
# compare/BASE...HEAD: "ahead" or "identical" means the live commit already
# holds this one.
status=$(gh api "repos/$REPO/compare/$SHA...$live" --jq .status)
case $status in
ahead|identical)
echo "::notice::the live page ($live) already holds $SHA: a newer run published it" >&2
echo "go=false"
;;
*)
echo "the live page is $live ($status of $SHA): publishing $SHA" >&2
echo "go=true"
;;
esac
Loading