https://github.com/purpleclay/imds-mock

Easy mocking of the Amazon EC2 Instance Metadata Service (IMDS)
https://github.com/purpleclay/imds-mock

aws-ec2 ec2-instance-metadata ec2-metadata ec2-spot-instances gin go imds imdsv2 mock

Last synced: about 2 months ago
JSON representation

Easy mocking of the Amazon EC2 Instance Metadata Service (IMDS)

• Host: GitHub
• URL: https://github.com/purpleclay/imds-mock
• Owner: purpleclay
• License: mit
• Created: 2022-08-07T14:11:56.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-08T21:59:35.000Z (8 months ago)
• Last Synced: 2024-11-14T14:47:13.604Z (about 2 months ago)
• Topics: aws-ec2, ec2-instance-metadata, ec2-metadata, ec2-spot-instances, gin, go, imds, imdsv2, mock
• Language: Go
• Homepage: https://docs.purpleclay.dev/imds-mock/
• Size: 530 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Instance Metadata Service Mock

[![Build status](https://img.shields.io/github/workflow/status/purpleclay/imds-mock/ci?style=flat-square&logo=go)](https://github.com/purpleclay/imds-mock/actions?workflow=ci)

[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](/LICENSE)

[![Go Report Card](https://goreportcard.com/badge/github.com/purpleclay/imds-mock?style=flat-square)](https://goreportcard.com/report/github.com/purpleclay/imds-mock)

[![Go Version](https://img.shields.io/github/go-mod/go-version/purpleclay/imds-mock.svg?style=flat-square)](go.mod)

[![codecov](https://codecov.io/gh/purpleclay/imds-mock/branch/main/graph/badge.svg)](https://codecov.io/gh/purpleclay/imds-mock)

The Instance Metadata Service (IMDS) stores data about an EC2 that you can use to configure or manage the running of that instance. Data is made accessible through the use of instance categories that adapt to its current state. Designing and developing software around the IMDS service poses two main challenges:

1. First and foremost, an EC2 instance is needed; increasing costs

1. There is no way to influence the IMDS service to simulate EC2 events such as spot termination

Both of which make testing difficult and unattainable.

## So why use a Mock?

The `imds-mock` attempts to solve these problems by providing a tool to accurately simulate any use case within the IMDS service, bringing testing to the forefront without additional cost.

### Features

- All mock responses accurately reflect those from the actual IMDS service

- Customisation of responses is supported through CLI flags

- Support for both IMDSv1 and IMDSv2, with strict IMDSv2 possible

- An in-built eventing system makes the simulation of spot interruption notices both easy and configurable

## Documentation

Check out the latest [documentation](https://purpleclay.github.io/imds-mock/) for a guide on how to use the imds-mock.