EC2 Metadata Mock v1.1.0

New Features

• add support to launch the AEMM helm chart with commands and arguments to align startup capability with other installation methods (e.g. ec2-metadata-mock spot) (#52)
• helm chart version is now in sync with AEMM version (#52, #53)
  See helm chart archive amazon-ec2-metadata-mock-1.1.0.tgz under release assets.

Bug Fixes

N/A

Improvements

• modify and improve release scripts to accommodate change in chart versioning (#51)
• add version validator for release (#51)
• automate release preparation (creation of git tag and updating versions in repo)

Breaking Changes

N/A

EC2 Metadata Mock v1.0.1

New Features

• Add version flag to AEMM. E.g. ec2-metadata-mock --version

Bug Fixes

• Fix Helm release script that generated helm archive with incorrect dir structure (#48)
• Fix Travis CI job config
• Fix imdsv2 token response to include ttl header, X-aws-ec2-metadata-token-ttl-seconds (#50)

Improvements

• Modify Helm release scripts to not generate helm test resource files
• Improve release scripts / process

Breaking Changes

• N/A

EC2 Metadata Mock v1.0.0

Summary:

This is the first major release of the amazon-ec2-metadata-mock tool.

amazon-ec2-metadata-mock is a tool to simulate Amazon EC2 instance metadata service for local testing.

Why did we build this?

The instance metadata service is accessed from an Amazon EC2 instance, and it vends metadata about the instance such as hostname, instance-id, maintenance events, spot actions, etc.

However, some instance metadata is available only when an instance is affected by an event OR if configured a specific way. E.g. A Spot instance's metadata item spot/instance-action is available only when AWS decides to interrupt the Spot instance. E.g. Metadata for an EBS volume block-device-mapping/ebsN is only available if the instance was configured to have a volume at launch time.

Because of this, it it challenging to test one's application for how it will respond in the event of a Spot interruption or other such events and requiring an EC2 instance for testing. ec2-metadata-mock attempts to bridge these gaps by providing mocks for most of these metadata categories. The mock responses are designed to replicate those from the actual instance metadata service for accurate, local testing.

Major Features

• Emulate Spot Instance Interruption (ITN) events
• Delay mock response from the mock serve start time
• Configure metadata in mock responses via CLI flags, config file, env variables
• IMDSv1 and v2 support (configurable for IMDSv2 support only)
• Save processed configuration to a local file

EC2 Metadata Mock v0.9.6

New Features

• N/A

Bug Fixes

• Fixed helm test now that it's testing against later AEMM version (#42)

Improvements

• CI/CD improvements (#42)

Breaking Changes

• N/A

EC2 Metadata Mock v0.9.5

New Features

• N/A

Bug Fixes

• Corrected spot interrupt response (#31)
• Corrected elastic inference accelerator response (#39)

Improvements

• Fixed transient issues in integration tests (#33)
• Improved release script and Travis integrations (#34)

Breaking Changes

• Updated command names for spot and events (#37)
  • spotItn --> spot
  • scheduledEvents --> events
• Aligned code with updated command names (#38)
  • config overrides will reflect new command names
  • Ex: AEMM_SPOT_ITN_ACTION --> AEMM_SPOT_ACTION

EC2 Metadata Mock v0.9.4

New Features

• helm chart for amazon-ec2-metadata-mock (#6)
• helm chart tests (#21)
• test script to run helm e2e tests, including linting, version increment check, installation and tests (#22)
• helm e2e tests are now run with travis CI builds (#24)
• application exits when reading from input config file fails (#28)

Bug Fixes

• modified the default for hostname so that zero config CLI works on Docker (#25)
  Thanks to @anuraaga's PR (#19)
• fixed windows binary file extension (#27)
• fixed 'EventId' formatting in response of scheduled maintenance events path (#28)
• updated helm-app-version-test to use git tag instead of result from git describe (#29)

Improvements

• updates to readmes / documentation (#27)
• new make target 'build-and-test' for local build and tests (#27)
• update command name for spot from 'spotitn' to 'spot' (#28)
• update helm chart appVersion from '0.9.3' to 'v0.9.3' (#29)
• add a script to be run manually to update the AEMM version and helm chart versions in various files (#29)

Breaking Changes

• remove command aliases that covered typos (#28)
  This is a breaking change only for removed command aliases:
  • scheduled-events
  • scheduledEvents
  • spot-itn
  • spotItn

EC2 Metadata Mock v0.9.3

Updates:

1. Renaming binary assets from amazon-ec2-metadata-mock* to ec2-metadata-mock*
2. Upgrade Go version from v1.13 to v1.14

EC2 Metadata Mock v0.9.2

Updates:

1. Renaming binary assets from amazon-ec2-metadata-mock* to ec2-metadata-mock*
2. Upgrade Go version from v1.13 to v1.14

EC2 Metadata Mock v0.9.1

Updates:

1. Renaming binary assets from amazon-ec2-metadata-mock* to ec2-metadata-mock*
2. Upgrade Go version from v1.13 to v1.14

Amazon EC2 Metadata Mock v0.9.0

This pre-release offers Amazon EC2 Metadata Mock functionality documented in the README. Quick installation via binaries is currently supported. Additional installation methods will be available in future releases.

Features:

1. Emulate Spot Instance Interruption (ITN) events
2. Delay mock response from the mock serve start time
3. Configure metadata in mock responses via CLI flags, config file, env variables
4. IMDSv1 and v2 support (configurable for IMDSv2 support only)
5. Save processed configuration to a local file