Skip to content

Releases

v1.1.0

Choose a tag to compare

@dhrimov dhrimov released this 13 Oct 07:35
Immutable release. Only release title and notes can be modified.
9b37f0c

What's new

manylinux_2_28 and manylinux_2_34 platforms

platform now accepts four more values:

  • aarch64-manylinux_2_28, x86_64-manylinux_2_28
  • aarch64-manylinux_2_34, x86_64-manylinux_2_34

These need python-version 3.12 or later. python3.11 runs on Amazon Linux 2, whose glibc 2.26 cannot load wheels built for these levels. A package built for that pair deploys fine and fails only when the function imports it, so the action now refuses the pair before installing anything:

::error::python3.11 runs on Amazon Linux 2 (glibc 2.26), which cannot load manylinux_2_28 or manylinux_2_34 wheels. Use x86_64-manylinux2014, or python-version 3.12 or later.

python3.12, 3.13 and 3.14 run on Amazon Linux 2023 (glibc 2.34), which loads all three levels. The aarch64-* platforms still map to the arm64 Lambda architecture and the x86_64-* ones to x86_64. Keeping that in line with your function's architecture is still your job.

Existing manylinux2014 callers need no change.

Dependencies

  • actions/upload-artifact 7.0.1 → 7.0.2, used when upload-artifact: true (#7)

Internal

  • E2E: new newer-glibc job covering the four new platforms on Python 3.13, and a guard-rails case for 3.11 + manylinux_2_28 (#9)
  • E2E: the nested-zip fallback is now covered with a >250 MiB fixture (#6)
  • E2E: actions/download-artifact 8.0.1 → 8.0.2 (#8)

Full changelog: v1.0.0...v1.1.0

v1.0.0

Choose a tag to compare

@dhrimov dhrimov released this 03 Oct 08:54
Immutable release. Only release title and notes can be modified.
79732be

First release of Package Python Lambda, a composite GitHub Action that packages a Python AWS Lambda project built with uv into a reproducible deployment zip.

The action checks the target runtime and CPU architecture before it builds anything. If they don't match what your Lambda expects, the build fails in CI, not when the function runs.

What it does

  • Installs and caches uv, with the cache keyed off your project's uv.lock.
  • Checks python-version and platform before any real work and fails fast with a clear ::error:: if either one is missing or unsupported.
  • Exports your locked dependencies (uv export --frozen --no-dev), builds your project as a wheel, and installs both into a venv for the target Lambda platform.
  • Packages the venv with package-python-function into a zip named after your project.
  • Leaves the zip on the runner's filesystem, so a Terraform or AWS CLI step in the same job can use it directly.

Highlights

  • Reproducible output. The same inputs give the same zip and the same SHA-256, so you can skip redeploying an unchanged function.
  • No silent architecture drift. python-version and platform have no defaults on purpose. You name both every time, so a compiled dependency can't quietly be built for the wrong ABI.
  • Size reporting against AWS's limit. The uncompressed-bytes output is the figure AWS's 250 MiB limit applies to. If a package goes over, the packager's nested-zip fallback kicks in and nested-zip reports it.
  • Monorepo friendly. Each call packages one lambda. Use your own matrix to package several in parallel, with optional artifact upload under a derived name that is unique per lambda, platform and runtime.

Supported targets

  • Runtimes: Python 3.11, 3.12, 3.13, 3.14. 3.11 builds but shows a warning: AWS retires it on 2027-06-30.
  • Platforms: aarch64-manylinux2014 (Lambda arm64) and x86_64-manylinux2014 (Lambda x86_64).
  • Runners: Linux only.

Usage

- uses: actions/checkout@v7

- id: package
  uses: dhrimov/package-python-lambda-gha@v1
  with:
    input-path: .
    output-path: terraform
    python-version: "3.13"
    platform: aarch64-manylinux2014

The project needs a pyproject.toml and a uv.lock.

Outputs

zip-path (absolute), zip-sha256, package-size-bytes, uncompressed-bytes, nested-zip.

Good to know

  • The action builds in <input-path>/build and deletes that directory before and after every build. Don't keep anything there.
  • The action makes no GitHub API calls of its own and needs no token scopes.
  • Deploying the zip is out of scope. The action's job ends once the zip exists.

See the README for all inputs, the pinning advice and the artifact naming rules.