Customizing the VM Image

How customize the TestDriver VM Image for robust test execution.

This guide is specifically for Enterprise Plan customers who have access to the shared TestDriver AMI. If you are on a different plan, please contact your account manager for more information.

1. Send Us Your AWS Account ID

   To begin, send your 12-digit AWS account ID to your TestDriver account manager. We’ll share the AMI directly with your AWS account using Amazon’s explicit AMI sharing process.

2. Wait for Confirmation

   Your account manager will notify you when the AMI has been shared with your account. You will receive the AMI ID (e.g., ami-0abcd1234efgh5678) and your RDP Username + Password.

3. Launch and Connect with RDP

   Once you have the AMI ID & RDP credentials from the previous step, launch an EC2 instance and connect via RDP:

   1. Ensure your security group allows RDP (TCP port 3389).
   2. In the EC2 Console, select your instance → Connect > RDP Client.
   3. Download the .rdp file and launch it with the Windows App
      Alternatively, copy the public IP and paste it into your RDP client.
   4. Login using your RDP Username + Password (e.g. testdriver + •••••••••) provided by your account manager.

   You will access a full Windows desktop where TestDriver is pre-installed and ready for customization.

4. Change the Windows password

   Inside the Windows desktop environment:

   1. Open up Powershell
   2. Run C:\testdriver\RotateLocalPasswords.ps1
   3. Copy the password presented in the output to a safe place. This is the only chance to copy the password.
   4. Restart the instance and double check you can log in before continuing.

   Note that this will change the password for the testdriver and rdp_local accounts, but Administrator will remain as a password you can only retreive through the AWS EC2 UI ((Instructions Here)[https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-rdp.html#retrieve-initial-admin-password]).

5. Customize the Instance

   Inside the Windows desktop environment:

   1. Download and install your application using a browser, Git, PowerShell, or other tools.
   2. Add any required system configuration, environment variables, or startup scripts.
   3. Verify the full setup works correctly in the sandbox.

   Common use cases:

   • Pull from GitHub or your artifact store
   • Configure your app with test credentials or environment variables
   • Enable logging or install monitoring tools
6. Create Your Custom AMI

   Once your customizations are complete, create an AMI from your instance:

   1. In the EC2 Console, select your customized instance.
   2. Go to Actions → Image and templates → Create image.
   3. Provide a descriptive Image name and Description.
   4. Click Create image to start the AMI creation process.
   5. Wait for the AMI status to change from “pending” to “available”.

   The AMI creation process may take several minutes depending on the instance size and customizations.
7. Share Your AMI and Use with TestDriver CLI

   After creating your custom AMI:

   1. Share the AMI ID with your TestDriver account manager so we can launch it in our infrastructure. Follow Amazon’s explicit AMI sharing process if needed.
   2. Once confirmed, you can reference the AMI directly from your machine using the TestDriver CLI:

   testdriverai --sandbox-ami=ami-0abcd1234efgh5678
   

   This instructs the CLI to launch a sandbox using your customized AMI, enabling test execution in your environment.

---

🔐 Best Practices & Security

• Always use strong RDP passwords and keep your key pairs secure.
• Apply Windows Updates to stay current with patches.
• Use IAM roles with least privilege to access other AWS resources.
• Consider encrypting your volumes and AMI if handling sensitive data.

---

🤝 Need Help?

Your TestDriver account manager is available to support you with:

• AMI access and customization
• CLI configuration
• Troubleshooting sandbox execution