cookbook 'selenium', '= 2.7.0'
selenium
(46) Versions
2.7.0
-
Follow14
Installs/Configures Selenium
cookbook 'selenium', '= 2.7.0', :supermarket
knife supermarket install selenium
knife supermarket download selenium
Selenium Cookbook
This cookbook installs and configures Selenium and WebDriver components (http://www.seleniumhq.org/).
This cookbook comes with the following Resource/Providers:
- selenium_hub - Installs and configures selenium-grid hubs.
- selenium_node - Installs and configures selenium-grid nodes with support for ChromeDriver, FirefoxDriver, HtmlUnitDriver, InternetExplorerDriver, and SafariDriver.
PhantomJS has been deprecated and is no longer supported. It will be removed in the next major release. Please use
ghostdriver cookbook instead.
Requirements
- Chef 11.14 or higher (sensitive attribute introduced)
Platforms
- CentOS, RedHat
- Mac OS X
- Ubuntu
- Windows
Cookbooks
These cookbooks are referenced with suggests, so be sure to depend on cookbooks that apply:
- windows
- nssm - Required by Windows services only (e.g. Hub and HtmlUnit running in background)
- macosx_autologin - Required by Mac OS X GUI services
- safari - Required by safaridriver
- macosx_gui_login - Required by safaridriver
Usage
See selenium_test
cookbook for working cross platform examples. Note that provided examples in this cookbook have passwords
unencrypted for simplicity.
selenium_hub
Installs and configures selenium-grid hubs.
Requirements
- Java must be installed outside of this cookbook.
Example
Install selenium-grid hub
selenium_hub 'selenium_hub' do action :install end
Attributes
This is a partial list of attributes available. See
hub
resource for the complete listing of attributes.
-
name
- Name attribute. The name of the service. -
host
- Hostname. Defaults tonull
. -
port
- Port. Defaults to4444
.
selenium_node
Installs and configures selenium-grid nodes with support for
ChromeDriver,
FirefoxDriver,
HtmlUnitDriver,
InternetExplorerDriver, and
SafariDriver.
Requirements
- Java must be installed outside of this cookbook.
- Browsers (e.g., chrome, firefox, etc...) must be installed outside of this cookbook.
- Linux nodes without a physical monitor require a headless display (e.g., xvfb, x11vnc, etc...) and must be installed and configured outside this cookbook.
- Mac OS X/Windows nodes (with the exception of HtmlUnitDriver) must run as a GUI service and that requires a username
and password for automatic login. Note that Windows password is stored unencrypted under windows registry
HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
and Mac OS X password is stored encrypted under/etc/kcpassword
but it can be easily decrypted.
Example
Install selenium-grid node with Chrome, Firefox, HtmlUnit and Internet Explorer capability
selenium_node 'selenium_node' do username 'Administrator' if platform?('windows') password 'password' if platform?('windows') capabilities [ { browserName: 'chrome', maxInstances: 5, seleniumProtocol: 'WebDriver' }, { browserName: 'firefox', maxInstances: 5, seleniumProtocol: 'WebDriver' }, { browserName: 'htmlunit', maxInstances: 1, platform: 'ANY', seleniumProtocol: 'WebDriver' }, { browserName: 'internet explorer', maxInstances: 1, seleniumProtocol: 'WebDriver' } ] action :install end
Attributes
This is a partial list of attributes available. See
node
resource for the complete listing of attributes.
-
name
- Name attribute. The name of the service or Windows foreground startup script. -
host
- Hostname. Defaults tonull
. -
port
- Port. Defaults to5555
. -
hubHost
- Selenium-grid hub hostname. Defaults toip
. -
hubPort
- Selenium-grid hub port. Defaults to4444
. -
capabilities
- The following drivers are supported and installed based on capabilities:-
ChromeDriver - Installed if capabilities contains
browser name
chrome
- FirefoxDriver - Pre-installed with Selenium server
- HtmlUnitDriver - Pre-installed with Selenium server
-
InternetExplorerDriver - 32-bit or 64-bit
installed if capabilities contains browser name
internet explorer
-
SafariDriver - Installed if capabilities contains
browser name
safari
-
ChromeDriver - Installed if capabilities contains
browser name
- Mac OS X/Windows only - Set both username and password to run as a GUI service or leave nil to run service in
background (HtmlUnit only):
-
username
- Defaults tonil
. -
password
- Defaults tonil
. Note that Windows password is stored unencrypted under windows registryHKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
and Mac OS X password is stored encrypted under/etc/kcpassword
but it can be easily decrypted. -
domain
- Optional for Windows only. Defaults tonil
.
-
ChefSpec Matchers
The Selenium cookbook includes custom ChefSpec matchers you can use to test
your own cookbooks.
Example Matcher Usage
expect(chef_run).to install_selenium_hub('resource_name').with( port: '4444' )
Selenium Cookbook Matchers
- install_selenium_hub(resource_name)
- install_selenium_node(resource_name)
Getting Help
- Ask specific questions on Stack Overflow.
- Report bugs and discuss potential features in Github issues.
Contributing
Please refer to CONTRIBUTING.
License
MIT - see the accompanying LICENSE file for details.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
Changelog
2.7.0 8/21/2015
- Allow custom arguments to be added to node service
- Allow custom download url for selenium standalone jar
2.6.0 - 8/2/2015
- Support Safari
2.5.2 - 8/2/2015
- Fix #18 Selenium iedriver does not extract
2.5.1 - 7/31/2015
- Update Selenium and IE driver from 2.46.0 to 2.47.0
- Update ChromeDriver from 2.15 to 2.16
2.5.0 - 7/29/2015
- Deprecate PhantomJS
2.4.2 - 6/29/2015
- Add powershell_version check
2.4.1 - 6/29/2015
- Fix #16 Errror provisioning chromedriver on centos7
- Fix #15 Drivers not copied to /selenium/drivers/ folders on Windows 7
2.4.0 - 6/9/2015
- Allow resources to be globally configured
2.3.3 - 6/9/2015
- Fix #13 org.openqa.selenium.WebDriverException: chrome not reachable on CentOS 7.0/Ubuntu 14.04
2.3.2 - 6/4/2015
- Update Selenium and IE driver from 2.45.0 to 2.46.0
2.3.1 - 5/26/2015
- Add supports 'mac_os_x' to metadata
2.3.0 - 5/26/2015
- Add support for Mac OS X (Chef 11.14 or higher required)
2.2.6 - 5/26/2015
- Fix #11 chromedriver version does not update
- Update ChromeDriver from 2.14 to 2.15
2.2.5 - 5/1/2015
- Fix #10 'failed to allocate memory' exception on Windows 2008
2.2.4 - 4/12/2015
- Fix selenium_node provider depends on windows
- Set Windows display resolution in selenium_test cookbook
2.2.3 - 3/23/2015
- Wrap host and hubHost in quotes in node config
- Update IE driver from 2.44.0 to 2.45.0
2.2.2 - 2/26/2015
- Firefox 36 breaks WebDriver 2.44.0
2.2.1 - 2/18/2015
- Update ChromeDriver from 2.12 to 2.14
2.2.0 - 2/5/2015
- Make Windows service an option for HtmlUnit and PhantomJS
2.1.0 - 2/2/2015
- Support HtmlUnit
2.0.0 - 2/2/2015
- Replace PhantomJS attributes
1.0.0 - 2/1/2015
- Initial release
Foodcritic Metric
2.7.0 passed this metric
2.7.0 passed this metric