This project is designed to provide a hands-on learning experience for using Selenium Grid, Python, and Docker to perform automated browser testing across multiple machines and browsers simultaneously. Selenium Grid is a powerful tool that enables distributed test execution, making it ideal for testing web applications at scale. By combining it with Python and Docker, we create a versatile and scalable testing environment that can be easily set up and deployed.
In this repository, you will find step-by-step instructions, code samples, and configurations to set up your own Selenium Grid infrastructure using Docker containers.
Note: The Docker images used in this project are specifically designed for ARM64 architectures. Please ensure that your system supports ARM64 before proceeding with the installation.
- Pre-requirements
- Installation
- Monitoring the Selenium Grid
- Running Docker Images
- Running Google Search
- Viewing Logs
To get started with this project, you'll need to install the following tools:
- Python: Python is a programming language used for writing test scripts and managing dependencies.
- Pyenv: pyenv is a tool that allows you to install and manage multiple versions of Python on your system.
- Pipenv: pipenv is a virtual environment manager and package installer for Python, ensuring dependency management and reproducibility.
- Docker: Docker is a platform that allows you to develop, ship, and run applications inside containers, ensuring consistent environments across different machines.
- Docker Compose: Docker Compose is a tool for defining and running multi-container Docker applications, simplifying the management of multiple Docker containers.
- Visual Studio Code: Visual Studio Code is a lightweight and powerful code editor with great support for Python development and a wide range of extensions.
- Git: Git is a version control system used for tracking changes in your code and collaborating with others.
Please follow the links provided for each tool to access the respective installation instructions for your specific operating system. Once you have these tools installed, you'll be ready to proceed with the experimentation project.
This chapter guides you through the installation process, ensuring that you have all the necessary tools and dependencies to run the project.
Instructions for setting up Pipenv and creating a virtual environment within the project directory.
make install-virtual-envAnd to activate the virtual environment
make activate-virtual-envTo launch the required Docker containers, use the following command:
make compose-upBefore proceeding, make sure to add the following entry to your /etc/hosts file:
127.0.0.1 selenium-hubOnce done, you can monitor the Selenium Grid dashboard by executing the following command:
make open-selenium-grid-dashboardThis chapter provides instructions on running the Google search tests using different browsers, namely Chromium and Firefox in headless mode with Selenium Grid.
Execute the Google search tests with the Chromium browser.
BROWSER=chromium pytest tests/test_google_search.pyRun the Google search tests with the Firefox browser.
BROWSER=firefox pytest tests/test_google_search.pyThis chapter provides instructions on running the Google search tests using Firefox.
pytest tests/test_google_search.pyFind out how to view the logs of the Chromium and Firefox containers for troubleshooting and debugging.
To view logs for all containers, you can use the following command:
make compose-logsCommands to view the logs of the Chromium container.
make compose-logs chromiumCommands to view the logs of the Firefox container.
make compose-logs firefox