Skip to content
Open
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
12 changes: 9 additions & 3 deletions .agents/skills/watch-github-actions/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,9 @@ During `0.x`, a minor train permits compatibility findings
as warnings; a patch train or no active train rejects them. Compare the current
train's version with the latest stable release; commit messages are irrelevant.
Compilation, baseline, and tool errors remain fatal. The `protobuf_compatibility` suite participates in
the `release-tag-v1` qualification profile. Both tagged pre-release and stable
the `release-tag-v1` qualification profile. Release Tag calls the reusable
`release-qualification.yml` workflow to run the checks and collect their results.
Both tagged pre-release and stable
publication require this profile to pass. Failed, cancelled, or skipped suites
block publication; build artifacts and qualification evidence remain in Actions
storage for diagnosis. Source-SHA images are staging inputs for qualification.
Expand All @@ -175,8 +177,12 @@ For `Codex Compatibility Review`, inspect its job summary and the
candidate and baseline SHAs before interpreting findings. `complete` describes
execution and coverage, not compatibility: also read the assessment and findings.
An `error`, incomplete coverage, or missing artifact means no clean review is
available. The job is advisory and independent of publication gates; the
qualification summary points to it without waiting for completion. Do not
available. Its findings are advisory and do not affect the qualification result.
The review is scheduled independently of Security Scan. The two Codex workflows
share the `codex-release-review` concurrency group with `queue: max`, retaining
up to 100 pending reviews while preventing overlapping API usage across runs.
Either review can run first; other security scanners run in parallel.
The qualification caller waits for both reviews to finish. Do not
rerun Release Tag to debug this reviewer. Use its dedicated manual workflow
with an existing candidate tag; that path does not publish release artifacts.

Expand Down
3 changes: 2 additions & 1 deletion .github/workflows/codex-compatibility.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,9 @@
contents: read

concurrency:
group: codex-compatibility-${{ inputs.candidate_ref }}-${{ github.run_id }}
group: codex-release-review
cancel-in-progress: false
queue: max

Check failure on line 33 in .github/workflows/codex-compatibility.yml

View workflow job for this annotation

GitHub Actions / Actionlint (informational)

unexpected key "queue" for "concurrency" section. expected one of "cancel-in-progress", "group"
Comment thread
SDAChess marked this conversation as resolved.

jobs:
review:
Expand Down
5 changes: 3 additions & 2 deletions .github/workflows/codex-security.yml
Original file line number Diff line number Diff line change
Expand Up @@ -71,8 +71,9 @@
security-events: write

concurrency:
group: codex-security-release-qualification
cancel-in-progress: true
group: codex-release-review
cancel-in-progress: false
Comment thread
SDAChess marked this conversation as resolved.
queue: max

Check failure on line 76 in .github/workflows/codex-security.yml

View workflow job for this annotation

GitHub Actions / Actionlint (informational)

unexpected key "queue" for "concurrency" section. expected one of "cancel-in-progress", "group"
Comment thread
SDAChess marked this conversation as resolved.

env:
CODEX_SECURITY_MAX_CONCURRENT_THREADS: "8"
Expand Down
239 changes: 239 additions & 0 deletions .github/workflows/release-qualification.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,239 @@
# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

name: Release Qualification

on:
workflow_call:
inputs:
release-tag:
description: Release tag identifying the candidate
required: true
type: string
source-sha:
description: Source commit of the candidate artifacts in the calling run
required: true
type: string
is-prerelease:
description: Whether the candidate is a pre-release
required: true
type: boolean
outputs:
artifact-name:
description: Artifact containing the qualification result
value: ${{ jobs.qualification-result.outputs.artifact-name }}
current-profile-passed:
description: Whether every required qualification suite passed
value: ${{ jobs.qualification-result.outputs.current-profile-passed }}
secrets:
CODEX_SECURITY_API_KEY:
required: true
CACHIX_AUTH_TOKEN:
required: false

permissions:
contents: read
packages: read

env:
RELEASE_TAG: ${{ inputs.release-tag }}

defaults:
run:
shell: bash

jobs:
security:
name: Security Scan
permissions:
actions: read
contents: read
packages: read
security-events: write
uses: ./.github/workflows/security-scan.yml
with:
candidate_ref: ${{ inputs.release-tag }}
fail-on-codex-findings: true
fail-on-static-findings: false
images: |
ghcr.io/nvidia/openshell/gateway:${{ inputs.source-sha }}
ghcr.io/nvidia/openshell/sandbox:${{ inputs.source-sha }}
ghcr.io/nvidia/openshell/supervisor:${{ inputs.source-sha }}
secrets:
CODEX_SECURITY_API_KEY: ${{ secrets.CODEX_SECURITY_API_KEY }}
CACHIX_AUTH_TOKEN: ${{ secrets.CACHIX_AUTH_TOKEN }}

prepare-integration:
permissions:
actions: read
contents: read
packages: read
uses: ./.github/workflows/prepare-integration-inputs.yml
with:
source-sha: ${{ inputs.source-sha }}
deb-artifact-name: deb-linux-amd64
rpm-artifact-name: rpm-linux-x86_64

conformance-integration:
needs: prepare-integration
permissions:
actions: read
contents: read
packages: read
uses: ./.github/workflows/integration-runner.yml
with:
category: conformance
source-sha: ${{ needs.prepare-integration.outputs.source_sha }}
integration-inputs-artifact-id: ${{ needs.prepare-integration.outputs.integration_inputs_artifact_id }}
test-matrix: >-
[
{"environment":"ubuntu-docker-rootful","installer":"deb","testsuite":"conformance"},
{"environment":"ubuntu-k3s","installer":"k3s","testsuite":"conformance"},
{"environment":"fedora-podman-rootful","installer":"rpm","testsuite":"conformance"},
{"environment":"fedora-podman-rootless","installer":"rpm","testsuite":"conformance"}
]

feature-specific-integration:
needs: prepare-integration
permissions:
actions: read
contents: read
packages: read
uses: ./.github/workflows/integration-runner.yml
with:
category: feature-specific
source-sha: ${{ needs.prepare-integration.outputs.source_sha }}
integration-inputs-artifact-id: ${{ needs.prepare-integration.outputs.integration_inputs_artifact_id }}
test-matrix: >-
[
{"environment":"fedora-podman-rootful","installer":"rpm","testsuite":"provider-refresh"},
{"environment":"fedora-podman-rootless","installer":"rpm","testsuite":"provider-refresh"}
]

docker-e2e:
permissions:
actions: read
contents: read
packages: read
uses: ./.github/workflows/e2e-docker-test.yml
with:
image-tag: ${{ inputs.source-sha }}
checkout-ref: ${{ inputs.source-sha }}
runner: linux-arm64-cpu8
conformance-artifact-prefix: openshell-conformance

vm-e2e:
permissions:
actions: read
contents: read
packages: read
uses: ./.github/workflows/e2e-vm-test.yml
with:
checkout-ref: ${{ inputs.source-sha }}
conformance-artifact-prefix: openshell-conformance

protobuf-compatibility:
name: Protobuf Compatibility
runs-on: linux-amd64-cpu8
timeout-minutes: 15
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
fetch-depth: 0
persist-credentials: false
ref: ${{ inputs.source-sha }}

- uses: ./.github/actions/check-protobuf-compatibility
with:
ref: refs/tags/${{ env.RELEASE_TAG }}

compatibility-review:
name: Compatibility Review (advisory)
permissions:
contents: read
uses: ./.github/workflows/codex-compatibility.yml
with:
candidate_ref: ${{ inputs.release-tag }}
source_sha: ${{ inputs.source-sha }}
secrets:
CODEX_SECURITY_API_KEY: ${{ secrets.CODEX_SECURITY_API_KEY }}

qualification-result:
name: Release Qualification
if: always()
needs:
- protobuf-compatibility
- security
- conformance-integration
- feature-specific-integration
- docker-e2e
- vm-e2e
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
contents: read
outputs:
artifact-name: ${{ steps.summary.outputs.artifact-name }}
current-profile-passed: ${{ steps.summary.outputs.current-profile-passed }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
ref: ${{ inputs.source-sha }}

- name: Record qualification result
id: summary
env:
CONFORMANCE_RESULT: ${{ needs.conformance-integration.result }}
DOCKER_E2E_RESULT: ${{ needs.docker-e2e.result }}
FEATURE_INTEGRATION_RESULT: ${{ needs.feature-specific-integration.result }}
IS_PRERELEASE: ${{ inputs.is-prerelease }}
PROTO_COMPATIBILITY_RESULT: ${{ needs.protobuf-compatibility.result }}
SECURITY_RESULT: ${{ needs.security.result }}
SOURCE_SHA: ${{ inputs.source-sha }}
VM_E2E_RESULT: ${{ needs.vm-e2e.result }}
run: |
set -euo pipefail
current_profile_passed=$(tasks/scripts/generate-qualification-summary.sh qualification-summary.json)
artifact_name="qualification-${RELEASE_TAG}-run-${GITHUB_RUN_ID}-attempt-${GITHUB_RUN_ATTEMPT}"
run_url=$(jq -r '.run.url' qualification-summary.json)

{
echo "artifact-name=${artifact_name}"
echo "current-profile-passed=${current_profile_passed}"
} >> "${GITHUB_OUTPUT}"

{
echo "## Release qualification"
echo
echo "- Candidate: \`${RELEASE_TAG}\` (\`${SOURCE_SHA}\`)"
echo "- Current qualification profile passed: **${current_profile_passed}**"
echo "- RFC-0014 qualification coverage complete: **false**"
echo "- Run: [${GITHUB_RUN_ID}, attempt ${GITHUB_RUN_ATTEMPT}](${run_url})"
echo
echo "| Suite | Result |"
echo "| --- | --- |"
echo "| Protobuf API compatibility | ${PROTO_COMPATIBILITY_RESULT} |"
echo "| Security | ${SECURITY_RESULT} |"
echo "| Conformance integration | ${CONFORMANCE_RESULT} |"
echo "| Feature integration | ${FEATURE_INTEGRATION_RESULT} |"
echo "| Docker E2E | ${DOCKER_E2E_RESULT} |"
echo "| VM E2E | ${VM_E2E_RESULT} |"
echo
echo "Advisory compatibility findings do not affect the qualification result."
echo "See the Compatibility Review job and compatibility-review-run-${GITHUB_RUN_ID}-attempt-${GITHUB_RUN_ATTEMPT} artifact in [this run](${run_url})."
} >> "${GITHUB_STEP_SUMMARY}"

- name: Upload qualification result
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
with:
name: ${{ steps.summary.outputs.artifact-name }}
path: qualification-summary.json
retention-days: 90
if-no-files-found: error

- name: Require current qualification profile before publication
if: steps.summary.outputs.current-profile-passed != 'true'
run: |
echo "Release ${RELEASE_TAG} did not pass the current release-tag-v1 qualification profile." >&2
exit 1
Loading
Loading