[terra-functional-testing] Update to use seleniarm 4.10 docker images…

… for Apple silicon support (#790)

* Update terra-functional-testing to use seleniarm 4.10 docker images

* Update CHANGELOG and CONTRIBUTORS

* Update WDIO screenshots

* Add option to use secure HTTP when gridUrl is provided

* Updated CHANGELOGs

* Add newline

* Revert https changes

* Removed extra character

* Updated CHANGELOG and added migration guide

CONTRIBUTORS.md

@@ -31,6 +31,7 @@ Cerner Corporation
 - Saket Bajaj [@saket2403]
 - Kayla Barnett [@kaylabarnett]
 - Nick Williams [@QuasiGnarus]
+- Art Parkeenvincha [@artpark]
 
 [@emilyrohrbough]: https://github.com/emilyrohrbough
 [@brettjankord]: https://github.com/bjankord
@@ -63,3 +64,4 @@ Cerner Corporation
 [@saket2403]: https://github.com/saket2403
 [@kaylabarnett]: https://github.com/kaylabarnett
 [@QuasiGnarus]: https://github.com/QuasiGnarus
+[@artpark]: https://github.com/artpark

packages/terra-functional-testing/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+* Breaking changes
+  * Updated to pull in the seleniarm 4.10 docker images.
+
 ## 3.7.0 - (July 12, 2023)
 
 * Changed
@@ -10,7 +13,7 @@
 ## 3.6.0 - (July 10, 2023)
 
 * Added
-  * Added `useHttps` flag to use a secure http connection when the `gridUrl` flag is also provided.
+  * Added `useHttps` to use a secure http connection when the `gridUrl` flag is also provided.
 
 * Changed
   * Updated `uuid` dependency to `8.2.0` for consistency across Terra packages.

packages/terra-functional-testing/src/docker/docker-compose.yml

@@ -1,43 +1,37 @@
 version: "3"
-
 services:
   selenium-hub:
-    image: selenium/hub:${TERRA_SELENIUM_DOCKER_VERSION:-3.141.59-zirconium}
+    image: seleniarm/hub:4.10.0-20230615
     container_name: selenium-hub
     ports:
+      - "4442:4442"
+      - "4443:4443"
       - "4444:4444"
     healthcheck:
       test: ["CMD", "/opt/bin/check-grid.sh"]
       interval: 15s
       timeout: 30s
       retries: 5
-
   chrome:
-    image: selenium/node-chrome:${TERRA_SELENIUM_DOCKER_VERSION:-3.141.59-zirconium}
-    # Volume mounting is necessary to ensure the browser does not crash inside the docker container.
-    # For more details see:
-    #  https://github.com/SeleniumHQ/docker-selenium#running-the-images
-    #  https://bugs.chromium.org/p/chromium/issues/detail?id=519952
-    #  https://bugzilla.mozilla.org/show_bug.cgi?id=1338771#c10
+    image: seleniarm/node-chromium:4.10.0-20230615
     volumes:
       - /dev/shm:/dev/shm
+    shm_size: 2gb
     depends_on:
       - selenium-hub
     environment:
-      - HUB_HOST=selenium-hub
-      - HUB_PORT=4444
-
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
   firefox:
-    image: selenium/node-firefox:${TERRA_SELENIUM_DOCKER_VERSION:-3.141.59-zirconium}
-    # Volume mounting is necessary to ensure the browser does not crash inside the docker container.
-    # For more details see:
-    #  https://github.com/SeleniumHQ/docker-selenium#running-the-images
-    #  https://bugs.chromium.org/p/chromium/issues/detail?id=519952
-    #  https://bugzilla.mozilla.org/show_bug.cgi?id=1338771#c10
+    image: seleniarm/node-firefox:4.10.0-20230615
     volumes:
       - /dev/shm:/dev/shm
+    shm_size: 2gb
     depends_on:
       - selenium-hub
     environment:
-      - HUB_HOST=selenium-hub
-      - HUB_PORT=4444
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+

packages/terra-toolkit-docs/CHANGELOG.md

@@ -9,6 +9,11 @@
 
 ## 2.14.0 - (July 10, 2023)
 
+* Added
+  * Added migration guide for `[email protected]`.
+
+## 2.14.0 - (July 10, 2023)
+
 * Added
   * Added `useHttps` flag information to `terra-functional-testing` documentation.
 

packages/terra-toolkit-docs/src/terra-dev-site/tool/terra-functional-testing/upgrade-guides.5/version-4-upgrade-guide.4.tool.md

@@ -0,0 +1,7 @@
+# Terra Functional Testing - Version 4 Upgrade Guide
+
+To upgrade to `terra-functional-testing` from v3 to v4, consumers will need to rerun their WDIO tests to generate new reference screenshots for all themes. This can be done by running the WDIO command with the `--updateScreenshots` flag.
+
+## Breaking Changes
+
+The docker image used for WDIO testing has been upgraded to be compatible with Apple Sillicon devices. However, the chromium version being tested on has been updated. The new chromium version has styling changes that affect the focus indicator and size of the testing environment -- therefore requiring consumers to generate new reference screenshots.