This project provides an incomplete capability of simulating AWS EC2 instance metadata. It was created to allow for testing of applications that utilize EC2 instance metadata in non-AWS environments or for testing applications in AWS against different metadata values.

wget https://raw.githubusercontent.com/mtnfog/aws-metadata-simulator/master/install.sh && chmod +x install.sh && ./install.sh
sudo iptables -t nat -A OUTPUT -p tcp -d 169.254.169.254 --dport 80 -j DNAT --to-destination 127.0.0.1:8080

go get -u github.com/mtnfog/aws-metadata-simulator

To run:

If specific values for the instance metadata are desired set those values in metadata.toml then run it:

go run main.go

To use a different file as the configuration give the filename as a command line argument:

go run main.go other.toml

To redirect traffic:

iptables -t nat -A OUTPUT -p tcp -d 169.254.169.254 --dport 80 -j DNAT --to-destination 127.0.0.1:8080

To use:

curl -X GET http://127.0.0.1:8080/latest/meta-data/ami-id

Now when applications make requests to the EC2 instance metadata the simulator will answer. You can test it:

curl http://169.254.169.254/latest/meta-data/hostname

To revert back to EC2's instance metadata service you must remove the iptables rule.