https://github.com/aerokube/ggr

A lightweight load balancer used to create big Selenium clusters
https://github.com/aerokube/ggr

ggr grid-router selenium

Last synced: about 2 months ago
JSON representation

A lightweight load balancer used to create big Selenium clusters

• Host: GitHub
• URL: https://github.com/aerokube/ggr
• Owner: aerokube
• License: apache-2.0
• Created: 2016-06-16T15:33:24.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-04-20T10:32:43.000Z (8 months ago)
• Last Synced: 2024-07-31T20:53:10.550Z (5 months ago)
• Topics: ggr, grid-router, selenium
• Language: Go
• Homepage: https://aerokube.com/ggr/latest/
• Size: 848 KB
• Stars: 312
• Watchers: 24
• Forks: 73
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.adoc
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - ggr - a lightweight server that routes and proxies Selenium WebDriver requests to multiple Selenium hubs. (Selenium and browser control tools / Mock)
• awesome-go - ggr - A lightweight load balancer used to create big Selenium clusters - ★ 169 (Testing)
• awesome-go-extra - ggr - 06-16T15:33:24Z|2022-05-30T07:58:50Z| (Testing / Selenium and browser control tools.)

README

        
# Go Grid Router

[![Build Status](https://github.com/aerokube/ggr/workflows/build/badge.svg)](https://github.com/aerokube/ggr/actions?query=workflow%3Abuild)

[![Coverage](https://codecov.io/github/aerokube/ggr/coverage.svg)](https://codecov.io/gh/aerokube/ggr)

[![GoReport](https://goreportcard.com/badge/github.com/aerokube/ggr)](https://goreportcard.com/report/github.com/aerokube/ggr)

[![Release](https://img.shields.io/github/release/aerokube/ggr.svg)](https://github.com/aerokube/ggr/releases/latest)

[![Docker Pulls](https://img.shields.io/docker/pulls/aerokube/ggr.svg)](https://hub.docker.com/r/aerokube/ggr)

Go Grid Router (aka Ggr) is a lightweight active load balancer used to create scalable and highly-available [Selenium](http://seleniumhq.org/) clusters.

![Ggr Animation](docs/img/ggr-animation.gif)

## Articles

* [Selenium testing: a new hope (part I)](https://hackernoon.com/selenium-testing-a-new-hope-7fa87a501ee9)

* [Selenium testing: a new hope (part II)](https://hackernoon.com/selenium-testing-a-new-hope-a00649cdb100)

## Quick Start Guide

To use Go Grid Router do the following:

1) Install [Docker](http://docker.com/) to host

2) Create configuration directory:

```

$ mkdir -p /etc/grid-router/quota

```

3) Create ```users.htpasswd``` file:

```

$ htpasswd -bc /etc/grid-router/users.htpasswd test test-password

```

4) Start Selenium standalone server on port 4445:

```

$ java -jar selenium-server-standalone.jar -port 4445

```

You can also start [Selenoid](https://github.com/aerokube/selenoid) instead.

5) Create quota file (use correct browser name and version):

```

$ cat /etc/grid-router/quota/test.xml

    

        

            

        

    

```

***Note***: file name should correspond to username you added to htpasswd file. For user ```test``` we added on previous steps you should create ```test.xml```.

6) Start Ggr container:

```

# docker run -d --name ggr -v /etc/grid-router/:/etc/grid-router:ro --net host aerokube/ggr:latest-release

```

7) Access Ggr on port 4444 in the same way you do for Selenium Hub but using the following url:

```

http://test:test-password@localhost:4444/wd/hub

```

## Complete Guide & Build Instructions

Complete reference guide (including build instructions) can be found at: http://aerokube.com/ggr/latest/