Pre-Requisites(with versions tested on)

• Java 8
• Ruby >= 2.3.3
• Rake 12.0.0
• Bundler 1.14.6
• Node v6.10.1
• Gauge 0.9.6
• Gauge-ruby plugin 0.4.2
• Firefox >= 45.0
• geckodriver 0.19.1
• jq

Setup

• git clone as a sibling directory to go.cd and go-plugins
• $ cd ruby-functional-tests
• $ gauge --install-all

Prepare and run specs

• Build GoCD server and agent zip installers - cd to gocd and run: ./gradlew clean installers:agentGenericZip installers:serverGenericZip test:test-addon:assemble
• Build GoCD plugins api - cd to gocd and run : ./gradlew -PfastBuild --parallel --max-workers 2 plugin-infra:go-plugin-api:install plugin-infra:go-plugin-api-internal:install installers:versionFile
• Build go plugins - cd to go-plugins and run: ./gradlew clean assemble copyJarsToOnePlace -PgoVersion=$(jq '.go_full_version' -r ../gocd/installers/target/distributions/meta/version.json)
• cd to ruby-functional-tests and run : $ bundle install --path=vendor/bundle
• To clean, prepare server and agent for functional test execute this command bundle exec rake GO_VERSION='X.x.x' clean_test server:prepare agent:prepare
• To run all specs execute this command bundle exec rake GO_VERSION='X.x.x' GAUGE_TAGS='<spec tags to run>' test
• To run specific task(s), execute this command bundle exec rake [kill/clean/prepare/test/bump-schema] GO_VERSION='X.x.x' GAUGE_TAGS='<spec tags to run>'
  • kill - Kills all running processes spun by the tests.
  • clean_test - Cleans all directories (ruby-functional-tests/target, ruby-functional-tests/reports).
  • prepare - Initializes the filesystem to run tests.
  • test - Runs the gauge tests with specified tags.
  • bump-schema - Bump up schema version. Example: VERSION=99 rake bump-schema

License

Copyright 2018 ThoughtWorks, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.