rust-release #264
Workflow file for this run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# Release workflow for codex-rs. | |
# To release, follow a workflow like: | |
# ``` | |
# git tag -a rust-v0.1.0 -m "Release 0.1.0" | |
# git push origin rust-v0.1.0 | |
# ``` | |
name: rust-release | |
on: | |
push: | |
tags: | |
- "rust-v*.*.*" | |
concurrency: | |
group: ${{ github.workflow }} | |
cancel-in-progress: true | |
jobs: | |
tag-check: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v5 | |
- name: Validate tag matches Cargo.toml version | |
shell: bash | |
run: | | |
set -euo pipefail | |
echo "::group::Tag validation" | |
# 1. Must be a tag and match the regex | |
[[ "${GITHUB_REF_TYPE}" == "tag" ]] \ | |
|| { echo "❌ Not a tag push"; exit 1; } | |
[[ "${GITHUB_REF_NAME}" =~ ^rust-v[0-9]+\.[0-9]+\.[0-9]+(-(alpha|beta)(\.[0-9]+)?)?$ ]] \ | |
|| { echo "❌ Tag '${GITHUB_REF_NAME}' doesn't match expected format"; exit 1; } | |
# 2. Extract versions | |
tag_ver="${GITHUB_REF_NAME#rust-v}" | |
cargo_ver="$(grep -m1 '^version' codex-rs/Cargo.toml \ | |
| sed -E 's/version *= *"([^"]+)".*/\1/')" | |
# 3. Compare | |
[[ "${tag_ver}" == "${cargo_ver}" ]] \ | |
|| { echo "❌ Tag ${tag_ver} ≠ Cargo.toml ${cargo_ver}"; exit 1; } | |
echo "✅ Tag and Cargo.toml agree (${tag_ver})" | |
echo "::endgroup::" | |
build: | |
needs: tag-check | |
name: ${{ matrix.runner }} - ${{ matrix.target }} | |
runs-on: ${{ matrix.runner }} | |
timeout-minutes: 30 | |
defaults: | |
run: | |
working-directory: codex-rs | |
strategy: | |
fail-fast: false | |
matrix: | |
include: | |
- runner: macos-14 | |
target: aarch64-apple-darwin | |
- runner: macos-14 | |
target: x86_64-apple-darwin | |
- runner: ubuntu-24.04 | |
target: x86_64-unknown-linux-musl | |
- runner: ubuntu-24.04 | |
target: x86_64-unknown-linux-gnu | |
- runner: ubuntu-24.04-arm | |
target: aarch64-unknown-linux-musl | |
- runner: ubuntu-24.04-arm | |
target: aarch64-unknown-linux-gnu | |
- runner: windows-latest | |
target: x86_64-pc-windows-msvc | |
- runner: windows-11-arm | |
target: aarch64-pc-windows-msvc | |
steps: | |
- uses: actions/checkout@v5 | |
- uses: dtolnay/[email protected] | |
with: | |
targets: ${{ matrix.target }} | |
- uses: actions/cache@v4 | |
with: | |
path: | | |
~/.cargo/bin/ | |
~/.cargo/registry/index/ | |
~/.cargo/registry/cache/ | |
~/.cargo/git/db/ | |
${{ github.workspace }}/codex-rs/target/ | |
key: cargo-${{ matrix.runner }}-${{ matrix.target }}-release-${{ hashFiles('**/Cargo.lock') }} | |
- if: ${{ matrix.target == 'x86_64-unknown-linux-musl' || matrix.target == 'aarch64-unknown-linux-musl'}} | |
name: Install musl build tools | |
run: | | |
sudo apt install -y musl-tools pkg-config | |
- name: Cargo build | |
run: cargo build --target ${{ matrix.target }} --release --bin codex --bin codex-responses-api-proxy | |
- name: Stage artifacts | |
shell: bash | |
run: | | |
dest="dist/${{ matrix.target }}" | |
mkdir -p "$dest" | |
if [[ "${{ matrix.runner }}" == windows* ]]; then | |
cp target/${{ matrix.target }}/release/codex.exe "$dest/codex-${{ matrix.target }}.exe" | |
cp target/${{ matrix.target }}/release/codex-responses-api-proxy.exe "$dest/codex-responses-api-proxy-${{ matrix.target }}.exe" | |
else | |
cp target/${{ matrix.target }}/release/codex "$dest/codex-${{ matrix.target }}" | |
cp target/${{ matrix.target }}/release/codex-responses-api-proxy "$dest/codex-responses-api-proxy-${{ matrix.target }}" | |
fi | |
- if: ${{ matrix.runner == 'windows-11-arm' }} | |
name: Install zstd | |
shell: powershell | |
run: choco install -y zstandard | |
- name: Compress artifacts | |
shell: bash | |
run: | | |
# Path that contains the uncompressed binaries for the current | |
# ${{ matrix.target }} | |
dest="dist/${{ matrix.target }}" | |
# For compatibility with environments that lack the `zstd` tool we | |
# additionally create a `.tar.gz` for all platforms and `.zip` for | |
# Windows alongside every single binary that we publish. The end result is: | |
# codex-<target>.zst (existing) | |
# codex-<target>.tar.gz (new) | |
# codex-<target>.zip (only for Windows) | |
# 1. Produce a .tar.gz for every file in the directory *before* we | |
# run `zstd --rm`, because that flag deletes the original files. | |
for f in "$dest"/*; do | |
base="$(basename "$f")" | |
# Skip files that are already archives (shouldn't happen, but be | |
# safe). | |
if [[ "$base" == *.tar.gz || "$base" == *.zip ]]; then | |
continue | |
fi | |
# Create per-binary tar.gz | |
tar -C "$dest" -czf "$dest/${base}.tar.gz" "$base" | |
# Create zip archive for Windows binaries | |
# Must run from inside the dest dir so 7z won't | |
# embed the directory path inside the zip. | |
if [[ "${{ matrix.runner }}" == windows* ]]; then | |
(cd "$dest" && 7z a "${base}.zip" "$base") | |
fi | |
# Also create .zst (existing behaviour) *and* remove the original | |
# uncompressed binary to keep the directory small. | |
zstd -T0 -19 --rm "$dest/$base" | |
done | |
- uses: actions/upload-artifact@v4 | |
with: | |
name: ${{ matrix.target }} | |
# Upload the per-binary .zst files as well as the new .tar.gz | |
# equivalents we generated in the previous step. | |
path: | | |
codex-rs/dist/${{ matrix.target }}/* | |
release: | |
needs: build | |
name: release | |
runs-on: ubuntu-latest | |
permissions: | |
contents: write | |
actions: read | |
outputs: | |
version: ${{ steps.release_name.outputs.name }} | |
tag: ${{ github.ref_name }} | |
should_publish_npm: ${{ steps.npm_publish_settings.outputs.should_publish }} | |
npm_tag: ${{ steps.npm_publish_settings.outputs.npm_tag }} | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v5 | |
- uses: actions/download-artifact@v4 | |
with: | |
path: dist | |
- name: List | |
run: ls -R dist/ | |
- name: Define release name | |
id: release_name | |
run: | | |
# Extract the version from the tag name, which is in the format | |
# "rust-v0.1.0". | |
version="${GITHUB_REF_NAME#rust-v}" | |
echo "name=${version}" >> $GITHUB_OUTPUT | |
- name: Determine npm publish settings | |
id: npm_publish_settings | |
env: | |
VERSION: ${{ steps.release_name.outputs.name }} | |
run: | | |
set -euo pipefail | |
version="${VERSION}" | |
if [[ "${version}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then | |
echo "should_publish=true" >> "$GITHUB_OUTPUT" | |
echo "npm_tag=" >> "$GITHUB_OUTPUT" | |
elif [[ "${version}" =~ ^[0-9]+\.[0-9]+\.[0-9]+-alpha\.[0-9]+$ ]]; then | |
echo "should_publish=true" >> "$GITHUB_OUTPUT" | |
echo "npm_tag=alpha" >> "$GITHUB_OUTPUT" | |
else | |
echo "should_publish=false" >> "$GITHUB_OUTPUT" | |
echo "npm_tag=" >> "$GITHUB_OUTPUT" | |
fi | |
- name: Setup pnpm | |
uses: pnpm/action-setup@v4 | |
with: | |
run_install: false | |
- name: Setup Node.js for npm packaging | |
uses: actions/setup-node@v5 | |
with: | |
node-version: 22 | |
- name: Install dependencies | |
run: pnpm install --frozen-lockfile | |
# stage_npm_packages.py requires DotSlash when staging releases. | |
- uses: facebook/install-dotslash@v2 | |
- name: Stage npm packages | |
env: | |
GH_TOKEN: ${{ github.token }} | |
run: | | |
./scripts/stage_npm_packages.py \ | |
--release-version "${{ steps.release_name.outputs.name }}" \ | |
--package codex \ | |
--package codex-responses-api-proxy \ | |
--package codex-sdk | |
- name: Create GitHub Release | |
uses: softprops/action-gh-release@v2 | |
with: | |
name: ${{ steps.release_name.outputs.name }} | |
tag_name: ${{ github.ref_name }} | |
files: dist/** | |
# Mark as prerelease only when the version has a suffix after x.y.z | |
# (e.g. -alpha, -beta). Otherwise publish a normal release. | |
prerelease: ${{ contains(steps.release_name.outputs.name, '-') }} | |
- uses: facebook/dotslash-publish-release@v2 | |
env: | |
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
with: | |
tag: ${{ github.ref_name }} | |
config: .github/dotslash-config.json | |
# Publish to npm using OIDC authentication. | |
# July 31, 2025: https://github.blog/changelog/2025-07-31-npm-trusted-publishing-with-oidc-is-generally-available/ | |
# npm docs: https://docs.npmjs.com/trusted-publishers | |
publish-npm: | |
# Publish to npm for stable releases and alpha pre-releases with numeric suffixes. | |
if: ${{ needs.release.outputs.should_publish_npm == 'true' }} | |
name: publish-npm | |
needs: release | |
runs-on: ubuntu-latest | |
permissions: | |
id-token: write # Required for OIDC | |
contents: read | |
steps: | |
- name: Setup Node.js | |
uses: actions/setup-node@v5 | |
with: | |
node-version: 22 | |
registry-url: "https://registry.npmjs.org" | |
scope: "@openai" | |
# Trusted publishing requires npm CLI version 11.5.1 or later. | |
- name: Update npm | |
run: npm install -g npm@latest | |
- name: Download npm tarballs from release | |
env: | |
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
run: | | |
set -euo pipefail | |
version="${{ needs.release.outputs.version }}" | |
tag="${{ needs.release.outputs.tag }}" | |
mkdir -p dist/npm | |
gh release download "$tag" \ | |
--repo "${GITHUB_REPOSITORY}" \ | |
--pattern "codex-npm-${version}.tgz" \ | |
--dir dist/npm | |
gh release download "$tag" \ | |
--repo "${GITHUB_REPOSITORY}" \ | |
--pattern "codex-responses-api-proxy-npm-${version}.tgz" \ | |
--dir dist/npm | |
gh release download "$tag" \ | |
--repo "${GITHUB_REPOSITORY}" \ | |
--pattern "codex-sdk-npm-${version}.tgz" \ | |
--dir dist/npm | |
# No NODE_AUTH_TOKEN needed because we use OIDC. | |
- name: Publish to npm | |
env: | |
VERSION: ${{ needs.release.outputs.version }} | |
NPM_TAG: ${{ needs.release.outputs.npm_tag }} | |
run: | | |
set -euo pipefail | |
tag_args=() | |
if [[ -n "${NPM_TAG}" ]]; then | |
tag_args+=(--tag "${NPM_TAG}") | |
fi | |
tarballs=( | |
"codex-npm-${VERSION}.tgz" | |
"codex-responses-api-proxy-npm-${VERSION}.tgz" | |
"codex-sdk-npm-${VERSION}.tgz" | |
) | |
for tarball in "${tarballs[@]}"; do | |
npm publish "${GITHUB_WORKSPACE}/dist/npm/${tarball}" "${tag_args[@]}" | |
done | |
update-branch: | |
name: Update latest-alpha-cli branch | |
permissions: | |
contents: write | |
needs: release | |
runs-on: ubuntu-latest | |
steps: | |
- name: Update latest-alpha-cli branch | |
env: | |
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
run: | | |
set -euo pipefail | |
gh api \ | |
repos/${GITHUB_REPOSITORY}/git/refs/heads/latest-alpha-cli \ | |
-X PATCH \ | |
-f sha="${GITHUB_SHA}" \ | |
-F force=true |