Skip to main content
In this guide, we’ll prepare your environment for running AWS Fault Injection Simulator (FIS) experiments on Amazon EKS. By the end of this lesson, you will have:
  • Logged into an EC2 host and navigated to your working directory
  • Created an IAM role dedicated to AWS FIS
  • Attached all required IAM policies to the role
  • Configured kubectl and applied Kubernetes RBAC
  • Verified that the metrics-server is operational and checked pod metrics
For more on AWS FIS, visit the AWS Fault Injection Simulator Documentation.

1. SSH into EC2 & Navigate to the Experiment Directory

First, connect to your EC2 instance (e.g., via EC2 Instance Connect), switch to root, and change into the workshop folder:
List the files to confirm you have the expected prerequisites:

2. Create the IAM Role for FIS

Your fis-trust-policy.json defines which AWS service can assume this role. Create the role using:
Sample response:
Ensure the path to fis-trust-policy.json is correct and your AWS CLI is configured with sufficient permissions.

3. Attach IAM Policies to the FIS Role

Grant the eks-fis-role permissions to manage EKS clusters, EC2 instances, Systems Manager, CloudWatch, and networking. You can attach them in a loop or individually. Below is a table of required policies: Example of attaching one policy:
Repeat for each policy listed above.

4. Configure kubectl & Apply RBAC

Update your kubeconfig to point at the target EKS cluster (replace $AWS_REGION and PetSite as needed):
Be sure your AWS CLI profile has permission to call eks:UpdateKubeconfig. Incorrect context may lead to applying objects to the wrong cluster.
Next, apply the RBAC manifests to map the IAM role to a Kubernetes service account:
These objects allow FIS to interact with your pods using the service account credentials.

5. Verify Metrics-Server & Pod Metrics

Ensure the metrics-server pod is running in your cluster:
Once available, fetch pod-level metrics in the default namespace:
With these prerequisites in place, you’re ready to launch your first AWS FIS memory-stress experiment on EKS!

References

Watch Video