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.