Skip to content

Add aws-emulator to the tools module - #803

Draft
wallrj wants to merge 2 commits into
cert-manager:mainfrom
wallrj:aws-emulator-tool
Draft

wallrj wants to merge 2 commits into
cert-manager:mainfrom
wallrj:aws-emulator-tool

Conversation

@wallrj

@wallrj wallrj commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

This adds aws-emulator to the tools module, so that projects can run tests against a local copy of the AWS APIs instead of an AWS account.

AWS Emulator is published by AWS. It was announced on 11 November 2026.

Why?

cert-manager tests its Route 53 DNS-01 provider by replaying canned XML. With the emulator, the tests can sign real requests and read the records back. cert-manager/cert-manager#9586 uses this tool. It points klone.yaml at this branch so that the tests run in CI.

What does the target do?

make _bin/tools/aws-emulator downloads the Debian package from downloads.aws.com, checks its SHA256 and unpacks the binary without installing the package.

  • It uses dpkg-deb where that exists. Our make-dind CI image has dpkg-deb and ar, but no xz.
  • Elsewhere, such as on Fedora, it uses ar and tar.

What happens on macOS?

AWS publishes the emulator for Linux only. On other systems:

  • make non-go-tools and make tools leave it out, so learn-tools-shas still works.
  • make _bin/tools/aws-emulator fails with "aws-emulator is only published for Linux".

What I tested

Check Result
make _bin/tools/aws-emulator on Fedora, amd64 (ar and tar) binary runs, reports 1.0.322
Same target inside make-dind:20260529-7f372af-trixie (dpkg-deb) binary runs, reports 1.0.322
HOST_ARCH=arm64 hash matches, binary is aarch64
HOST_OS=darwin, direct target fails with the message above
HOST_OS=darwin, make -n non-go-tools emulator not included

Things to weigh before merging

  • Size. The package is about 170 MB and the binary about 970 MB. It is only downloaded by projects which ask for it.
  • Release rate. The emulator had more than 50 releases in its first three days. Renovate will include it in the grouped tools update, and each update downloads both packages to learn the hashes.
  • Version numbers. The GitHub tag is v1.0.322 and the package is 1.0.322-1. I checked that this mapping holds for this one version only.
  • Signature. AWS also publishes a GPG signature for each package. This PR relies on the pinned SHA256, like the other tools.
NONE

[Claude Fable 5.2]

AWS Emulator is a local program, published by AWS, which serves the AWS
APIs and keeps the resources in memory. Tests can use it instead of an
AWS account.
https://github.com/aws/aws-emulator

AWS publishes it for Linux only, as RPM and Debian packages. The new
target downloads the Debian package, checks its SHA256 and unpacks the
binary without installing the package. It uses dpkg-deb where that
exists, because our CI image has no xz command, and ar and tar elsewhere.

On other systems the tool is left out of the non-go-tools and tools
targets, and asking for it directly fails with a clear message.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Signed-off-by: Richard Wall <richard@the-moon.net>
@cert-manager-prow cert-manager-prow Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. labels Nov 12, 2026
@cert-manager-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign erikgb for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@cert-manager-prow cert-manager-prow Bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Nov 12, 2026
wallrj added a commit to wallrj/cert-manager that referenced this pull request Nov 12, 2026
The tools module is temporarily taken from the branch of
cert-manager/makefile-modules#803, which adds the aws-emulator tool.
That branch is based on the latest makefile-modules, so this also updates
the vendored Go to 1.27.4 and a few other tools.

On Linux, make test and make test-ci now download the emulator and set
AWS_EMULATOR to its path. The tests use that path, so they cannot be
skipped by accident in CI. AWS publishes the emulator for Linux only, so
the tests are still skipped on other systems.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Signed-off-by: Richard Wall <richard@the-moon.net>
@cert-manager-prow cert-manager-prow Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Nov 14, 2026
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Signed-off-by: Richard Wall <richard@the-moon.net>
@cert-manager-prow cert-manager-prow Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Nov 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant