Skip to content

AI-powered virtual executive team — a single coherent executive persona backed by 8 specialist agents (FastAPI + Next.js).

fix(ci): pin the release tag glob to digits and key concurrency on the ref

Rufus9485560fb34a
diff --git a/.github/workflows/release-images.yml b/.github/workflows/release-images.yml
index d977575e..2c7ca9d1 100644
--- a/.github/workflows/release-images.yml
+++ b/.github/workflows/release-images.yml
@@ -31,19 +31,22 @@ on:
branches: [main]
# Semver only. A bare `v*` would accept `v0.2` or `vnext`, which
# metadata-action's semver rules ignore, giving a green run that
- # published no release tags.
- tags: ["v[0-9]*.[0-9]*.[0-9]*"]
+ # published no release tags. In these patterns `*` is any run of
+ # characters and `+` means one-or-more of the preceding class, so
+ # `[0-9]+` is what pins each component to digits.
+ tags: ["v[0-9]+.[0-9]+.[0-9]+"]
permissions:
contents: read
packages: write
-# Keyed on the commit, not the ref: `git push origin main v0.2.0` delivers a
-# branch push and a tag push for the same SHA, and both write `sha-<short>`.
-# Serialising them keeps that tag pointing at one build. Never cancel a
-# half-pushed release.
+# Keyed on the ref so consecutive pushes to main run in order and a slow
+# older build cannot overwrite the `main` tag after a faster newer one.
+# (`git push origin main v0.2.0` starts a branch run and a tag run for the
+# same commit in different groups; both write `sha-<short>` from the same
+# source, which is harmless.) Never cancel a half-pushed release.
concurrency:
- group: ${{ github.workflow }}-${{ github.sha }}
+ group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: false
jobs:
diff --git a/README.md b/README.md
index 5411b5ae..49f717da 100644
--- a/README.md
+++ b/README.md
@@ -290,8 +290,8 @@ curl -X POST http://localhost:8000/documents \
Two containers — the FastAPI backend and the Next.js UI — plus one persistent
volume at `/data`. [docker/docker-compose.yml](docker/docker-compose.yml) is the
-reference topology and also what `make docker` runs locally, so the local and
-deployed shapes match.
+reference topology and also what `make docker` runs locally, except that the
+compose UI runs as a dev server rather than the production image.
Versioned images are published to GitHub Container Registry on every release,
so a deployment can pull instead of building:
@@ -301,8 +301,8 @@ docker pull ghcr.io/sentelabsai/openexecutive-api:<version>
docker pull ghcr.io/sentelabsai/openexecutive-ui:<version>
```
-Tags: `X.Y.Z` and `X.Y` for a release, `latest` for the newest release, and
-`main` for the current head of `main`. The available versions are listed on
+Tags: `X.Y.Z` and `X.Y` for a release, `latest` for the most recently
+published release, and `main` for the current head of `main`. The available versions are listed on
each package's page under the repository's Packages. See
[docs/deployment.md](docs/deployment.md#images) for how releases are cut.
diff --git a/docs/deployment.md b/docs/deployment.md
index 4ae91bea..6e05fef5 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -6,8 +6,9 @@ disk will host it: `docker compose` on a single box, a container platform, or a
Kubernetes deployment.
[docker/docker-compose.yml](../docker/docker-compose.yml) is the reference
-topology. It is also what `make docker` runs locally, so the local and deployed
-shapes are the same.
+topology. It is also what `make docker` runs locally, with one difference: the
+compose UI is a `next dev` server on a bind mount, not the production image
+from `Dockerfile.ui`.
---
@@ -54,7 +55,7 @@ thing that builds `Dockerfile.ui`.
| Tag | Set by | Meaning |
|---|---|---|
| `X.Y.Z`, `X.Y` | pushing git tag `vX.Y.Z` | A release. Pin deployments to one of these. |
-| `latest` | pushing git tag `vX.Y.Z` | The newest release. |
+| `latest` | pushing git tag `vX.Y.Z` | The most recently published release, by push order, not the highest version. Pushing a `v0.2.1` patch after `v0.3.0` moves `latest` back to `0.2.1`. |
| `main` | every push to `main` | Current head of `main`; not a release. |
| `sha-<short>` | every push | The commit the image was built from. |
| `buildcache` | every push | BuildKit layer cache. Not an image; ignore it. |