cfpb / development

A repository for the discussion and publication of the CFPB development team standards.
Creative Commons Zero v1.0 Universal
63 stars 32 forks source link

Document and recommend VMs for local setup and manual testing and debugging. Especially crucial for debugging. #139

Open cfarm opened 6 years ago

cfarm commented 6 years ago
anselmbradford commented 6 years ago

I have this bookmarked and use it quite often https://github.com/xdissent/ievms. Only reason to re-run it is some Windows VMs require activation after 30 days.

cfarm commented 6 years ago

Similar documentation for testing manually in Sauce Labs is also a need

cfarm commented 6 years ago

This is what I used for IE VMs https://developer.microsoft.com/en-us/microsoft-edge/

jimmynotjim commented 6 years ago

Tip for IE VMs, after installing the VM and running the windows updates, create a snapshot in Virtual Box so you can rollback.

anselmbradford commented 6 years ago

Sauce instructions (note, says Sauce gulp command is not working, but that has been fixed): https://github.com/cfpb/cfgov-refresh/blob/master/docs/testing.md#sauce-connect---send-tests-to-the-cloud

anselmbradford commented 6 years ago

Updated Sauce testing settings in https://github.com/cfpb/cfgov-refresh/pull/3461

cfarm commented 6 years ago

@marcesher posted this new Sauce Labs service in chat - private mobile device lab testing, seems especially useful for manual debugging https://saucelabs.com/enterprise/private-device-cloud

Scotchester commented 6 years ago

Instructions for setting up Microsoft-provided Windows VMs for local IE/Edge testing

Microsoft officially makes VMs available for testing IE and Edge at https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/. They can be downloaded one at a time from that site and set up individually, but there is a GitHub repository that provides a script for mass installation: https://github.com/xdissent/ievms.

Instructions follow for individual installations, because my original run of IEVMS_VERSIONS="10 EDGE" failed due to the 10 VM needing the REUSE_WIN7="no" option on my machine.

What worked for me for Edge

  1. Log off of all VPNs for maximum bandwidth
  2. brew install unar (see "Notes and further explanations")
  3. curl -s https://raw.githubusercontent.com/xdissent/ievms/master/ievms.sh | env IEVMS_VERSIONS="EDGE" bash
  4. When it finishes, open VirtualBox and start the newly-created "MSEdge - Win10" VM
  5. Visit http://10.0.2.2:8000/ to access a server running on localhost:8000

What worked for me for IE 10

  1. Log off of all VPNs for maximum bandwidth
  2. brew install unar (if you didn't already)
  3. curl -s https://raw.githubusercontent.com/xdissent/ievms/master/ievms.sh | env IEVMS_VERSIONS="10" REUSE_WIN7="no" bash
  4. When "Waiting for IE10 - Win8 to shutdown..." starts looping in your terminal:
    1. Open VirtualBox
    2. Right-click the newly created "IE 10 - Win8" VM and choose "Show"
    3. Click the "Desktop" tile to dismiss the Start Menu.
    4. Dismiss the dialog prompting you to install something-or-other that's Oracle-related
    5. You should see a script that was paused in a Command Prompt window now continue to run
    6. After it completes and a 30-second timer counts down, the machine will shut down and the ievms script in your terminal will complete
  5. Open VirtualBox and start the "IE10 - Win8" VM
  6. Visit http://10.0.2.2:8000/ to access a server running on localhost:8000

Notes and further explanations

Scotchester commented 6 years ago

How the full run went last night

curl -s https://raw.githubusercontent.com/xdissent/ievms/master/ievms.sh | env IEVMS_VERSIONS="8 9 10 11 EDGE" bash

Scotchester commented 6 years ago

I noticed on Friday that when I tried to run IE 7, it had not automatically run the updater to update IE9 to IE11, as I assumed it had. Need to investigate whether that's a bug or something I should've known to do.