Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New virtualization tool set (and new aet-cookbook version) #301

Merged
merged 12 commits into from
Aug 31, 2018
2 changes: 1 addition & 1 deletion .travis.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
language: java
sudo: false
sudo: required
jdk:
- oraclejdk8
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ All notable changes to AET will be documented in this file.
- [PR-325](https://github.com/Cognifide/aet/pull/325) Support env variables in report manager
- [PR-331](https://github.com/Cognifide/aet/pull/325) Support env variables in MongoDB config
- [PR-338](https://github.com/Cognifide/aet/pull/338) Enable creating new dbs by default
- [PR-301](https://github.com/Cognifide/aet/pull/301) New versions of virtualization tools used with new AET cookbook

## Version 2.1.6

Expand Down
15 changes: 8 additions & 7 deletions documentation/src/main/wiki/BasicSetup.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,13 @@ All services run using default ports. For communication please use the following

#### Prerequisites

By default the Vagrant virtual machine needs 6 GB of RAM and 4 vCPUs, so please make sure that
By default the Vagrant virtual machine needs 6 GB of RAM and 4 vCPUs, so please make sure that
you have enough memory on your machine (16 GB is recommended).

You need to download and install the following software:
* [VirtualBox 5.1.30](https://www.virtualbox.org/wiki/Download_Old_Builds_5_1)
* [Vagrant 1.9.2](https://releases.hashicorp.com/vagrant/)
* [ChefDK 2.4.17](https://downloads.chef.io/chef-dk/)
* [VirtualBox 5.2.18](https://www.virtualbox.org/wiki/Downloads)
* [Vagrant 2.1.2](https://releases.hashicorp.com/vagrant/)
* [ChefDK 3.1.0](https://downloads.chef.io/chefdk/stable)
* [JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
* [Chrome browser](https://www.google.com/chrome/browser/desktop/) to view reports
* [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/downloads) (at least version 2.40)
Expand All @@ -45,17 +45,18 @@ Open a command prompt **as the administrator** and execute the following command
set the `VAGRANT_HOME` variable for the location (by default it is set to `$HOME/vagrant.d`) and
update VirtualBox settings (`File -> Preferences -> General`) to move all disks to other directory.

Download or clone (`git clone [email protected]:Cognifide/aet.git`) the AET source code and navigate to the `vagrant` module directory.
Download or clone (`git clone [email protected]:Cognifide/aet.git`) the AET source code and navigate to the `vagrant` module directory.
Execute following commands to start the virtual machine (this process may take a few minutes):
* `berks install` - downloads Chef dependencies from external sources. It acts as `mvn clean install`, but for Chef cookbooks.
* `berks update`
* `vagrant up` - creates a new virtual machine (the `.box` file will be downloaded during the first run), runs Chef inside it, sets domains and port forwarding up.

See [Vagrant README](https://github.com/Cognifide/aet/blob/master/vagrant/README.md) file
See [Vagrant README](https://github.com/Cognifide/aet/blob/master/vagrant/README.md) file
for more Vagrant details, useful commands, etc.

#### Set up Selenium Grid node

When your Vagrant virtual machine is up and running, you need to start a Selenium Grid node process
When your Vagrant virtual machine is up and running, you need to start a Selenium Grid node process
to be able to run AET suites. To start the node process on your host machine (e.g. Windows):
```
java -Dwebdriver.chrome.driver="<path/to/chromedriver>" -jar <path/to/selenium-server-standalone.jar> -role node -hub http://192.168.123.100:4444/grid/register -browser "browserName=chrome,maxInstances=20" -maxSession 20
Expand Down
2 changes: 1 addition & 1 deletion documentation/src/main/wiki/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ please use the [Issues Tool](https://github.com/Cognifide/aet/issues) to raise a
### 1.1. What do I need to start using AET?
You need Maven and Java installed to run AET and Chrome browser to see reports if you have AET environment
already set up. See more information in [[Running Suite|RunningSuite#requirements]] section.
To setup AET you need [VirtualBox 5.1.30](https://www.virtualbox.org/wiki/Download_Old_Builds_5_1) to run AET VM.
To setup AET you need [VirtualBox 5.2.18](https://www.virtualbox.org/wiki/Downloads) to run AET VM.
See more details in [[Basic Setup|BasicSetup]] section.


Expand Down
9 changes: 9 additions & 0 deletions documentation/src/main/wiki/WhatsNew.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,15 @@ Here are notes that summarize the most important changes in AET from the user an
To see the full list of changes, please refer to [CHANGELOG](https://github.com/Cognifide/aet/blob/master/CHANGELOG.md).

### `master` branch version (not released yet)

#### Upgrade for our virtualization tool set

Changes that allows us to use newer versions of VirtualBox, Vagrant and Chef for AET instance setup:

* [VirtualBox 5.2.18](https://www.virtualbox.org/wiki/Downloads)
* [Vagrant 2.1.2](https://releases.hashicorp.com/vagrant/)
* [ChefDK 3.1.0](https://downloads.chef.io/chefdk/stable)

#### Suite XML re-use option
Added possibility to pass additional argument with suite XML file - `name`.
Thanks to that you may re-use the same XML file to run different suites
Expand Down
2 changes: 1 addition & 1 deletion vagrant/Berksfile
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ source "https://supermarket.chef.io"
# Uncomment one of the below lines to use aet cookbook from alternative location.
# And update the cookbook required version in 'metadata.rb' file.

#cookbook 'aet', git: 'https://github.com/Cognifide/aet-cookbook.git', branch: 'master'
cookbook 'aet', git: 'https://github.com/Cognifide/aet-cookbook.git', branch: 'master'
#cookbook 'aet', path: '../../aet-cookbook'

metadata
2 changes: 1 addition & 1 deletion vagrant/Vagrantfile
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
aet.local
)

config.omnibus.chef_version = '12.19.36'
config.omnibus.chef_version = '14.3.37'
config.berkshelf.enabled = true

config.vm.provision :chef_solo do |chef|
Expand Down
4 changes: 2 additions & 2 deletions vagrant/metadata.rb
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,6 @@
license 'Apache 2.0'
description 'Installs/Configures aet-vagrant'
long_description 'Installs/Configures aet-vagrant'
version '1.4.9'
version '2.1.6'

depends 'aet', '~> 4.0.0'
depends 'aet', '~> 5.0.0'